跳到主要内容

转让批次 Webhook

在转让流程中，系统会发送 webhook 通知批次的状态变更。所有 webhook 的类型均为 trade_receivables.assignment_status_change，并通过创建时提供的 assignment_external_id 标识批次。

Webhook 配置

如需接收 webhook，需要在 QI Tech 配置回调 URL。该配置决定您接收哪些状态：只发送已订阅的事件。请联系 integracao.dtvm@qitech.com.br 进行配置。投递、重试和签名：参见 Webhook 接收。

批次状态流程​

转让批次状态流程，从 pending_assets_insertion 到 completed，以及转向 denied 和 discarded 的分支

图例：蓝色 = 会发送 webhook 的中间状态 · 虚线 = 不发送 webhook 的状态 · 绿色 = 转让完成 · 红色 = 拒绝或废弃的最终状态。

完整的状态列表（包括不发送 webhook 的状态）参见批次状态枚举值。

Webhook 结构​

字段类型描述
webhook_typestring始终为 trade_receivables.assignment_status_change。
webhook_datetimestring发送的日期和时间，格式为 YYYY-MM-DDTHH:MM:SSZ。
dataobject事件数据。见下表。

data 属性​

字段类型描述
assignment_external_idstring创建时提供的批次 external_id。
assignment_new_statusstring批次的新状态。
assignment_configuration_keystring批次所属的转让配置——与端点 URL 中使用的 key 相同。由于一个转让方可能有多个有效配置，它表示事件发生在哪一项协议下。
fund_class_keystring批次所属的基金类别。
signed_term_urlstring仅在 pending_payment webhook 中、转让协议书已电子签署时返回：用于下载已签署协议书的预签名 URL，有效期 24 小时。过期后请使用转让文件。
Webhook Body
{
    "data": {
        "assignment_external_id": "1caff47c-bd05-48b0-a6bc-9569f5070f6b",
        "assignment_new_status": "pending_manager_approval",
        "assignment_configuration_key": "3571e292-3a83-4011-904d-20ee963022ef",
        "fund_class_key": "b7d3e2a1-4c5f-4e8b-9d1a-2f3c4e5a6b7c"
    },
    "webhook_type": "trade_receivables.assignment_status_change",
    "webhook_datetime": "2024-04-23T15:08:30Z"
}

各状态的事件​

请求体始终相同；变化的是 assignment_new_status。

assignment_new_status发送时机
pending_assets_insertion批次已创建，可接收资产。批次被重新开放时也会发送。
completed_assets_insertion资产插入已结束。批次从登记环节返回且有资产被登记机构拒绝时也会发送。 assignment_date 为未来日期的批次不会发送此事件：批次先进入 waiting_assignment_date，在转让日期进入 completed_assets_insertion，不发送 webhook。
pending_eligibility所有资产均已审查，批次进入合格性审查。
pending_consultant_approval批次通过合格性审查，等待顾问审批。
pending_manager_approval批次通过合格性审查（适用时也已由顾问审批），等待管理人审批。
pending_assets_registry批次已自动审批通过，资产正在登记。
waiting_assets_to_formalize资产已登记（或批次已自动审批通过且无需登记），等待正式化。
pending_assignment_term正在生成转让协议书。
pending_assignment_term_signature转让协议书已发送签署。可在转让文件中查询。
pending_custody根据转让配置，等待托管。仅当配置免除协议书签署时发送；签署后进入 pending_custody 不发送 webhook。
pending_payment协议书已签署（或无需签署），向转让方的付款正在处理。可能包含 signed_term_url。
pending_assets_wallet_inclusion付款已确认；资产正在纳入投资组合。
waiting_after_assignment_registry转让后登记（延迟登记）已发送至登记机构。
completed资产已纳入基金投资组合——转让完成。在采用延迟登记的配置中，于纳入投资组合时、转让后登记之前发送。
denied批次被拒绝：在合格性审查中、因所有资产均被拒绝、在登记环节，或由顾问/管理人拒绝。无法通过 API 回到流程中。
discarded批次已废弃——例如在基金会计关账时尚未付款。denied 的批次也会在此时被废弃。
不发送 webhook 的状态转换
  • 通过 API 或门户进行的最终审批（使批次进入 pending_assets_registry 或 waiting_assets_to_formalize）在此次转换中不会发送 webhook。请使用审批响应中的 status。
  • waiting_assignment_date、pending_send_to_signature、pending_assignment_term_validation 和 pending_after_assignment_documentation 不发送 webhook。
  • 转让协议书签署后进入 pending_custody。

如需随时核对状态，请使用获取批次。