Criar lote de cessão

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.

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.	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

{
    "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.	—

[
    {
        "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 ou por Consultar lote de cessão.

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

Próximo passo

• Consultar lote de cessão