Importar o retorno CNAB e baixar as parcelas¶
Cenário FIN-05
Disponível
Perfil: Financeiro
Mais tarefas do perfil: Financeiro
Odoo 16.0
Etapa 5 de 12 do processo Cobrança: boleto, CNAB e PIX. Anterior: Gerar a remessa CNAB de cobrança. Próxima: Enviar instruções de cobrança ao banco.
O banco devolve um arquivo de retorno com as parcelas pagas. Ao importá-lo, o Odoo lança juros, multa, desconto e tarifa nas contas definidas na Configuração CNAB e concilia o valor com a parcela da fatura, que passa a Pago.
Visão geral: Emitir boletos e acompanhar remessa e retorno CNAB
Importante
O arquivo de retorno é montado pelo cenário: este ambiente não troca arquivos com o banco.
Vídeo¶
Antes de começar¶
Fatura lançada e remessa enviada ao banco (Gerar o boleto da fatura e Gerar a remessa CNAB de cobrança).
Contas contábeis de tarifa, juros e desconto na Configuração CNAB e diário com importação CNAB 400 (Configurar a carteira de cobrança do banco).
Serviço BRCobranca em execução, porque ele lê o arquivo de retorno.
Arquivo de retorno baixado do banco.
Exemplo usado neste cenário¶
A fatura Teste Nordeste CNAB400, de R$ 1.000,00 em duas parcelas, foi registrada no Banco do Nordeste. O banco devolve um retorno com a parcela 1 (300,00, vencida em 15/10/2026) paga em 20/10/2026 com juros e multa, e a parcela 2 (700,00, vencida em 30/11/2026) paga em 25/11/2026 com desconto de pontualidade. Cada pagamento tem a tarifa de cobrança de 2,50.
Como os valores são calculados:
Parcela 1, atraso de 5 dias (15/10 a 20/10): multa de 2% sobre 300,00 = 6,00.
Juros de mora de 1% ao mês, pro rata dia: 300,00 x 1% / 30 x 5 dias = 0,50. Juros e multa = 6,50.
Valor pago da parcela 1 = 300,00 + 6,50 = 306,50. O Odoo baixa o título pelo valor recebido menos os juros: 306,50 - 6,50 = 300,00.
Parcela 2, paga antes do vencimento: desconto de 1% sobre 700,00 = 7,00; valor pago = 693,00. O Odoo baixa o título por 693,00 + 7,00 = 700,00.
No arquivo de retorno, o código de ocorrência (posições 109 e 110) diz o que aconteceu com o título: 02 é entrada confirmada e 06 é liquidação. O cenário usa 06 nas duas parcelas. Confirme os códigos no manual CNAB 400 do banco, pois mudam de banco para banco.
Tarifa de cobrança: 2,50 por título, 5,00 no total, lançada como despesa bancária (não reduz o título).
Total recebido no arquivo = 306,50 + 693,00 = 999,50. Entrada líquida no banco = 999,50 - 5,00 = 994,50.
Passo a passo¶
Abra o aplicativo Faturamento pelo menu de aplicativos.
Abra o menu Financeiro e clique em Importar Arquivo de Lote.
No campo Parâmetro de configuração de importação, escolha o diário Banco Nordeste.
Em Arquivo Extrato, clique em Faça upload de seu arquivo e escolha o retorno do banco.
Clique em Arquivo Importação: o Odoo lê o retorno pelo serviço BRCobranca.
Confira os dois lançamentos de diário criados, um por parcela paga.
Abra Financeiro, Registro de Retorno de CNAB, e o registro do banco: veja os totais recebido, juros, desconto e tarifa.
Abra Clientes, Faturas: a fatura Teste Nordeste CNAB400 está com o status Pago.
Resultado esperado¶
Duas entradas de diário lançadas (uma por parcela), com juros de 6,50, desconto de 7,00 e tarifas de 5,00 nas contas configuradas, o registro de retorno com os totais do arquivo e a fatura paga, sem saldo em aberto.
Se houver erro¶
O arquivo é recusado com BOLETO NÃO ENCONTRADO no registro de retorno. O nosso número do arquivo não existe em nenhuma parcela do diário escolhido. Confira se o diário do campo Parâmetro de configuração é o do banco que gerou a remessa.
Aparece Nothing to import: the file is empty! O arquivo não tem nenhum registro de detalhe ou é de outro layout. Baixe o retorno CNAB 400 do banco de novo e confira a extensão do arquivo.
O diário não aparece na lista do campo de importação. O diário não está com o tipo de importação CNAB 400 ou CNAB 240. Abra o diário, aba Informações Referentes a Importação, e escolha o tipo CNAB.
Limites deste cenário¶
O arquivo de retorno do vídeo é montado pelo cenário, no layout CNAB 400 do Banco do Nordeste, com os valores do exemplo; no uso real ele vem do banco. Na biblioteca BRCobranca o layout do Banco do Nordeste não traz a data de crédito, e o Odoo usa a data de vencimento como data do lançamento (a data do pagamento fica só no registro de retorno). Atenção: lançar pela data de vencimento desalinha a conciliação bancária (Conciliar o extrato bancário com a parcela paga), porque a data do lançamento no diário não é a do crédito no extrato, e o fluxo de caixa (Projetar o fluxo de caixa pela lista de vencimentos), porque o realizado cai no mês do vencimento e não no do pagamento. O desconto concedido pelo banco depende da configuração de desconto da carteira. Liquidação a menor ou a maior e cancelamento de remessa não são tratados aqui.
Módulos: l10n_br_account_payment_order, l10n_br_account_payment_brcobranca, account_move_base_import. 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.