Glossário CNAB

Os termos do dia a dia de quem gera, valida e confere arquivos CNAB 240 e 400 — com links para os guias de layout por banco e para as ferramentas do ValidaCNAB.

CNAB

Padrão de arquivo de troca de informações bancárias definido pela FEBRABAN. Os formatos mais usados são o CNAB 240 (com lotes e segmentos, usado em pagamentos e cobrança) e o CNAB 400 (posicional, um registro por linha, usado na cobrança). Ver mais

CNAB 240

Formato com linhas de 240 posições organizadas em hierarquia: header de arquivo, lotes (cada um com header, segmentos e trailer) e trailer de arquivo. É o padrão dos pagamentos e da cobrança moderna. Ver mais

CNAB 400

Formato posicional com linhas de 400 posições: um header (tipo 0), registros de detalhe (um por título) e um trailer (tipo 9). Cada banco tem variações — por isso cada layout é conferido contra o manual oficial. Ver mais

Remessa

Arquivo que a empresa envia ao banco instruindo a cobrança: registro de títulos, baixas, descontos e protestos. A segunda posição da linha de um CNAB 400 identifica a modalidade. Ver mais

Retorno

Arquivo que o banco devolve informando o que aconteceu com cada título da remessa: liquidações, rejeições e ocorrências. Comparar remessa e retorno por chave de negócio é o que o ValidaCNAB faz no comparador. Ver mais

Header de arquivo

Registro de abertura: identifica a empresa (código do banco, conta, data de geração) e é único no início do arquivo, tanto no CNAB 240 quanto no 400.

Trailer de arquivo

Registro de fechamento: declara totais (quantidade de registros, soma de valores) que o banco confere contra o conteúdo. O motor de regras do ValidaCNAB confere essas somatórias antes do envio.

Lote

Unidade do CNAB 240 que agrupa registros do mesmo serviço (cobrança, pagamento). Cada lote tem header próprio — com o par tipo de serviço/forma de lançamento que decide quais segmentos são válidos ali. Ver mais

Segmento

Registro de detalhe do CNAB 240 identificado por letra (A, B, J, P, Q…). Um título de cobrança ocupa, por exemplo, os segmentos P e Q. Segmento fora do serviço declarado no lote é erro. Ver mais

Registro detalhe

No CNAB 400, o registro tipo 1 — um por título da remessa — com nosso número, valor, vencimento e dados do sacado. A posição de cada campo muda entre bancos; o guia campo a campo mostra cada um. Ver mais

Nosso número

Identificador do título no banco. É a chave de negócio usada pelo comparador para casar a remessa com o retorno, porque o banco não devolve registros na mesma ordem do envio. Ver mais

Código de ocorrência

Resposta do banco no retorno sobre cada título (ex.: 06 liquidação, 03 rejeição). O ValidaCNAB traduz os códigos pelo manual oficial de cada banco, com a fonte citada. Ver mais

Dígito verificador (DV)

Algarismo calculado (módulo 10 ou 11) que protege agência, conta, nosso número e código de barras contra erro de digitação. O motor de regras recalcula o DV de cada campo conferido. Ver mais

Código de barras

Sequência de 44 posições do boleto (ou 48 em arrecadação) com banco, moeda, fator de vencimento, valor e campo livre, protegida pelo DV geral. O motor confere o DV FEBRABAN do código de barras.

Linha digitável

Versão legível do código de barras em 47 posições. No ValidaCNAB, o mapeamento visual mostra a relação entre cada bloco da linha e o conteúdo do arquivo. Ver mais

Carteira

Código que define o tipo de cobrança do título (simples, escritural, com registro) e muda como o banco trata o arquivo. É campo da remessa e aparece no guia de cada banco. Ver mais

Convênio

Contrato da empresa com o banco para operar cobrança. Em alguns bancos o layout depende do convênio: no Banco do Brasil, por exemplo, o manual de remessa vale para numeração acima de 1.000.000. Ver mais

Layout provado

Layout transcrito do manual oficial do banco, conferido por 11 invariantes estruturais e por fixtures reais, com procedência registrada (fonte, versão e data). É o selo que o ValidaCNAB exibe antes do upload. Ver mais

Ocorrência

No retorno, o resultado do processamento de um título (liquidação, rejeição, protesto). No ValidaCNAB, "ocorrência" também aparece no resultado da validação como a violação de regra apontada com linha e campo.