O arquivo de retorno CNAB 240 é o que o banco envia de volta depois que você processa uma remessa. É nele que você descobre se cada pagamento foi aceito, rejeitado ou está pendente. Este guia explica como ler o retorno e o que significam os campos mais importantes.
O que é o arquivo de retorno CNAB 240
Depois que você envia um arquivo de remessa ao banco, o banco processa cada instrução e gera um arquivo de retorno com o resultado. O retorno tem a mesma estrutura do arquivo de remessa — Header de arquivo, Header de lote, Registros de detalhe, Trailer de lote, Trailer de arquivo — mas com campos de resultado preenchidos.
Remessa → você envia ao banco
Retorno → banco devolve com resultados
Estrutura do retorno CNAB 240
Header de arquivo (tipo 0)
Header de lote (tipo 1)
Segmento A (tipo 3) — dados do pagamento
Segmento B (tipo 3) — dados complementares (se houver)
Segmento Z (tipo 3) — resultado do processamento ← campo chave
Trailer de lote (tipo 5)
Trailer de arquivo (tipo 9)
O Segmento Z é exclusivo do retorno — ele contém o código de ocorrência (resultado) de cada instrução. Na remessa, o Segmento Z não existe.
Campo de ocorrência — onde está o resultado
No Segmento A do retorno, procure o campo Código de Ocorrência (geralmente posições 231–240 no padrão FEBRABAN, mas varia por banco):
| Código | Significado típico |
|---|---|
00 | Crédito ou débito efetuado (sucesso) |
01 | Insuficiência de fundos |
03 | Estabelecimento inativo |
06 | Data inválida |
09 | Agência/conta encerrada |
10 | Não existe conta |
12 | Erro nos dados do pagamento |
20 | Lote rejeitado |
45 | Inconsistência de dados |
Importante: os códigos de ocorrência variam por banco. Sempre consulte o manual técnico do banco para a tabela completa — o código 12 no Bradesco pode ter significado diferente no Itaú.
Campos mais importantes no Segmento A do retorno
| Campo | O que contém |
|---|---|
| Data de pagamento realizado | Data em que o crédito foi efetivado |
| Data real do crédito | Pode diferir da data solicitada (feriado, D+1) |
| Valor real do crédito | Valor creditado (pode diferir se houve estorno parcial) |
| Código de ocorrência | Resultado: 00 = sucesso, outros = erro |
| Número do documento da empresa | O mesmo que você enviou na remessa — use para conciliar |
Como conciliar retorno com a remessa
O campo Número do documento da empresa (ou Número do seu número) é a chave de conciliação. Você define esse número na remessa e ele volta no retorno inalterado — use-o para associar cada linha do retorno ao pagamento correspondente no seu sistema.
Remessa: pagamento ID 4521 → campo "seu número" = "00004521"
Retorno: "seu número" = "00004521", código = "00" → pagamento 4521 confirmado
Segmento Z — informações complementares do resultado
O Segmento Z, quando presente, traz informações adicionais sobre a ocorrência — motivo detalhado da rejeição, dados do beneficiário conforme o banco registrou, ou informações de tarifa cobrada. Nem todos os bancos incluem o Segmento Z em todos os retornos.
Processar o retorno automaticamente
Para automatizar a leitura do retorno:
- Leia linha por linha.
- Identifique o tipo de registro pelo caractere na posição 8 (
0= header,1= header lote,3= detalhe,5= trailer lote,9= trailer arquivo). - Para registros tipo
3, identifique o segmento pela posição 14 (A,B,J,Z...). - Extraia o código de ocorrência do Segmento A.
- Marque o pagamento como confirmado (código
00) ou com erro (qualquer outro).
Erros comuns ao processar retorno
Processar apenas Segmento A e ignorar Segmento Z: alguns erros só aparecem no Z.
Não verificar o total de registros no trailer: se o arquivo foi corrompido ou truncado, o trailer declara um número diferente do real.
Usar código de ocorrência genérico: o mesmo código pode ter significados diferentes em cada banco. Construa uma tabela por banco, não uma tabela única.
Validar o arquivo de retorno
Use o Formatador CNAB do Toolspace para verificar a integridade do arquivo de retorno: contadores do trailer, sequência de registros e estrutura de lotes.
Perguntas frequentes
Com que frequência o banco gera o arquivo de retorno? Geralmente uma vez ao dia (D+1 para a maioria dos bancos). Pagamentos enviados antes das 17h normalmente aparecem no retorno do dia seguinte.
Posso reenviar um pagamento que foi rejeitado? Sim. Corrija o dado incorreto (conta, CPF, valor) e inclua numa nova remessa com número de arquivo incrementado.
O Segmento Z é obrigatório? Não pelo padrão FEBRABAN, mas alguns bancos sempre o incluem. Processe-o se presente, mas não falhe se ausente.
Como saber se o arquivo de retorno veio completo? Verifique se o TOTAL_DE_REGISTROS_NO_ARQUIVO no trailer de arquivo (tipo 9) bate com a contagem real de linhas.
Conclusão
O arquivo de retorno CNAB 240 confirma o resultado de cada instrução enviada. O Segmento A traz o código de ocorrência, e o campo "seu número" é a chave de conciliação com seu sistema. Para validar a integridade do arquivo de retorno antes de processar, use o Formatador CNAB do Toolspace.