Pular para o conteúdo principal

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ú, Sicoob, 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. A geração automática do boleto do pedido de venda é a exceção: ela é ligada na chave Gerar boleto do Tipo Pedido.

Índice​

Conceito

Cadastro e edição

Envio e visualização

Ações em lote

Regras de negócio

Configurações

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 registraO 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 geraA 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íveisAg. 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.
OndeClientes → 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:

StatusSignificado
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).
CanceladoBoleto cancelado (no idworks via ação Cancelar, ou pelo banco).
Baixa manualCliente pagou por outro meio (PIX, transferência) e a operação deu baixa manualmente no boleto sem aguardar o retorno do banco.
ProtestoBoleto 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.

Quando o banco confirma o recebimento com data dentro do período financeiro fechado, o boleto fica Pago, mas a baixa da conta a receber não é lançada. Em vez dela, aparece um alerta Recebimento em período fechado em Alertas prioritários, na Home, que abre o título para alguém lançar a baixa à mão, e a mesma mensagem fica no histórico do título. Isso vale pelos dois caminhos por onde o pagamento chega:

  • Aviso automático do banco (Sicoob e Banco Inter).
  • Consulta ao banco (Banco Inter, Sicoob e Itaú): a que o idworks faz sozinho nos boletos pendentes (veja O sistema atualiza o status do boleto sozinho?) e a do ícone Atualizar ou da atualização em lote.

Pelo Atualizar, a tela não mostra erro: aparece a confirmação de sucesso de sempre, a visualização do boleto abre e, na lista, o status passa a Pago. O aviso de que a baixa ficou faltando é o alerta da Home, que aparece quando a Home é carregada.

Na consulta ao banco, não há alerta (nem baixa) quando o título do boleto já não está em aberto — por exemplo, porque a baixa já foi lançada à mão — ou quando o idworks não encontra a conta bancária do boleto (nem pela integração, nem pelo banco e número da conta).

Veja Fechamento Financeiro.

Quais bancos têm integração de boleto disponível?​

As integrações que emitem boleto pelo idworks são:

IntegraçãoGera boleto?Edita boleto?
Banco InterSimSim
ItaúSimSim
SicoobSimSim
Cielo (gateway)SimSim
Pagar.me (gateway)SimNão
MercadoPago (gateway)SimNã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, Sicoob e Cielo.

O Sicoob tem exigências próprias. No cadastro da integração vão as credenciais de acesso e o número do cliente — o número do contrato do beneficiário no Sisbr, fornecido pelo banco. É preciso também ter uma conta bancária da empresa vinculada a essa integração; sem ela o idworks recusa a emissão com a mensagem "Conta bancária não encontrada para esta integração". A conta corrente informada ao Sicoob é sempre a dessa conta bancária vinculada.

O certificado digital que o Sicoob exige não é mais o informado no cadastro da integração: o idworks usa o certificado A1 da empresa — o mesmo que ela já usa para emitir NF-e, importado em Configurações → Minhas Empresas, aba Certificado. Em qualquer operação com o Sicoob (gerar, consultar, editar ou cancelar boleto), fora do modo de homologação, o idworks confere o certificado e recusa a operação quando:

  • a empresa não tem certificado cadastrado — "... não tem certificado digital cadastrado. Suba o certificado A1 em Minha empresa > Certificado.";
  • o certificado venceu — "... venceu em dd/mm/aaaa. Renove o certificado A1 em Minha empresa > Certificado.";
  • o certificado ainda não está vigente (a data de início de validade é futura);
  • o certificado é de outra empresa — o CNPJ do titular não bate com o da empresa dona da conta. Certificado da matriz usado pela filial (mesma raiz de CNPJ) é aceito.

No cadastro do aplicativo no portal do Sicoob, o banco pede a chave pública do certificado. Ela pode ser baixada pelo botão Exportar chave pública, na aba Certificado da empresa — veja Minhas Empresas.

Os juros e a multa configurados na integração Sicoob começam a contar no dia seguinte ao vencimento. Boletos Sicoob gerados antes de uma correção recente saíam com juros e multa 100 vezes menores que o percentual configurado (2% virava 0,02%); os boletos novos já saem com o percentual certo, mas os antigos continuam com o valor que o banco registrou. Se a espécie do documento ficar em branco na integração, o boleto sai como Duplicata Mercantil; se a identificação de emissão e a de distribuição ficarem em branco, o boleto é emitido e distribuído pela própria empresa.

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:

  1. Cliente — selecione o cliente a ser cobrado. O sistema busca o endereço cadastrado automaticamente.
  2. Integração — escolha o banco que emitirá o boleto (precisa estar cadastrado em Configurações → Integrações).
  3. Valor — valor do boleto.
  4. Data vencimento — data em que o boleto vence.
  5. Comentários — observação opcional que aparece no boleto.
  6. Clique em Salvar.

O idworks pede o registro do boleto ao banco escolhido. 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.

A geração não é instantânea. O idworks espera o banco terminar de processar o registro antes de dar o boleto por criado, e depois ainda busca a página do boleto. Por isso a janela pode demorar alguns segundos para responder — não clique em Salvar de novo enquanto isso.

Dois desfechos merecem atenção, principalmente no Banco Inter:

  • Aparece "Boleto em processamento. Estará disponível em breve" — o banco aceitou o pedido, mas não terminou de registrar dentro do tempo que o idworks aguarda. O boleto não entra na lista. Espere alguns instantes e gere novamente; se o registro anterior tiver se concluído no banco, cancele o duplicado depois.
  • O boleto entra na lista mas sem a página para visualizar — acontece quando o banco registrou o boleto mas ainda não devolveu o arquivo. A cobrança é válida (código de barras e linha digitável já estão lá), mas os ícones Visualizar e Copiar URL Boleto ficam sem conteúdo, e o envio automático por WhatsApp não sai. O arquivo não é refeito pelo ícone Atualizar — para forçar a geração, use Editar Boleto e confirme uma alteração de valor ou vencimento.

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 Editar Boleto (lápis) na linha. A janela abre permitindo alterar valor e/ou vencimento. A edição só funciona nas integrações Itaú, Banco Inter, Sicoob e Cielo — nas demais o sistema responde "Integração não tem recurso de atualização".

Três recusas são comuns nessa janela:

AvisoPor quê
"Boleto está pago ou cancelado e não pode ser alterado"O boleto está em Pago ou Cancelado. Nesses dois status o sistema recusa a alteração mesmo que o ícone tenha aberto a janela.
"Precisar informar novo valor e/ou data"Você confirmou sem mudar nada. No Itaú vale a mesma coisa repetir o valor ou a data que já estavam lá: valor e data iguais aos atuais são descartados e a janela se comporta como se nada tivesse sido informado.
"Integração não tem recurso de atualização"O boleto foi gerado por PagarMe ou MercadoPago, que não aceitam alteração.

Quando a alteração é aceita, o banco é atualizado primeiro e o idworks grava o novo valor/vencimento em seguida. No Itaú, no Banco Inter e no Sicoob, a página do boleto também é gerada de novo, para o cliente receber o documento já com os dados corrigidos.

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 Cancelar Boleto (círculo com X) 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 CancelarDar Baixa e Cancelar
Quando usarCliente 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 fazCancela 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óriosNenhum — confirmação direta.Data pagamento e Valor pago.
Efeito no boletoStatus 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 Atualizar (setas circulares) 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.

Boleto ou link Cielo pago parcelado. Quando a integração Cielo está configurada para lançar o pagamento parcelado e o cliente paga em várias parcelas o boleto/link de um pedido, a atualização troca os recebimentos daquele pagamento em Financeiro → Contas a Receber pelas parcelas do pagamento. As parcelas novas mantêm a competência, a data do documento, o número do documento e a empresa emissora do recebimento original. Se algum recebimento do pedido ficar sem competência e o pedido já tiver a nota fiscal emitida, ele recebe a data de emissão da nota como competência e data do documento, e o número da nota como número do documento.

O sistema atualiza o status do boleto sozinho?​

Sim, dentro de um alcance limitado. De tempos em tempos o idworks percorre sozinho os boletos que ainda não foram pagos e pergunta ao banco se houve pagamento. Quando o banco confirma, o status vira Pago e o recebimento correspondente é baixado — sem ninguém clicar em nada. Se a data do recebimento cair em período financeiro fechado, o status vira Pago, mas a baixa não é lançada e aparece um alerta na Home — veja O que significa cada Status do boleto?.

O que entra e o que fica de fora dessa varredura automática:

EntraFica de fora
StatusAg. Pagamento e PendentePago, Cancelado, Baixa manual e Protesto
Vencimentode 10 dias antes até 10 dias depois da data de hojevencimentos mais antigos ou mais distantes do que isso

Ou seja: um boleto vencido há mais de dez dias deixa de ser consultado sozinho. Para esses, use o ícone Atualizar da linha ou Mais Ações → Atualizar boletos em massa — a consulta manual não tem limite de data e vale para qualquer boleto que não esteja pago.

Como copiar a URL do boleto para enviar ao cliente?​

Clique no ícone Copiar URL Boleto (duas folhas) 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:

  1. Clique no ícone Visualizar (olho) na linha de ações.
  2. 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 a página gerada. Na maioria das vezes é o curto intervalo entre criar o boleto e o banco devolver o arquivo — mas se o banco não devolver, o boleto fica indefinidamente sem a página. Nesse caso, use Editar Boleto e confirme uma alteração de valor ou vencimento: nas integrações Itaú, Banco Inter e Sicoob isso manda gerar o documento outra vez. Enquanto isso, a cobrança continua válida pelo código de barras.

Como copiar o código de barras?​

Dentro da janela Visualizar, clique no botão 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) abre uma janela; ao clicar em Processar, o sistema faz uma chamada ao banco para cada um dos boletos selecionados e atualiza o status — a janela mostra só a barra de progresso e o contador de boletos processados sobre o total, sem resultado por boleto. Ao Fechar a janela, a lista é recarregada com os status novos.

Ú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.

A largura das colunas do resultado de Gerar boletos em massa fica salva?​

Fica. Em Mais Ações → Gerar boletos em massa, depois de importar a planilha e processar, a janela mostra uma tabela de resultado com Status, Mensagem e URL de cada linha (é a mesma tabela de onde sai o Exportar Resultado). Nessa tabela você pode arrastar a divisória entre os títulos das colunas para alargar ou estreitar uma coluna — por exemplo, abrir a coluna Mensagem para ler o motivo de uma linha que deu erro sem precisar exportar.

Esse ajuste agora é guardado na sua conta de usuário, e não só no navegador em que você mexeu. Da próxima vez que abrir essa janela, as colunas voltam com a largura que você deixou — inclusive se você entrar de outro computador ou de outro navegador.

A largura é por usuário: cada pessoa da equipe guarda a sua, e mexer na sua não muda a de ninguém.

Nessa janela não existe o botão de configuração de colunas. O que fica guardado é a largura que você arrastou — quais colunas aparecem é sempre igual.

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).

Mesmo quando o ícone está ativo, a alteração pode ser recusada na hora de salvar: boletos em Pago ou Cancelado são sempre barrados, e integrações sem recurso de alteração (PagarMe e MercadoPago) também.

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 ao emitir a nota fiscal do pedido?​

Essa configuração não fica em Parametrizações: ela é uma chave do Tipo Pedido. Acesse Financeiro → Tipo Pedido, abra o tipo usado pelos pedidos que devem cobrar por boleto, ative a chave Gerar boleto (Gerar boleto a partir da emissão da nota fiscal) e salve.

A partir daí, ao emitir a nota fiscal de um pedido desse tipo, o boleto sai sozinho — sem precisar abrir esta tela. Vale saber como o sistema decide o que gerar:

  1. É gerado um boleto para cada recebimento em aberto do pedido — pedido parcelado em três vezes sai com três boletos, cada um com o seu valor e o seu vencimento.
  2. Só entram os recebimentos cuja forma de pagamento tem integração bancária vinculada; os demais são ignorados.
  3. Recebimentos que já têm boleto gerado são pulados.
  4. Quando não sobra nada a gerar, o sistema avisa que os recebimentos do pedido já têm boleto ou não têm integração de boleto/link.

Cada parcela é um registro pedido ao banco, um de cada vez. Em pedidos com muitas parcelas, dê alguns instantes e atualize a lista em vez de mandar gerar de novo.

Enquanto a geração de boletos de um pedido está em andamento, uma nova tentativa de gerar boleto para o mesmo pedido — um segundo clique, ou a geração manual disparada enquanto a automática da nota ainda roda — é recusada com "Processo já está rodando, aguardar!". O mesmo vale para a geração dos boletos de uma ordem de serviço. A trava se desfaz sozinha quando a primeira geração termina (com sucesso ou com erro) e, em último caso, depois de alguns minutos. Boleto avulso, sem pedido nem OS, não passa por essa trava.

A trava evita apenas gerações simultâneas. Uma nova geração depois que a primeira terminou é processada normalmente — confira a lista antes de gerar outra vez.

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 que emite o boleto — seja ela PagarMe, MercadoPago, Banco Inter, Itaú, Sicoob ou Cielo: acesse Configurações → Parametrizações → Configurações Gerais da integração, marque Enviar boleto WhatsApp e salve. Como a parametrização é lida na integração que gerou o boleto, ela vale por integração: se a loja cobra por mais de um banco, marque em cada uma que deve enviar.

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.

A mensagem enviada também passa a constar na conversa de WhatsApp daquele cliente, junto com o restante do histórico de atendimento — assim quem for atender depois vê que o boleto já foi mandado, sem precisar procurar no pedido.

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 que emite o boleto — seja ela PagarMe, MercadoPago, Banco Inter, Itaú, Sicoob ou Cielo: 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 boleto junto com o link da ficha do pedido — usando o e-mail cadastrado no cliente.

Os boletos gerados de uma vez para o mesmo pedido ou a mesma OS — por exemplo, todas as parcelas de um pedido parcelado — saem num único e-mail, e não um e-mail por boleto. O e-mail diz "Boleto(s) gerado(s) com sucesso." e lista cada boleto numa linha, com vencimento, valor e o link: "Vencimento dd/mm/aaaa - R$ valor: Clique aqui para visualizar o boleto". Boletos gerados em momentos diferentes (um agora, outro mais tarde) continuam indo em e-mails separados. O conteúdo muda conforme a origem:

  • Boleto vinculado a um pedido de venda — o e-mail traz o assunto "<Loja> - Pedido Nº <número do pedido>", a lista de boletos e, abaixo dela, o link da ficha do pedido.
  • 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>", a lista de boletos 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 — um registro por e-mail enviado. Se quiser reenviar manualmente, use a ação Copiar URL Boleto na linha.

O agrupamento vale só para o e-mail. O envio por WhatsApp continua saindo uma mensagem por boleto.

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, Sicoob 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çãoSubmenuO que muda quando ativada
Gerar boleto após emissão NFFiscal ServiçoAo 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 packingLogística (WMS) → PackingAo 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 WhatsAppConfigurações Gerais (no cadastro da integração que emite o boleto)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 emailConfigurações Gerais (no cadastro da integração que emite o boleto)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). Os boletos gerados de uma vez para o mesmo pedido ou OS vão num único e-mail. O envio fica registrado no histórico de eventos do pedido/OS.

A geração automática do boleto do pedido de venda não está em Parametrizações: é a chave Gerar boleto do cadastro do Tipo Pedido (Financeiro → Tipo Pedido). Veja Como gerar boleto automaticamente ao emitir a nota fiscal do pedido?.

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égioLibera
Visualizar geração boleto bancárioAcesso à tela e à lista.
Criar boleto bancárioBotã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.
Última atualização em