Decisão da gestora sobre despesa da consultoria

Quando a consultoria vinculada ao fundo lança uma despesa ou envia uma nota fiscal, a QI Tech analisa primeiro. Depois, a despesa ou a nota fica em pending_manager_approval, aguardando a gestora aprovar ou reprovar. São duas chamadas:

O que aguarda a decisão	Onde aparece	Chamada
A despesa com provisão	Despesa pending_manager_approval	Decidir a despesa
A nota fiscal (análise de consolidação)	consolidation_analysis.status pending_manager_approval	Decidir a nota fiscal

Para encontrar o que aguarda a gestora, filtre a lista de despesas com status=pending_manager_approval, ou a lista de análises com status=pending_manager_approval.

Quem lançou ou enviou a despesa ou a nota, ou abriu a análise vigente, não pode decidi-la. Pela API, a identidade comparada é a chave da gestora. Despesas lançadas pela própria gestora não passam por esta etapa.

Corpo da decisão

As duas chamadas usam o mesmo corpo.

Corpo da requisição — reprovação

{
    "status": "reproved",
    "reproval_details": "Valor diverge do orçamento aprovado."
}

Campo	Tipo	Obrigatório	Descrição
status	string	Sim	approved ou reproved.
reproval_details	string	Condicional	Motivo da reprovação, de 1 a 1000 caracteres. Obrigatório com reproved; com approved, é ignorado.

Decidir a despesa

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita

URL base de cada host: Ambientes (Hosts).

ENDPOINT

/expense/fund_class/{fund_class_key}/expense/{expense_key}

MÉTODO

PUT

Aprova ou reprova uma despesa da consultoria em pending_manager_approval. Vale com a análise de consolidação fora de revisão; se a nota está em revisão, decida pela nota fiscal.

STATUS

200

A despesa, na estrutura da consulta por chave, com permission_type: viewer, sem status_events e consolidation_status_events:

• Reprovada: reproved, com reproval_reason: manager_reproval. A análise de consolidação vigente também fica reproved.
• Aprovada: entra na carteira em in_provision, ou vai para pending_contract_analysis se o contrato ainda está em análise. Datas de pagamento ou de provisão que já passaram vão para o primeiro dia útil a partir de hoje.

Decidir a nota fiscal

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita

URL base de cada host: Ambientes (Hosts).

ENDPOINT

/expense/fund_class/{fund_class_key}/expense/{expense_key}/consolidation_analysis

MÉTODO

PUT

Aprova ou reprova a nota fiscal da consultoria. Vale com a análise de consolidação em pending_manager_approval.

STATUS

200

A análise de consolidação, na estrutura de Análise de consolidação:

• Reprovada: análise reproved, com reproval_reason: manager_reproval.
  • Uma despesa ainda em in_manual_analysis ou pending_manager_approval é reprovada junto.
  • Num rebate, a despesa não muda, e a análise da taxa de gestão, se ainda aberta, é reprovada com rebate_inconsistency.
• Aprovada: análise approved.
  • A despesa é consolidada, e o pagamento é agendado para a data da análise ou o primeiro dia útil disponível (depois das 17h, o seguinte).
  • Uma despesa que ainda não está na carteira entra nela antes de ser consolidada, ou vai para pending_contract_analysis se o contrato ainda está em análise.
  • Na taxa de gestão, os rebates aprovados são consolidados antes, cada um pelo próprio valor. total_rebate_value passa a ser a soma deles, e a taxa é consolidada pelo payment_value (o valor líquido).
  • Num rebate, só a análise é aprovada; ele é consolidado junto com a taxa de gestão.

Erros

Status	code	Quando acontece
400	EXP000154	A despesa ou a análise não está em pending_manager_approval.
400	EXP000162	A nota fiscal da despesa está em revisão: decida pela nota fiscal.
400	EXP000150	reproved sem reproval_details.
400	QIT000001	Corpo inválido: sem status, status fora de approved e reproved, reproval_details vazio ou com mais de 1000 caracteres, ou campo não previsto.
400	EXP000153	Aprovação: o contrato deixou de aceitar a despesa.
400	EXP000037, EXP000008, EXP000009, EXP000027	Aprovação de uma despesa que ainda não está na carteira: datas incompatíveis com a data contábil do fundo ou fora de dia útil.
400	EXP000157	Aprovação da nota da taxa de gestão com rebates ainda em análise.
400	EXP000085, EXP000086, EXP000036	Aprovação da nota: a despesa não tem favorecido ou destino de pagamento.
400	EXP000043, EXP000044	Aprovação da nota por boleto: falta a linha digitável, ou o valor do boleto difere do consolidado.
400	EXP000011, EXP000051, EXP000073, EXP000074	Aprovação da nota: a despesa já está consolidada, cancelada, paga ou concluída.
400	EXP000069	A classe de fundo não é da gestora.
403	EXP000207	Você lançou ou enviou a despesa ou a nota, ou abriu a análise vigente: não pode decidi-la.
404	EXP000010	A despesa não existe no fundo.
503	EXP000132	A API não conseguiu ler o contrato. Tente de novo.

Exemplo

{
  "title": "Expense Not Pending Manager Approval",
  "description": "The expense is in status pre_approved, not pending manager approval.",
  "translation": "A despesa esta no status pre_approved, nao aguardando aprovacao do gestor.",
  "code": "EXP000154"
}

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