Inserção de Ativo para Recompra

Endpoint para inserir um ativo que será recomprado pelo cedente em um lote de substituição. A recompra ocorre quando o cedente precisa retirar um ativo da carteira do fundo, substituindo-o por novos ativos.

Lotes de substituição

Este endpoint é utilizado exclusivamente em lotes de substituição. O fluxo de substituição difere do fluxo de cessão padrão por incluir um passo adicional: a inserção dos ativos a serem recomprados, antes da inserção dos novos ativos.

Para mais detalhes, consulte o Manual de Cessão de Direitos Creditórios.

Onde estou no fluxo?

Este é o 2º passo do fluxo de substituição. Antes, você deve ter criado o lote. Após inserir os ativos de recompra, insira os novos ativos que substituirão os recomprados.

Request

ENDPOINT

/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment/{assignment_external_id}/repurchased_asset

MÉTODO

POST

Request Body

{
    "asset_type": "duplicata_mercantil",
    "external_id": "88c2304e-8eb3-44e0-acb4-25811ae20cf1",
    "assignor_document_number": "66.642.277/0001-26",
    "repurchase_value": 1000.00
}

Atributos do body

Campo	Tipo	Obrigatoriedade	Descrição
asset_type	string	obrigatório	Tipo do ativo que será recomprado (ex: ccb, duplicata_mercantil, discounted_contract).
external_id	string	obrigatório	Identificador externo do ativo que será recomprado. Deve ser o mesmo external_id utilizado quando o ativo foi originalmente inserido.
assignor_document_number	string	obrigatório	CPF ou CNPJ do cedente que originalmente cedeu o ativo ao fundo.
repurchase_value	number	obrigatório	Valor de recompra do ativo. Até 2 casas decimais.

Response

STATUS

201

Response Body

{
    "repurchased_asset_key": "a6115a17-8b4d-49a3-aed6-47c9574eab88",
    "asset_type": "duplicata_mercantil",
    "asset_key": "65bbce6d-e0b4-4471-a702-e0ced4542e5b",
    "external_id": "88c2304e-8eb3-44e0-acb4-25811ae20cf1",
    "assignor": {
        "assignor_key": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
        "document_number": "66.642.277/0001-26",
        "name": "Cedente Exemplo Ltda"
    },
    "status": "pending_eligibility",
    "assignment": {
        "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
        "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
        "name": "CESSÃO #12345",
        "assignment_number": "00012345",
        "assignment_date": "2024-04-01",
        "status": "pending_assets_insertion",
        "origin_type": "client"
    },
    "repurchase_value": 1000.00
}

Atributos da resposta

Campo	Tipo	Descrição
repurchased_asset_key	string	Identificador único do registro de recompra gerado pela QI Tech (UUID).
asset_type	string	Tipo do ativo recomprado.
asset_key	string	Identificador único do ativo original na carteira do fundo (UUID).
external_id	string	Identificador externo do ativo, conforme informado na requisição.
assignor	object	Dados do cedente que originalmente cedeu o ativo.
status	string	Status atual do ativo de recompra.
assignment	object	Dados do lote de substituição ao qual o ativo de recompra pertence. Consulte os atributos do lote na página de Recuperação do Lote.
repurchase_value	number	Valor de recompra do ativo, conforme informado na requisição.

Atributos de assignor

Campo	Tipo	Descrição
assignor_key	string	Identificador único do cedente (UUID).
document_number	string	CPF ou CNPJ do cedente.
name	string	Nome do cedente.

Próximos passos

Após inserir os ativos de recompra, o fluxo continua com:

1. Inserção dos novos ativos — adicione os ativos que substituirão os recomprados.
2. Envio dos documentos — envie a documentação exigida para cada novo ativo.
3. Encerramento da inserção — sinalize que todos os ativos foram inseridos para que o lote siga para a análise de elegibilidade.