跳到主要内容

插入资产文件

用于为转让批次中的资产提交所需文件的端点。文件以 Base64 编码，每个请求一份文件。

适用范围
角色主机所需权限
管理人manager-api写入
顾问consultant-apiBatches
转让方assignor-api写入

各主机的 Base URL：环境（主机）。

我在流程中的哪一步？

您可以在插入资产后（状态 pending_eligibility）立即提交文件，也可以在收到 pending_documentation webhook 后提交——该 webhook 表示资产已通过合格性审查，正在等待文件。因文件被拒绝的资产（denied 且 denied_by = document）在收到新文件后会回到 pending_documentation。

需要提交哪些文件？

所需类型按产品定义，见转让配置中的 required_documents（转让前）和 after_assignment_required_documents（转让后）字段。只接受这些类型。

  • 商业 duplicata（duplicata_mercantil）：无需提交文件——QI Tech 根据发票数据生成 duplicata 文件。调用会被接受并返回 document_key，但不会存储任何内容。
  • 分期合同（contract）：参见分期合同应提交哪份文件。

只有在所有所需文件都已提交并通过校验后，资产才会进入 pre_approved。

文件格式

PDF、P7S 或 XML 格式的文件，以 Base64 编码，最大 10 MB。其他格式会被拒绝并返回 TRC000166。

Request​

ENDPOINT
/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment/{assignment_external_id}/asset/{asset_external_id}/document
MÉTODO
POST

Path params​

参数类型描述
fund_class_keystring基金的唯一 key（UUID）。
assignment_configuration_keystring转让配置的 key（UUID）。
assignment_external_idstring批次的外部标识，在创建批次时提供。
asset_external_idstring创建资产时提供的 external_id。
Request Body
{
    "document_type": "ccb",
    "document_b64": "aGVsbG8gd29ybGQgaWYgeW91IGRlY29kZWQgbWUsIGJlIGNhcmVmdWwuIEl0IG11c3QgYmUgYSBQREYgRmlsZSBvdGhlcndpc2UgSSB3aWxsIHJhaXNlIGFuIEVycm9yLg=="
}

请求体属性​

字段类型是否必填描述
document_typestring必填所提交文件的类型。可接受的值为所用转让配置中配置的值——见下方枚举值。
document_b64string必填以 Base64 编码的文件内容（PDF、P7S 或 XML；最大 10 MB）。

document_type 的值（仅当列于转让配置中时接受）：

值描述
ccb银行信贷凭证（Cédula de Crédito Bancário）——CCB 类资产。
duplicata_servicos服务 duplicata。
invoice发票。
cte电子运输单据（Conhecimento de Transporte Eletrônico）。
discounted_contract贴现合同。
contract被转让的分期合同本身（即资产），而不是转让合同。
legal_fees_contract律师费合同。
check支票。
promissory_note本票。
disbursement_receipt放款凭证。
vehicle_reservation_receipt车辆保留凭证——带车辆担保的业务。属于转让后文件。

分期合同应提交哪份文件​

对于 document_type contract，请提交被转让的合同：即发起人与债务人之间签订的、包含创建资产时所提供分期信息的文书。它是该资产的底层凭证。

请勿在此提交转让合同或转让协议书。这些文件用于正式确认资产向基金的转移，在转让文件中有专门的流程。

每项资产接收一份包含其自身合同的 PDF。在包含三份合同（A、B 和 C）的批次中，请提交三个文件：合同 A 提交到资产 A，B 提交到资产 B，C 提交到资产 C。不要将多份合同合并到同一个 PDF 中。每项资产的每种类型只接受一份文件；为同一资产再提交一份 contract 会返回 TRC000035，除非之前的文件已被拒绝。

两个提交文件的时点

该端点服务于流程中两个不同的时点，两者之间唯一的区别是资产的状态：

  • 转让之前。 资产通过单项合格性审查后进入 pending_documentation，等待产品配置为必需的文件。全部提交后，进入 pre_approved。
  • 转让之后。 如果转让配置要求转让后文件，资产会在批次清算后进入 pending_after_assignment_documentation。带车辆担保业务的车辆保留凭证（vehicle_reservation_receipt）即在此时提交。全部提交后，资产进入 completed，如您订阅了该状态，还会发送资产的 completed webhook。也可以通过资产查询跟踪。

每个时点所需的文件列表按产品定义，见转让配置响应中的 required_documents（转让前）和 after_assignment_required_documents（转让后）字段。发送未为该转让配置的 document_type（包括不存在的值）会返回 TRC000032。

Response​

STATUS
201
Response Body
{
    "document_key": "8e515a17-8b4d-49a3-aed6-47c9574e426a"
}

响应属性​

字段类型描述
document_keystringQI Tech 生成的文件唯一标识（UUID）。

错误​

状态码代码触发条件
400TRC000032document_type 不在转让配置的 required_documents 或 after_assignment_required_documents 中（包括不存在的值）。
400TRC000034document_b64 不是有效的 Base64。
400TRC000155文件超过 10 MB。
400TRC000166格式不被接受。可接受的格式：PDF、P7S 和 XML。
404TRC000020批次中没有使用该 asset_external_id 的资产。
409TRC000026资产所处状态不接收文件（pending_eligibility、pending_documentation、因文件被 denied 或 pending_after_assignment_documentation）。
409TRC000035该资产已有一份此类型且未被拒绝的文件。
409TRC000162批次处于 denied 或 discarded。

认证、权限和主机相关错误：参见 API 错误。

后续步骤​

提交所有所需文件后，流程继续：

  1. 结束插入——表明所有资产均已插入，以便批次进入合格性审查。