资产清算
本节介绍 QI DTVM 所管理的投资基金进行资产清算所使用的 API。通过这些 API，可以登记构成基金投资组合的资产的分期付款、摊销、回购及其他清算事件。
本节所述的资产清算仅适用于已纳入基金投资组合的信用权利（CCB、duplicata、合同等）。国债（Letras do Tesouro）、债券（Debêntures）及其他固定收益资产不适用此流程。
- 如需使用这些服务，请联系 integracao.dtvm@qitech.com.br 开通 Sandbox 和生产环境。
- 您需要
fund_class_key（基金的 key），它是该 API 所有端点 Base URL 的组成部分：
/settlement/fund_class/{fund_class_key}
如何提交注销
| 方式 | 运作方式 | 位置 |
|---|---|---|
| 通过 API，逐笔清算 | 创建付款批次、每笔清算一个请求、关闭批次。即本节详述的流程 | 集成 API |
| 通过文件 | 一个文件包含所有清算：CNAB 444 或 CSV | 管理人/顾问门户 |
如果您已从收款银行收到 CNAB 回执文件，可以直接上传该文件。参见通过文件注销和 CNAB 444 格式——注销。
清算流程
下图展示了主流程、分支以及每个步骤产生的状态。将鼠标悬停在节点上可查看端点，点击可打开对应文档。
承载所有将一并处理的清算的容器，由唯一的 external_id 标识。
/settlement/fund_class/{fund_class_key}/payment_batch每笔清算一个请求，需提供资产类型、金额、清算类型和标识。
.../payment_batch/{external_id}/settlement设置 batch_status。批次中至少需要插入一笔清算。
.../payment_batch/{external_id}不处理任何清算，也不产生任何资金变动。流程结束。
QI Tech 确认付款。自此事件起，开始处理各笔清算。
Ver documentação →每笔清算都会在基金投资组合中完成对账，并通过 webhook 单独通知。
Ver documentação →所有清算均已达到最终状态，批次周期结束。
Ver documentação →所有状态转换、webhook 的 payload 以及异常路径，参见资产清算流程。
操作步骤
1. 创建付款批次
创建付款批次，并提供唯一标识（external_id）。该批次将作为所有一并处理的清算的容器。
如需核对已创建的批次，请使用批次查询。
2. 插入清算
将清算添加到已创建的批次中。每笔清算都必须单独插入，并提供资产类型、金额、清算类型以及所需的标识。
没有用于移除单笔清算的端点。如果误插入了某笔清算，请在关闭时废弃该批次并新建一个批次。如需核对已插入的清算，请使用清算查询。
3. 关闭批次
插入所有清算后，关闭批次以启动内部处理。现金对账和资产组合更新将自动完成。也可以通过同一端点废弃整个批次——此时不会处理任何清算。
4. 通过 Webhook 跟踪
通过以下 webhook 跟踪进度：
- 付款批次 webhook——批次状态通知。
- 清算 webhook——每笔清算的单独状态通知。
批次关闭后，现金对账流程和资产组合更新由 API 自动完成。