跳到主要内容

汇款文件(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。有关这些实体的更多详情,请参阅后续关于查询文件和临时记录的页面。