Trabalhar com cobrança bancária no Brasil eventualmente leva você ao CNAB — o padrão Febraban para troca de arquivos entre empresas e bancos. O CNAB 240 é o formato mais moderno e o preferido para integrações novas. Neste guia você entende a estrutura do CNAB 240, quando usar, em que ele difere do CNAB 400 e como formatar e validar arquivos com o Toolspace antes de enviar para o banco.
O que é o CNAB 240
CNAB significa Centro Nacional de Automação Bancária — é o conjunto de leiautes Febraban que define como bancos e empresas trocam dados. O CNAB 240 organiza informações em registros de 240 caracteres por linha.
A estrutura é hierárquica: cada arquivo pode ter vários lotes, e cada lote agrupa registros de detalhe (cobranças, pagamentos, retornos). Essa organização em lotes é o grande diferencial do 240 — permite enviar várias operações distintas (boleto, débito automático, fornecedor) no mesmo arquivo.
Para que serve
CNAB 240 é usado para:
- Cobrança registrada (envio de boletos para o banco emitir).
- Pagamento de fornecedores (PJ).
- Pagamento de salários (folha).
- Retornos (bancos enviam à empresa o que aconteceu com cada cobrança).
- Tributos (DARF, GPS, GARE).
Cada banco publica um manual técnico com pequenas variações (campos opcionais, códigos de motivo). Sempre que estiver preparando integração, baixe o manual atualizado do banco em questão.
Estrutura básica do arquivo
Um arquivo CNAB 240 sempre segue este esqueleto:
[Header de Arquivo] ← 1 linha (240 caracteres)
[Header de Lote] ← 1 linha
[Detalhe 1] ... [Detalhe N]
[Trailer de Lote] ← 1 linha
...
[Trailer de Arquivo] ← 1 linha
Cada registro tem tipo identificado em uma posição fixa (geralmente a 8ª posição):
- 0 = Header de arquivo
- 1 = Header de lote
- 3 = Detalhe (com sub-segmentos: P, Q, R, S, T, U…)
- 5 = Trailer de lote
- 9 = Trailer de arquivo
Campos comuns no header
- Código do banco (3 dígitos)
- Código do convênio (negociado entre empresa e banco)
- Nome da empresa
- Data de geração
- Hora de geração
- Sequencial de arquivo (incrementado a cada envio)
A maioria dos erros que travam homologação aparece no header — convênio errado, data fora do formato, sequencial repetido.
Como saber se o seu arquivo está correto
Antes de subir para o banco:
- Abra o Formatador CNAB do Toolspace.
- Suba o arquivo (.txt, .ret ou .rem).
- Selecione o layout CNAB 240.
- O sistema confere o tamanho de cada linha (deve ter exatamente 240 caracteres + quebra), valida posições críticas e aponta erros com a posição exata.
- Baixe o arquivo ajustado.
Tudo é processado localmente — nenhum dado bancário é enviado para servidor.
Diferenças entre CNAB 240 e CNAB 400
| Aspecto | CNAB 240 | CNAB 400 |
|---|---|---|
| Tamanho do registro | 240 caracteres | 400 caracteres |
| Estrutura | Lotes hierárquicos | Linha única por boleto |
| Modernidade | Padrão atual | Padrão antigo (legado) |
| Tipos de operação | Cobrança, pagamentos, salários, tributos | Principalmente cobrança |
| Bancos suportados | Todos os grandes | Vários — alguns ainda exigem |
Em 2026, novos sistemas costumam adotar 240. Mas se você está integrando com banco que ainda usa 400 (especialmente em retornos antigos), saiba que os dois convivem.
Erros comuns em CNAB 240
- Linha com 239 ou 241 caracteres: cabeçalho mal preenchido ou quebra de linha extra.
- Registro fora de ordem: detalhe antes de header de lote, ou trailer no lugar errado.
- Sequencial duplicado: enviar arquivo 001 duas vezes faz o banco rejeitar.
- Convênio inválido: erro mais comum em homologação — confira com o gerente.
- Datas fora do padrão DDMMAAAA ou AAAAMMDD: cada banco define qual usar.
- Caracteres especiais: acentos costumam ser proibidos; use texto sem acentuação.
Quando usar CNAB e quando usar API
Bancos modernos oferecem API REST para boletos (Open Finance, Pix, BaaS). Para volumes baixos e integrações novas, API é mais simples.
CNAB ainda faz sentido em três cenários:
- Volume alto: enviar 50 mil boletos por dia em arquivo é mais barato que 50 mil chamadas API.
- Bancos legados: muitos bancos cooperativos e regionais só oferecem CNAB.
- Sistemas ERP: SAP, Totvs, Senior costumam exportar nativamente em CNAB.
Perguntas frequentes
O CNAB 240 vai ser descontinuado? Não há previsão. Apesar do crescimento das APIs, CNAB segue como padrão Febraban e é usado por todos os grandes bancos.
Posso editar manualmente um arquivo CNAB? Tecnicamente sim, mas é arriscado: qualquer caractere fora do tamanho esperado quebra o layout. Use o Formatador CNAB para validar antes.
Bancos cobram para enviar CNAB? Em geral, sim — convênio CNAB tem tarifa por boleto registrado. Confira com seu banco.
Como gerar CNAB 240 a partir de uma planilha Excel? Usando ERPs ou scripts custom em Python/Node. O Toolspace oferece formatação e validação, mas não geração a partir de planilhas (ainda).
Conclusão
CNAB 240 é o padrão Febraban para troca de arquivos bancários no Brasil — moderno, organizado em lotes e usado para cobrança, pagamentos e tributos. Antes de enviar qualquer arquivo ao banco, confira no Formatador CNAB do Toolspace — economiza horas de homologação.