跳到主要内容

汇款文件(CNAB)- 简介

信息

本次调用传输的文件必须遵循 QI Tech 400 位收款文件布局标准。 手册下载链接:收款布局 - QI Tech 版本 2.1.

汇款文件(CNAB)提供了在单个文件中发送多条票据登记指令以及其他类型指令(延期、减免、核销等)的可能性,这些指令可针对不同的票据。发送上述指令(延期、减免等)用于已有票据时,票据通过钱包代码(requester_profile_code)和我方号码(our_number)进行识别。

上传 CNAB 文件后,若请求成功(响应代码 202),将创建一个临时 CNAB 文件(TemporaryCNABFile)。可以使用临时 CNAB 文件查询其记录端点来查看文件处理状态以及可能的错误(包括文件本身及其记录的错误)。

如果发现任何语法错误,文件将被拒绝。但文件将被完整读取,或读取至发现 100 个错误为止,以便能够以更实用、高效的方式返回并修正所有错误。

文件读取时会创建临时记录,只有在文件被接受时才会处理这些记录。也就是说,如果文件被拒绝(状态为 rejected),其所有记录也将被拒绝。此外,文件被拒绝后,将不再为其创建临时记录。因此,被拒绝文件的记录条目通常少于文件中发送的记录数量。

另一方面,当文件被完整读取并接受(状态为 read)时,将开始创建最终记录,这些记录将是实际生效的指令。如果临时记录显示状态为 rejected(已拒绝),则表示其中存在语义错误——即内容错误。此时,将附带一个 error_data 对象,提供拒绝原因的详细信息。反之,如果状态为 processed,则表示最终记录已创建并发送至 CIP/Núclea。有关这些实体的更多详情,请参阅后续关于查询文件和临时记录的页面。

通过 CNAB 进行信用分账

在 CNAB 文件中提供信用分账(分账支付)信息:

  • QI SCD(CNAB400 - QI Tech v2.1 布局): 明细记录中 identificacao_registro = 3。完整细节请参阅 收款布局 - QI Tech v2.1
  • Bradesco(CNAB400 与 CNAB240): 明细记录类型 3
  • Itaú(CNAB400 与 CNAB240): 明细记录类型 4
  • Santander: 不支持通过 CNAB 进行信用分账。请使用 REST 接口信用分账更新,或在通过 API 发行时携带 split_payment_data

如何映射 N 个分账账户: 每条分账记录可包含最多 3 个附加账户(账户号 + 校验位 + 百分比)。如需超过 3 个分账账户,可在 Boleto 主记录之后按顺序添加多条分账记录——它们将累积到同一笔记录中。例如:7 个账户 = 3 条记录(3 + 3 + 1)。

限制(所有银行):

  • 仅支持百分比计算方式(计算代码 = 2)。
  • 各百分比之和(受益人 + 分账)必须正好等于 100
  • 分账账户总数遵循 REST API 的相同限制(最多 10 个附加账户)。
  • beneficiary_max_amount(受益人最高金额、超出部分分配给第一条规则的分账模式)仅支持 REST API,不支持通过 CNAB 设置。如需此场景,请使用 REST 接口发行信用分账更新