Decisão da gestora sobre contrato da consultoria

Aprova ou reprova um contrato lançado por uma consultoria vinculada ao fundo. Depois da análise da QI Tech, esse contrato espera a decisão da gestora em pending_manager_approval. Contratos lançados pela própria gestora não passam por esta etapa.

Para encontrar os contratos que aguardam a gestora, filtre a lista de contratos por status=pending_manager_approval.

Aprovar ou reprovar

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita

URL base de cada host: Ambientes (Hosts).

ENDPOINT

/expense_contract/fund_class/{fund_class_key}/contract/{contract_key}/status

MÉTODO

PUT

Parâmetros de caminho

Parâmetro	Tipo	Descrição
fund_class_key	string	Chave da classe de fundo (UUID).
contract_key	string	Chave do contrato (UUID).

Corpo da requisição — reprovação

{
    "status": "reproved",
    "reproval_details": "Valor acima do orçado para o exercício."
}

Atributos do corpo

Campo	Tipo	Obrigatório	Descrição
status	string	Sim	approved ou reproved.
reproval_details	string	Não	Motivo da reprovação, de 1 a 1000 caracteres. Não pode ser enviado com approved.

Resposta

STATUS

200

O contrato, na estrutura descrita em atributos do contrato.

• Reprovado: status: reproved, com reproval_reason: manager_reproval.
• Aprovado: o contrato vai para
  • pending_vendor_approval, se o cadastro do fornecedor ainda não foi aprovado;
  • active, se signature_method é external;
  • pending_signature, nos demais casos.

Erros

Status	code	Quando acontece
400	QIT000001	status diferente de approved e reproved, ou reproval_details enviado com approved.
404	ECT000005	A classe de fundo não existe ou você não tem acesso a ela.
404	ECT000009	O contrato não existe nessa classe de fundo.
409	ECT000023	O contrato não está em pending_manager_approval.
409	ECT000030	Aprovação: a gestora não tem grupo de assinantes cadastrado no portal, ou o fornecedor não tem grupo de assinantes valid.

Exemplo

{
  "title": "Invalid status change",
  "description": "A contract in status in_manual_analysis cannot change to approved through this route.",
  "translation": "Um contrato com status in_manual_analysis nao pode mudar para approved por esta rota.",
  "code": "ECT000023"
}

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