跳到主要内容

资产回购与出售

本节介绍用于出售和回购已纳入 QI DTVM 所管理基金投资组合的信用权利的 API。流程涵盖从创建批次到将资产从基金投资组合中注销的全过程。

背景

该服务仅将资产从基金投资组合中注销，不会向其他行政管理人发送数据。

有两个基本概念：批次（assignment）和资产（asset）。一个批次由一个或多个资产组成，每个插入的资产都必须已在基金投资组合中。

前提条件
  • 如需使用这些服务，请联系 integracao.dtvm@qitech.com.br 开通 Sandbox 和生产环境。
  • 您需要 fund_class_key（基金的 key），它是该 API 所有端点 Base URL 的组成部分；以及在创建批次时提供的 assignment_configuration_key（配置的 key）：
/trade_resolve/fund_class/{fund_class_key}

出售/回购流程​

下图展示了主流程、分支以及每个步骤产生的状态。将鼠标悬停在节点上可查看端点，点击可打开对应文档。

IntegradorQI Tech
1创建批次
pending_assets_insertion
Integrador

提供唯一的 external_id、基金的会计日期以及向基金付款方的证件号。

POST/trade_resolve/fund_class/{fund_class_key}/assignment
Ver documentação →
2插入资产
资产：pending_wallet_sale
Integrador

每个资产一个请求，使用其纳入投资组合时的同一 external_id 进行标识。资产必须在投资组合中处于有效状态。

POST.../assignment/{external_id}/asset
Ver documentação →
价格确认
条件
资产：pending_validation
QI Tech

当出售价格与会计公允价值的偏差超过 5% 时，资产会被暂留。API 不提供确认操作：请与 integracao.dtvm@qitech.com.br 协商。

3关闭批次
completed_assets_insertion
Integrador

至少需要有一个未被废弃的资产。您可以发送 number_of_assets 和 total_value，由 API 核对总数。

PUT.../assignment/{external_id}
Ver documentação →
批次已废弃
discarded
QI Tech

在关闭之前可以废弃批次。API 不提供废弃操作：请向 integracao.dtvm@qitech.com.br 申请。

回购协议书
pending_documents_signature
QI Tech

内部协议书：由 QI Tech 生成文件并收集签名。外部协议书：批次进入 pending_signed_term_submission。

等待款项计入基金
pending_payment
QI Tech

协议书签署后，QI Tech 在基金账户中登记预期付款。

资产已从投资组合中注销
completed
QI Tech

确认入账后，批次进入 pending_wallet_sale，资产逐一注销。全部完成后，批次结束。

操作步骤​

1. 创建批次​

创建批次时，提供唯一标识（external_id）、操作日期（基金当前的会计日期）以及向基金付款方的证件号。批次创建后处于 pending_assets_insertion，是所有待注销资产的容器。

查看创建批次文档

2. 插入资产​

每个请求插入一个资产，使用其纳入投资组合时的同一 external_id（或合同编号）进行标识。插入时，资产必须在基金投资组合中处于有效状态。

查看插入资产文档

价格偏差超过 5%

如果所提供的出售价格与资产会计公允价值的偏差超过 5%，资产不会自动继续：它会处于 pending_validation，需经确认后才能进入注销。偏差在 5% 以内的直接进入 pending_wallet_sale。

API 不提供确认操作。只要还有资产处于 pending_validation，批次在关闭后就不会推进。如果您的流程可能产生超过 5% 的偏差，请与 integracao.dtvm@qitech.com.br 协商处理流程。

3. 关闭批次​

插入所有资产后，关闭批次。至少需要有一个未被废弃的资产。您也可以选择发送 number_of_assets 和 total_value，由 API 在接受关闭前核对汇总的数量和总金额。

批次只能在此步骤之前废弃，且 API 不提供批次废弃操作：请向 integracao.dtvm@qitech.com.br 申请。

查看关闭批次文档

4. 回购协议书​

回购协议书由谁出具取决于批次的配置：

  • 内部协议书——当所有资产都已准备好注销时，QI Tech 生成协议书（pending_documents_generation）并收集各方签名（pending_documents_signature）。集成方无需任何操作。
  • 外部协议书——批次进入 pending_signed_term_submission，需要接收已签署的协议书。manager-api、consultant-api 和 assignor-api 均不提供该协议书的提交功能：使用外部协议书之前，请与 integracao.dtvm@qitech.com.br 约定提交方式。

两种情况下，协议书签署后，批次都会进入 pending_payment，等待款项计入基金账户。

5. 付款与资产注销​

最后的步骤均自动完成：QI Tech 确认基金账户已入账，批次进入 pending_wallet_sale，资产从投资组合中注销；所有资产完成后，批次以 completed 结束。

Webhook​

当内部协议书签署完成、批次进入 pending_payment 时，QI Tech 会向批次配置中登记的代理方发送 trade_resolve.assignment_status_change webhook。这是唯一会发送 webhook 的状态：使用外部协议书的批次不会收到此事件。登记由 QI Tech 完成：请发送邮件至 integracao.dtvm@qitech.com.br 申请。签名验证参见 Webhook 认证。

Webhook Body
{
    "webhook_type": "trade_resolve.assignment_status_change",
    "webhook_datetime": "2024-04-02T10:15:00Z",
    "data": {
        "assignment_external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
        "assignment_new_status": "pending_payment",
        "signed_term_url": "https://TEMPORARY_TERM_URL"
    }
}
字段描述
assignment_external_id批次的 external_id
assignment_new_status批次的新状态：pending_payment
signed_term_url下载已签署协议书的链接。24 小时后失效。