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, quando todos os ativos estiverem pré-aprovados (pre_approved) ou descartados (discarded), a elegibilidade do lote como um todo será avaliada automaticamente.

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 aguardará automaticamente até que todos estejam com análise finalizada 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	Status para o qual o lote será atualizado. Para encerrar a inserção de ativos, envie completed_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": 0.00
}

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.
number_of_approved_assets	integer	Quantidade de ativos aprovados no lote. Nesta etapa, o valor será 0 pois a elegibilidade ainda não foi processada.
assignment_total_value	number	Valor total da cessão em reais. Nesta etapa, o valor será 0.00 pois a precificação ainda não ocorreu.

Possíveis erros

STATUS

400

Lote sem ativos inseridos

Você tentou encerrar a inserção de ativos, mas o lote ainda não possui nenhum ativo. É necessário inserir pelo menos um ativo antes de fechar o lote.

{
  "title": "Cannot Close This Assignment",
  "description": "Cannot close this assignment because there is no asset.",
  "translation": "Não é possível fechar este lote porque não há nenhum ativo.",
  "code": "TRC000042"
}

Próximos passos

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

1. Elegibilidade dos ativos — cada ativo será analisado individualmente. Você receberá webhooks dos ativos informando aprovação ou reprovação.
2. Elegibilidade do lote — quando todos os ativos tiverem sido analisados, a elegibilidade do lote será avaliada. O resultado será informado via webhook do lote.
3. Aprovação do gestor — caso o lote seja aprovado na elegibilidade, o gestor do fundo deverá aprová-lo.