通过 CNAB 发行票据

通过 CNAB 发行票据，需要将 CNAB 文件发送至 /multibank_cnab 端点。

认证

需要使用 JWT 令牌进行认证，更多详情请查阅认证文档。

请注意，CNAB 端点的认证方式与其他端点不同：

请求的 Content-Type 应为 multipart/form-data
上传的文件应置于 file 字段中

QI Tech 400 位 CNAB 布局

下方提供了 QI Tech 400 位 CNAB 布局供参考：

CNAB 400 位布局

文件头部记录（Header de Arquivo）— 类型 0

位置	长度	格式	描述
1	1	N	记录代码 = 0
2-3	2	N	记录类型 = 01
4-9	6	N	字面量（保留）
10-10	1	A	服务类型标识符
11-26	16	A	字面量
27-46	20	AN	企业名称
47-76	30	AN	银行名称
77-79	3	AN	银行编号
80-94	15	AN	企业代码（账户标识）
95-100	6	N	文件创建日期 (DDMMAA)
101-394	294	A	保留字段（空格）
395-400	6	N	顺序编号

批次指令记录（Registro de Detalhe de Instrução）— 类型 1

位置	长度	格式	描述
1	1	N	记录代码 = 1
2-21	20	AN	账户标识
22-22	1	N	税务标识类型
23-36	14	N	税务标识号码（CPF/CNPJ）
37-62	26	AN	指令类型代码
63-70	8	N	到期日 (DDMMAAAA)
71-83	13	N	金额（分）
84-86	3	N	银行代码
87-91	5	N	机构（AGencia）
92-92	1	A	机构验证位
93-102	10	AN	我们的号码
103-107	5	N	钱包号码
108-108	1	N	指令标识符
109-110	2	N	指令代码 1
111-122	12	N	指令日期/值 1
123-124	2	N	指令代码 2
125-136	12	N	指令日期/值 2
137-146	10	N	到期日（DDMMAAAA + 2 位）
147-156	10	AN	账号
157-157	1	AN	账号验证位
158-162	5	N	我们的号码（NOSSO_NUMERO）
163-173	11	N	金额（厘）
174-175	2	N	指令代码
176-179	4	N	减免天数
180-192	13	N	减免金额（分）
193-205	13	N	折扣金额（分）
206-218	13	N	罚款金额（分）
219-220	2	N	罚款代码
221-234	14	N	付款人 CPF/CNPJ
235-274	40	AN	付款人姓名
275-314	40	AN	付款人地址
315-326	12	AN	付款人城市
327-328	2	A	付款人州
329-336	8	N	付款人邮政编码
337-394	58	AN	背书人/保证人姓名
395-400	6	N	顺序编号

Request

ENDPOINT

/multibank_cnab

MÉTODO

POST

请求内容类型为 multipart/form-data，将 CNAB 文件放在 file 字段中上传。

Response

STATUS

200

Response Body

{
  "file_info": {
    "beneficiary_code": "329-01-0001-0000001",
    "beneficiary_name": "Greg Brown",
    "file_sequence_id": "00001",
    "file_type_identifier": "1",
    "file_type_literal": "REMESSA",
    "service_code": "01",
    "service_literal": "COBRANÇA",
    "wrote_at": "2020-05-15"
  },
  "occurrence_stats": {
    "bank_slip_edit": 0,
    "bankruptcy_protest_request": 0,
    "cancel_rebate": 0,
    "extension": 0,
    "notary_office_entry": 0,
    "notary_office_exit": 0,
    "notary_office_payment": 0,
    "notification": 0,
    "payment": 0,
    "payment_notice": 0,
    "payment_write_off": 0,
    "protest_cancel_and_write_off_request": 0,
    "protest_cancel_request": 0,
    "protest_remove_request": 0,
    "protest_request": 0,
    "rebate": 0,
    "registration": 1,
    "write_off": 0
  },
  "semantic_errors": []
}

认证​

QI Tech 400 位 CNAB 布局​

Request​

Response​

认证

QI Tech 400 位 CNAB 布局

Request

Response