Boleto Bancário
A tela Boleto Bancário é onde a empresa gera, acompanha e gerencia boletos de cobrança emitidos para clientes — tanto avulsos (cobrança direta sem pedido) quanto vinculados a um pedido de venda ou a uma nota fiscal de serviço. Cada boleto é gerado via integração bancária já configurada (Banco Inter, Itaú, Cielo, PagarMe ou MercadoPago) e fica disponível com URL para envio ao cliente, código de barras e PDF do boleto.
A partir desta tela você gera um novo boleto (escolhendo cliente, valor, vencimento e integração), edita boletos que ainda permitem alteração, cancela com ou sem dar baixa do pagamento, atualiza o status consultando o banco em tempo real, copia a URL para enviar por e-mail/WhatsApp ao cliente, visualiza a página do boleto pronta para impressão e executa ações em massa sobre os boletos selecionados.
As parametrizações que automatizam a geração e o envio (consultar boleto após packing, gerar boleto automaticamente após emissão de NF de serviço, enviar o boleto ao cliente por WhatsApp ou e-mail assim que ele é gerado) ficam em Configurações → Parametrizações e estão resumidas no final desta página.
Índice
Conceito
- O que é a tela Boleto Bancário?
- Qual a diferença entre Boleto Bancário e Contas a Receber?
- O que significa cada Status do boleto?
- Quais bancos têm integração de boleto disponível?
- O que é o ícone à esquerda da linha (carrinho ou auditoria)?
Cadastro e edição
- Como gerar um novo boleto?
- Como editar um boleto?
- Como cancelar um boleto?
- Qual a diferença entre Somente Cancelar e Dar Baixa e Cancelar?
- Como atualizar o status do boleto consultando o banco?
Envio e visualização
- Como copiar a URL do boleto para enviar ao cliente?
- Como visualizar o boleto pronto para impressão?
- Como copiar o código de barras?
- Como buscar e filtrar boletos?
Ações em lote
Regras de negócio
- Por que o ícone Editar está desabilitado?
- Por que o ícone Cancelar está desabilitado?
- Por que o ícone Atualizar está desabilitado?
Configurações
- Como gerar boleto automaticamente após emitir NF de serviço?
- Como consultar boletos pendentes ao finalizar o packing?
- Como enviar o boleto ao cliente por WhatsApp automaticamente?
- Como enviar o boleto ao cliente por e-mail automaticamente?
Boas práticas
Referência rápida
O que é a tela Boleto Bancário?
É a tela onde a empresa gera e gerencia boletos de cobrança para clientes. Cada linha é um boleto emitido — vinculado a um pedido de venda, a uma nota fiscal de serviço, ou avulso (cobrança direta sem vínculo). A tela permite criar, editar, cancelar, atualizar o status consultando o banco em tempo real, copiar a URL para envio ao cliente e visualizar o boleto pronto para impressão.
O boleto é emitido via integração bancária já configurada na empresa (cada banco tem seu próprio cadastro em Configurações → Integrações). A tela é única, sem abas — todos os filtros e ações ficam à vista.
📍 Onde: menu lateral → Clientes → Boleto Bancário.
Qual a diferença entre Boleto Bancário e Contas a Receber?
| Boleto Bancário (esta tela) | Contas a Receber | |
|---|---|---|
| O que registra | O documento de cobrança físico/digital — o boleto em si, com URL, código de barras e status do banco. | O título financeiro — valor, vencimento, status de pagamento, vínculo com pedido. |
| Quem gera | A integração bancária da empresa, via API do banco. | O sistema, automaticamente ao confirmar um pedido ou manualmente em Financeiro → Contas a Receber. |
| Tem URL/código de barras? | Sim — gerados pelo banco e armazenados no idworks. | Não — mas o boleto vinculado tem. |
| Estados possíveis | Ag. Pagamento, Pago, Pendente, Cancelado, Baixa manual, Protesto. | Aberto, Pago, Pago Parcialmente, Vencido, Cancelado. |
| Pode existir sem o outro? | Boleto sem conta a receber existe (cobrança avulsa). | Conta a receber sem boleto existe quando o pagamento é PIX, cartão, dinheiro etc. |
| Onde | Clientes → Boleto Bancário. | Financeiro → Contas a Receber. |
Os dois trabalham em conjunto: a baixa de uma conta a receber paga via boleto move o status do boleto automaticamente (via webhook ou consulta manual). A geração de um boleto a partir de um pedido também cria a conta a receber correspondente.
O que significa cada Status do boleto?
A coluna Status mostra a situação atual do boleto no banco:
| Status | Significado |
|---|---|
| Ag. Pagamento (laranja) | Boleto registrado no banco e aguardando o pagamento do cliente. Estado inicial para a maioria das integrações. |
| Pago (azul) | Banco confirmou o pagamento — a conta a receber correspondente é dada como paga automaticamente. |
| Pendente (cinza) | Boleto criado no idworks mas ainda não confirmado no banco (geralmente um curto intervalo entre solicitar e o banco registrar). |
| Cancelado | Boleto cancelado (no idworks via ação Cancelar, ou pelo banco). |
| Baixa manual | Cliente pagou por outro meio (PIX, transferência) e a operação deu baixa manualmente no boleto sem aguardar o retorno do banco. |
| Protesto | Boleto enviado para protesto após vencimento + tolerância. |
O status pode ser atualizado em tempo real pelo ícone Atualizar da linha (consulta o banco) ou em lote pela ação correspondente em Mais Ações.
Quais bancos têm integração de boleto disponível?
As integrações que emitem boleto pelo idworks são:
| Integração | Gera boleto? | Edita boleto? |
|---|---|---|
| Banco Inter | Sim | Sim |
| Itaú | Sim | Sim |
| Cielo (gateway) | Sim | Sim |
| Pagar.me (gateway) | Sim | Não |
| MercadoPago (gateway) | Sim | Não |
Para usar, é preciso ter o cadastro da integração correspondente em Configurações → Integrações (com chave de API, certificado e/ou credenciais conforme exige). Apenas as integrações da tabela acima geram boleto pelo idworks. A edição (alterar valor/vencimento) só funciona em Itaú, Banco Inter e Cielo.
O que é o ícone à esquerda da linha (carrinho ou auditoria)?
A primeira coluna da lista tem um pequeno ícone que indica a origem do boleto:
- Carrinho de compras — boleto vinculado a um pedido de venda. A coluna seguinte "Pedido | NFE serviço" traz o número do pedido com um botão de olho para abrir o detalhe.
- Auditoria — boleto vinculado a uma nota fiscal de serviço. A coluna seguinte traz o número da NFSe.
- Vazio — boleto avulso, sem vínculo com pedido ou NFSe (cobrança direta do cliente).
Clique no ícone de olho ao lado do número para abrir o pedido ou a nota fiscal de serviço correspondente em uma aba nova.
Como gerar um novo boleto?
Clique em Novo Boleto no topo da tela. O modal abre com o formulário:
- Cliente — selecione o cliente a ser cobrado. O sistema busca o endereço cadastrado automaticamente.
- Integração — escolha o banco que emitirá o boleto (precisa estar cadastrado em Configurações → Integrações).
- Valor — valor do boleto.
- Data vencimento — data em que o boleto vence.
- Comentários — observação opcional que aparece no boleto.
- Clique em Salvar.
O idworks chama a API do banco escolhido para registrar o boleto. Quando o banco confirma, o boleto aparece na lista com URL e código de barras prontos para envio — e a janela de visualização abre automaticamente para você conferir.
Cadastros que você precisa ter antes
- Cliente — em Clientes → Listar Clientes (com endereço completo).
- Integração bancária — em Configurações → Integrações, escolha o banco e configure as credenciais.
Pré-requisito: privilégio Criar boleto bancário.
Como editar um boleto?
Clique no ícone EditOutlined (Editar Boleto) na linha. A janela abre permitindo alterar valor e/ou vencimento. A edição só funciona nas integrações Itaú, Banco Inter e Cielo — nas demais o sistema responde "Integração não tem recurso de atualização". É preciso informar um novo valor e/ou uma nova data; sem nenhum dos dois, o sistema avisa "Precisar informar novo valor e/ou data".
Quando o ícone está acinzentado, o boleto não permite mais edição (geralmente porque já está pago, cancelado, ou a integração não suporta edição).
Pré-requisito: privilégio Editar Boleto Bancário.
Como cancelar um boleto?
Clique no ícone CloseCircleOutlined (Cancelar Boleto) na linha. Uma janela de confirmação abre com a pergunta:
Você está prestes a cancelar este boleto. Deseja também realizar a baixa no pagamento ou apenas proceder com o cancelamento do boleto?
Você tem três opções:
- Fechar — desiste do cancelamento.
- Dar Baixa e Cancelar — abre um segundo modal para informar Data pagamento e Valor pago — útil quando o cliente já pagou (via PIX, transferência, dinheiro) e você precisa registrar o pagamento ao mesmo tempo que cancela o boleto para evitar cobrança duplicada.
- Somente Cancelar — cancela o boleto sem registrar pagamento. A conta a receber associada (se houver) fica em aberto.
O cancelamento é enviado ao banco — quando confirmado, o status muda para Cancelado.
Pré-requisito: privilégio Cancelar Boleto Bancário.
Qual a diferença entre Somente Cancelar e Dar Baixa e Cancelar?
| Somente Cancelar | Dar Baixa e Cancelar | |
|---|---|---|
| Quando usar | Cliente desistiu da compra, boleto foi emitido errado, ou simplesmente o cobrar via outro meio. | Cliente pagou por outro canal (PIX, transferência bancária, dinheiro), mas o boleto continua aberto no banco. |
| O que o sistema faz | Cancela o boleto no banco. A conta a receber correspondente fica em aberto — precisa ser tratada manualmente. | Cancela o boleto e registra um pagamento (lançamento na conta bancária) com a data e o valor informados. A conta a receber é dada como paga. |
| Campos obrigatórios | Nenhum — confirmação direta. | Data pagamento e Valor pago. |
| Efeito no boleto | Status vira Cancelado. | Status vira Cancelado (e o pagamento é registrado em paralelo). |
Use Dar Baixa e Cancelar quando precisar "matar" um boleto que ficou aberto após o cliente ter pago por fora.
Como atualizar o status do boleto consultando o banco?
Clique no ícone ReloadOutlined (Atualizar) na linha. O idworks faz uma consulta à API do banco para buscar o status atualizado e atualiza a linha. Útil quando você suspeita que o cliente pagou mas o status na tela ainda mostra Ag. Pagamento (pode haver atraso no webhook do banco).
O ícone fica desabilitado quando o boleto está no status Pago — porque o banco não vai mudar o status de um boleto já pago.
Como copiar a URL do boleto para enviar ao cliente?
Clique no ícone CopyOutlined (Copiar URL Boleto) na linha. A URL do boleto é copiada para a área de transferência — o ícone muda para um "check" verde por 1 segundo para confirmar.
Cole a URL no e-mail, WhatsApp ou em qualquer canal de comunicação com o cliente. Ao clicar, ele vê o boleto formatado pronto para imprimir ou pagar via o app do banco.
Como visualizar o boleto pronto para impressão?
Há duas formas:
- Clique no ícone EyeOutlined (Visualizar) na linha de ações.
- Duplo-clique na linha.
Uma janela abre exibindo o boleto em PDF (renderizado em iframe). No rodapé do modal, você tem botões para Copiar Cód. de Barras e Copiar URL — úteis para enviar ao cliente.
O ícone Visualizar fica desabilitado quando o boleto ainda não tem URL gerada (raríssimo — apenas no curto intervalo entre criar e o banco confirmar).
Como copiar o código de barras?
Dentro da janela Visualizar, clique no botão BarcodeOutlined (Copiar Cód. de Barras) no rodapé. O código de barras é copiado para a área de transferência — o botão muda para "Cód. de Barras Copiado!" por 1 segundo para confirmar.
Útil para enviar ao cliente em apps de mensagem onde a URL pode falhar — ele cola no app do banco para pagar.
Como buscar e filtrar boletos?
Clique em Filtros para abrir o painel lateral. Os filtros disponíveis:
- Conta — separa por conta (subdomínio).
- Data criação — intervalo de datas em que o boleto foi gerado.
- Data vencimento — intervalo de datas em que o boleto vence.
- Status — Ag. Pagamento, Pago, Pendente, Cancelado, Baixa manual ou Protesto (pode selecionar mais de um).
- Nome / razão social — busca textual no nome do cliente.
- E-mail — busca textual no e-mail do cliente.
- CPF / CNPJ — busca exata pelo documento.
- Cód. pedido — código interno do pedido vinculado.
- TID — identificador da transação no banco (útil para conciliação).
Os filtros são cumulativos. Clique em Aplicar para atualizar a lista.
Como atualizar status de vários boletos de uma vez?
Selecione os boletos na lista (caixa de seleção) e clique em Mais Ações. A opção Atualizar Boletos em Massa (visível quando há linhas selecionadas) dispara uma chamada ao banco para cada um dos boletos selecionados e atualiza o status — exibe barra de progresso e tabela com Status (Sucesso/Atenção) e Mensagem por linha.
Útil no início do dia, para sincronizar todos os boletos pendentes de uma vez.
Como cancelar vários boletos selecionados?
Selecione os boletos e clique em Mais Ações → Cancelar Boletos em Massa. O sistema pede confirmação e processa um a um — boletos que não podem ser cancelados (já pagos ou já cancelados) ficam com status Atenção na tabela de resultado.
Pré-requisito: privilégio Cancelar Boleto Bancário.
Por que o ícone Editar está desabilitado?
Causas possíveis:
- Você não tem o privilégio Editar Boleto Bancário.
- O boleto não permite mais edição — o sistema marca isso internamente quando o banco já não aceita alteração (boleto pago, cancelado, protestado ou outras situações).
Para alterar dados de um boleto que não permite edição, o caminho é cancelar o boleto atual e gerar um novo com os dados corretos.
Por que o ícone Cancelar está desabilitado?
O ícone fica desabilitado quando:
- Você não tem o privilégio Cancelar Boleto Bancário.
- O boleto não permite cancelamento (marcação interna do sistema com base na resposta do banco).
- O status do boleto não é Ag. Pagamento nem Pendente — boletos já Pagos, Cancelados, em Baixa manual ou Protesto não podem ser cancelados pela tela.
Por que o ícone Atualizar está desabilitado?
O ícone Atualizar fica desabilitado quando o boleto está no status Pago. Como o banco não muda o status de um boleto já pago, a consulta seria redundante — o sistema bloqueia para evitar chamadas desnecessárias.
Para outros status (Ag. Pagamento, Pendente, Protesto), o ícone funciona normalmente.
Como gerar boleto automaticamente após emitir NF de serviço?
Ative a parametrização Gerar boleto após emissão NF. Acesse Configurações → Parametrizações → Fiscal Serviço, marque Gerar boleto após emissão NF e salve.
A partir desse momento, sempre que uma NF de serviço for emitida e o tipo de pagamento configurado for boleto (com a integração bancária ativa), o sistema gera o boleto automaticamente em sequência — sem precisar abrir esta tela.
Como consultar boletos pendentes ao finalizar o packing?
Ative a parametrização Consultar Boleto após finalizar o packing. Acesse Configurações → Parametrizações → Logística (WMS) → Packing, marque Consultar Boleto após finalizar o packing e salve.
A partir desse momento, sempre que o operador finalizar o packing de um pedido, o sistema consulta se há boleto disponível para o pedido e mostra para impressão na mesma tela.
Útil para integrar a impressão do boleto ao fluxo de envio — o cliente recebe a entrega já com o boleto impresso.
Como enviar o boleto ao cliente por WhatsApp automaticamente?
Ative a parametrização Enviar boleto WhatsApp. Ela fica no cadastro da integração de pagamento (PagarMe, MercadoPago, Banco Inter ou Itaú): acesse Configurações → Parametrizações → Configurações Gerais da integração, marque Enviar boleto WhatsApp e salve.
A partir desse momento, sempre que um boleto for gerado por essa integração, o sistema envia o boleto ao cliente por WhatsApp automaticamente — com o nome da sua loja, o valor, a data de vencimento e o PDF do boleto anexado. Não é preciso copiar a URL e enviar manualmente.
Para o envio acontecer, o cliente precisa ter telefone cadastrado e o boleto precisa já ter a página gerada. O sistema ajusta o número para o formato internacional do Brasil automaticamente. Quando o telefone está em formato inválido (ou o envio falha por algum motivo no WhatsApp), o boleto continua gerado normalmente — a falha fica registrada no histórico de eventos do pedido vinculado, para você reenviar manualmente pela ação Copiar URL Boleto.
Como enviar o boleto ao cliente por e-mail automaticamente?
Ative a parametrização Enviar boleto/ficha do pedido por email. Ela fica no cadastro da integração de pagamento (PagarMe, MercadoPago, Banco Inter ou Itaú): acesse Configurações → Parametrizações → Configurações Gerais da integração, marque Enviar boleto/ficha do pedido por email e salve.
Com ela ativa, ao gerar o boleto o sistema encaminha por e-mail ao cliente o link da ficha do pedido junto com o boleto — usando o e-mail cadastrado no cliente. O conteúdo do e-mail muda conforme a origem do boleto:
- Boleto vinculado a um pedido de venda — o e-mail traz o assunto "<Loja> - Pedido Nº <número do pedido>" e dois links: um para o boleto e outro para a ficha do pedido (com o número do pedido no assunto).
- Boleto vinculado a uma nota fiscal de serviço — o e-mail traz o assunto "<Loja> - Nota Fiscal de Serviço Nº <número da NFS-e>", o link do boleto e o XML da NFS-e anexado ao e-mail.
O envio (ou a falha) fica registrado no histórico de eventos do pedido (ou da OS) vinculado, com o e-mail destinatário. Se quiser reenviar manualmente, use a ação Copiar URL Boleto na linha.
Quando o cadastro do cliente tem mais de um e-mail (separados por vírgula ou ponto e vírgula), o sistema usa o primeiro da lista.
Boas práticas para a cobrança por boleto
Algumas escolhas na hora de gerar e tratar o boleto evitam cobrança duplicada, retrabalho e cliente sem o boleto na mão:
- Escolha a integração certa logo na geração. Só Itaú, Banco Inter e Cielo permitem alterar valor ou vencimento depois. Se gerar em outra integração e precisar mudar algo, não dá para editar — o caminho é cancelar e gerar de novo.
- Confira o cliente com endereço completo antes de gerar. O boleto puxa o endereço do cadastro do cliente automaticamente — cliente sem endereço completo pode travar a emissão no banco.
- Quando o cliente pagou por fora, use Dar Baixa e Cancelar. Se ele já quitou por PIX, transferência ou dinheiro e o boleto continua aberto, essa opção cancela o boleto e registra o pagamento de uma vez — evita cobrança em duplicidade. Use Somente Cancelar apenas quando não houve pagamento.
- Atualize o status antes de cobrar de novo. Se o cliente diz que pagou mas a linha ainda mostra Ag. Pagamento, clique em Atualizar para consultar o banco em tempo real — o aviso de pagamento pode estar atrasado e você evita cobrar quem já pagou.
- Sincronize os pendentes no início do dia. Selecione os boletos abertos e use Mais Ações → Atualizar Boletos em Massa para trazer de uma vez quem pagou — assim as contas a receber vinculadas baixam sozinhas.
- Para enviar automático, garanta telefone e e-mail no cliente. O envio por WhatsApp precisa de telefone cadastrado e o envio por e-mail usa o primeiro e-mail do cadastro. Cadastro incompleto faz o envio falhar — e o boleto segue gerado, mas sem chegar ao cliente.
Resumo de parametrizações
Configurações da empresa que afetam esta tela. Para ativar ou desativar, acesse Configurações → Parametrizações, abra o submenu indicado e habilite ou desabilite a parametrização.
| Parametrização | Submenu | O que muda quando ativada |
|---|---|---|
| Gerar boleto após emissão NF | Fiscal Serviço | Ao emitir uma NF de serviço com tipo de pagamento Boleto e integração bancária ativa, o sistema gera o boleto automaticamente em sequência. |
| Consultar Boleto após finalizar o packing | Logística (WMS) → Packing | Ao finalizar o packing de um pedido, o sistema consulta se há boleto disponível e o mostra para impressão na própria tela de packing. |
| Enviar boleto WhatsApp | Configurações Gerais (na integração PagarMe, MercadoPago, Banco Inter ou Itaú) | Ao gerar o boleto, o sistema envia automaticamente o boleto ao cliente por WhatsApp (com nome da loja, valor, vencimento e PDF anexo), desde que o cliente tenha telefone cadastrado. |
| Enviar boleto/ficha do pedido por email | Configurações Gerais (na integração PagarMe, MercadoPago, Banco Inter ou Itaú) | Ao gerar o boleto, o sistema encaminha por e-mail ao cliente o link da ficha do pedido junto com o boleto (ou o XML da NFS-e anexado, quando o boleto vier de uma nota fiscal de serviço). O envio fica registrado no histórico de eventos do pedido/OS. |
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar geração boleto bancário | Acesso à tela e à lista. |
| Criar boleto bancário | Botão Novo Boleto e geração automática a partir de outras telas. |
| Editar Boleto Bancário | Ícone Editar Boleto na linha. |
| Cancelar Boleto Bancário | Ícone Cancelar Boleto na linha (com ou sem dar baixa) e ação em lote. |