信用权利转让
本节介绍向 QI DTVM 所管理的投资基金转让信用权利所使用的 API。流程涵盖从创建转让批次到将资产纳入基金投资组合的全过程。
如需深入了解业务规则和产品，请参见信用权利转让手册。建议与本节提供的路由结合阅读。
- 如需使用这些服务，请联系 integracao.dtvm@qitech.com.br 开通 Sandbox 和生产环境。
- 您需要
fund_class_key（基金的 key）和assignment_configuration_key（转让配置的 key），可在转让方准入中获取。 - 如需查询可用的转让配置，请使用转让配置列表端点。
如何提交转让
有两种方式，最终结果相同。每个批次选择一种——同一批次中不能混用两种方式。
| 方式 | 运作方式 | 位置 |
|---|---|---|
| 通过 API，逐个资产 | 创建批次、每个资产一个请求、结束插入。即本节详述的流程 | 集成 API |
| 通过文件 | 一个文件包含批次中的所有资产：duplicata、CT-e、支票和本票使用 CNAB 444，CCB、律师费和分期合同使用 CSV | 管理人/顾问门户；管理人 API |
duplicata 的格式为 CNAB 444；CSV 适用于信贷业务（CCB）、律师费和分期合同。参见通过文件转让、CNAB 444 格式——转让和 CSV 格式——分期合同，均附有可下载的示例。
转让流程
下图展示了主流程、分支以及每个步骤产生的状态。将鼠标悬停在节点上可查看端点，点击可打开对应文档。
承载所有将转让给基金的资产的容器，由唯一的 external_id 标识。
/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment每个资产一个请求，包含交易信息、分期和付款人数据。
.../assignment/{assignment_external_id}/asset只有在提交了产品要求的所有文件后，资产才会在流程中继续推进。
.../asset/{asset_external_id}/document表明所有资产均已插入，并使批次进入合格性审查。
.../assignment/{assignment_external_id}先逐一审查每项资产，再审查整个批次。被拒绝的资产不会保留在批次中。
Ver documentação →资产或批次未通过合格性审查，或管理人拒绝了该批次。流程结束。
仅当转让配置要求时才为人工步骤。否则为自动审批，无需任何操作。
.../assignment/{assignment_external_id}批次审批通过后，生成转让协议书并由各方签署。
Ver documentação →转让款项支付给转让方。
Ver documentação →资产进入基金投资组合，批次周期结束。
Ver documentação →所有状态转换、webhook 的 payload 以及异常路径，参见转让流程。
操作步骤
1. 创建批次
创建转让批次，并提供唯一标识（external_id）。该批次将作为所有转让给基金的资产的容器。
2. 插入资产
将资产（CCB、duplicata、分期合同等）添加到已创建的批次中。每项资产都必须单独插入，并包含其交易信息、分期和付款人数据。
3. 提交文件
为每项已插入的资产提交产品要求的文件（合同、发票等）。只有在提交了所有要求的文件后，资产才会在流程中继续推进。
4. 结束插入
表明所有 资产均已插入批次。系统会等待每项资产的单项审查完成，再进行整个批次的合格性审查。
5. 审批
批次合格性审查通过后，批次进入审批。根据转让配置，该步骤可以是人工的——由基金顾问和/或管理人审查并审批通过或拒绝该批次，批次在作出决定前处于 pending_consultant_approval / pending_manager_approval——也可以是自动的，集成方无需任何操作。审批通过后，将自动生成转让协议书。
6. 签署、付款与纳入投资组合
最后的步骤均自动完成：各方签署转让协议书，向转让方付款，资产纳入基金投资组合。可通过批次 webhook跟踪进度。
替换批次
替换流程与转让流程的步骤相同，但多一个步骤：在同一批次中插入将由 转让方回购的资产——插入回购资产。批次开放期间，回购资产和新资产可按任意顺序插入；结束插入时，批次中至少要有一项回购资产，且新资产的价值不得低于回购资产的价值。