Enviou um arquivo CNAB para o banco e recebeu uma rejeição em lote? Esses erros têm padrão — a maioria cai em uma das categorias abaixo. Veja como identificar e corrigir os problemas mais comuns antes de reenviar.
Por que arquivos CNAB são rejeitados
Os bancos processam os arquivos CNAB por validação linha a linha. Se qualquer campo obrigatório estiver errado, o lote inteiro pode ser rejeitado. Os motivos mais frequentes:
- Data inválida (feriado, fim de semana sem flag)
- Contador de registros divergente no trailer
- Valor com formatação errada (zeros insuficientes)
- Código do banco incorreto no header
- Número de sequência fora de ordem
- Segmento obrigatório ausente (CNAB 240)
- CPF/CNPJ do favorecido com dígito verificador inválido
- Agência ou conta com dígito verificador errado
Erro 1: Data de pagamento inválida
Sintoma: banco rejeita o lote com código de erro relacionado a data.
Causa: a data cai em feriado nacional ou fim de semana e o campo "indicador de forma de pagamento" não está marcado para próximo dia útil.
Correção: no campo de data de pagamento, use o próximo dia útil, ou ative o flag de "próximo dia útil" se o banco suportar.
Valide seu arquivo com o Formatador e Validador CNAB do Toolspace que sinaliza datas problemáticas.
Erro 2: Contador de registros divergente
Sintoma: trailer de arquivo ou de lote declara quantidade diferente do que existe.
Causa: o sistema gerou o arquivo mas não atualizou os campos de total de registros e total de lotes.
Correção: reconte os registros do arquivo e atualize:
TOTAL_DE_REGISTROS_NO_ARQUIVOno trailer de arquivo (tipo 9)TOTAL_DE_REGISTROS_NO_LOTEno trailer de lote (tipo 5)
Erro 3: Valor com formatação incorreta
Sintoma: banco interpreta valor errado ou rejeita o campo numérico.
Causa: o CNAB exige campos numéricos com padding de zeros à esquerda (ex.: valor R$ 100,00 = 0000010000 em campo de 10 dígitos). Sem o padding, o banco lê um valor diferente.
Correção: aplique zfill ou lpad no campo de valor antes de gerar o arquivo.
Erro 4: Código do banco incorreto
Sintoma: banco rejeita o arquivo imediatamente no header.
Causa: o campo CODIGO_DO_BANCO no header está com código de outro banco ou com zeros.
Correção: use o código correto de 3 dígitos:
- Itaú:
341· Bradesco:237· BB:001· Caixa:104· Santander:033
Erro 5: Sequência de registros fora de ordem
Sintoma: banco acusa "registro fora de sequência" ou "número de sequência duplicado".
Causa: o campo NUMERO_DO_REGISTRO (sequencial de 1 a N) não está em ordem crescente contínua.
Correção: garanta que cada linha do arquivo tenha o campo de sequência incrementado de 1 em 1, sem lacunas ou repetições.
Erro 6 (CNAB 240): Segmento obrigatório ausente
Sintoma: lote rejeitado com erro de segmento.
Causa: o tipo de pagamento exige segmento B (PIX, endereço do favorecido) mas o arquivo só tem segmento A.
Correção: adicione o segmento B após cada segmento A que exigir informação complementar. Consulte o manual do banco para saber quais segmentos são obrigatórios por tipo de pagamento.
Como validar antes de enviar
Em vez de descobrir erros por rejeição bancária, valide o arquivo antes:
- Abra o Formatador CNAB do Toolspace.
- Cole ou faça upload do arquivo CNAB 240 ou 400.
- O validador aponta campos inválidos, contadores divergentes e sequências erradas.
- Corrija os problemas apontados e reenvie.
Perguntas frequentes
O banco retorna código de erro no arquivo de retorno? Sim. O retorno CNAB inclui o campo OCORRENCIA ou CODIGO_DO_ERRO por registro, indicando o motivo da rejeição. Consulte o manual do banco para a tabela de códigos.
Toda rejeição é do arquivo ou pode ser do boleto? Ambos. A rejeição pode ser do formato do arquivo (estrutura) ou dos dados do boleto/pagamento (conta inexistente, CPF inválido, etc.).
Como testar sem enviar ao banco? Muitos bancos oferecem ambiente de homologação (sandbox). Use o validador do Toolspace para uma verificação prévia antes mesmo de acessar o sandbox.
Posso reenviar o mesmo arquivo corrigido? Sim, desde que o número de sequência do arquivo (NUMERO_DO_ARQUIVO_REMESSA) seja incrementado. Alguns bancos rejeitam número de arquivo repetido.
Conclusão
A maioria das rejeições de arquivo CNAB é corrigível em minutos quando você sabe o que procurar. Use o Formatador CNAB do Toolspace para validar o arquivo antes de enviar ao banco e evite ciclos desnecessários de rejeição.