Gerar o boleto da fatura

  • Cenário FIN-03

  • Disponível em parte

  • Perfil: Financeiro

  • Mais tarefas do perfil: Financeiro

  • Odoo 16.0

Etapa 3 de 12 do processo Cobrança: boleto, CNAB e PIX. Anterior: Configurar a carteira de cobrança do banco. Próxima: Gerar a remessa CNAB de cobrança.

Ao lançar uma fatura com modo de pagamento de cobrança, o Odoo numera cada parcela (nosso número), cria as linhas na ordem de pagamento e permite imprimir o boleto pelo botão Print Boleto, gerado pelo serviço BRCobranca.

Visão geral: Emitir boletos e acompanhar remessa e retorno CNAB

Limites deste cenário

Só a geração do boleto é demonstrada. O envio do boleto por e-mail ao cliente (botão Enviar & Imprimir) não funciona no ambiente de captura: faltam o servidor de e-mail de saída e o wkhtmltopdf, e o Odoo recusa gerar o PDF da fatura. O serviço BRCobranca da imagem usada não implementa todos os bancos: Itaú 240 e Ailos 240 não geram boleto, e o boleto do Unicred 400 falha nessa imagem. O boleto não é registrado automaticamente no banco: o registro vem da remessa (Gerar a remessa CNAB de cobrança).

Importante

O boleto é gerado pelo serviço BRCobranca; o envio por e-mail não é mostrado.

Vídeo

Duração: 1 min 12 s. Sem áudio: a narração está nas legendas, na faixa de baixo do vídeo.

Antes de começar

  • Carteira de cobrança configurada e ligada ao modo de pagamento (Configurar a carteira de cobrança do banco).

  • Serviço BRCobranca em execução e endereço informado em brcobranca_api_url.

  • Fatura de cliente em rascunho com o modo de pagamento Cobrança Banco Nordeste 400.

Exemplo usado neste cenário

A Sua Empresa (São Paulo) lança uma fatura de R$ 1.000,00 em 15/10/2026 para Serviços Exemplo SP Ltda, com 30% adiantado e saldo no fim do mês seguinte, pelo modo Cobrança Banco Nordeste 400. Saem dois boletos: 300,00 e 700,00.

Como os valores são calculados:

  • Parcela 1: 30% de 1.000,00 = 300,00, vencimento 15/10/2026 (data da fatura).

  • Parcela 2: 1.000,00 - 300,00 = 700,00, vencimento 30/11/2026 (fim do mês seguinte).

  • Cada parcela vira um boleto com o valor da parcela e um nosso número próprio, tirado da sequência da configuração CNAB.

Passo a passo

  1. Abra o aplicativo Faturamento pelo menu de aplicativos.

  2. Abra o menu Clientes e clique em Faturas.

  3. Abra a fatura Teste Nordeste CNAB400, que está em rascunho.

  4. No campo Data da Fatura, informe 15/10/2026.

  5. Confira o Modo de Pagamento: Cobrança Banco Nordeste 400.

  6. Clique em Confirmar: as duas parcelas viram linhas de pagamento na ordem de pagamento.

  7. Clique em Print Boleto: o PDF do boleto é gerado e o navegador o abre em outra aba, fora deste vídeo.

Resultado esperado

Fatura lançada, com duas linhas de pagamento (300,00 e 700,00) em uma ordem de pagamento em rascunho e o boleto em PDF gerado e anexado à fatura. A remessa ao banco é o cenário Gerar a remessa CNAB de cobrança.

Se houver erro

  • Aparece BRCobranca API URL is not configured. O endereço do serviço BRCobranca não foi informado. Informe brcobranca_api_url nos Parâmetros do Sistema ou na variável BRCOBRANCA_API_URL.

  • O botão Print Boleto não aparece. A fatura não está lançada ou o modo de pagamento não tem Configuração CNAB. Lance a fatura e confira o modo de pagamento (Configurar a carteira de cobrança do banco).

Módulos: l10n_br_account_payment_order, l10n_br_account_payment_brcobranca. Os valores do exemplo foram conferidos automaticamente na execução gravada; a conferência não substitui a validação do contador da sua empresa.