Webhook de status do aditamento

A QI Tech envia este webhook ao originador a cada mudança de status de um aditamento da dívida (CCB), depois do webhook de aditamento criado.

WEBHOOK_TYPE

laas.amendment.amendment_status_change

A URL que recebe o webhook é a mesma dos demais webhooks da sua integração e é configurada uma única vez. Veja Configurando webhooks.

Quando ele chega

O webhook sai nas transições que entram no histórico do aditamento e em nenhuma outra. O status in_pending_fund_notification_queue e as novas tentativas de avisar o fundo não geram webhook.

Status no webhook	O que aconteceu
pending_fund_notification	O novo cronograma foi aplicado à dívida. Falta avisar o fundo cessionário.
applied	O fundo reconheceu o aditamento. Estado final. Também é o status direto quando o fundo já tinha o aditamento antes do cronograma ser aplicado.
failed	O fundo recusou o aditamento e a recusa não se resolve com nova tentativa. Estado final.

O que você recebe depende de onde o fundo cessionário guarda a carteira:

Fundo	Webhooks que você recebe
Carteira na QI DTVM	Aditamento criado, pending_fund_notification e applied.
Carteira fora da QI DTVM	Aditamento criado e pending_fund_notification. O aditamento fica nesse status e nenhum webhook novo é enviado.

info

O webhook traz só o status. O motivo de um failed (code e description da recusa do fundo) está em status_events[].event_data da consulta de aditamentos.

Corpo do webhook

Campo	Tipo	Obrigatório	Descrição	Tamanho
key	uuid	Sim	Chave da dívida (CCB) aditada. Igual a data.credit_operation_key.	36
status	string	Sim	Status em que o aditamento entrou: pending_fund_notification, applied ou failed.	—
webhook_type	string	Sim	Sempre laas.amendment.amendment_status_change.	—
event_datetime	string	Sim	Data e hora do envio, em UTC, no formato AAAA-MM-DDTHH:MM:SSZ.	20
data	object	Sim	A identificação do aditamento. Veja a tabela abaixo.	—

Atributos de data

Campo	Tipo	Obrigatório	Descrição	Tamanho
amendment_key	uuid	Sim	Chave do aditamento.	36
credit_operation_key	uuid	Sim	Chave da dívida (CCB) aditada.	36

Exemplo — fundo reconheceu o aditamento

{
    "key": "5ae2c008-44c1-4435-bbfa-094a4b11d962",
    "status": "applied",
    "webhook_type": "laas.amendment.amendment_status_change",
    "event_datetime": "2026-11-09T14:48:02Z",
    "data": {
        "amendment_key": "c3a7f1d2-6b0e-4e8a-9d41-27b5e0f8a6c4",
        "credit_operation_key": "5ae2c008-44c1-4435-bbfa-094a4b11d962"
    }
}

Erros

Este webhook não devolve erro ao originador. A sua URL deve responder com um status 2xx; o comportamento de entrega e o reenvio estão em Configurando webhooks.

Próximo passo

• Consultar aditamentos da dívida: o cronograma antes e depois, o histórico de status e o motivo de uma recusa.