跳到主要内容

投资组合 Webhook

投资组合在变更为某些状态时会发送 composition.status_change webhook。该 webhook 仅发送给基金类别的管理人。

签名、请求头和重发策略与所有 webhook 相同：参见 Webhook 认证。

发送时机​

status时机处理方式
pending_confirmation投资组合已准备就绪，等待管理人审批。审核投资组合，并审批通过或拒绝。
confirmed投资组合已确认：验证投资组合在管理人审批通过时确认（如该基金类别启用了自动审批，则自动确认）；最终投资组合在处理结束时确认。查询或下载投资组合。
reprocessed一份已确认的投资组合被 QI DTVM 重新处理。原已确认的投资组合不再有效。请列出同一日期的投资组合以获取当前有效版本。

拒绝（reproved、reproved_by_agent）以及处理过程中的中间状态不会发送 webhook。

Payload​

Webhook Body
{
    "webhook_type": "composition.status_change",
    "webhook_datetime": "2025-01-22T20:30:23.459123+00:00",
    "data": {
        "composition_key": "f2208257-1489-4937-8862-031bca34016f",
        "composition_date": "2025-01-21",
        "composition_type": "pre_quota",
        "status": "pending_confirmation",
        "fund_class_key": "5dac941c-c779-4049-a4ee-7cee583b6860"
    }
}
字段类型描述
webhook_typestring始终为 composition.status_change。
webhook_datetimestring发送的日期和时间，UTC（ISO 8601）。
data.composition_keystring投资组合的 key。可用它查询完整的投资组合。
data.composition_datestring投资组合的参考日期（YYYY-MM-DD）。
data.composition_typestringpre_quota、final_quota 或 opening_quota。
data.statusstring投资组合的新状态。
data.fund_class_keystring基金类别的 key。

配置​

webhook 的 URL 以及会触发通知的投资组合类型（例如仅 pre_quota）由 QI DTVM 配置——您的集成中没有用于此项配置的端点。请联系集成团队：integracao.dtvm@qitech.com.br。