CNAB 444 Layout — Assignment

Layout of the assignment remittance file accepted by QI DTVM. It is the CNAB 444 collection standard used in the FIDC market, with the filling rules and the domains actually validated by our platform.

Where this file is used

This is the file sent in the flow described in Assignment by File, through the manager or consultant portal, or through the manager API. To settle assets already held in the portfolio, the layout is a different one: see CNAB 444 Layout — Settlement.

File structure

Record	Identification (position 1)	Quantity
Header	`0`	1, always the first line
Detail	`1`	1 per assigned instrument
Trailer	`9`	1, always the last line

All the lines have exactly 444 characters, not counting the line break.

File name

CBDDMMxx.REM or CBDDMMxx.TXT — CB fixed, DD day, MM month and xx an alphanumeric sequential number. Examples: CB120801.REM, CB1208AE.TXT.

We accept any name, as long as the extension is .rem or .txt. The convention above is only the recommended one.

General filling rules

Rule	Detail
Fixed length	Every line has 444 positions. Shorter or longer lines refuse the file.
Numeric fields	Right-aligned, padded with zeros on the left.
Alphanumeric fields	Left-aligned, padded with spaces on the right.
Monetary values	Always with 2 decimal places, without a comma or a period. `R$ 2.470,56` → `000000000247056`.
Dates	`DDMMYY` format. E.g.: 12/08/2025 → `120825`.
Allowed characters	Only `A-Z`, `a-z`, `0-9`, space and `. / - , ( ) &`. Do not use accents or `Ç` — replace `SÃO PAULO` with `SAO PAULO` and `AÇOS` with `ACOS`.
Encoding	UTF-8 or ASCII. Line break `CRLF` or `LF`.

The most common error

An accent or a cedilla in the drawee's name, corporate name or address. The message returned points to the exact position and the name of the field — for example: "Caracteres inválidos encontrados na posição 240, dentro do campo 'Nome do sacado'."

Header Record

#	Position	Len.	Field	Req.	Accepted content
1	001–001	1	Record identification	Yes	`0`
2	002–002	1	Remittance file identification	Yes	`1`
3	003–009	7	Remittance literal	Yes	`REMESSA`
4	010–011	2	Service code	Yes	`01`
5	012–026	15	Service literal	Yes	`COBRANCA` + 7 spaces
6	027–046	20	Originator code	Yes	Code provided by QI DTVM at registration, right-aligned with zeros
7	047–076	30	Originator name	Yes	Corporate name
8	077–079	3	Bank number	No	Free
9	080–094	15	Bank name	No	Free
10	095–100	6	File generation date	Yes	`DDMMYY`
11	101–108	8	Blanks	Yes	8 spaces
12	109–110	2	System identification	Yes	`MX`
13	111–117	7	File sequential number	No	Free
14	118–120	3	Assignor's bank	No	Digits or blanks
15	121–125	5	Assignor's branch	No	Digits or blanks
16	126–126	1	Branch check digit	No	Free
17	127–138	12	Assignor's checking account	No	Digits or blanks
18	139–139	1	Checking account check digit	No	Free
19	140–377	238	Blanks	Yes	Exactly 238 spaces
20	378–391	14	Original assignor's CPF/CNPJ	No	CNPJ with 14 characters, CPF with 11 digits + 3 spaces, or 14 spaces
21	392–438	47	Blanks	Yes	Exactly 47 spaces
22	439–444	6	Record sequential number	Yes	`000001`

Originator code (positions 27–46)

It is the identifier of the originator registered in the assignment configuration. A code that is not registered or that is linked to another configuration refuses the file with the message "O código do originador '…' não foi encontrado". Request the code in the assignor onboarding process.

Original assignor (positions 378–391)

A field specific to QI DTVM, which does not exist in the market layout. Use it when the instrument has already gone through a previous endorsement and you need to record the CNPJ/CPF of the original assignor. If it does not apply, leave it blank.

Detail Record

One record per instrument. The fields in bold are the ones that feed the asset created in the fund's portfolio.

#	Position	Len.	Field	Req.	Accepted content
1	001–001	1	Record identification	Yes	`1`
2	002–007	6	Grace date	No	`DDMMYY` or zeros
3	008–008	1	Interest type	No	`0` without correction, `1` fixed interest, `2` CDI, `3` IPCA-15, `4` IPCA, `5` IGPM, or blank
4	009–010	2	Blanks	Yes	2 spaces
5	011–020	10	Interest rate	No	Digits (7 decimals) or 10 spaces
6	021–022	2	Co-obligation	Yes	`01` with co-obligation, `02` without co-obligation
7	023–024	2	Special characteristic (SCR)	No	Annex 8 of SCR 3040, `00` or blanks
8	025–028	4	Operation modality (SCR)	Conditional	Annex 3 of SCR 3040. It can be left blank for duplicatas and CT-e
9	029–030	2	Operation nature (SCR)	No	Annex 2 of SCR 3040, `00` or blanks
10	031–034	4	Source of funds (SCR)	No	Annex 4 of SCR 3040, `0000` or blanks
11	035–036	2	Risk class (SCR)	No	`AA`, `A`…`H`, `HH`, `01`, `00` or blanks
12	037–037	1	Zeros	No	`0` or blank
13	038–062	25	Participant's control number	Yes	Unique identifier of the asset in your system. Left-aligned
14	063–065	3	Bank number	No	Digits or blanks
15	066–070	5	Zeros	No	Zeros or blanks
16	071–081	11	Identification of the instrument at the bank	No	Digits or 11 spaces
17	082–082	1	Check digit of the "nosso número"	No	Free
18	083–092	10	Paid value	No	Zeros in the assignment
19	093–093	1	Slip issuance condition	No	Blank
20	094–094	1	Slip for automatic debit	No	Blank
21	095–100	6	Settlement date	No	Zeros in the assignment
22	101–104	4	Identification of the bank's operation	No	4 spaces or `0000`
23	105–105	1	Credit apportionment indicator	No	Blank or `0`
24	106–106	1	Debit notice addressing	No	Blank
25	107–108	2	Blanks	No	2 spaces or `00`
26	109–110	2	Occurrence identification	Yes	See Occurrences
27	111–120	10	Document number	Yes	Number of the instrument/duplicata. Exactly 10 characters
28	121–126	6	Maturity date	Yes	`DDMMYY`
29	127–139	13	Face value	Yes	Nominal value of the instrument, 2 decimals
30	140–142	3	Bank in charge of the collection	No	Digits, zeros or blanks
31	143–147	5	Depositary branch	No	5 digits, `00000` or blanks
32	148–149	2	Instrument kind	Yes	See Instrument kinds
33	150–150	1	Identification	No	Blank
34	151–156	6	Issue date of the instrument	Yes	`DDMMYY`
35	157–158	2	1st instruction	No	`00`
36	159–159	1	2nd instruction	No	`0`
37	160–161	2	Person type of the assignor	Yes	`01` natural person, `02` legal entity
38	162–173	12	Interest/late fee per day of delay	No	12 alphanumeric characters or 12 spaces
39	174–192	19	Assignment term number	No	Free or blanks
40	193–205	13	Present value (acquisition)	Yes	Value paid by the fund for this instrument, 2 decimals
41	206–218	13	Rebate value	No	Zeros or digits
42	219–220	2	Drawee's registration type	Yes	`01` natural person (CPF), `02` legal entity (CNPJ)
43	221–234	14	Drawee's registration number	Yes	CNPJ with 14 positions; CPF with 11 digits right-aligned. The check digit is verified
44	235–274	40	Drawee's name	Yes	It cannot be left blank
45	275–314	40	Drawee's address	Yes	It cannot be left blank. E.g.: `AV EXEMPLO, 100`
46	315–323	9	Invoice number	Conditional	Required for duplicatas and CT-e
47	324–326	3	Invoice series	No	3 alphanumeric characters or 3 spaces. When blank it assumes `1`
48	327–334	8	Drawee's postal code	Yes	8 digits, without a hyphen
49	335–394	60	Assignor	Yes	`335–380` assignor's name (46) · `381–394` assignor's CNPJ (14)
50	395–438	44	NF-e access key	Conditional	44 digits. Required for `duplicata_mercantil` and `cte` in occurrences `01`, `81` and `84`
51	439–444	6	Record sequential number	Yes	Sequential number of the line, starting at `000002`

Trailer Record

#	Position	Len.	Field	Req.	Accepted content
1	001–001	1	Record identification	Yes	`9`
2	002–438	437	Blanks	Yes	Exactly 437 spaces
3	439–444	6	Record sequential number	Yes	Number of the last line of the file

Accepted occurrences

The occurrence (positions 109–110) says what to do with the instrument.

Code	Meaning	When to use
`01`	Remittance — acquisition of instruments	The assignment default. It is what you use in almost every case
`80`	Remittance — acquisition with settlement to the consultancy	Treated as an acquisition
`81`	Entry by exchange of instruments, with settlement to the consultancy	Counterpart of a repurchase within the same file
`84`	Entry by exchange of instruments, with settlement to the assignor	Counterpart of a repurchase within the same file
`72`	Partial repurchase	Only in a substitution batch. It generates an amortization of the repurchased asset
`74`	Settlement by repurchase	Only in a substitution batch. It generates a settlement of the repurchased asset

A repurchase requires a substitution batch

The 72 and 74 occurrences are only accepted when the assignment configuration is of the substitution type and the batch was created with assignment_type: substitution_assignment. In a regular batch, the file is refused with the message "A ocorrência de recompra '…' só é permitida em configurações de cessão de recompra (substituição)".

Settlement occurrences do not go here

Codes such as 04, 14, 75 and 77 belong to the settlement file and are processed by another flow. Sending them in an assignment file makes the asset fail in the processing, even if the line passes the structure validation. See Settlement by File.

Instrument kinds

The instrument kind, in positions 148–149, defines how the instrument is read. These codes are processed in the assignment-by-file flow:

Code	Kind	Asset type	Invoice	NF-e access key	Example
`01`	Duplicata	`duplicata_mercantil`	Required	Required	Download
`14`	Service duplicata	`duplicata_servicos`	Required	Waived	Download
`53`	CT-e	`cte`	Required	Required	Download
`51`, `52`, `87`	Check	`check`	—	Waived	—
`02`, `06`	Promissory note	`promissory_note`	—	Waived	—

For checks and promissory notes, the instrument number is the Document number (positions 111–120) and the issue date is the one in positions 151–156. The bank (063–065) and the branch (143–147), when filled in, are also carried over to the instrument: use them for checks and leave them blank or zeroed for promissory notes, which do not accept these fields and would have the asset refused.

Other codes pass the structure check, but are not processed

The CNAB 444 layout provides for other kinds — 41 digital CCB, 60 contract, among others. They pass the structural validation of the file, but they are not converted into an asset in the assignment-by-file flow: the processing returns "Asset type … was not expected" and the batch does not advance.

If your product uses one of these kinds, assign through the integration API, asset by asset, or confirm the path with integracao.dtvm@qitech.com.br before assembling the file.

The kind must match the assignment configuration

A duplicata_mercantil configuration expects kind 01. Sending a kind incompatible with the asset type of the configuration makes the asset be refused at insertion.

Mapping: from the CNAB to the asset in the portfolio

Each detail line becomes an asset identical to the one that would be created by the Asset Creation — Duplicata endpoint (or CTE).

Position in the CNAB	Asset field (API)
038–062 Participant's control number	`discounted_credit_right.external_id` and `participant_control_number` — it is what the asset is referenced by afterwards, including in the settlement
111–120 Document number	`discounted_credit_right.order_number` — it identifies the line within the file and cannot be repeated
121–126 Maturity date	`discounted_credit_right.maturity_date`
127–139 Face value	`discounted_credit_right.face_value`
148–149 Instrument kind	`asset_type`
151–156 Issue date	`discounted_credit_right.invoice.issue_date`
193–205 Present value	`total_purchase_value`
219–220 / 221–234 Drawee	`borrower.person_type` and `borrower.document_number`
235–274 Drawee's name	`borrower.name`
275–314 Drawee's address	`borrower.address.street` and `number`
315–323 / 324–326 Invoice	`invoice.number` and `invoice.serie`
327–334 Postal code	`borrower.address.postal_code`
395–438 NF-e access key	`invoice.access_key`
Header 027–046 Originator code	`originator_document_number`
Header 378–391 Original assignor	`original_assignor_document_number`

Drawee's address

The street and the number are extracted from the text in positions 275–314, and the rest of the address (neighborhood, city and state) is completed automatically from the postal code. Write it in the LOGRADOURO, NUMERO format (street, number).

Commented example

Assignment of two commercial duplicatas of the assignor 11.222.333/0001-81, maturing on 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

Line	Reading
Header	Originator `00000011222333000181`, file generated on 12/08/2025, system `MX`
Detail 1	Asset `CTRL000001`, document `0001000010`, matures on 10/10/2025, face R$ 1,510.00, acquisition R$ 1,480.00, drawee CNPJ `45.678.912/0001-55`
Detail 2	Asset `CTRL000002`, document `0002000020`, face R$ 1,520.00, acquisition R$ 1,490.00, drawee CNPJ `78.912.345/0001-09`
Trailer	Closes the file with the sequential number `000004`

Example files

File	Kind	What it carries
Commercial duplicata	`01`	Two instruments with the invoice and the NF-e access key filled in
Service duplicata	`14`	Two instruments with the invoice and without the NF-e access key
CT-e	`53`	Two transport bills with the access key filled in

About the examples

The three files pass our validation in full. The CNPJs are fictitious, but they have a valid check digit — if you replace them with "round" documents like 45678912000199, the file will be refused.

File structure​

File name​

General filling rules​

Header Record​

Detail Record​

Trailer Record​

Accepted occurrences​

Instrument kinds​

Mapping: from the CNAB to the asset in the portfolio​

Commented example​

Example files​

Checklist before sending​