Layout CNAB 400 Caixa Econômica Federal — 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. O tipo 4 fechou em 2026-08-18, quando o extrator passou a honrar a matriz cm do PDF.
- 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 | Código do Serviço | |
| 12-26 | Literal de Serviço | A | 15 | Sim | Literal de Serviço | |
| 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 | Código do Beneficiário | |
| 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 | Sim | Campo 13.0V do manual | |
| 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 | Código do Beneficiário | |
| 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 |
Tipo 4 — Registro Detalhe Opcional - Rateio de Crédito - Retorno — Opcional
Vinculado a: 1
| 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-21 | Código da Agência de Vinculação | N | 4 | Sim | Código da Agência de Vinculação | |
| 22-28 | Código do Beneficiário | N | 7 | Sim | Código do Beneficiário | |
| 29-31 | Uso Exclusivo CAIXA | A | 3 | Não | Brancos | |
| 32-56 | Brancos | A | 25 | Não | Campo em branco | |
| 57-58 | Identificação do Registro Opcional | N | 2 | Sim | Nota NE042 | |
| 59-60 | Tipo de Pagamento | N | 2 | Não | Nota NE043 | |
| 61-62 | Quantidade de Pagamentos Possíveis | N | 2 | Não | Nota NE044 | |
| 63-77 | Valor Nominal | N | 15 | Não | Nota NE020 | decimais: 2 |
| 78-78 | Tipo de Valor Máximo | N | 1 | Não | Nota NE045 | |
| 79-93 | Valor Máximo | N | 15 | Não | Nota NE046 | decimais: 2 |
| 94-108 | Percentual Máximo | N | 15 | Não | Percentual Máximo | decimais: 2 |
| 109-109 | Tipo de Valor Mínimo | N | 1 | Não | Nota NE045 | |
| 110-124 | Valor Mínimo | N | 15 | Não | Nota NE047 | decimais: 2 |
| 125-139 | Percentual Mínimo | N | 15 | Não | Percentual Mínimo | decimais: 2 |
| 140-142 | Uso Exclusivo CAIXA | A | 3 | Não | Brancos | |
| 143-147 | Código do Mantenedor | N | 5 | Não | Nota NE048 | |
| 148-148 | Dígito Verificador da Agência | A | 1 | Não | Nota NE049 | |
| 149-160 | Conta | N | 12 | Não | Nota NE050 | |
| 161-161 | Dígito Verificador da Conta | A | 1 | Não | Nota NE051 | |
| 162-162 | Dígito Verificador da Agência/Conta | A | 1 | Não | Nota NE052 | |
| 163-164 | Modalidade do Nosso Número | N | 2 | Não | Nota NE015 | |
| 165-179 | Identificação do Título no Banco | N | 15 | Não | Nota NE015 | |
| 180-182 | Uso Exclusivo CAIXA | A | 3 | Não | Brancos | |
| 183-183 | Código de Cálculo do Rateio | N | 1 | Não | 1 = Valor Cobrado, 2 = Valor Registro, 3 = Rateio p/ Menor Valor | |
| 184-184 | Tipo de Valor Informado | N | 1 | Não | 1 = Percentual, 2 = Valor ou Quantidade | |
| 185-199 | Valor ou Percentual do Rateio | N | 15 | Não | Nota NE053 | decimais: 2 |
| 200-202 | Código do Banco para Crédito | N | 3 | Não | Código do Banco para Crédito | |
| 203-207 | Código da Agência para Crédito | N | 5 | Não | Nota NE048 | |
| 208-208 | Dígito Verificador da Agência para Crédito | N | 1 | Não | Nota NE049 | |
| 209-220 | Conta Corrente para Crédito | N | 12 | Não | Nota NE050 | |
| 221-221 | Dígito Verificador da Conta para Crédito | N | 1 | Não | Nota NE051 | |
| 222-222 | Dígito Verificador da Agência/Conta para Crédito | N | 1 | Não | Nota NE052 | |
| 223-262 | Nome do Beneficiário do Rateio | A | 40 | Não | Nome do Beneficiário do Rateio | |
| 263-268 | Identificação da Parcela do Rateio | N | 6 | Não | Identificação da Parcela do Rateio | |
| 269-271 | Quantidade de Dias para Crédito | N | 3 | Não | Floating | |
| 272-279 | Data do Crédito ao Beneficiário | N | 8 | Não | Data do Crédito ao Beneficiário | DDMMAAAA |
| 280-289 | Motivo Ocorrido | N | 10 | Não | Identificação das rejeições, nota NE054 | |
| 290-394 | Uso Exclusivo CAIXA | A | 105 | Não | Brancos | |
| 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 | 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-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 |