Webhooks da carteira

A carteira emite o webhook composition.status_change quando muda para alguns status. Ele é enviado só para a gestora da classe de fundo.

Assinatura, headers e política de reenvio são os mesmos de todos os webhooks: veja Autenticação de webhooks.

Quando é enviado

status	Quando	O que fazer
pending_confirmation	A carteira está pronta e aguarda a aprovação da gestora.	Analise a carteira e aprove ou reprove.
confirmed	A carteira foi confirmada: a de validação, ao ser aprovada pela gestora (ou automaticamente, se a classe tem aprovação automática); a final, ao fim do processamento.	Consulte ou baixe a carteira.
reprocessed	Uma carteira já confirmada foi reprocessada pela QI DTVM.	A carteira confirmada deixa de valer. Liste as carteiras da mesma data para obter a versão vigente.

Reprovações (reproved, reproved_by_agent) e os status intermediários de processamento não emitem 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"
    }
}

Campo	Tipo	Descrição
webhook_type	string	Sempre composition.status_change.
webhook_datetime	string	Data e hora do envio, em UTC (ISO 8601).
data.composition_key	string	Chave da carteira. Use-a para consultar a carteira completa.
data.composition_date	string	Data de referência da carteira (YYYY-MM-DD).
data.composition_type	string	pre_quota, final_quota ou opening_quota.
data.status	string	Novo status da carteira.
data.fund_class_key	string	Chave da classe de fundo.

Configuração

A URL do webhook e os tipos de carteira que geram notificação (por exemplo, só pre_quota) são configurados pela QI DTVM — não há endpoint para isso na sua integração. Solicite ao time de integração em integracao.dtvm@qitech.com.br.