Aprovação do Lote

Quando a configuração de cessão exige aprovação manual, o lote aprovado na elegibilidade fica aguardando a decisão da consultoria (pending_consultant_approval) e/ou da gestora (pending_manager_approval). Este endpoint registra essa decisão: aprovar ou reprovar o lote.

Disponível em

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

URL base de cada host: Ambientes (Hosts).

O cedente acessa o mesmo endpoint pela assignor-api para encerrar a inserção, mas não pode enviar approved nem denied (TRC000059).

Quem decide em cada status

Status do lote	Gestora	Consultoria
pending_consultant_approval	Pode reprovar (denied) ou reabrir (pending_assets_insertion). Não pode aprovar.	Pode aprovar, reprovar ou reabrir.
pending_manager_approval	Pode aprovar, reprovar ou reabrir.	Não pode agir (TRC000087).

A mesma decisão pode ser tomada pelo Portal do Gestor ou pelo Portal do Consultor.

Onde estou no fluxo?

Este passo ocorre após a elegibilidade do lote. Você recebe um webhook com o status pending_consultant_approval ou pending_manager_approval indicando que o lote aguarda decisão. Para retirar ativos antes de aprovar, veja Remoção de Ativos do Lote.

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",
    "number_of_approved_assets": 45,
    "assignment_total_value": 150000.00
}

Request Body — Reprovação

{
    "assignment_status": "denied",
    "denial_reason": {
        "reason_type": "manager",
        "denial_reason": "Concentração por sacado acima do limite do fundo"
    }
}

Atributos do body

Campo	Tipo	Obrigatoriedade	Descrição
assignment_status	string	obrigatório	approved aprova o lote; denied reprova.
disbursement_account_key	string	opcional	Só na aprovação. Chave (UUID) da conta do cedente que receberá o pagamento, entre as contas cadastradas na homologação do cedente. Se omitida, é usada a conta marcada como padrão do cedente. Recusada quando o lote já tem conta de desembolso definida ou quando o contrato de cessão fixa outra conta.
transfer_type	string	opcional	Só na aprovação. Forma de pagamento ao cedente: pix ou wire_transfer. Se omitida, vale a do lote ou da configuração de cessão.
number_of_approved_assets	integer	opcional	Só na aprovação. Quantidade de ativos aprovados que você espera no lote. Se enviado, assignment_total_value também é obrigatório, e os dois são conferidos com o lote antes de aprovar. Use para garantir que aprova exatamente o que analisou. A conferência só é feita na aprovação que encerra a decisão: quando a aprovação da consultoria leva o lote para pending_manager_approval, os dois campos são ignorados.
assignment_total_value	number	opcional	Só na aprovação. Valor total do lote que você espera, em reais. Enviado junto com number_of_approved_assets.
denial_reason	object	opcional	Só na reprovação. Motivo da reprovação: reason_type (obrigatório dentro do objeto; use manager ou consultant) e denial_reason (texto livre). Fica registrado em status_events[].denial_reason e status_events[].denial_metadata na Recuperação do Lote.

Response

STATUS

200

Response Body — Aprovação

{
    "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
    "status": "waiting_assets_to_formalize",
    "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"
}

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. Na aprovação: pending_manager_approval (consultoria aprovou e a gestora ainda precisa aprovar), pending_assets_registry (configurações com registro dos ativos) ou waiting_assets_to_formalize. Na reprovação: denied.
number_of_approved_assets	integer	Só na aprovação. Quantidade de ativos aprovados no lote. É 0 quando o lote segue para a gestora.
assignment_total_value	number	Só na aprovação. Valor total da cessão, em reais.

Aprovação final sem webhook

Quando a aprovação leva o lote para pending_assets_registry ou waiting_assets_to_formalize, nenhum webhook do lote é enviado nessa transição: use o status da resposta. O próximo webhook do lote chega na etapa seguinte (termo de cessão, custódia ou pagamento). A transição para pending_manager_approval gera webhook normalmente.

Um lote reprovado (denied) não volta para a esteira pela API. No fechamento contábil do dia ele passa para discarded.

Erros

Status	Código	Quando acontece
400	TRC000024	O lote não está em um status que aceite essa decisão (por exemplo, já aprovado ou ainda em elegibilidade). Consulte a Recuperação do Lote.
400	TRC000087	A gestora tentou aprovar um lote em pending_consultant_approval, ou a consultoria tentou agir num lote em pending_manager_approval.
400	TRC000059	O cedente enviou approved ou denied.
400	TRC000095	Foi enviado só um entre number_of_approved_assets e assignment_total_value.
400	TRC000096	assignment_total_value não confere com o valor atual do lote.
400	TRC000097	number_of_approved_assets não confere com a quantidade de ativos aprovados.
400	TRC000118	Foi enviado disbursement_account_key, mas o lote já tem conta de desembolso definida.
400	TRC000149	Os descontos ao cedente superam o limite permitido para o lote.
400	TRC000185	disbursement_account_key diferente da conta fixada no contrato de cessão.
404	TRC000018	Nenhum lote com esse external_id nesta configuração de cessão.
404	TRC000116	disbursement_account_key não corresponde a nenhuma conta do cedente.
422	TRC000186	A conta de desembolso fixada no contrato de cessão não está mais ativa no cadastro do cedente. Contate o time de integração.

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

Próximos passos

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

1. Registro e formalização dos ativos — conforme o tipo de registro da configuração de cessão.
2. Termo de Cessão — o termo é gerado e enviado para assinatura. Você recebe um webhook com status pending_assignment_term_signature. O documento pode ser consultado via Documentos da Cessão.
3. Pagamento — após a assinatura, o sistema realiza o pagamento ao cedente. Um webhook com status pending_payment é enviado.
4. Encarteiramento — os ativos são incluídos na carteira do fundo e o lote é finalizado com status completed.