Aprovação do Gestor

Após a elegibilidade do lote ser aprovada, o gestor do fundo deve analisar e decidir pela aprovação ou reprovação do lote. Se aprovado, o sistema gera o Termo de Cessão e o encaminha para assinatura. Se reprovado, o lote é descartado e o processo se encerra.

Rota exclusiva para Gestores

Este endpoint está disponível somente para gestores do fundo. Caso o gestor não seja integrado via API, essa ação pode ser realizada pelo Portal do Gestor.

Onde estou no fluxo?

Este passo ocorre após a elegibilidade do lote ter sido aprovada. Você receberá um webhook com o status pending_manager_approval indicando que o lote está aguardando a decisão do gestor.

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 — Aprovação

{
    "assignment_status": "approved",
    "disbursement_account_key": "764746ce-a530-4a71-af66-3f7c879627df"
}

Request Body — Reprovação

{
    "assignment_status": "denied"
}

Atributos do body

Campo	Tipo	Obrigatoriedade	Descrição
assignment_status	string	obrigatório	Decisão do gestor sobre o lote. Valores aceitos: approved ou denied.
disbursement_account_key	string	opcional	Chave única (UUID, 36 caracteres) da conta de desembolso cadastrada na homologação do cedente. Se não informada, será utilizada a conta padrão configurada no contrato de cessão.

Enumeradores de assignment_status:

Valor	Descrição
approved	Aprova o lote — o sistema gerará o Termo de Cessão
denied	Reprova o lote — o lote será descartado

Response

STATUS

200

Response Body — Aprovação

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

Response Body — Reprovação

{
    "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
    "status": "denied",
    "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 após a decisão do gestor (approved ou denied).
number_of_approved_assets	integer	Quantidade de ativos aprovados na elegibilidade. Em caso de reprovação, o valor será 0.
assignment_total_value	number	Valor total da cessão em reais. Em caso de reprovação, o valor será 0.00.

Possíveis erros

STATUS

400

Lote não encontrado

O external_id informado na URL não corresponde a nenhum lote existente nesta configuração de cessão. Verifique se o identificador está correto e se você está usando a fund_class_key e assignment_configuration_key corretas.

{
  "title": "Assignment not found",
  "description": "Assignment not found",
  "translation": "Cessão não foi encontrada",
  "code": "TRC000018"
}

STATUS

400

Operação inválida para o status atual

O lote não está em um status que permita aprovação ou reprovação. Isso geralmente ocorre quando o lote ainda não passou pela elegibilidade, ou quando já foi aprovado/reprovado anteriormente. Consulte o status atual do lote via Recuperação do Lote para entender em qual etapa ele se encontra.

{
  "title": "Invalid operation",
  "description": "This assignment can not receive 'denied' status",
  "translation": "Esse lote não pode receber o status 'denied'",
  "code": "TRC000024"
}

Próximos passos

Após a aprovação do gestor, o fluxo continua automaticamente:

1. Assinatura do Termo de Cessão — o sistema gera o Termo de Cessão e o envia para assinatura de todas as partes. Você receberá um webhook com status pending_assignment_term_signature. O documento pode ser consultado via Documentos da Cessão.
2. Pagamento — após a assinatura, o sistema realiza o pagamento ao cedente. Um webhook com status pending_payment será enviado.
3. Encarteiramento — os ativos são incluídos na carteira do fundo e o lote é finalizado com status completed.