Um arquivo de remessa CNAB é o que você envia ao banco para instruir pagamentos, cobranças ou transferências em lote. Se você está implementando geração de CNAB no seu sistema, este guia cobre a estrutura obrigatória e os campos que causam mais rejeições.
O que é um arquivo de remessa CNAB
Remessa é o arquivo que a empresa envia ao banco. O banco processa e devolve um retorno com o resultado de cada instrução. Os dois formatos principais são CNAB 240 (linhas de 240 caracteres) e CNAB 400 (linhas de 400 caracteres).
A remessa pode conter:
- Instruções de cobrança (registrar boletos para que o banco os aceite)
- Instruções de pagamento (pagar boletos, salários, fornecedores)
- Instruções de TED/DOC/Pix (transferências)
Estrutura obrigatória do CNAB 240
Todo arquivo CNAB 240 segue esta hierarquia rígida:
[Linha 1] Header de arquivo (tipo 0)
[Linha 2] Header de lote (tipo 1)
[Linha 3+] Registros detalhe (tipo 3, segmentos A, B, J, N...)
[Linha N] Trailer de lote (tipo 5)
[Linha N+1] Trailer de arquivo (tipo 9)
Um arquivo pode ter múltiplos lotes — um por tipo de pagamento. Cada lote abre com Header (tipo 1) e fecha com Trailer (tipo 5).
Header de arquivo (tipo 0) — campos críticos
| Campo | Posição | Tamanho | Valor |
|---|---|---|---|
| Código do banco | 1–3 | 3 | Ex.: 341 (Itaú), 033 (Santander) |
| Lote de serviço | 4–7 | 4 | 0000 no header de arquivo |
| Tipo de registro | 8 | 1 | 0 |
| CNPJ/CPF da empresa | 18–32 | 15 | Sem pontuação, com zeros à esquerda |
| Número do arquivo | 158–163 | 6 | Sequencial — incrementar a cada envio |
| Data de geração | 164–171 | 8 | Formato DDMMAAAA |
Erro frequente: reusar o mesmo número de arquivo. Muitos bancos rejeitam número de arquivo duplicado.
Header de lote (tipo 1) — campos críticos
| Campo | Posição | Tamanho | Valor |
|---|---|---|---|
| Código do banco | 1–3 | 3 | Igual ao header de arquivo |
| Lote de serviço | 4–7 | 4 | 0001, 0002... sequencial por lote |
| Tipo de operação | 9 | 1 | C = crédito, D = débito |
| Tipo de serviço | 10–11 | 2 | 20 = pagamento fornecedor, 30 = salário |
| Forma de pagamento | 12–13 | 2 | 01 = crédito em conta, 03 = TED, 45 = Pix |
Registro de detalhe (tipo 3) — Segmento A
Para pagamento por crédito em conta ou TED:
| Campo | Posição | Tamanho | Notas |
|---|---|---|---|
| Tipo de movimento | 15 | 1 | 0 = inclusão |
| Instrução | 16–17 | 2 | 00 = sem instrução |
| Banco do favorecido | 21–23 | 3 | Código 3 dígitos |
| Agência | 24–28 | 5 | Sem dígito, zeros à esquerda |
| DV agência | 29 | 1 | Dígito verificador da agência |
| Conta | 30–41 | 12 | Sem dígito, zeros à esquerda |
| DV conta | 42 | 1 | Dígito verificador da conta |
| Nome do favorecido | 44–73 | 30 | Alfanumérico, espaços à direita |
| Data do pagamento | 91–98 | 8 | Formato DDMMAAAA |
| Valor do pagamento | 120–134 | 15 | Inteiro, sem vírgula, 2 casas decimais implícitas |
Exemplo: R$ 1.500,00 → 000000000150000 (zeros à esquerda, sem vírgula).
Segmento B (Pix) — campos obrigatórios
Para pagamentos Pix, o Segmento B é obrigatório após cada Segmento A:
- Tipo de chave Pix (posição variável por banco):
01= CPF,02= CNPJ,03= telefone,04= e-mail,05= chave aleatória (EVP). - Chave Pix: alfanumérico, tamanho fixo definido pelo banco.
Trailer de lote (tipo 5) — campos críticos
| Campo | Valor |
|---|---|
| Total de registros no lote | Contagem exata de linhas dentro do lote (incluindo headers) |
| Soma dos valores | Soma de todos os valores de pagamento do lote |
Erro frequente: gerar o arquivo e não atualizar os totalizadores no trailer. Se a contagem declarada for diferente da real, o banco rejeita o lote inteiro.
Trailer de arquivo (tipo 9)
| Campo | Valor |
|---|---|
| Total de lotes | Quantidade de lotes no arquivo |
| Total de registros | Soma de todas as linhas do arquivo |
Checklist antes de enviar a remessa
- Código do banco correto (3 dígitos, sem zeros extras)
- CNPJ/CPF da empresa com zeros à esquerda
- Número de arquivo incrementado em relação ao anterior
- Data de pagamento é dia útil (ou flag de próximo dia útil ativo)
- Valores com padding de zeros à esquerda (sem vírgula)
- Contadores de registros e lotes atualizados nos trailers
- Segmento B presente após Segmento A em pagamentos Pix
- Sequência de registros sem lacunas (1, 2, 3...)
Validar antes de enviar
Use o Formatador CNAB do Toolspace para verificar automaticamente a estrutura do arquivo: contadores, sequências, campos obrigatórios e formatos de data e valor.
Perguntas frequentes
Quantos pagamentos posso incluir numa remessa? Depende do banco. Alguns limitam por número de lotes ou por valor total. Consulte o manual do banco.
Posso misturar TED e Pix no mesmo arquivo? Sim, em lotes separados. Cada forma de pagamento vai num lote diferente com o campo Forma de Pagamento específico.
O arquivo precisa de codificação específica? Sim — CNAB usa ASCII puro. Caracteres especiais (ç, ã, é) devem ser substituídos por equivalentes sem acento ou por espaço.
Qual a extensão do arquivo CNAB? Geralmente .rem para remessa e .ret para retorno, mas o banco aceita qualquer extensão. O conteúdo é texto puro.
Conclusão
Gerar um arquivo CNAB correto exige atenção aos totalizadores, formato de valores e segmentos obrigatórios. Para validar a estrutura antes de enviar ao banco, use o Formatador CNAB do Toolspace.