Layout CNAB 400 — Contratos Parcelados

Layout do arquivo de remessa de cessão de contratos parcelados no padrão CNAB 400 de cobrança (registros 0, 1, 2 e 9). Cada registro 1 é uma parcela; as parcelas com o mesmo número do documento formam um contrato.

Onde este arquivo é usado

Este é o arquivo enviado no fluxo descrito em Cessão por Arquivo, pelo portal do gestor ou do consultor, ou pela API da gestora. O layout 400 só é aceito em configuração de cessão de contrato parcelado (contract) ou de contrato descontado (discounted_contract). Em qualquer outra configuração o arquivo é recusado com a mensagem "O layout CNAB 400 aceita apenas cessão de contratos, mas a configuração de cessão é de '…'."

Baixar remessa de exemplo — dados fictícios: troque o código do originador no header (posições 27–46) pelo seu antes de testar.

Estrutura do arquivo

Registro	Identificação (posição 1)	Quantidade
Header	0	1, sempre a primeira linha
Detalhe	1	1 por parcela
Complemento	2	Opcional, depois de uma parcela. É conferido e não altera o contrato
Trailer	9	1, sempre a última linha

Todas as linhas têm exatamente 400 caracteres, sem contar a quebra de linha. O arquivo é reconhecido como CNAB 400 pelo tamanho das linhas: não remova os espaços do fim da linha.

Regras gerais de preenchimento

Regra	Detalhe
Tamanho fixo	Toda linha tem 400 posições. Linhas mais curtas ou mais longas recusam o arquivo.
Campos numéricos	Alinhados à direita, completados com zeros à esquerda.
Campos alfanuméricos	Alinhados à esquerda, completados com espaços à direita.
Valores monetários	13 posições, com 2 casas decimais, sem vírgula ou ponto. R$ 1.234,56 → 0000000123456.
Datas	Formato DDMMAA. Ex.: 15/10/2026 → 151026.
Extensão	.rem ou .txt. Quebra de linha CRLF ou LF.

Registro Header

#	Posição	Tam.	Campo	Obrig.	Conteúdo aceito
1	001–001	1	Identificação do registro	Sim	0
2	002–002	1	Identificação do arquivo remessa	Sim	1
3	003–009	7	Literal remessa	Sim	REMESSA
4	010–011	2	Código do serviço	Sim	01
5	012–026	15	Literal do serviço	Sim	COBRANCA + 7 espaços
6	027–046	20	Código do originador	Sim	Código cadastrado na configuração de cessão, alinhado à direita com zeros
7	047–076	30	Nome do originador	Sim	Razão social
8	077–079	3	Número do banco	Sim	Dígitos
9	080–094	15	Nome do banco	Sim	Não pode ficar em branco
10	095–100	6	Data de gravação do arquivo	Sim	DDMMAA
11	101–108	8	Brancos	Sim	8 espaços
12	109–110	2	Identificação do sistema	Sim	MX
13	111–117	7	Nº sequencial do arquivo	Sim	Dígitos
14	118–394	277	Brancos	Sim	Exatamente 277 espaços
15	395–400	6	Nº sequencial do registro	Sim	000001

Código do originador (posições 27–46)

É o identificador do originador cadastrado na configuração de cessão. Um código não cadastrado ou vinculado a outra configuração recusa o arquivo. Solicite o código no processo de homologação do cedente.

Registro Detalhe (parcela)

Um registro por parcela. Só os campos abaixo são lidos; as demais posições do layout de cobrança (por exemplo, 002–037, conta de débito e identificação da empresa) podem vir preenchidas e não são usadas.

#	Posição	Tam.	Campo	Obrig.	Conteúdo aceito
1	001–001	1	Identificação do registro	Sim	1
2	038–062	25	Nº de controle do participante	Sim	Identificador da parcela no seu sistema. Único no arquivo e não deve mudar depois da cessão: é por ele que a parcela é encontrada na liquidação
3	109–110	2	Identificação da ocorrência	Sim	01 (entrada)
4	111–120	10	Nº do documento	Sim	Número do contrato. Repita o mesmo número em todas as parcelas do contrato
5	121–126	6	Data de vencimento	Sim	DDMMAA
6	127–139	13	Valor de face	Sim	Valor da parcela, 2 decimais, maior que zero
7	148–149	2	Espécie do título	Sim	60 contrato · 61 contrato físico
8	151–156	6	Data de emissão	Sim	DDMMAA. Igual em todas as parcelas do contrato
9	193–205	13	Valor presente (aquisição)	Sim	Preço que o fundo paga pela parcela (valor de face com o desconto acertado), 2 decimais, maior que zero
10	219–220	2	Tipo de inscrição do sacado	Sim	01 pessoa física (CPF), 02 pessoa jurídica (CNPJ)
11	221–234	14	Nº de inscrição do sacado	Sim	CNPJ com 14 posições; CPF com 11 dígitos alinhados à direita. O dígito verificador é conferido. Igual em todas as parcelas do contrato
12	235–274	40	Nome do sacado	Sim	Não pode ficar em branco
13	275–314	40	Endereço do sacado	Sim	Não pode ficar em branco. Ex.: AV EXEMPLO, 100
14	327–334	8	CEP do sacado	Sim	8 dígitos, sem hífen
15	395–400	6	Nº sequencial do registro	Sim	Sequencial da linha

Posições 193–205

No layout de cobrança bancária essas posições costumam trazer o IOF, muitas vezes zerado. Na cessão elas trazem o valor presente da parcela: com zeros, a linha é recusada.

Registro Complemento

#	Posição	Tam.	Campo	Obrig.	Conteúdo aceito
1	001–001	1	Identificação do registro	Sim	2
2	002–394	393	Mensagens e descontos do boleto	Não	Livre; não é lido
3	395–400	6	Nº sequencial do registro	Sim	6 dígitos

Registro Trailer

#	Posição	Tam.	Campo	Obrig.	Conteúdo aceito
1	001–001	1	Identificação do registro	Sim	9
2	002–394	393	Brancos	Sim	Exatamente 393 espaços
3	395–400	6	Nº sequencial do registro	Sim	6 dígitos

Como as parcelas viram contratos

• Agrupamento: linhas com o mesmo Nº do documento (111–120) são as parcelas de um mesmo contrato, e esse número vira o identificador e o número do contrato na carteira. O arquivo pode ter contratos de vários sacados.
• Consistência: todas as parcelas de um contrato precisam ter o mesmo Nº de inscrição do sacado e a mesma data de emissão; senão, o arquivo é recusado. Os demais dados do sacado vêm da primeira linha do contrato.
• Numeração: não informe número de parcela. As parcelas de cada contrato são numeradas 1, 2, 3, … pela data de vencimento.
• Nº de controle do participante: obrigatório e sem repetição no arquivo.
• Valores: o valor de compra do contrato é a soma dos valores presentes das suas parcelas. O layout 400 não traz taxa, e o contrato entra sem taxa nominal.

Exemplo

O arquivo de exemplo tem dois contratos:

Linha	Registro	Nº do documento	Nº de controle	Vencimento	Valor de face	Valor presente	Resultado
2	1	CT4001	400002	15/10/2026	1.500,00	1.400,00	Contrato CT4001, parcela 1
3	2	—	—	—	—	—	Complemento, não lido
4	1	CT4001	400001	15/11/2026	1.500,00	1.350,00	Contrato CT4001, parcela 2
5	2	—	—	—	—	—	Complemento, não lido
6	1	CT4002	400003	20/10/2026	800,00	760,00	Contrato CT4002, parcela 1
7	2	—	—	—	—	—	Complemento, não lido

O contrato CT4001 entra com valor de compra de R$ 2.750,00 e o CT4002 com R$ 760,00.