Se você está implementando ou depurando um arquivo CNAB 240, a parte mais confusa costuma ser os segmentos: para que serve cada um, em que ordem aparecem e quais são obrigatórios. Este guia é um mapa rápido de todos os segmentos do CNAB 240.
O que são segmentos no CNAB 240
No CNAB 240, cada registro de detalhe (tipo 3) é identificado por um segmento — uma letra que indica que tipo de informação aquela linha carrega. Um único pagamento pode gerar 2 a 4 linhas de segmento, dependendo do tipo de transação.
A estrutura dentro de um lote é:
Header de lote (tipo 1)
Segmento X (tipo 3, segmento X)
Segmento Y (tipo 3, segmento Y) ← se necessário
...
Trailer de lote (tipo 5)
Mapa de segmentos por finalidade
Segmento A — Dados do favorecido (obrigatório)
Contém: banco, agência, conta, nome do favorecido, data e valor do pagamento.
Usado em: pagamentos por TED, DOC, crédito em conta (salário, fornecedores).
Segmento B — Dados complementares (opcional/obrigatório por tipo)
Contém: endereço do favorecido, CPF/CNPJ, chave Pix, informações adicionais.
Usado em: pagamentos Pix (obrigatório), pagamentos a pessoa física com endereço exigido.
Fica sempre após o Segmento A correspondente.
Segmento C — Informações de IR e outras retenções (opcional)
Contém: valor de IRRF, INSS, CSLL e outras retenções aplicadas ao pagamento.
Usado em: pagamentos a fornecedores com retenção de impostos.
Segmento J — Pagamento de boletos e tributos (obrigatório)
Contém: código de barras ou linha digitável, data de vencimento, valor com desconto/mora.
Usado em: pagamento de boletos bancários, tributos com código de barras.
Segmento J-52 — Boletos de concessionária (obrigatório para 48 dígitos)
Variação do Segmento J para contas de consumo (água, luz, IPTU) — os 48 dígitos do código têm layout diferente no campo.
Usado em: pagamento de contas de consumo com código de barras de 48 dígitos.
Segmento N — GPS e DARF simplificado (obrigatório)
Contém: código do tributo, período de apuração, número do documento.
Usado em: pagamento de GPS (INSS), DARF (impostos federais), GARE, IPVA.
Segmento O — Pagamento por depósito em cheque (legado)
Raramente usado hoje. Contém dados para depósito via cheque.
Segmento W — Informações complementares do lote (informativo)
Contém: dados específicos do banco ou da empresa para controle interno.
Obrigatório em alguns bancos mesmo sem uso real — verifique o manual do banco.
Segmento Z — Registro de retorno (apenas em arquivos de retorno)
Contém: o resultado do processamento de cada instrução — código de ocorrência, data de crédito, valor creditado.
Aparece apenas no retorno que o banco envia à empresa.
Ordem correta dos segmentos num lote de pagamento
Para um pagamento de boleto via CNAB 240:
Header de lote (tipo 1)
Segmento J ← dados do boleto
Segmento J-52 ← se for concessionária (48 dígitos)
Segmento B ← dados complementares (depende do banco)
Segmento C ← apenas se houver retenção de IR
Trailer de lote (tipo 5)
Para pagamento de fornecedor por crédito em conta:
Header de lote (tipo 1)
Segmento A ← dados do favorecido
Segmento B ← dados complementares ou chave Pix
Segmento C ← retenção de impostos, se houver
Trailer de lote (tipo 5)
Validar segmentos antes de enviar ao banco
Segmentos fora de ordem ou ausentes causam rejeição do lote inteiro. Antes de enviar, use o Formatador CNAB do Toolspace para verificar a estrutura do arquivo e garantir que os segmentos estão na sequência correta.
Perguntas frequentes
Todo banco usa os mesmos segmentos? O padrão FEBRABAN define os segmentos, mas cada banco pode ter variações no layout dos campos dentro do segmento. Consulte o manual técnico do banco específico.
O Segmento B é obrigatório para TED? Para TED convencional, geralmente não. Para Pix, sim — a chave Pix vai no Segmento B.
Posso ter mais de um lote no mesmo arquivo? Sim. Um arquivo CNAB 240 pode ter múltiplos lotes, cada um com um tipo de pagamento diferente.
Segmento Z aparece na remessa ou só no retorno? Apenas no retorno. Na remessa você envia A, B, C, J, N, O. No retorno o banco inclui Z com os resultados.
Conclusão
Conhecer para que serve cada segmento evita erros de estrutura e acelera a integração bancária. Para validar o arquivo CNAB 240 completo antes do envio, use o Formatador CNAB do Toolspace.