Retorno CNAB BO03¶
Importar o arquivo de retorno do banco e atualizar os boletos automaticamente: confirmar registros, liquidar pagamentos, registrar baixas e capturar erros. É o passo que fecha o ciclo iniciado na Remessa CNAB.
Pré-requisitos¶
- Cedente cadastrado (veja Cedentes)
- Arquivo de retorno baixado do banco (
.RET,.TXT,.REMou.CRM) - Boleto Service rodando
De onde vem o arquivo
O banco gera o arquivo de retorno diariamente (em alguns casos várias vezes ao dia). Você baixa no canal de Cobrança do Internet Banking ou no gerenciador financeiro do banco.
Passo a passo¶
1. Acessar a tela¶
No menu lateral, clique em Financeiro → Boletos → Retorno CNAB.
2. Selecionar Empresa e Cedente¶
Os dois campos são obrigatórios. O Cedente determina o banco — o sistema usa o layout correto (CNAB 240 ou 400) com base no cadastro.
3. Selecionar o arquivo¶
Há duas formas:
- Arrastar o arquivo do explorador para a área tracejada.
- Clicar na área e selecionar pelo dialog.
Formatos aceitos: .ret, .txt, .rem, .crm.
Após selecionar, a área fica verde e mostra o nome do arquivo e o tamanho.
4. Processar¶
Clique em Processar Retorno. O serviço:
- Lê o arquivo conforme o layout do banco.
- Para cada registro, identifica o boleto pelo nosso número.
- Aplica o movimento (registro confirmado, liquidação, baixa, erro etc.).
- Atualiza a situação do boleto e, quando aplicável, dá baixa nas duplicatas do financeiro.
5. Cards de resumo¶
Após processar, três cards aparecem:
| Card | Significado |
|---|---|
| Liquidados | Boletos que foram pagos — duplicatas baixadas no financeiro. |
| Baixados | Boletos baixados sem pagamento (cancelamento, devolução, prazo expirado). |
| Erros | Registros que o banco rejeitou ou que não puderam ser processados — exigem análise. |
Conferência rápida
O total Liquidados do dia deve bater com o extrato bancário. Se houver divergência, abra os registros (passo 6) para identificar quais boletos estão envolvidos.
6. Detalhamento do retorno¶
Tabela com cada movimento do arquivo:
| Coluna | Descrição |
|---|---|
| Nosso Nº | Identificador do boleto. |
| Sacado | Quem deveria pagar. |
| Vencimento | Data prevista. |
| Valor | Valor do título no arquivo. |
| Tipo Movimento | Código/descrição do movimento (ex.: liquidação, baixa, registro confirmado, instrução acatada). |
| Detalhe | Observação adicional ou motivo do erro. |
A paginação carrega 25 registros por vez — clique em Carregar mais para o restante.
7. Tratar erros¶
Erros mais comuns devolvidos pelo banco:
| Tipo | O que fazer |
|---|---|
| Nosso número não cadastrado | Boleto não estava registrado — confira se a remessa foi processada pelo banco. |
| Boleto já baixado | Tentativa de baixar um boleto já fechado — ignorável. |
| Convênio/carteira inválido | Revise o cadastro do cedente. |
| CEP/endereço inválido | Sacado precisa ser corrigido — emita novamente. |
Processar o mesmo arquivo duas vezes
O sistema identifica o nosso número e o tipo de movimento. Em geral é seguro reprocessar, mas pode gerar "Erros" do tipo "boleto já liquidado". O ideal é processar um arquivo por dia e arquivar.
Erros comuns¶
Botão Processar Retorno desabilitado
Verifique se selecionou Empresa, Cedente E arquivo. Os três são obrigatórios.
\"Formato de arquivo não reconhecido\"
O Tipo CNAB do cedente (240 ou 400) não bate com o do arquivo. Confirme com o banco e ajuste em Cedentes.
Liquidações não aparecem no dashboard
Confirme que o Retorno CNAB foi processado e que os registros do tipo liquidação estão marcados como sucesso. Veja o Dashboard de boletos após o processamento.
Arquivo muito grande / processamento lento
Bancos com muitos movimentos podem demorar. Aguarde — não atualize a página durante o processamento.