Encerrar Inserção de Ativos

Após inserir todos os ativos desejados no lote, utilize este endpoint para sinalizar que a inserção foi concluída. A partir desse momento o lote não recebe novos ativos. Quando todos os ativos estiverem com a análise individual concluída (pre_approved, pending_formalization, denied ou registry_denied), a elegibilidade do lote como um todo é avaliada automaticamente.

Disponível em

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

URL base de cada host: Ambientes (Hosts).

Não é necessário aguardar os webhooks dos ativos

Você pode encerrar a inserção a qualquer momento após inserir os ativos. Não é preciso esperar que todos os ativos passem pela elegibilidade individual: o sistema aguarda até que todos estejam com a análise concluída antes de prosseguir com a elegibilidade do lote.

Onde estou no fluxo?

Este é o 3º passo do fluxo de cessão. Antes deste passo, você deve ter:

1. Criado o lote
2. Inserido os ativos e enviado os documentos

Request

ENDPOINT

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

MÉTODO

PUT

Path params

Parâmetro	Tipo	Descrição
assignment_external_id	string	O external_id informado na criação do lote.

Request Body

{
    "assignment_status": "completed_assets_insertion"
}

Atributos do body

Campo	Tipo	Obrigatoriedade	Descrição
assignment_status	string	obrigatório	Para encerrar a inserção de ativos, envie completed_assets_insertion. O lote precisa estar em pending_assets_insertion.

Response

STATUS

200

Response Body

{
    "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
    "status": "completed_assets_insertion",
    "number_of_approved_assets": 0,
    "assignment_total_value": 15230.75
}

Atributos da resposta

Campo	Tipo	Descrição
assignment_key	string	Identificador único do lote (UUID).
external_id	string	Chave externa do lote fornecida pelo parceiro.
status	string	Novo status do lote: completed_assets_insertion, ou waiting_assignment_date quando a assignment_date do lote é posterior à data contábil do fundo. Nesse caso o lote passa para completed_assets_insertion na data da cessão. Essa passagem não gera webhook.
number_of_approved_assets	integer	Sempre 0 nesta chamada: a contagem de ativos aprovados só é feita na aprovação.
assignment_total_value	number	Soma do total_purchase_value dos ativos não reprovados (denied/registry_denied), em reais. Em lotes de substituição, já descontado o valor dos ativos recomprados.

Erros

Status	Código	Quando acontece
400	TRC000023	assignment_status com valor não aceito. Os valores aceitos neste endpoint são completed_assets_insertion, pending_assets_insertion, approved e denied.
400	TRC000024	O lote não está em pending_assets_insertion.
400	TRC000042	O lote não tem nenhum ativo em análise ou aprovado. Insira pelo menos um ativo antes de encerrar.
400	TRC000160	Todos os ativos do lote foram reprovados.
400	TRC000092	Lote de substituição: o valor dos novos ativos é menor que o valor dos ativos recomprados.
400	TRC000093	Lote de substituição sem nenhum ativo de recompra.
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

Após encerrar a inserção, o fluxo segue automaticamente:

1. Elegibilidade dos ativos — cada ativo é analisado individualmente. Você recebe webhooks dos ativos informando aprovação ou reprovação.
2. Elegibilidade do lote — quando todos os ativos tiverem sido analisados, a elegibilidade do lote é avaliada. O resultado é informado via webhook do lote.
3. Aprovação — se a configuração de cessão exigir, a consultoria e/ou a gestora aprovam o lote.