Webhook de ativo cedido
Quando um lote de cessão é liquidado, a QI Tech envia um webhook para cada dívida (CCB) que permaneceu no lote. Com ele, o originador sabe, ativo a ativo, o que foi cedido, por qual valor e para qual cessionário, sem precisar listar os ativos do lote.
Os webhooks de ativo saem no mesmo momento do webhook de lote de cessão com status settled. Um lote de 459 dívidas gera 459 webhooks de ativo e um webhook de lote.
Como habilitar
O webhook de ativo cedido é opcional e habilitado por configuração de cessão. Peça a ativação ao time de suporte de cessão (suporte.cessao@qitech.com.br), informando a configuração de cessão desejada. A URL que recebe o webhook é a mesma do webhook de lote; veja Configurando webhooks.
Corpo do webhook
| Campo | Tipo | Obrigatório | Descrição | Tamanho |
|---|---|---|---|---|
key | uuid | Sim | Chave do ativo no lote. Igual a data.assignment_item_key. | 36 |
webhook_type | string | Sim | Sempre assignment.assignment_item_status_change. | — |
event_datetime | string | Sim | Data e hora do evento, em UTC, no formato AAAA-MM-DDTHH:MM:SS. | 19 |
data | object | Sim | Dados do ativo cedido. Veja a tabela abaixo. | — |
Atributos de data
| Campo | Tipo | Obrigatório | Descrição | Tamanho |
|---|---|---|---|---|
assignment_item_key | uuid | Sim | Chave do ativo dentro do lote de cessão. | 36 |
assignment_key | uuid | Sim | Chave do lote de cessão ao qual o ativo pertence. | 36 |
credit_operation_key | uuid | Sim | Chave da dívida (CCB) cedida. | 36 |
contract_number | string | Sim | Número da CCB. | — |
status | string | Sim | Sempre settled: o ativo foi cedido e a cessão, liquidada. | — |
present_amount | number | Sim | Valor presente do ativo na data-base da cessão, em reais. É o valor pelo qual o ativo foi cedido. | — |
reference_date | string | Sim | Data-base da cessão, no formato AAAA-MM-DD. | 10 |
purchaser_document_number | string | Sim | CNPJ do cessionário, só dígitos. | 14 |
Exemplo
{
"key": "cbd84a21-77a7-42b4-a58d-1202103490cd",
"webhook_type": "assignment.assignment_item_status_change",
"event_datetime": "2026-09-29T14:50:53",
"data": {
"assignment_item_key": "cbd84a21-77a7-42b4-a58d-1202103490cd",
"assignment_key": "8a369478-8024-4e55-97f0-f9e6f29cbbee",
"credit_operation_key": "684c24b6-33b7-4b4d-b9b4-6ca3f1bb3740",
"contract_number": "0000000001/CCB",
"status": "settled",
"present_amount": 727.36,
"reference_date": "2026-09-29",
"purchaser_document_number": "12345678000190"
}
}
Use credit_operation_key para ligar o webhook à dívida no seu sistema, e assignment_key para agrupar os ativos do mesmo lote.
Erros
Este webhook não devolve erro ao originador. A sua URL deve responder com um status 2xx; o comportamento de entrega está em Configurando webhooks.
Próximo passo
- Listar ativos do lote: a mesma informação, sob demanda.
- Consultar cessões de uma dívida: o histórico de cessões de uma CCB.