Layout CNAB 444 — Cessão

Layout do arquivo de remessa de cessão aceito pela QI CTVM. É o padrão CNAB 444 de cobrança usado no mercado de FIDCs, com as regras de preenchimento e os domínios efetivamente validados pela nossa plataforma.

Onde este arquivo é usado

Este é o arquivo enviado no fluxo descrito em Cessão por Arquivo, pelo portal do gestor ou do consultor. Para dar baixa em ativos já encarteirados, o layout é outro: veja Layout CNAB 444 — Baixa.

Estrutura do arquivo

Registro	Identificação (posição 1)	Quantidade
Header	0	1, sempre a primeira linha
Detalhe	1	1 por título cedido
Trailer	9	1, sempre a última linha

Todas as linhas têm exatamente 444 caracteres, sem contar a quebra de linha.

Nome do arquivo

CBDDMMxx.REM ou CBDDMMxx.TXT — CB fixo, DD dia, MM mês e xx sequencial alfanumérico. Exemplos: CB120801.REM, CB1208AE.TXT.

Aceitamos qualquer nome, desde que a extensão seja .rem ou .txt. A convenção acima é apenas a recomendada.

Regras gerais de preenchimento

Regra	Detalhe
Tamanho fixo	Toda linha tem 444 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	Sempre com 2 casas decimais, sem vírgula ou ponto. R$ 2.470,56 → 000000000247056.
Datas	Formato DDMMAA. Ex.: 12/08/2025 → 120825.
Caracteres permitidos	Apenas A-Z, a-z, 0-9, espaço e . / - , ( ) &. Não use acentos nem Ç — troque SÃO PAULO por SAO PAULO e AÇOS por ACOS.
Codificação	UTF-8 ou ASCII. Quebra de linha CRLF ou LF.

O erro mais comum

Acento ou cedilha em nome de sacado, razão social ou endereço. A mensagem devolvida aponta a posição exata e o nome do campo — por exemplo: "Caracteres inválidos encontrados na posição 240, dentro do campo 'Nome do sacado'."

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 fornecido pela QI CTVM no cadastro, alinhado à direita com zeros
7	047–076	30	Nome do originador	Sim	Razão social
8	077–079	3	Número do banco	Não	Livre
9	080–094	15	Nome do banco	Não	Livre
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	Não	Livre
14	118–120	3	Banco do cedente	Não	Dígitos ou brancos
15	121–125	5	Agência do cedente	Não	Dígitos ou brancos
16	126–126	1	DV da agência	Não	Livre
17	127–138	12	Conta corrente do cedente	Não	Dígitos ou brancos
18	139–139	1	DV da conta corrente	Não	Livre
19	140–377	238	Brancos	Sim	Exatamente 238 espaços
20	378–391	14	CPF/CNPJ do cedente original	Não	CNPJ com 14 caracteres, CPF com 11 dígitos + 3 espaços, ou 14 espaços
21	392–438	47	Brancos	Sim	Exatamente 47 espaços
22	439–444	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 com a mensagem "O código do originador '…' não foi encontrado". Solicite o código no processo de homologação do cedente.

Cedente original (posições 378–391)

Campo específico da QI CTVM, que não existe no layout de mercado. Use quando o título já tiver passado por um endosso anterior e você precisar registrar o CNPJ/CPF do cedente de origem. Se não se aplica, deixe em branco.

Registro Detalhe

Um registro por título. Os campos em negrito são os que alimentam o ativo criado na carteira do fundo.

#	Posição	Tam.	Campo	Obrig.	Conteúdo aceito
1	001–001	1	Identificação do registro	Sim	1
2	002–007	6	Data de carência	Não	DDMMAA ou zeros
3	008–008	1	Tipo de juros	Não	0 sem correção, 1 juros fixo, 2 CDI, 3 IPCA-15, 4 IPCA, 5 IGPM, ou branco
4	009–010	2	Brancos	Sim	2 espaços
5	011–020	10	Taxa de juros	Não	Dígitos (7 decimais) ou 10 espaços
6	021–022	2	Coobrigação	Sim	01 com coobrigação, 02 sem coobrigação
7	023–024	2	Característica especial (SCR)	Não	Anexo 8 do SCR 3040, 00 ou brancos
8	025–028	4	Modalidade da operação (SCR)	Condicional	Anexo 3 do SCR 3040. Pode ficar em branco para duplicatas e CTe
9	029–030	2	Natureza da operação (SCR)	Não	Anexo 2 do SCR 3040, 00 ou brancos
10	031–034	4	Origem do recurso (SCR)	Não	Anexo 4 do SCR 3040, 0000 ou brancos
11	035–036	2	Classe de risco (SCR)	Não	AA, A…H, HH, 01, 00 ou brancos
12	037–037	1	Zeros	Não	0 ou branco
13	038–062	25	Nº de controle do participante	Sim	Identificador único do ativo no seu sistema. Alinhado à esquerda
14	063–065	3	Número do banco	Não	Dígitos ou brancos
15	066–070	5	Zeros	Não	Zeros ou brancos
16	071–081	11	Identificação do título no banco	Não	Dígitos ou 11 espaços
17	082–082	1	Dígito do nosso número	Não	Livre
18	083–092	10	Valor pago	Não	Zeros na cessão
19	093–093	1	Condição de emissão da papeleta	Não	Branco
20	094–094	1	Papeleta para débito automático	Não	Branco
21	095–100	6	Data da liquidação	Não	Zeros na cessão
22	101–104	4	Identificação da operação do banco	Não	4 espaços ou 0000
23	105–105	1	Indicador de rateio de crédito	Não	Branco ou 0
24	106–106	1	Endereçamento de aviso de débito	Não	Branco
25	107–108	2	Brancos	Não	2 espaços ou 00
26	109–110	2	Identificação da ocorrência	Sim	Ver Ocorrências
27	111–120	10	Nº do documento	Sim	Número do título/duplicata. Exatamente 10 caracteres
28	121–126	6	Data de vencimento	Sim	DDMMAA
29	127–139	13	Valor de face	Sim	Valor nominal do título, 2 decimais
30	140–142	3	Banco encarregado da cobrança	Não	Dígitos, zeros ou brancos
31	143–147	5	Agência depositária	Não	5 dígitos, 00000 ou brancos
32	148–149	2	Espécie de título	Sim	Ver Espécies
33	150–150	1	Identificação	Não	Branco
34	151–156	6	Data de emissão do título	Sim	DDMMAA
35	157–158	2	1ª instrução	Não	00
36	159–159	1	2ª instrução	Não	0
37	160–161	2	Tipo de pessoa do cedente	Sim	01 pessoa física, 02 pessoa jurídica
38	162–173	12	Juros/mora por dia de atraso	Não	12 caracteres alfanuméricos ou 12 espaços
39	174–192	19	Nº do termo de cessão	Não	Livre ou brancos
40	193–205	13	Valor presente (aquisição)	Sim	Valor pago pelo fundo por este título, 2 decimais
41	206–218	13	Valor do abatimento	Não	Zeros ou dígitos
42	219–220	2	Tipo de inscrição do sacado	Sim	01 pessoa física (CPF), 02 pessoa jurídica (CNPJ)
43	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
44	235–274	40	Nome do sacado	Sim	Não pode ficar em branco
45	275–314	40	Endereço do sacado	Sim	Não pode ficar em branco. Ex.: AV EXEMPLO, 100
46	315–323	9	Nº da nota fiscal	Condicional	Obrigatório para duplicatas e CTe
47	324–326	3	Série da nota fiscal	Não	3 alfanuméricos ou 3 espaços. Em branco assume 1
48	327–334	8	CEP do sacado	Sim	8 dígitos, sem hífen
49	335–394	60	Cedente	Sim	335–380 nome do cedente (46) · 381–394 CNPJ do cedente (14)
50	395–438	44	Chave da NF-e	Condicional	44 dígitos. Obrigatória para duplicata_mercantil e cte nas ocorrências 01, 81 e 84
51	439–444	6	Nº sequencial do registro	Sim	Sequencial da linha, começando em 000002

Registro Trailer

#	Posição	Tam.	Campo	Obrig.	Conteúdo aceito
1	001–001	1	Identificação do registro	Sim	9
2	002–438	437	Brancos	Sim	Exatamente 437 espaços
3	439–444	6	Nº sequencial do registro	Sim	Número da última linha do arquivo

Ocorrências aceitas

A ocorrência (posições 109–110) diz o que fazer com o título.

Código	Significado	Quando usar
01	Remessa — aquisição de títulos	Padrão da cessão. É o que você usa em quase todos os casos
80	Remessa — aquisição com liquidação para a consultoria	Tratada como aquisição
81	Entrada por troca de títulos, com liquidação para a consultoria	Contrapartida de recompra dentro do mesmo arquivo
84	Entrada por troca de títulos, com liquidação para o cedente	Contrapartida de recompra dentro do mesmo arquivo
72	Recompra parcial	Só em lote de substituição. Gera amortização do ativo recomprado
74	Baixa por recompra	Só em lote de substituição. Gera liquidação do ativo recomprado

Recompra exige lote de substituição

As ocorrências 72 e 74 só são aceitas quando a configuração de cessão é do tipo substituição e o lote foi criado com assignment_type: substitution_assignment. Em um lote comum, o arquivo é recusado com a mensagem "A ocorrência de recompra '…' só é permitida em configurações de cessão de recompra (substituição)".

Ocorrências de baixa não entram aqui

Códigos como 04, 14, 75 e 77 pertencem ao arquivo de baixa e são processados por outro fluxo. Enviá-los em um arquivo de cessão faz o ativo falhar no processamento, mesmo que a linha passe na validação de estrutura. Veja Baixa por Arquivo.

Espécies de título

A espécie, nas posições 148–149, define como o título é lido. Três códigos são processados no fluxo de cessão por arquivo:

Código	Espécie	Tipo de ativo	Nota fiscal	Chave da NF-e	Exemplo
01	Duplicata	duplicata_mercantil	Obrigatória	Obrigatória	Baixar
14	Duplicata de serviço	duplicata_servicos	Obrigatória	Dispensada	Baixar
53	CT-e	cte	Obrigatória	Obrigatória	Baixar

Outros códigos passam na estrutura, mas não são processados

O layout CNAB 444 prevê dezenas de espécies — 02 nota promissória, 41 CCB digital, 51 cheque, 60 contrato, entre outras. Elas passam pela validação estrutural do arquivo, mas não são convertidas em ativo no fluxo de cessão por arquivo: o processamento devolve "Asset type … was not expected" e o lote não avança.

Se o seu produto usa uma dessas espécies, ceda pela API de integração, ativo a ativo, ou confirme o caminho com integracao.dtvm@qitech.com.br antes de montar o arquivo.

A espécie precisa combinar com a configuração de cessão

Uma configuração de duplicata_mercantil espera espécie 01. Enviar uma espécie incompatível com o tipo de ativo da configuração faz o ativo ser recusado na inserção.

De-para: do CNAB para o ativo na carteira

Cada linha de detalhe vira um ativo idêntico ao que seria criado pelo endpoint de Criação de Ativo — Duplicata.

Posição no CNAB	Campo do ativo (API)
038–062 Nº de controle do participante	discounted_credit_right.external_id e participant_control_number — é por ele que o ativo é referenciado depois, inclusive na baixa
111–120 Nº do documento	discounted_credit_right.order_number — identifica a linha dentro do arquivo e não pode se repetir
121–126 Data de vencimento	discounted_credit_right.maturity_date
127–139 Valor de face	discounted_credit_right.face_value
148–149 Espécie de título	asset_type
151–156 Data de emissão	discounted_credit_right.invoice.issue_date
193–205 Valor presente	total_purchase_value
219–220 / 221–234 Sacado	borrower.person_type e borrower.document_number
235–274 Nome do sacado	borrower.name
275–314 Endereço do sacado	borrower.address.street e number
315–323 / 324–326 Nota fiscal	invoice.number e invoice.serie
327–334 CEP	borrower.address.postal_code
395–438 Chave da NF-e	invoice.access_key
Header 027–046 Código do originador	originator_document_number
Header 378–391 Cedente original	original_assignor_document_number

Endereço do sacado

O logradouro e o número são extraídos do texto das posições 275–314, e o restante do endereço (bairro, cidade e UF) é completado automaticamente a partir do CEP. Escreva no formato LOGRADOURO, NUMERO.

Exemplo comentado

Cessão de duas duplicatas mercantis do cedente 11.222.333/0001-81, com vencimento em 10/10/2025.

CB120801.REM

01REMESSA01COBRANCA       00000011222333000181INDUSTRIA EXEMPLO S/A         ...MX...000001
1...0CTRL000001...01000100001101025000000015100...0245678912000155COMERCIO EXEMPLO ALFA LTDA...000002
1...0CTRL000002...01000200002101025000000015200...0278912345000109COMERCIO EXEMPLO BETA LTDA...000003
9                                                                              ...000004

Linha	Leitura
Header	Originador 00000011222333000181, arquivo gerado em 12/08/2025, sistema MX
Detalhe 1	Ativo CTRL000001, documento 0001000010, vence em 10/10/2025, face R$ 1.510,00, aquisição R$ 1.480,00, sacado CNPJ 45.678.912/0001-55
Detalhe 2	Ativo CTRL000002, documento 0002000020, face R$ 1.520,00, aquisição R$ 1.490,00, sacado CNPJ 78.912.345/0001-09
Trailer	Fecha o arquivo com o sequencial 000004

Arquivos de exemplo

Arquivo	Espécie	O que traz
Duplicata mercantil	01	Dois títulos com nota fiscal e chave da NF-e preenchidas
Duplicata de serviços	14	Dois títulos com nota fiscal e sem chave da NF-e
CT-e	53	Dois conhecimentos de transporte com chave preenchida

Sobre os exemplos

Os três arquivos passam integralmente pela nossa validação. Os CNPJs são fictícios, mas têm dígito verificador válido — se você trocar por documentos "redondos" tipo 45678912000199, o arquivo será recusado.

Checklist antes de enviar

• Todas as linhas com exatamente 444 caracteres
• Header começa com 01REMESSA01COBRANCA e tem MX nas posições 109–110
• Código do originador cadastrado, alinhado à direita com zeros
• Sem acentos, Ç ou caracteres especiais em qualquer campo
• CPF/CNPJ do sacado com dígito verificador válido
• Nome e endereço do sacado preenchidos
• Chave da NF-e com 44 dígitos nas duplicatas mercantis e CT-e
• Nº de controle do participante único por ativo
• Valores monetários sem vírgula, com 2 decimais
• Ocorrência 01 (ou 72/74 apenas em lote de substituição)
• Sequencial de registro correto, com o trailer fechando na última linha