# QI Tech — Cessão de CCB (LaaS) › Webhooks Documentação da QI Tech em texto corrido, para colar em um LLM. Fonte: https://docs.qitech.com.br 2 página(s). Índice: - Webhook de ativo cedido (/documentation/manual_cessao/referencia/webhook-ativo-cedido) - Webhook de lote de cessão (/documentation/manual_cessao/referencia/webhook-lote-de-cessao) --- # Webhook de ativo cedido URL: /documentation/manual_cessao/referencia/webhook-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. WEBHOOK_TYPE assignment.assignment_item_status_change Os webhooks de ativo saem no mesmo momento do [webhook de lote de cessão](/documentation/manual_cessao/referencia/webhook-lote-de-cessao) 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](/documentation/primeiros_passos/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 ```json { "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" } } ``` :::tip 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](/documentation/primeiros_passos/configurando_webhooks). ## Próximo passo - [Listar ativos do lote](/documentation/manual_cessao/referencia/listar-ativos-do-lote): a mesma informação, sob demanda. - [Consultar cessões de uma dívida](/documentation/manual_cessao/referencia/consultar-cessoes-da-divida): o histórico de cessões de uma CCB. --- # Webhook de lote de cessão URL: /documentation/manual_cessao/referencia/webhook-lote-de-cessao A QI Tech envia este webhook ao originador quando um lote de cessão chega a um status final: liquidado (`settled`) ou cancelado (`canceled`). Ele descreve o lote como um todo. Para saber quais dívidas (CCBs) entraram no lote, [liste os ativos do lote](/documentation/manual_cessao/referencia/listar-ativos-do-lote). WEBHOOK_TYPE assignment.status_change A URL que recebe o webhook é configurada uma única vez para a sua integração. Veja [Configurando webhooks](/documentation/primeiros_passos/configurando_webhooks). ## Corpo do webhook | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ---------------- | -------- | ----------- | ----------------------------------------------------------------------------- | ------- | | `key` | `uuid` | Sim | Chave do lote de cessão. Igual a `data.assignment_key`. | 36 | | `webhook_type` | `string` | Sim | Sempre `assignment.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 lote. Veja a tabela abaixo. | — | ### Atributos de `data` | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ------------------------- | --------- | ----------- | ------------------------------------------------------------------------------------------------------------ | ------- | | `assignment_key` | `uuid` | Sim | Chave do lote de cessão. | 36 | | `status` | `string` | Sim | Status final do lote: `settled` (liquidado) ou `canceled` (cancelado). | — | | `reference_date` | `string` | Sim | Data-base da cessão, usada na precificação, no formato `AAAA-MM-DD`. | 10 | | `number_of_items` | `integer` | Sim | Quantidade de dívidas que permaneceram no lote, depois das recusas e retiradas. | — | | `total_number_of_items` | `integer` | Sim | Quantidade de dívidas selecionadas para o lote, antes das recusas e retiradas. | — | | `total_amount` | `number` | Não | Soma do valor presente das dívidas do lote, em reais. Pode vir `null` quando o lote é cancelado. | — | | `term_of_assignment_url` | `string` | Não | URL do termo de cessão, quando o fluxo gera o termo. `null` quando não há termo. | 2048 | ## Exemplo — lote liquidado ```json { "key": "8a369478-8024-4e55-97f0-f9e6f29cbbee", "webhook_type": "assignment.status_change", "event_datetime": "2026-09-29T14:50:53", "data": { "assignment_key": "8a369478-8024-4e55-97f0-f9e6f29cbbee", "status": "settled", "reference_date": "2026-09-29", "number_of_items": 459, "total_number_of_items": 459, "total_amount": 63848.05, "term_of_assignment_url": null } } ``` ## Exemplo — lote cancelado ```json { "key": "60055b72-62aa-4daa-b6ad-adcaeedfe5ff", "webhook_type": "assignment.status_change", "event_datetime": "2026-09-29T14:33:36", "data": { "assignment_key": "60055b72-62aa-4daa-b6ad-adcaeedfe5ff", "status": "canceled", "reference_date": "2026-09-29", "number_of_items": 0, "total_number_of_items": 226, "total_amount": null, "term_of_assignment_url": null } } ``` ## 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](/documentation/primeiros_passos/configurando_webhooks). ## Próximo passo - [Listar ativos do lote](/documentation/manual_cessao/referencia/listar-ativos-do-lote): as dívidas do lote, com o status de cada uma. - [Consultar lote de cessão](/documentation/manual_cessao/referencia/consultar-lote-de-cessao): o estado atual do lote, a qualquer momento. - [Webhook de ativo cedido](/documentation/manual_cessao/referencia/webhook-ativo-cedido): um webhook por dívida do lote liquidado, com valor presente e cessionário.