Consulta de análises de consolidação

Lista a análise de consolidação vigente de cada despesa que recebe nota fiscal da gestora ou da consultoria: notas a enviar, em análise, aguardando a decisão da gestora e já decididas. A gestora vê todos os fundos dela; a consultoria informa o fundo.

Para a análise de uma despesa específica, use Consultar a análise vigente.

Listar análises

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Leitura
Consultoria	consultant-api	Ler Consolidações

URL base de cada host: Ambientes (Hosts).

ENDPOINT

/expense/consolidation_analyses

MÉTODO

GET

Parâmetros de consulta

Parâmetro	Tipo	Obrigatório	Descrição
status	string	Não	Status da análise, vários separados por vírgula: pending_submission, in_manual_analysis, pending_manager_approval, approved, reproved, consolidated, canceled.
fund_class_key	string	Condicional	Restringe a um fundo. Obrigatório para a consultoria.
limit	integer	Não	Itens por página, de 0 a 200. Padrão: 10.
page	integer	Não	Página, a partir de 0. Padrão: 0.

• Análises em pending_submission ou reproved só aparecem quando a despesa está pre_approved ou in_provision, isto é, quando já cabe enviar a nota.
• Para a consultoria, a lista traz todas as despesas do fundo informado que recebem nota, inclusive as lançadas pela gestora e as calculadas pela QI Tech. Sem Ler Consolidações nesse fundo, a resposta é 403 (EXP000219).
• A lista vem da análise mais recente para a mais antiga.

STATUS

200

Corpo da resposta

{
    "data": [
        {
            "consolidation_analysis_key": "e3f4a5b6-c7d8-4e9f-8a0b-1c2d3e4f5a6b",
            "analysis_number": 1,
            "status": "pending_submission",
            "payment_method": "transfer",
            "payment_date": "2026-11-20",
            "payment_value": 15000.0,
            "total_rebate_value": null,
            "reproval_reason": null,
            "reproval_details": null,
            "last_updated": "2026-11-09T14:10:00Z",
            "expense": {
                "expense_key": "b7f1c8e2-5a7d-4c7f-9a0e-2c3d4e5f6a7b",
                "status": "pre_approved",
                "type": "audit_tax",
                "description": "Auditoria do exercício 2026"
            }
        }
    ],
    "limit": 10,
    "page": 0,
    "is_last_page": true
}

• total_rebate_value só vem preenchido na taxa de gestão, como na análise de consolidação.
• expense traz a despesa com os campos da consulta de despesas até payment_confirmation. O exemplo mostra só alguns.

Erros

Status	code	Quando acontece
400	EXP000187	status com valor fora da lista.
400	EXP000188	Consultoria sem fund_class_key.
403	EXP000124	Consultoria sem vínculo ativo com o fundo de fund_class_key.
403	EXP000219	Consultoria sem Ler Consolidações no fundo de fund_class_key.
404	EXP000018	A gestora não tem fundos no serviço de despesas.
500	QIT000500	limit ou page fora do intervalo. A validação desses parâmetros chega como erro interno: corrija o parâmetro e repita a chamada.

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