Emitir boletos e acompanhar remessa e retorno CNAB

Relacione parcelas a receber a boletos, ordens de cobrança e ocorrências de retorno bancário. Cada banco e convênio exige o leiaute correspondente configurado.

Cobrança: boleto, CNAB e PIX

As etapas deste processo, na ordem em que acontecem: 12 no total, 7 com vídeo curto e legendas. As que ainda não funcionam na 16.0 levam ao motivo e à alternativa.

  1. Conferir parcelas e vencimentos da fatura (vídeo de 2 min)

  2. Configurar a carteira de cobrança do banco (vídeo de 2 min)

  3. Gerar o boleto da fatura (disponível em parte, vídeo de 1 min)

  4. Gerar a remessa CNAB de cobrança (vídeo de 1 min)

  5. Importar o retorno CNAB e baixar as parcelas (vídeo de 2 min)

  6. Enviar instruções de cobrança ao banco (vídeo de 2 min)

  7. Cobrar por PIX e baixar o recebimento (não disponível na 16.0)

  8. Descobrir os boletos emitidos contra o CNPJ por DDA (não disponível na 16.0)

  9. Importar o extrato bancário por Open Finance (não disponível na 16.0)

  10. Pagar por API com confirmação por webhook (não disponível na 16.0)

  11. Conciliar o pagamento efetivo da nota por evento ECONF (não disponível na 16.0)

  12. Configurar os provedores de pagamento Pix, Cielo e PagSeguro (prévia: em revisão na oca, vídeo de 2 min)

Antes de começar

Tenha a cobrança configurada e homologada com o banco: conta bancária, convênio, carteira, numeração, leiaute CNAB e modo de pagamento. Confira razão social, CPF/CNPJ e endereços do sacado e cedente. O fluxo de cobrança da demo ainda exige ensaio completo dos arquivos bancários.

Passo a passo

1. Confira o boleto

Na fatura lançada ou em sua parcela, confira modo de pagamento de cobrança, vencimento, valor e Nosso Número. Use Imprimir boleto quando disponível. Revise cedente, sacado, banco, código de barras ou linha digitável, valor e vencimento antes de disponibilizar ao cliente.

2. Gere e acompanhe a remessa

Abra Ordens de Cobrança, escolha o modo de pagamento do banco e inclua as parcelas abertas desejadas. Revise total, datas e duplicidades. Confirme e gere a remessa pelas ações da ordem. Registre separadamente a entrega ao banco; baixar um arquivo não o envia ao banco.

3. Processe o retorno e as exceções

Importe o retorno do banco pela ação de retorno CNAB configurada. Revise o Log de Retorno CNAB e relacione cada ocorrência à sua parcela. Diferencie registro, rejeição, liquidação e demais eventos. Confira valores, encargos e saldos residuais antes de aceitar as atualizações financeiras resultantes.

Resultado esperado

Cada cobrança pode ser acompanhada desde a parcela e o boleto até a remessa, o retorno do banco e a liquidação.

Se algo der errado

Nos títulos rejeitados, preserve o código da ocorrência e confira leiaute e dados cadastrais. Em Nosso Número desconhecido ou retorno duplicado, investigue a ordem existente antes de reimportar. PDF de boleto ou geração de remessa não comprovam registro nem pagamento.

Ainda não disponível na 16.0

O que este assunto ainda não cobre na versão 16.0 da localização brasileira, com a alternativa possível. Precisa de alguma destas funções? Fale com a KMEE.

Cobrar por PIX e baixar o recebimento

Não disponível na 16.0. Cenário FIN-07.

A cobrança Pix a partir da parcela da fatura, com vencimento (cobv), não existe. O PR aberto OCA/l10n-brazil#4799 (módulo payment_bacen_pix, ainda fora da 16.0 oficial) traz um provedor de pagamento Pix pela API do Banco Central, mas só para cobrança imediata (cob) paga pelo cliente no portal, com QR code e confirmação por webhook ou consulta periódica (Banco do Brasil e Banco Inter). Esse fluxo precisa do ambiente de testes do banco e de credencial real, então não é filmado aqui; só a configuração do provedor é filmada, no cenário Configurar os provedores de pagamento Pix, Cielo e PagSeguro. Sem cobv, sem juros e multa, sem baixa a partir da parcela em l10n_br_account_payment_order. A cobrança com vencimento (cobv), o Pix Automático e o webhook ficam para um PR separado.

O que existe hoje na 16.0: a chave PIX no cadastro do contato (usada no pagamento a fornecedor por PIX, Pagar fornecedor por ordem de pagamento CNAB) e a forma de pagamento PIX QR-CODE no pagamento de boletos por CNAB 240 (Pagar fornecedor por ordem de pagamento CNAB e Pagar guia de tributo com código de barras). Na 16.0 oficial não há emissão de cobrança PIX (cob ou cobv), QR code na fatura, webhook de recebimento nem baixa automática por PIX; a cobrança imediata pelo portal está no PR aberto 4799 (configuração em Configurar os provedores de pagamento Pix, Cielo e PagSeguro).

Descobrir os boletos emitidos contra o CNPJ por DDA

Não disponível na 16.0. Cenário FIN-13.

Na 16.0 instalada só existem os códigos de retorno de DDA no CNAB do Santander (l10n-brazil/l10n_br_account_payment_order/data/cnab_codes/banco_santander_cnab_240_400.xml); não há importação, consulta nem lançamento de contas a pagar a partir de DDA. Não há PR nem plano para o caso.

Cenário não documentado. O fornecedor descreve o fluxo manual (envio de arquivo) e o automático por VAN, com detecção de pagamento em duplicidade, mas isso é conteúdo de fornecedor, não norma.

Importar o extrato bancário por Open Finance

Não disponível na 16.0. Cenário FIN-14.

Na 16.0 instalada só há importação de OFX (kmee-odoo-addons/account_statement_import_ofx_invert_type, sobre account_statement_import_ofx da OCA). A KMEE prevê OFX e Open Finance como ingestão futura (conciliação bancária automática via OCA account_statement_import), sem PR nem módulo.

Cenário não documentado. Os limites do fornecedor (consentimento no aplicativo do banco, até 100 mil movimentos, 3 consultas por minuto, cache de 1 hora, contratação separada) são de conteúdo de fornecedor e não de norma. A conciliação por OFX está no Conciliar o extrato bancário com a parcela paga.

Pagar por API com confirmação por webhook

Não disponível na 16.0. Cenário FIN-15.

Na 16.0 só há ordem de pagamento por CNAB (l10n-brazil/l10n_br_account_payment_order). Não há módulo de API de pagamento, webhook nem PR; o escopo vem de um blog de fornecedor.

Cenário não documentado e com escopo a validar antes de planejar: o artigo do fornecedor não detalha alçadas de aprovação nem Pix.

Conciliar o pagamento efetivo da nota por evento ECONF

Não disponível na 16.0. Cenário FIN-16.

A busca por ECONF e por evento de conciliação financeira no código instalado não devolve resultado (só aparecem ocorrências de nomes não relacionados em l10n_br_nfe e l10n_br_mdfe), e só existe a lacuna do split payment (issue #5146), que é outro evento.

Cenário não documentado. A obrigação e o prazo vêm só de conteúdo de fornecedor; a norma deve ser conferida no Portal Nacional da NF-e antes de virar requisito. A conciliação do extrato com o pagamento está no Conciliar o extrato bancário com a parcela paga.

Veja na prática, com vídeo

Cenários da localização brasileira ligados a este guia, do começo ao fim, com exemplo calculado, passo a passo e vídeo curto com legendas.

Continue o processo