信用权利转让手册
本手册描述了向 QI CTVM 管理的基金转让信用权利所涉及的步骤。此外，还解释了产品的业务规则以及集成合作伙伴需要注意的主要事项，以便实现更快速、更高效的集成。
前提条件
-
已签订转让合同，并已激活相应产品（参见**转让人同质化** API）；
-
只有基金管理员、合同中的转让人以及关联的发起人才能访问此服务。
-
已存储基金受让人的唯一标识键（fund_class_key）以及转让配置的唯一标识键（assignment_configuration_key）。
BASE_URL = "/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}"
BASE_URL 是本 API 所有端点使用的路径。
状态流程
转让流程有两个主要实体，其状态机之间存在关联。一方面是批次，称为 assignment；另一方面是资产，称为 asset。对于批次，其流程如下：
对于资产，流程如下：
集成摘要
总结而言，要完成资产入库，需遵循以下步骤：
- 创建批次；
- 插入资产；
- 结束资产插入；
- 资产资格审核 Webhook；
- 发送文件；
- 批次资格审核 Webhook；
- 管理员审批；
- 签署转让协议；
- 转让支付；
- 资产入库；
1 - 创建批次
**创建批次**仅需要集成合作伙伴系统生成的唯一标识符。该标识符将用于 Webhook 回调和其他功能路由（如下文所述）。
此标识符必须是唯一的，QI CTVM 系统不允许合作伙伴重复发送同一批次。
2 - 插入资产
插入资产是整个集成中最精细的过程。本节将解释资产创建所涉及的业务规则，包括与类型无关的规则以及特定类型的规则。
对于理解此 API，理解资产价值和资产购买价值的概念非常重要。为此，我们使用以下符号：
[A] 为资产购买价值，在对象根部提供，表示基金应为该资产支付的金额。
[B] 为操作溢价的总和。可通过将所提供的所有 premiums 中的 total_values 求和得出。
[C] 为操作折扣的总和。可通过将所提供的所有 deductions 中的 total_values 求和得出。
[D] 为资产价值，可通过以下公式推导：
2.1 - 与资产类型无关的规则
2.1.1 - 资产类型与转让配置的兼容性
每个转让配置对应唯一的资产类型。同一批次中永远不可能混合 CCB 和应收票据。激活产品生成的 assignment_configuration_key 包含特定资产类型，在给定配置中只接受该类型。 如果违反此规则，将返回以下错误：
Response Body
{
"code": "TRC000025"
}
2.1.2 - 向已完成批次插入
如果尝试将资产插入已关闭的批次，集成合作伙伴将收到以下错误：
Response Body
{
"code": "TRC000022"
}
2.1.3 - 邮政编码验证
操作借款人地址对象的邮政编码必须有效。因此，如果提供了不存在的邮政编码，请求将不被接受，并返回以下错误：
Response Body
{
"code": "TRC000070"
}
2.1.4 - External ID 唯一性
同一资产不能被合作伙伴转让两次。因此，如果该资产已存在于我们的数据库中且未被丢弃，将引发以下错误：
Response Body
{
"code": "TRC000054"
}
2.2 - 信贷操作规则
信贷操作是指那些源自借款人承诺的资产，借款人按一定利率借款，并按照特定流 程履行还款承诺。因此，这些资产始终有未偿本金和会增加该价值的利率。创建信贷操作所需的数据结构可在**此页面**找到。
2.2.1 - 资产价值与未偿本金不符
对于信贷操作，资产价值必须始终大于或等于未偿本金（信贷操作对象的 principal_value 字段）。与此业务规则相关的错误为：
Response Body
{
"code": "TRC000054"
}
2.2.2 - 发行价值与未偿本金不符
合同的发行价值必须始终大于或等于未偿本金。与此业务规则相关的错误为：
Response Body
{
"code": "TRC000054"
}
2.2.3 - 分期付款顺序
信贷操作的所有分期付款必须按到期日（maturity_date）升序排列，且编号（installment_number）连续。因此，如果流程从第1期开始，下一期必须是第2期，然后是第3期，以此类推。
与这些规则相关的错误分别为：
Response Body
{
"code": "TRC000054"
}
Response Body
{
"code": "TRC000054"
}
2.2.4 - 固定利率和浮动利率对象
根据操作的利率类型（interest_rate_type），需要提供固定和/或浮动利率对象。如果利率类型为固定利率，则只需要提供固定利率对象；而对于浮动利率，浮动利率对象为必填项，固定利率对象为可选项。例如，如果操作
3 - 结束资产插入
在批次的所有资产创建完成后，合作伙伴可以命令**结束资产插入**。这一步骤很重要，以便 QI CTVM 系统知道从此时起，当所有资产都经过资格审核并提供了所有文件后，可以对整个批次进行资格审核。
无需等待所有资产的 Webhook。当不再需要插入资产时，可以执行此命令。
4 - 资产资格审核 Webhook
随着资产被基金资格规则逐一分析，系统将逐个返回 Webhooks。这些 Webhooks 将通过合作伙伴在创建时提供的资产唯一标识符进行标识。
分析结果只有两种可能：资产通过或被拒绝。如果是前者，资产将继续其流程，等待文件插入；否则，它将进入已丢弃状态，不会进入后续步骤。
5 - 发送文件
当某一资产通过资格审核后，合作伙伴可以继续**插入产品所需的文件**。每个所需文件需要发送一个请求。内容将通过二进制文件的 Base64 编码传输，从而可以通过 JSON 完成，与我们系统的所有其他 API 一致。
注意，要执行此请求，除了文件的二进制内容外，还需要提供该文件的文档类型。只有提交了所有所需文件，资产才会继续流程。当这一切发生时，资产将进入预审批（pre_approved）状态。
所需文件取决于产品类型和基金章程。这可以通过获取转让合同的产品来获取，该产品已激活以获取该批次的 assignment_configuration_key。
无需已命令结束资产插入。如果想将发送文件的逻辑与接收 Webhook 关联，这完全可行且推荐。
6 - 批次资格审核 Webhook
一旦某个已结束资产插入的批次，且其所有资产都已被丢弃或预批准，它将进行整个批次的资格审核分析。即使所有资产都已被批准，整个批次也可能导致基金出现某种不合规情况。因此需要第二步进行资格审核。
与资产类似，资格审核可能产生两种结果：批准或拒绝。结果将通过 Webhook 通知，但这次以批次的 external_id 标识。
如果批次被拒绝，它将被丢弃，流程结束。否则，它将进入管理员分析和审批阶段。
7 - 管理员审批
管理员审批必须通过**特定请求或通过我们的门户**来完成。如果批次被拒绝，它将被丢弃，流程结束。否则，系统将生成转让协议并发送签署，将批次置于 pending_assignment_term_signature 状态，直到所有相关方签署文件。
8 - 签署转让协议
一旦签署，我们会发送一个 Webhook，通知协议已签署并应继续进行支付，因此进入 pending_payment 状态。
9 - 转让支付
此时，系统向转让人支付转让总金额，即所有未丢弃资产的 total_purchase_value 之和，支付到产品激活时提供的账户。一旦付款确认，我们发送一个 Webhook，资产开始入库。
10 - 资产入库
最后，一旦所有资产都被妥善入库，批次将变为 completed，从此时起，集成合作伙伴可以完全确认所有资产已妥善存入基金的库存中。