Carteira - Aprovação

Aprova ou reprova a carteira de validação. Só é aceito para carteiras no status pending_confirmation — o status em que a carteira fica quando está pronta para a sua análise e em que a gestora recebe o webhook de mudança de status.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

/composition/fund_class/FUND_CLASS_KEY/composition/COMPOSITION_KEY

MÉTODO

PUT

Request Body — aprovar

{
    "new_status": "confirmed"
}

Request Body — reprovar

{
    "new_status": "reproved_by_agent",
    "reproved_reason": "Cota divergente do controle interno da gestora."
}

Campo	Tipo	Obrigatório	Descrição
new_status	string	Sim	Novo status da carteira. Ver enumeradores abaixo.
reproved_reason	string	Sim, quando new_status é reproved_by_agent	Motivo da reprovação, de 1 a 255 caracteres.

Enumeradores do "new_status"

Enumerador	Descrição
confirmed	Aprova a carteira.
reproved_by_agent	Reprova a carteira, registrando o motivo informado em reproved_reason.
reproved	Reprova a carteira sem exigir motivo. Prefira reproved_by_agent.

O motivo da reprovação fica registrado no histórico da carteira: o campo status_events da consulta da carteira traz cada mudança de status com o seu metadata.

Response

Em caso de sucesso, a API devolve 204 No Content, sem corpo. Consulte a carteira para ver o novo status.

Erros

Status	Código	Quando acontece
404	CMP000013	A carteira não está em pending_confirmation (já foi aprovada, reprovada ou ainda está em processamento).
404	CMP000010	new_status diferente de confirmed, reproved_by_agent ou reproved.
404	CMP000025	new_status é reproved_by_agent e reproved_reason não foi enviado.
404	CMP000012	Não existe carteira com essa composition_key na classe informada.
404	CMP000001	Não existe classe com essa fund_class_key.
409	CMP000022	Já existe outra carteira da mesma classe, data e tipo no status pedido.
400	QIT000001	Corpo fora do contrato: new_status ausente ou fora dos valores aceitos, ou campo não previsto.
400	QIT000004	A fund_class_key é de uma classe de outra gestora.

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