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ú, Bradesco, Banco do Brasil, ABC, etc.) e fica disponível com URL para envio ao cliente, código de barras e DANFE/PDF.
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 (consultar boleto após packing, gerar boleto automaticamente após emissão de NF de serviço) 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?
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?
Os bancos com integração para emissão automática de boleto através do idworks são:
| Banco | Status |
|---|---|
| Banco Inter | Integração ativa |
| Itaú | Integração ativa |
| Bradesco | Integração ativa |
| Banco do Brasil | Integração ativa |
| Banco ABC | Integração ativa |
Para usar, é preciso ter o cadastro da integração bancária correspondente em Configurações → Integrações (com chave de API, certificado e/ou credenciais conforme o banco exige).
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. O modal abre permitindo alterar valor, vencimento e comentários — exatamente quais campos são editáveis depende do banco (alguns só permitem alterar vencimento; outros aceitam valor também).
Quando o ícone está acinzentado, o boleto não permite mais edição (geralmente porque já está pago, cancelado ou o banco não suporta edição naquele estágio).
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á Pago (IDStatusBankSlip=2) — 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 (1) nem Pendente (3) — 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 (IDStatusBankSlip=2). 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.
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. |
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. |