跳到主要内容

信用权利转让手册

本手册介绍向 QI DTVM 所管理基金转让信用权利的操作步骤、产品的业务规则，以及加快集成的注意事项。每次调用的接口契约（字段、响应和错误）见各步骤中链接的参考页面。

前提条件​

  1. 已签订转让合同并已启用相应产品——参见转让方准入。
  2. 以合同中的管理人、顾问或转让方身份访问。各角色可调用的内容见每个参考页面中的适用范围区块。
  3. 受让基金的 key（fund_class_key）和转让配置的 key（assignment_configuration_key），它们构成所有调用的路径：
/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}

基金的转让配置可在转让配置列表中查询。

状态流程​

转让流程包含两个实体，各自具有相互关联的状态机：批次（assignment）和其中的资产（asset）。

转让批次状态流程，从 pending_assets_insertion 到 completed，以及转向 denied 和 discarded 的分支

批次——蓝色 = 会发送 webhook 的状态 · 虚线 = 不发送 webhook 的状态 · 绿色 = 转让完成 · 红色 = 拒绝或废弃。

资产状态流程，从 pending_eligibility 到 completed，以及转向 denied、registry_denied 和 discarded 的分支

资产——蓝色 = 中间状态 · 绿色 = 资产已纳入投资组合 · 红色 = 拒绝或废弃。

完整的状态列表参见批次状态枚举值和资产状态枚举值。

集成概要​

  1. 创建批次。
  2. 插入资产。
  3. 提交文件。
  4. 结束插入。
  5. 资产和批次的合格性审查（自动，带 webhook）。
  6. 配置要求时，由顾问和/或管理人审批。
  7. 签署转让协议书、付款和纳入投资组合（自动，带 webhook）。

1. 创建批次​

使用 POST .../assignment 创建批次——参见创建转让批次。只需提供在您系统中生成的标识 external_id，后续调用和 webhook 都会使用它。

批次的 external_id 在整个平台中唯一：使用相同值第二次创建会被拒绝。如发生错误，请重发请求：如果批次已存在，请查询它。

2. 插入资产​

使用 POST .../assignment/{assignment_external_id}/asset 插入资产，每个资产一个请求。请求体取决于资产类型：CCB、duplicata、CT-e、贴现合同和分期合同。也可以通过文件转让整个批次。

资产价值与购买价值​

为便于理解金额校验，使用以下记号：

  • [A]——资产的购买价值（对象根部的 total_purchase_value）：基金为该资产支付的金额；
  • [B]——溢价之和（premiums 中每一项的 total_value）；
  • [C]——折价之和（deductions 中每一项的 total_value）；
  • [D]——资产价值，计算方式为 [D] = [A] − [B] + [C]。

资产价值 [D] 会与所提供的分期现金流进行核对。存在差异时，插入会被拒绝，错误代码见各资产类型页面的错误部分。

适用于所有类型的规则​

  • 配置的资产类型。 每项转让配置只接受一种资产类型；例如，不能在同一批次中混合 CCB 和 duplicata。
  • 批次处于开放状态。 只有当批次处于 pending_assets_insertion 时才能插入资产。
  • 资产的 external_id。 在批次内唯一：同一批次中使用相同 external_id 的第二个资产会被拒绝。如发生错误，请重发请求。
  • 发起人。 originator_document_number 必须属于已在 QI Tech 登记的发起人，且格式与登记时一致；否则插入会返回 TRC000019。

信贷业务​

信贷业务（CCB）具有未偿本金和利率。分期必须按到期日（maturity_date）升序排列，且 installment_number 连续。根据利率类型，提供固定利率和/或浮动利率对象。详见插入 CCB。

3. 提交文件​

使用 POST .../asset/{asset_external_id}/document 提交每项资产的文件，每个请求一份，以 Base64 编码——参见插入资产文件。可以在插入资产后立即提交，无需等待 pending_documentation webhook。

所需文件取决于产品，见转让配置的 required_documents 和 after_assignment_required_documents 字段。只有在所有所需文件都已提交并通过校验后，资产才会达到 pre_approved。

4. 结束插入​

不再插入资产时，使用 PUT .../assignment/{assignment_external_id} 并设置 assignment_status = completed_assets_insertion 结束插入——参见结束资产插入。

无需等待所有资产的 webhook。只有当所有资产的审查都完成后，批次才会进入合格性审查。

5. 资产和批次的合格性审查​

每项资产都会按基金的合格性规则进行审查，结果通过资产 webhook 发送，并以资产的 external_id 标识。审批通过的资产继续流程；被拒绝的资产进入 denied，不计入批次。

所有资产审查完成后，整个批次进行合格性审查：即使所有资产都审批通过，批次仍可能导致基金不符合投资限制。结果通过批次 webhook 发送，并以批次的 external_id 标识。被拒绝的批次进入 denied。

6. 审批​

如果转让配置要求人工审批，批次在作出决定前处于 pending_consultant_approval 和/或 pending_manager_approval，决定通过 PUT .../assignment/{assignment_external_id} 作出——参见批次审批——或在 Portal do Gestor 中作出。如需在审批前移除资产，请参见从批次中移除资产。

如为自动审批，批次无需任何操作即可继续。

7. 转让协议书、付款与纳入投资组合​

审批通过后，资产完成登记和正式化，生成转让协议书并发送签署（pending_assignment_term_signature）——可在转让文件中查询。

协议书签署后，向转让方在批次的放款账户中付款（pending_payment）。金额为未被拒绝资产的 total_purchase_value 之和。付款确认后，资产纳入投资组合（pending_assets_wallet_inclusion），最后批次变为 completed：此后所有资产均计入基金持仓。

替换批次​

在回购配置下创建的批次中，还需使用 POST .../assignment/{assignment_external_id}/repurchased_asset 插入转让方将要回购的资产——参见插入回购资产。被回购资产的金额会从付款中扣除。