O arquivo de retorno CNAB é como o banco "responde" para a sua empresa: confirma quais boletos foram pagos, quais foram baixados por inadimplência, quais foram rejeitados e por quê. Validar esse arquivo antes de processar no ERP garante que sua conciliação financeira não fique furada. Neste guia você aprende a usar o Validador CNAB Avançado do Toolspace para verificar arquivos de retorno em segundos.
O que é o arquivo de retorno
Quando sua empresa envia uma remessa com boletos para o banco, ele processa cada cobrança. À medida que clientes pagam, o banco gera um arquivo retorno (.ret) que sua empresa baixa diariamente para reconciliar contas a receber.
Cada linha de detalhe no retorno informa:
- Nosso número (identificador do título no banco).
- Seu número (identificador interno do ERP).
- Código de ocorrência (foi pago, foi baixado, foi rejeitado, etc.).
- Data da ocorrência.
- Valor pago (pode ter desconto, juros, multa).
- Data do crédito (quando o dinheiro entra na conta).
- Tarifas cobradas pelo banco.
Por que validar antes de processar
Sem validação, dois cenários comuns dão dor de cabeça:
- Arquivo corrompido no FTP/banco: linhas truncadas ou caracteres bagunçados — seu ERP processa errado e a conciliação fica desbalanceada.
- Codes de ocorrência desconhecidos: cada banco usa códigos próprios em campos opcionais. Se o seu ERP não reconhece, fica como "movimento desconhecido" e ninguém sabe se foi pago.
Validar o arquivo antes de importar evita ter que estornar lançamentos.
Como validar com o Toolspace
- Abra o Validador CNAB Avançado.
- Suba o arquivo de retorno (.ret ou .txt).
- Selecione o layout: CNAB 240 ou CNAB 400 (retorno).
- Clique em Validar.
- O painel mostra:
- Quantidade total de registros e por tipo (header, detalhe, trailer).
- Códigos de ocorrência encontrados, com a descrição padrão.
- Linhas com problemas estruturais (tamanho errado, posições suspeitas).
- Resumo de valores liquidados, tarifas e baixas.
Tudo localmente, sem upload.
Códigos de ocorrência mais críticos
No retorno cobrança CNAB 400, alguns códigos pedem atenção:
- 02 — Confirmação de entrada (boleto registrado com sucesso).
- 03 — Entrada rejeitada (boleto não foi registrado — vale conferir motivo).
- 06 — Liquidação normal (foi pago).
- 09 — Baixa por liquidação (foi pago e baixado).
- 15 — Liquidação em cartório (foi protestado e pago).
- 17 — Liquidação após baixa (foi pago após baixa manual).
No CNAB 240, os códigos mudam por banco — cada um tem seu manual. O Validador exibe a descrição padrão Febraban e marca os códigos personalizados como "verificar manual do banco".
Checagens estruturais que o Validador faz
- Header presente com banco e data de geração.
- Trailer presente com contador de registros batendo.
- Linhas com tamanho exato (240 ou 400).
- Sequência consistente (header → detalhes → trailer).
- Datas em formato válido (DDMMAAAA ou AAAAMMDD).
- Valores numéricos sem caracteres não esperados.
- CPF/CNPJ válidos quando presentes em posições conhecidas.
Para CNAB 240 com lotes, ele também valida hierarquia (header de lote → detalhes do lote → trailer do lote → próximo lote).
Erros mais comuns em retorno
Arquivo truncado
Servidores FTP às vezes interrompem download. O sintoma: trailer ausente ou linha final cortada. O Validador detecta porque o último registro tipo deve ser sempre header ou trailer.
Linhas com caracteres não-ASCII
Acentos em retornos antigos viram bagunça. O Validador aponta posições onde aparecem caracteres ASCII estendidos.
Datas inconsistentes
Algumas posições do detalhe carregam data de vencimento, data de pagamento, data de crédito. Se houver caractere fora do formato DDMMAAAA (ou AAAAMMDD no 240), o Validador alerta.
Valores com sinal de negativo
Em CNAB padrão Febraban, não há sinal — todos os valores são positivos com 2 casas decimais implícitas. Se aparece "-", é erro do gerador do arquivo.
Códigos de ocorrência não previstos
Cada banco pode incluir códigos privados. O Validador lista todos os códigos vistos e separa os reconhecidos dos desconhecidos.
Fluxo recomendado de processamento
- Receba o retorno do banco (FTP automático ou download manual).
- Valide com o Toolspace antes de importar no ERP.
- Se passou na validação, importe no ERP.
- Concilie contas a receber.
- Arquive o retorno (com sufixo de data) por pelo menos 5 anos.
Perguntas frequentes
Posso processar o retorno direto sem validar? Pode, mas você assume risco de importar dados corrompidos. Validar leva 5 segundos e evita meses de retrabalho contábil.
O Validador concilia automaticamente? Não. Ele apenas valida estrutura e identifica códigos de ocorrência. A conciliação real (matchear retorno com contas a receber) é feita pelo ERP.
Funciona com retornos de pagamento (não cobrança)? Sim. CNAB 240 cobre pagamento de fornecedor, salário e tributo — o Validador identifica os tipos de operação corretamente.
Banco mudou o código de ocorrência e meu ERP não reconhece. O Validador resolve? Não diretamente — ele indica que o código é desconhecido. Você precisa consultar o manual atualizado do banco e ajustar o ERP.
Conclusão
Validar o arquivo de retorno CNAB antes de processar no ERP economiza horas de retrabalho contábil. Use o Validador CNAB Avançado para conferir estrutura, códigos de ocorrência e valores em segundos — tudo localmente, sem comprometer dados sensíveis.