资产回购与出售
本节介绍用于出售和回购已纳入 QI CTVM 所管理基金投资组合的信用权利的 API。该流程涵盖从创建批次到将资产从基金投资组合中注销的全过程。
该服务仅将资产从基金投资组合中注销，不会向其他管理机构发送数据。
该服务有两个基本概念：批次（assignment）和资产（asset）。一个批次由一个或多个资产组成，插入的每个资产都必须已经存在于基金的投资组合中。
- 如需访问这些服务，请联系 integracao.dtvm@qitech.com.br，以便在同质化（Sandbox）环境和生产环境中获得相应权限。
- 您需要
fund_class_key（基金密钥），它构成本 API 所有端点的基础 URL；以及assignment_configuration_key（配置密钥），在创建批次时提供：
/trade_resolve/fund_class/{fund_class_key}
出售/回购流程
下图展示了主路径、分支以及每个步骤产生的状态。将鼠标悬停在节点上可查看端点，点击可打开该步骤的文档。
需提供唯一的 external_id、操作日期，以及向基金付款的账户。
/trade_resolve/fund_class/{fund_class_key}/assignment每个资产一次请求，使用该资产入库时所用的同一个 external_id 标识。该资产必须在投资组合中处于有效状态。
.../assignment/{external_id}/asset当售价与公允会计价值偏差超过 5% 时，资产将被暂缓，需要明确确认。该端点尚未提供文档 — 请与 integracao.dtvm@qitech.com.br 确认。
批次中至少需要有一个未被丢弃的资产。您可以提供 number_of_assets 和 total_value 让 API 核对总数。
.../assignment/{external_id}在关闭批次之前可以丢弃。一旦条款进入流转，批次便无法再被丢弃。
内部条款：由 QI Tech 生成文件并收集签署。外部条款：由集成方提交已签署的条款。
条款签署完成后，QI Tech 会在基金账户中登记付款预期。
款项确认后，资产将逐个注销。全部完成后，批次结束。
分步说明
1. 创建批次
创建批次时需提供唯一标识符（external_id）、操作日期，以及向基金付款的账户。批次的初始状态为 pending_assets_insertion，它是所有待注销资产的容器。
2. 插入资产
每次请求插入一个资产，并使用该资产入库时所用的同一个 external_id 进行标识。插入时该资产必须在基金投资组合中处于有效状态。
如果所提供的售价与资产的公允会计价值偏差超过 5%，该资产不会自动继续流转：它将停留在 pending_validation 状态，需要集成方明确确认后才能进入注销环节。偏差在 5% 以内的资 产将直接进入 pending_wallet_sale。
确认端点目前尚未在本节中提供文档 — 如果您的流程可能产生超过 5% 的偏差，请与 integracao.dtvm@qitech.com.br 确认具体操作方式。
3. 关闭批次
插入所有资产后，关闭批次。批次中至少需要有一个未被丢弃的资产。您还可以选择性地提供 number_of_assets 和 total_value，以便 API 在接受关闭请求前核对合并后的资产数量与总金额。
在此步骤之前可以丢弃批次：一旦条款进入流转，批次便无法再被丢弃。
4. 回购条款
回购条款由谁出具取决于批次的配置：
- 内部条款 — 由 QI Tech 生成条款并收集各方签署，集成方无需任何操作。
- 外部条款 — 批次进入
pending_signed_term_submission状态，集成方需提交已签署的条款，流程才能继续。
两种情况下，条款签署完成后批次都会进入 pending_payment，等待款项入账至基金账户。
5. 付款与资产注销
最后的步骤为自动执行：QI Tech 确认款项已入账至基金账户，资产从投资组合中注销；当所有资产处理完毕后，批次以 completed 状态结束。