# QI Tech — Cessão de CCB (LaaS) › Endpoints Documentação da QI Tech em texto corrido, para colar em um LLM. Fonte: https://docs.qitech.com.br 7 página(s). Índice: - Consultar cessões de uma dívida (/en/documentation/manual_cessao/referencia/consultar-cessoes-da-divida) - Consultar lote de cessão (/en/documentation/manual_cessao/referencia/consultar-lote-de-cessao) - Criar lote de cessão (/en/documentation/manual_cessao/referencia/criar-lote-de-cessao) - Listar ativos do lote (/en/documentation/manual_cessao/referencia/listar-ativos-do-lote) - Listar configurações de cessão (/en/documentation/manual_cessao/referencia/listar-configuracoes-de-cessao) - Listar eventos do lote (/en/documentation/manual_cessao/referencia/listar-eventos-do-lote) - Listar lotes de cessão (/en/documentation/manual_cessao/referencia/listar-lotes-de-cessao) --- # Consultar cessões de uma dívida URL: /en/documentation/manual_cessao/referencia/consultar-cessoes-da-divida Lista todos os lotes de cessão em que uma dívida (CCB) entrou, inclusive lotes cancelados. Use para responder "esta CCB foi cedida, quando e em qual lote?". ## Endpoint ENDPOINT /v2/assignment/assignment_item/credit_operation_key/ CREDIT_OPERATION_KEY /assignments MÉTODO GET STATUS 200 ## Autenticação Requer assinatura da requisição. Veja [Troca de chaves](/documentation/primeiros_passos/troca_de_chaves). ## Parâmetros de caminho | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ---------------------- | ------ | ----------- | ---------------------- | ------- | | `credit_operation_key` | `uuid` | Sim | Chave da dívida (CCB). | 36 | ## Parâmetros de consulta | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ----------- | --------- | ----------- | ------------------------------ | ------- | | `page` | `integer` | Não | Página desejada. Padrão `1`. | — | | `page_size` | `integer` | Não | Lotes por página. Padrão `10`. | — | ## Resposta | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ------------ | -------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------- | ------- | | `data` | `array` | Sim | Lotes em que a dívida entrou. Cada item tem os campos de [Consultar lote de cessão](/documentation/manual_cessao/referencia/consultar-lote-de-cessao), com `signable_term_url` sempre `null`. | — | | `pagination` | `object` | Sim | `page` e `page_size` usados na consulta. | — | Uma dívida que nunca entrou em lote devolve `200` com `data` vazio. ```json { "data": [ { "assignment_key": "8a369478-8024-4e55-97f0-f9e6f29cbbee", "status": "settled", "settled": true, "reference_date": "2026-09-29", "creation_datetime": "2026-09-29T06:00:12", "number_of_items": 459, "total_number_of_items": 459, "total_amount": 63848.05, "term_of_assignment_url": null, "signable_term_url": null, "external_identifier": null } ], "pagination": { "page": 1, "page_size": 10 } } ``` :::tip `settled` diz respeito ao lote, não à dívida: uma dívida recusada pelo cessionário pode estar num lote liquidado. Para saber se esta dívida foi cedida, veja o `status` dela em [Listar ativos do lote](/documentation/manual_cessao/referencia/listar-ativos-do-lote). ::: ## Erros | Status | Código | Descrição | | ------ | ----------- | -------------------------------------------------- | | 403 | `QIT000005` | Algum lote da consulta não pertence à sua integração. | ## Próximo passo - [Listar ativos do lote](/documentation/manual_cessao/referencia/listar-ativos-do-lote) --- # Consultar lote de cessão URL: /en/documentation/manual_cessao/referencia/consultar-lote-de-cessao Devolve o estado atual de um lote de cessão: status, data-base, quantidade de dívidas, valor total e termo de cessão. Use para acompanhar um lote recebido no [webhook de lote de cessão](/documentation/manual_cessao/referencia/webhook-lote-de-cessao). ## Endpoint ENDPOINT /v2/assignment/ ASSIGNMENT_KEY MÉTODO GET STATUS 200 ## Autenticação Requer assinatura da requisição. Veja [Troca de chaves](/documentation/primeiros_passos/troca_de_chaves). ## Parâmetros de caminho | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ---------------- | ------ | ----------- | ------------------------ | ------- | | `assignment_key` | `uuid` | Sim | Chave do lote de cessão. | 36 | ## Resposta | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ------------------------ | --------- | ----------- | --------------------------------------------------------------------------------------------- | ------- | | `assignment_key` | `uuid` | Sim | Chave do lote de cessão. | 36 | | `status` | `string` | Sim | Status atual do lote. Os status finais são `settled` (liquidado) e `canceled` (cancelado). | — | | `settled` | `boolean` | Sim | `true` quando a liquidação financeira do lote já ocorreu. | — | | `reference_date` | `string` | Sim | Data-base da cessão, no formato `AAAA-MM-DD`. | 10 | | `creation_datetime` | `string` | Sim | Data e hora de criação do lote, em ISO 8601. | — | | `number_of_items` | `integer` | Sim | Quantidade de dívidas que permanecem no lote. | — | | `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. | — | | `term_of_assignment_url` | `string` | Não | URL do termo de cessão assinado. `null` enquanto não houver termo. | 2048 | | `signable_term_url` | `string` | Não | URL para assinar o termo de cessão, quando ele existe e ainda não foi assinado. | — | | `external_identifier` | `string` | Não | Identificador externo do lote, quando informado. | — | :::info Enquanto o lote está em andamento, `status` passa por status intermediários (seleção, cálculo, registro, envio ao cessionário, assinatura do termo). Para integrar, trate `settled` e `canceled` como finais e os demais como "em andamento". ::: ```json { "assignment_key": "8a369478-8024-4e55-97f0-f9e6f29cbbee", "status": "settled", "settled": true, "reference_date": "2026-09-29", "creation_datetime": "2026-09-29T06:00:12", "number_of_items": 459, "total_number_of_items": 459, "total_amount": 63848.05, "term_of_assignment_url": null, "signable_term_url": null, "external_identifier": null } ``` ## Erros | Status | Código | Descrição | | ------ | ------------ | ------------------------------------------------------- | | 403 | `QIT000005` | O lote não pertence à sua integração. | | 404 | `ASG0000011` | Nenhum lote encontrado com essa `assignment_key`. | ## Webhooks relacionados - [Webhook de lote de cessão](/documentation/manual_cessao/referencia/webhook-lote-de-cessao) ## Próximo passo - [Listar ativos do lote](/documentation/manual_cessao/referencia/listar-ativos-do-lote) - [Listar eventos do lote](/documentation/manual_cessao/referencia/listar-eventos-do-lote) --- # Criar lote de cessão URL: /en/documentation/manual_cessao/referencia/criar-lote-de-cessao Cria lotes de cessão sob demanda para uma configuração de cessão, fora do horário da cessão automática. Informe as dívidas a ceder em `credit_operation_keys`; sem elas, a QI Tech seleciona as dívidas elegíveis da configuração. ## Endpoint ENDPOINT /v2/assignment/assignment_configuration/ ASSIGNMENT_CONFIGURATION_KEY /assignment MÉTODO POST STATUS 201 ## Autenticação Requer assinatura da requisição. Veja [Troca de chaves](/documentation/primeiros_passos/troca_de_chaves). ## Parâmetros de caminho | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ------------------------------ | ------ | ----------- | -------------------------------------------------------------------------------------------------------------- | ------- | | `assignment_configuration_key` | `uuid` | Sim | Chave da configuração de cessão. Veja [Listar configurações de cessão](/documentation/manual_cessao/referencia/listar-configuracoes-de-cessao). | 36 | ## Corpo da requisição Todos os campos são opcionais. Um corpo vazio pede à QI Tech que selecione as dívidas elegíveis da configuração. | Campo | Tipo | Obrigatório | Descrição | Tamanho | | --------------------------- | --------------- | ----------- | --------------------------------------------------------------------------------------------------- | ------- | | `credit_operation_keys` | `array[uuid]` | Não | Chaves das dívidas (CCBs) a ceder. | — | | `purchaser_document_number` | `string` | Não | CNPJ do cessionário, só dígitos. Se informado, precisa ser o da configuração. | 14 | ```json { "credit_operation_keys": [ "684c24b6-33b7-4b4d-b9b4-6ca3f1bb3740", "5b1f0c2e-7a3d-4e9b-8c6f-2d4e6a8b0c1d" ] } ``` ## Resposta A resposta é uma **lista**, com um item por lote criado. As dívidas são divididas em lotes conforme o tamanho de lote da configuração. Se nenhuma dívida elegível for encontrada, a lista vem vazia. | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ------------------- | --------- | ----------- | ------------------------------------------------------- | ------- | | `assignment_key` | `uuid` | Sim | Chave do lote criado. | 36 | | `reference_date` | `string` | Sim | Data-base da cessão, no formato `AAAA-MM-DD`. | 10 | | `number_of_items` | `integer` | Sim | Quantidade de dívidas no lote. | — | | `total_amount` | `number` | Não | Soma do valor presente das dívidas, em reais. | — | | `creation_datetime` | `string` | Sim | Data e hora de criação do lote, em ISO 8601. | — | | `created_at` | `string` | Sim | Data e hora de registro do lote, em ISO 8601. | — | ```json [ { "assignment_key": "8a369478-8024-4e55-97f0-f9e6f29cbbee", "reference_date": "2026-09-29", "number_of_items": 2, "total_amount": null, "creation_datetime": "2026-09-29T10:15:02", "created_at": "2026-09-29T10:15:02" } ] ``` O lote segue o fluxo de cessão da configuração. Acompanhe pelo [webhook de lote de cessão](/documentation/manual_cessao/referencia/webhook-lote-de-cessao) ou por [Consultar lote de cessão](/documentation/manual_cessao/referencia/consultar-lote-de-cessao). ## Erros | Status | Código | Descrição | | ------ | ------------ | --------------------------------------------------------------------------- | | 400 | `ASG0000149` | `purchaser_document_number` diferente do cessionário da configuração. | | 400 | `ASG0000161` | Há mais de uma configuração ativa para a sua integração e este cessionário. | | 403 | `QIT000005` | A configuração não pertence à sua integração. | | 404 | `ASG0000011` | Nenhuma configuração encontrada com essa chave. | | 404 | `ASG0000165` | Alguma dívida de `credit_operation_keys` não foi encontrada. | ## Webhooks relacionados - [Webhook de lote de cessão](/documentation/manual_cessao/referencia/webhook-lote-de-cessao) ## Próximo passo - [Consultar lote de cessão](/documentation/manual_cessao/referencia/consultar-lote-de-cessao) --- # Listar ativos do lote URL: /en/documentation/manual_cessao/referencia/listar-ativos-do-lote Lista, de forma paginada, as dívidas (CCBs) de um lote de cessão: valor presente, status de cada uma, parcelas e, quando houver, o motivo da recusa pelo cessionário. ## Endpoint ENDPOINT /v2/assignment/ ASSIGNMENT_KEY /assignment_items MÉTODO GET STATUS 200 ## Autenticação Requer assinatura da requisição. Veja [Troca de chaves](/documentation/primeiros_passos/troca_de_chaves). ## Parâmetros de caminho | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ---------------- | ------ | ----------- | ------------------------ | ------- | | `assignment_key` | `uuid` | Sim | Chave do lote de cessão. | 36 | ## Parâmetros de consulta | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ----------- | --------- | ----------- | ------------------------------- | ------- | | `page` | `integer` | Não | Página desejada. Padrão `1`. | — | | `page_size` | `integer` | Não | Ativos por página. Padrão `10`. | — | ## Resposta A resposta tem `data` (os ativos da página) e `pagination` (`page` e `page_size`). A resposta não traz o total; pare quando `data` vier com menos itens que `page_size`. ### Atributos de cada ativo | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ------------------------------- | --------- | ----------- | ------------------------------------------------------------------------------------------ | ------- | | `assignment_item_key` | `uuid` | Sim | Chave do ativo no lote. | 36 | | `credit_operation_key` | `uuid` | Sim | Chave da dívida (CCB). | 36 | | `contract_number` | `string` | Sim | Número da CCB. | — | | `requester_identifier_key` | `string` | Não | Identificador da dívida no seu sistema, quando informado na emissão. | — | | `control_number` | `string` | Não | Número de controle do ativo, gerado pelo modelo da configuração de cessão. | — | | `status` | `string` | Sim | Status do ativo no lote, por exemplo `settled`, `rejected` ou `canceled`. | — | | `settled` | `boolean` | Sim | `true` quando o lote foi liquidado e o ativo não foi cancelado. | — | | `present_amount` | `number` | Sim | Valor presente do ativo na data-base da cessão, em reais. | — | | `contract_present_amount` | `number` | Não | Valor presente do contrato, em reais. | — | | `issue_amount` | `number` | Sim | Valor de emissão da CCB, em reais. | — | | `disbursed_amount` | `number` | Sim | Valor desembolsado ao tomador, em reais. | — | | `disbursement_date` | `string` | Sim | Data do desembolso, no formato `AAAA-MM-DD`. | 10 | | `number_of_installments` | `integer` | Sim | Quantidade de parcelas da CCB. | — | | `issuer_name` | `string` | Sim | Nome do tomador. | — | | `issuer_document_number` | `string` | Sim | CPF ou CNPJ do tomador, só dígitos. | 14 | | `purchaser_document_number` | `string` | Sim | CNPJ do cessionário, só dígitos. | 14 | | `endorsement_url` | `string` | Não | URL do endosso da CCB, quando gerado. | — | | `rejected_reasons` | `array` | Não | Presente só quando o ativo foi recusado. Cada item tem `reason` e `reason_details`. | — | | `assignment_item_installments` | `array` | Sim | Parcelas do ativo. Veja a tabela abaixo. | — | ### Atributos de `assignment_item_installments` | Campo | Tipo | Obrigatório | Descrição | Tamanho | | -------------------- | --------- | ----------- | ------------------------------------------------- | ------- | | `installment_key` | `uuid` | Sim | Chave da parcela. | 36 | | `installment_number` | `integer` | Sim | Número da parcela. | — | | `due_date` | `string` | Sim | Vencimento da parcela, no formato `AAAA-MM-DD`. | 10 | | `total_amount` | `number` | Sim | Valor da parcela no vencimento, em reais. | — | | `present_amount` | `number` | Sim | Valor presente da parcela na data-base, em reais. | — | | `your_number` | `integer` | Não | Número de identificação da parcela. | — | **Exemplo de resposta** ```json { "data": [ { "assignment_item_key": "cbd84a21-77a7-42b4-a58d-1202103490cd", "credit_operation_key": "684c24b6-33b7-4b4d-b9b4-6ca3f1bb3740", "contract_number": "0000000001/CCB", "requester_identifier_key": "SEU-ID-0001", "control_number": "0000000001", "status": "settled", "settled": true, "present_amount": 727.36, "contract_present_amount": 730.12, "issue_amount": 800.0, "disbursed_amount": 750.0, "disbursement_date": "2026-09-25", "number_of_installments": 1, "issuer_name": "NOME DO TOMADOR", "issuer_document_number": "96969879003", "purchaser_document_number": "12345678000190", "endorsement_url": null, "assignment_item_installments": [ { "installment_key": "0f3b6a1e-5d2c-4b7a-9e8f-1a2b3c4d5e6f", "installment_number": 1, "due_date": "2026-10-25", "total_amount": 800.0, "present_amount": 727.36, "your_number": null } ] } ], "pagination": { "page": 1, "page_size": 10 } } ``` ## Erros | Status | Código | Descrição | | ------ | ------------ | ------------------------------------------------- | | 403 | `QIT000005` | O lote não pertence à sua integração. | | 404 | `ASG0000011` | Nenhum lote encontrado com essa `assignment_key`. | ## Próximo passo - [Consultar cessões de uma dívida](/documentation/manual_cessao/referencia/consultar-cessoes-da-divida) --- # Listar configurações de cessão URL: /en/documentation/manual_cessao/referencia/listar-configuracoes-de-cessao Lista as configurações de cessão da sua integração. Cada configuração é o acordo com um cessionário: para quem as dívidas são cedidas e quando a cessão automática roda. A `assignment_configuration_key` devolvida aqui é usada para [criar um lote de cessão](/documentation/manual_cessao/referencia/criar-lote-de-cessao). ## Endpoint ENDPOINT /v2/assignment/assignment_configurations MÉTODO GET STATUS 200 ## Autenticação Requer assinatura da requisição. Veja [Troca de chaves](/documentation/primeiros_passos/troca_de_chaves). ## Parâmetros de consulta | Campo | Tipo | Obrigatório | Descrição | Tamanho | | --------------------------- | --------- | ----------- | -------------------------------------------------- | ------- | | `purchaser_document_number` | `string` | Não | Filtra pelo CNPJ do cessionário, só dígitos. | 14 | | `page` | `integer` | Não | Página desejada. Padrão `1`. | — | | `page_size` | `integer` | Não | Configurações por página. Padrão `10`. | — | ## Resposta | Campo | Tipo | Obrigatório | Descrição | Tamanho | | -------------------------------------- | --------- | ----------- | ------------------------------------------------------------------ | ------- | | `data` | `array` | Sim | Configurações da página. | — | | `data[].assignment_configuration_key` | `uuid` | Sim | Chave da configuração de cessão. | 36 | | `data[].is_active` | `boolean` | Sim | `true` quando a configuração está ativa. | — | | `data[].purchaser_document_number` | `string` | Sim | CNPJ do cessionário, só dígitos. | 14 | | `data[].purchaser_name` | `string` | Sim | Nome do cessionário. | — | | `data[].requester_key` | `uuid` | Sim | Chave da sua integração. | 36 | | `data[].requester_name` | `string` | Sim | Nome da sua integração. | — | | `data[].next_execution_datetime` | `string` | Não | Data e hora da próxima cessão automática, em ISO 8601. | — | | `data[].is_automatic_debt` | `boolean` | Sim | Indica se a configuração opera com débito automático. | — | | `pagination` | `object` | Sim | `page` e `page_size` usados na consulta. | — | ```json { "data": [ { "assignment_configuration_key": "3571e292-3a83-4011-904d-20ee963022ef", "is_active": true, "purchaser_document_number": "12345678000190", "purchaser_name": "NOME DO CESSIONARIO", "requester_key": "d3f788fd-0000-0000-0000-000000000000", "requester_name": "NOME DO ORIGINADOR", "next_execution_datetime": "2026-09-30T06:00:00", "is_automatic_debt": false } ], "pagination": { "page": 1, "page_size": 10 } } ``` ## Erros | Status | Código | Descrição | | ------ | ----------- | ------------------------------------------------------- | | 403 | `QIT000005` | A consulta pediu configurações de outra integração. | ## Próximo passo - [Criar lote de cessão](/documentation/manual_cessao/referencia/criar-lote-de-cessao) --- # Listar eventos do lote URL: /en/documentation/manual_cessao/referencia/listar-eventos-do-lote Devolve o histórico de status de um lote de cessão: cada mudança, com o status anterior, o novo status e o horário. Use para entender onde um lote está parado ou quando ele avançou. ## Endpoint ENDPOINT /v2/assignment/ ASSIGNMENT_KEY /events MÉTODO GET STATUS 200 ## Autenticação Requer assinatura da requisição. Veja [Troca de chaves](/documentation/primeiros_passos/troca_de_chaves). ## Parâmetros de caminho | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ---------------- | ------ | ----------- | ------------------------ | ------- | | `assignment_key` | `uuid` | Sim | Chave do lote de cessão. | 36 | ## Parâmetros de consulta | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ----------- | --------- | ----------- | -------------------------------- | ------- | | `page` | `integer` | Não | Página desejada. Padrão `1`. | — | | `page_size` | `integer` | Não | Eventos por página. Padrão `10`. | — | ## Resposta | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ------------------- | -------- | ----------- | ---------------------------------------------------- | ------- | | `data` | `array` | Sim | Eventos da página. | — | | `data[].old_status` | `string` | Sim | Status do lote antes da mudança. | — | | `data[].next_status`| `string` | Sim | Status do lote depois da mudança. | — | | `data[].created_at` | `string` | Sim | Data e hora da mudança, em ISO 8601. | — | | `pagination` | `object` | Sim | `page` e `page_size` usados na consulta. | — | ```json { "data": [ { "old_status": "waiting_settlement", "next_status": "settled", "created_at": "2026-09-29T14:50:53" } ], "pagination": { "page": 1, "page_size": 10 } } ``` ## Erros | Status | Código | Descrição | | ------ | ----------- | ------------------------------------- | | 403 | `QIT000005` | O lote não pertence à sua integração. | ## Próximo passo - [Consultar lote de cessão](/documentation/manual_cessao/referencia/consultar-lote-de-cessao) --- # Listar lotes de cessão URL: /en/documentation/manual_cessao/referencia/listar-lotes-de-cessao Lista, de forma paginada, os lotes de cessão da sua integração. Filtre por `reference_date` para ver os lotes de um dia. ## Endpoint ENDPOINT /v2/assignment/assignments MÉTODO GET STATUS 200 ## Autenticação Requer assinatura da requisição. Veja [Troca de chaves](/documentation/primeiros_passos/troca_de_chaves). ## Parâmetros de consulta | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ---------------- | --------- | ----------- | ------------------------------------------------------------------- | ------- | | `reference_date` | `string` | Não | Data-base dos lotes, no formato `AAAA-MM-DD`. Filtra por data exata. | 10 | | `page` | `integer` | Não | Página desejada. Padrão `1`. | — | | `page_size` | `integer` | Não | Lotes por página. Padrão `10`, máximo `10`. | — | ## Resposta | Campo | Tipo | Obrigatório | Descrição | Tamanho | | ------------ | -------- | ----------- | --------------------------------------------------------------------------------------------------------------------- | ------- | | `data` | `array` | Sim | Lotes da página. Cada item tem os mesmos campos de [Consultar lote de cessão](/documentation/manual_cessao/referencia/consultar-lote-de-cessao). | — | | `pagination` | `object` | Sim | `page` e `page_size` usados na consulta. A resposta não traz o total; pare quando `data` vier com menos itens que `page_size`. | — | ```json { "data": [ { "assignment_key": "8a369478-8024-4e55-97f0-f9e6f29cbbee", "status": "settled", "settled": true, "reference_date": "2026-09-29", "creation_datetime": "2026-09-29T06:00:12", "number_of_items": 459, "total_number_of_items": 459, "total_amount": 63848.05, "term_of_assignment_url": null, "signable_term_url": null, "external_identifier": null } ], "pagination": { "page": 1, "page_size": 10 } } ``` ## Erros | Status | Código | Descrição | | ------ | ------------ | -------------------------------- | | 400 | `ASG0000180` | `page_size` maior que `10`. | ## Próximo passo - [Consultar lote de cessão](/documentation/manual_cessao/referencia/consultar-lote-de-cessao)