Caixa Econômica Federal - CNAB 400 - Retorno

Guia campo a campo do layout CNAB 400 do Caixa Econômica Federal (Retorno): posição, tamanho, tipo, obrigatoriedade e descrição de cada campo. Valide seu arquivo com o ValidaCNAB.

Procedência

Versão do manual: 67.126 v029
Última conferência do layout: 2026-08-18
Fonte oficial: https://www.caixa.gov.br/Downloads/cobranca-caixa/Manual_de_Leiaute_de_Arquivo_Eletronico_CNAB_400.pdf

Observações do layout

Manual de Leiaute CNAB 400, versão 67.126 v029, baixado de caixa.gov.br em 2026-08-18.
O PDF usa fonte sem ToUnicode; a extração exige o deslocamento +29 tratado em scripts/pdf/extrair-texto.mjs.
No detalhe do retorno, o campo 13.1 declara X(025) mas ocupa 24 posições (83-106). Vale a faixa.
Opcionais tipo 2 (mensagens), tipo 3 (e-mail/SMS) e tipo 4 (rateio de crédito) transcritos para remessa. O tipo 4 do retorno não é declarado na composição localizada do manual e segue sem suporte comprovado.
No tipo 4, o campo 40.4 declara faixa 289-394 com PICTURE X(105): vale o PICTURE (290-394), porque 39.4 termina em 289. O 35.4 declara 9(040) num campo de nome e é transcrito como alfanumérico.

Registros de Header

Tipo 0 — Header de Arquivo - Retorno

Posição	Campo	Tipo	Tamanho	Obrigatório	Descrição	Formato
1-1	Código do Registro	N	1	Sim	Código do Registro
2-2	Código do Retorno	N	1	Sim	Código do Retorno
3-9	Literal do Retorno	A	7	Sim	Literal do Retorno
10-11	Código do Serviço	N	2	Sim	§3.6.7: preencher com 01
12-26	Literal de Serviço	A	15	Sim	§3.6.7/NE002: COBRANCA nos bytes; NE002 escreve COBRANÇA na prosa
27-30	Código da Agência	N	4	Sim	Código da Agência
31-37	Código do Beneficiário	N	7	Sim	NE004: A1 usa código de 6 dígitos e zero final; A2 usa zero inicial e código de 6 dígitos; B usa código de 7 dígitos
38-46	Uso Exclusivo CAIXA	A	9	Não	Brancos
47-76	Nome da Empresa	A	30	Sim	Nome da Empresa
77-79	Código do Banco	N	3	Sim	Código do Banco
80-94	Nome do Banco	A	15	Sim	Nome do Banco
95-100	Data de Geração do Arquivo	N	6	Sim	Data de Geração do Arquivo	DDMMAA
101-158	Mensagem	A	58	Não	Mensagem
159-161	Número da Versão do Layout	N	3	Não	NE004/NE065: em branco para beneficiário A1; 007 em A2/B
162-389	Uso Exclusivo CAIXA	A	228	Não	Brancos
390-394	Número Sequencial do Arquivo Retorno	N	5	Sim	Número Sequencial do Arquivo Retorno
395-400	Número Sequencial do Registro no Arquivo	N	6	Sim	Número Sequencial do Registro no Arquivo

Registros de Detalhe

Tipo 1 — Registro de Detalhe - Retorno

Posição	Campo	Tipo	Tamanho	Obrigatório	Descrição	Formato
1-1	Código do Registro	N	1	Sim	Código do Registro
2-3	Tipo de Inscrição da Empresa	N	2	Sim	Tipo de Inscrição da Empresa
4-17	Número de Inscrição da Empresa	N	14	Sim	Número de Inscrição da Empresa
18-20	Uso Exclusivo CAIXA	N	3	Não	Uso Exclusivo CAIXA
21-27	Código do Beneficiário	N	7	Sim	NE004: A1/A2 usam zero inicial e código de 6 dígitos; B usa código de 7 dígitos
28-28	Identificação da Emissão do Boleto	N	1	Sim	Identificação da Emissão do Boleto
29-29	Identificação da Entrega/Distribuição do Boleto	N	1	Sim	Identificação da Entrega/Distribuição do Boleto
30-31	Uso Exclusivo CAIXA	A	2	Não	Uso Exclusivo CAIXA
32-56	Uso da Empresa	A	25	Não	Identificação do título na empresa
57-58	Modalidade	N	2	Sim	Modalidade
59-73	Nosso Número	N	15	Sim	Identificação do título na CAIXA
74-79	Uso Exclusivo CAIXA	A	6	Não	Uso Exclusivo CAIXA
80-82	Código de Rejeição	N	3	Não	Código de Rejeição
83-106	Uso Exclusivo CAIXA	A	24	Não	Manual declara X(025); a faixa tem 24 posições
107-108	Código da Carteira	N	2	Sim	Código da Carteira
109-110	Código de Ocorrência	N	2	Sim	Ocorrência do retorno
111-116	Data da Ocorrência	N	6	Sim	Data da Ocorrência	DDMMAA
117-126	Número do Documento	A	10	Sim	Número do Documento
127-146	Uso Exclusivo CAIXA	A	20	Não	Uso Exclusivo CAIXA
147-152	Data de Vencimento do Título	N	6	Sim	Data de Vencimento do Título	DDMMAA
153-165	Valor do Título	N	13	Sim	Valor do Título	decimais: 2
166-168	Código do Banco	N	3	Sim	Código do Banco
169-173	Agência Cobradora	N	5	Não	Agência Cobradora
174-175	Espécie do Título	N	2	Sim	Espécie do Título
176-188	Despesa de Cobrança	N	13	Não	Despesa de Cobrança	decimais: 2
189-191	Outras Despesas	N	3	Não	Custas de liquidação ou protesto
192-192	Uso Exclusivo CAIXA	N	1	Não	Uso Exclusivo CAIXA
193-194	Float	N	2	Não	Dias de float
195-200	Data do Crédito ao Beneficiário	N	6	Não	Data do Crédito ao Beneficiário	DDMMAA
201-214	Uso Exclusivo CAIXA	A	14	Não	Uso Exclusivo CAIXA
215-227	Valor do IOF	N	13	Não	Valor do IOF	decimais: 2
228-240	Valor do Abatimento	N	13	Não	Valor do Abatimento	decimais: 2
241-253	Valor do Desconto	N	13	Não	Valor do Desconto	decimais: 2
254-266	Valor Principal Pago	N	13	Sim	Valor principal pago pelo pagador	decimais: 2
267-279	Valor dos Juros	N	13	Não	Juros pagos pelo pagador	decimais: 2
280-292	Valor da Multa	N	13	Não	Multa paga pelo pagador	decimais: 2
293-293	Código da Moeda	N	1	Sim	Código da Moeda
294-299	Data do Crédito	N	6	Não	Data do Crédito	DDMMAA
300-300	Tipo de Inscrição do Pagador	N	1	Sim	Tipo de Inscrição do Pagador
301-314	Número de Inscrição do Pagador	N	14	Sim	Número de Inscrição do Pagador
315-394	Uso Exclusivo CAIXA	A	80	Não	Uso Exclusivo CAIXA
395-400	Número Sequencial do Registro no Arquivo	N	6	Sim	Número Sequencial do Registro no Arquivo

Registros de Trailer

Tipo 9 — Trailer de Arquivo - Retorno

Posição	Campo	Tipo	Tamanho	Obrigatório	Descrição
1-1	Código do Registro	N	1	Sim	Código do Registro
2-2	Código do Retorno	N	1	Sim	Código do Retorno
3-4	Código do Serviço	N	2	Sim	Código do Serviço
5-7	Código do Banco	N	3	Sim	Código do Banco
8-394	Uso Exclusivo CAIXA	A	387	Não	Brancos
395-400	Número Sequencial do Registro no Arquivo	N	6	Sim	Número Sequencial do Registro no Arquivo