Como Formatar Arquivo CNAB Online: Guia 2026

Antes de subir um arquivo CNAB para o banco, você precisa ter certeza de que o leiaute está correto: tamanho de linha, posição dos campos, contadores no trailer. Um único caractere fora do lugar derruba a homologação. A boa notícia é que dá para conferir e formatar tudo online em segundos — sem instalar nada e com privacidade total. Neste guia você aprende a usar o Formatador CNAB do Toolspace e os erros mais comuns que ele detecta.

Por que formatar antes de enviar

Bancos rejeitam arquivos CNAB por motivos quase sempre formais:

• Linha com tamanho errado (240/241 ou 400/401 caracteres).
• Header ou trailer fora do padrão.
• Contador de registros que não bate com o que realmente está no arquivo.
• Quebra de linha errada (LF vs CRLF).
• Caracteres especiais (acentos) onde não deveriam estar.

Se você manda 50 mil boletos em um arquivo e qualquer detalhe está errado, o lote inteiro volta. Formatar antes evita semanas de homologação.

Formatador CNAB do Toolspace: o que ele faz

O Formatador CNAB online processa arquivos CNAB 240 e CNAB 400 (remessa e retorno) diretamente no navegador. Ele:

1. Confere o tamanho correto de cada linha.
2. Valida a presença e a estrutura do header e trailer.
3. Verifica contadores de registros (no trailer).
4. Detecta quebras de linha inconsistentes (LF, CRLF).
5. Aponta linhas com caracteres fora do esperado (acentos, controle).
6. Gera um arquivo formatado pronto para download.

Tudo é processado localmente no navegador. Nenhum byte do seu CNAB sai do dispositivo — importante porque arquivos CNAB carregam dados sensíveis (CPF, CNPJ, valores).

Passo a passo

1. Abra o Formatador CNAB.
2. Arraste o arquivo (.txt, .rem ou .ret) ou clique para selecionar.
3. Escolha o layout: CNAB 240 ou CNAB 400.
4. Clique em Formatar.
5. O painel mostra avisos por linha (com a posição exata dos erros).
6. Baixe o arquivo já ajustado.

Se houver erros, corrija no sistema que gerou o arquivo (ERP, script) e rode novamente — o CNAB precisa estar perfeito antes de chegar ao banco.

Erros mais frequentes detectados

Tamanho de linha errado

CNAB 240 exige exatamente 240 caracteres por linha. CNAB 400, exatamente 400. Erros comuns:

• Linha com 239 ou 241: campo mal preenchido.
• Linhas misturando padrões: arquivo gerado por sistema confuso.

Header com convênio inválido

Quase 50% dos erros de homologação são pelo convênio: número do contrato com o banco. Se o número está zerado ou diferente do contrato, o banco rejeita. O Formatador detecta convênio em branco/preenchido com zeros.

Trailer com contador errado

O trailer carrega o número de registros do arquivo. Se o ERP gerou 1500 detalhes mas o trailer diz 1499, o banco recusa. O Formatador conta os registros e compara com o trailer.

Quebra de linha mista

Alguns sistemas geram CRLF (Windows), outros LF (Linux/Mac). Bancos costumam exigir um padrão específico. O Formatador identifica quebras misturadas (que costumam aparecer quando alguém abre o arquivo em editor errado e salva).

Caracteres ASCII estendidos

Acentos, "ç", aspas tipográficas e bullets viram caracteres não-ASCII e quebram a leitura no banco. O Formatador lista as posições onde aparecem.

Boas práticas

1. Não edite o CNAB no Word ou Google Docs: eles substituem aspas e podem alterar caracteres invisíveis.
2. Use editor que mostre quebras de linha (VSCode, Notepad++, Sublime).
3. Versione os arquivos: salve cada envio com sufixo de data e sequencial.
4. Faça testes em homologação antes de produção — todo banco oferece ambiente de teste.
5. Guarde o retorno: o arquivo de retorno é a prova de que o banco recebeu e processou.

Diferença entre formatar e validar profundamente

O Formatador faz checagens estruturais (tamanhos, contadores, presença de header/trailer). Se você quer validações específicas do banco (regras de carteira, código de ocorrência permitido, dígitos verificadores em campos específicos), use o Validador CNAB Avançado do Toolspace, que cobre regras adicionais.

Exemplo de fluxo real

Você gera um CNAB 240 de remessa com 5.000 boletos no seu ERP. Antes de enviar:

1. Abre o Formatador CNAB.
2. Suba o arquivo, escolhe CNAB 240.
3. O Formatador identifica 12 linhas com 239 caracteres (alguns nomes do pagador foram cortados sem padding).
4. Você volta no ERP, ajusta o template do registro de detalhe e regera.
5. Roda novamente: 0 erros.
6. Envia ao banco com confiança.

Perguntas frequentes

O Formatador modifica o conteúdo do CNAB? Apenas formata e exibe inconsistências. Não altera os dados (CPF, valor, vencimento). Se você quer corrigir conteúdo, edite no ERP que gerou o arquivo.

Funciona com CNAB de pagamento (não cobrança)? Sim, para CNAB 240 que cobre pagamento de fornecedor, salário e tributo. Para CNAB 400 a cobertura ainda é principalmente cobrança (que é onde 400 mais aparece).

Preciso pagar? Não. O Formatador é 100% gratuito e funciona sem cadastro.

Posso usar com arquivos grandes (50 MB+)? Depende da memória do navegador. Para arquivos muito grandes, considere processar em pedaços ou rodar em desktop com mais RAM.

Conclusão

Formatar CNAB antes de enviar para o banco não é luxo — é o caminho mais curto para passar na homologação. Use o Formatador CNAB do Toolspace para conferir tamanho, header, trailer e estrutura em segundos, com privacidade total.