Inserção de Ativo para Recompra

Endpoint para inserir, num lote de substituição, um ativo da carteira do fundo que será recomprado pelo cedente. O valor dos ativos recomprados é abatido do pagamento da cessão dos novos ativos do mesmo lote.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita
Consultoria	consultant-api	Lotes

URL base de cada host: Ambientes (Hosts).

Lotes de substituição

Este endpoint só aceita lotes criados numa configuração de cessão de recompra (assignment_configuration_type = repurchase_configuration). O lote precisa estar em pending_assets_insertion. Os ativos de recompra e os novos ativos podem ser inseridos em qualquer ordem enquanto o lote estiver aberto.

Para encerrar a inserção, o lote precisa ter pelo menos um ativo de recompra, e o valor dos novos ativos não pode ser menor que o dos ativos recomprados — veja Encerrar Inserção de Ativos.

Onde estou no fluxo?

Antes, você deve ter criado o lote. Insira também 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": "11.222.333/0001-81",
    "repurchase_value": 1000.00,
    "settlement_type": "asset_settlement"
}

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	O external_id com que o ativo foi originalmente cedido ao fundo. De 1 a 50 caracteres.
assignor_document_number	string	obrigatório	CPF ou CNPJ, com pontuação, do cedente que cedeu o ativo ao fundo.
settlement_type	string	obrigatório	Modalidade da recompra. Veja a tabela abaixo.
repurchase_value	number	opcional	Valor de recompra, em reais. Mínimo 0.01. Se omitido, vale o valor justo atual do ativo na carteira do fundo.

Valores de settlement_type:

Valor	Descrição
asset_settlement	Recompra total do ativo.
asset_amortization	Recompra parcial (amortização) do ativo.

Response

STATUS

201

Response Body (assignment resumido)

{
    "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-4890-abcd-ef1234567890",
        "document_number": "11.222.333/0001-81",
        "name": "Cedente Exemplo Ltda"
    },
    "status": "pending_assignment_validation",
    "assignment": {
        "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
        "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
        "name": "CESSÃO #12345",
        "assignment_number": "12345",
        "assignment_date": "2024-04-01",
        "status": "pending_assets_insertion",
        "origin_type": "client"
    },
    "repurchase_value": 1000.00,
    "contract_number": "000123",
    "maturity_date": "2024-09-30"
}

Atributos da resposta

Campo	Tipo	Descrição
repurchased_asset_key	string	Identificador único da recompra gerado pela QI Tech (UUID).
asset_type	string	Tipo do ativo recomprado.
asset_key	string	Identificador do ativo na carteira do fundo (UUID).
external_id	string	O external_id do ativo, conforme informado na requisição.
assignor	object	Cedente que cedeu o ativo: assignor_key, document_number e name.
status	string	Status da recompra. Veja a tabela abaixo.
assignment	object	Lote de substituição, com a mesma estrutura da Recuperação do Lote, sem status_events.
repurchase_value	number	Valor de recompra, em reais.
contract_number	string	Número do contrato do ativo recomprado, quando houver.
maturity_date	string	Vencimento do ativo recomprado, no formato YYYY-MM-DD.

Status da recompra:

Status	Descrição
pending_assignment_validation	Recompra registrada, aguardando o lote seguir o fluxo.
sending_to_wallet	Recompra sendo liquidada na carteira do fundo.
completed	Recompra concluída.
discarded	Recompra descartada junto com o lote.

Erros

Status	Código	Quando acontece
400	TRC000088	A configuração de cessão do lote não é de recompra.
400	TRC000089	O lote não está em pending_assets_insertion.
400	TRC000090	O ativo não foi encontrado na carteira do fundo para esse cedente, tipo e external_id, ou não pode ser recomprado.
404	TRC000005	Nenhum cedente com esse assignor_document_number.
404	TRC000012	asset_type inexistente.
404	TRC000018	Nenhum lote com esse external_id nesta configuração de cessão.

Erros de autenticação, permissão e host: veja Erros da API.

Próximos passos

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.