Análise de consolidação

A análise de consolidação é a etapa da nota fiscal: a gestora ou a consultoria envia a nota da despesa, e a QI Tech confere a nota, o valor e os dados de pagamento antes de consolidar e pagar. Cada despesa tem uma análise vigente (analysis_number 1, 2...). Uma análise reprovada é substituída por uma nova.

Recebem nota por aqui:

• as despesas lançadas pela gestora ou pela consultoria;
• as despesas calculadas pela QI Tech em que a nota é da gestora:
  • origens manual, performance_fee e expense_control;
  • origem quota_fee, exceto custody_tax e administration_tax;
  • origem recurring_expense consolidada pela gestora e paga sem débito automático.

Fluxo:

1. A despesa fica pre_approved ou in_provision, com a análise em pending_submission.
2. Anexe a nota fiscal e os demais documentos à análise.
3. Envie a nota fiscal: a análise vai para in_manual_analysis.
4. A QI Tech aprova (análise approved, despesa consolidated) ou reprova (reproved). Uma nota enviada pela consultoria passa antes pela decisão da gestora (pending_manager_approval).
5. Na reprovação, se a despesa continua pre_approved ou in_provision, abra uma nova análise e repita a partir do passo 2. Se a despesa também ficou reproved (ela ainda estava em in_manual_analysis ou pending_manager_approval), lance outra despesa.

A nota também pode ir no lançamento da despesa: a análise é enviada junto com a despesa.

Consultar a análise vigente

Disponível em

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

URL base de cada host: Ambientes (Hosts).

ENDPOINT

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

MÉTODO

GET

Devolve a análise vigente da despesa.

STATUS

200

Corpo da resposta

{
    "consolidation_analysis_key": "e3f4a5b6-c7d8-4e9f-8a0b-1c2d3e4f5a6b",
    "expense_key": "b7f1c8e2-5a7d-4c7f-9a0e-2c3d4e5f6a7b",
    "analysis_number": 2,
    "status": "pending_submission",
    "expense_description": "Auditoria do exercício 2026",
    "payment_method": "transfer",
    "payment": {
        "target": {
            "name": "AUDITORES EXEMPLO S.A.",
            "document_number": "44.555.666/0001-81"
        },
        "target_account": {
            "account_number": "123456",
            "account_branch": "0001",
            "account_digit": "7",
            "financial_institution_code": "341",
            "financial_institution_ispb": "60701190"
        }
    },
    "payment_date": "2026-11-20",
    "payment_value": 15000.0,
    "total_rebate_value": null,
    "is_reimbursement": false,
    "reimbursement_recipient": null,
    "reproval_reason": null,
    "reproval_details": null,
    "last_updated": "2026-11-09T14:10:00Z",
    "documents": [
        {
            "name": "nfe_001234.pdf",
            "document_key": "d4e5f6a7-b8c9-4123-def4-567890abcdef",
            "consolidation_analysis_key": "e3f4a5b6-c7d8-4e9f-8a0b-1c2d3e4f5a6b",
            "document_type": "invoice",
            "status": "in_manual_analysis"
        }
    ]
}

Atributos da análise

Campo	Tipo	Descrição
consolidation_analysis_key	string	Chave da análise (UUID).
expense_key	string	Chave da despesa.
analysis_number	integer	Número da análise, a partir de 1.
status	string	Ver status da análise.
expense_description	string	Descrição da despesa.
payment_method	string	transfer, pix, bank_slip ou automatic_debit.
payment	object	Dados de pagamento, na estrutura do lançamento.
payment_date	string	Data de pagamento, YYYY-MM-DD.
payment_value	number	Valor a pagar. Na taxa de gestão, é o valor líquido pago à gestora, sem os rebates.
total_rebate_value	number	Só na taxa de gestão: soma dos rebates da taxa, gravada no envio da nota e recalculada na aprovação com os rebates aprovados. payment_value + total_rebate_value é o valor bruto da taxa. null nas demais despesas e antes do envio.
is_reimbursement	boolean	true quando a despesa é um reembolso.
reimbursement_recipient	string	manager, consultant ou null.
reproval_reason	string	invalid_documents, missing_documents, incorrect_value, incorrect_payment_data, incorrect_information, manager_reproval, rebate_inconsistency ou null.
reproval_details	string	Detalhe da reprovação, ou null.
last_updated	string	Última alteração, ISO 8601 em UTC.
documents	array	Documentos da análise, inclusive os cancelados: name, document_key, consolidation_analysis_key, document_type, status.
rebates	array	Só na consulta da análise vigente de uma management_tax: rebates não cancelados, com expense_key, status, payment_value, consolidation_analysis_status, reproval_reason, reproval_details.

Anexar documento à análise

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita
Consultoria	consultant-api	Lançar e Editar Despesas ou Enviar Consolidações

URL base de cada host: Ambientes (Hosts).

ENDPOINT

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

MÉTODO

POST

Anexa a nota fiscal ou outro documento à análise. Vale com a análise em pending_submission ou reproved. Depois de uma reprovação, abra a nova análise antes e anexe nela: a nova análise não copia os documentos da anterior.

Corpo da requisição

{
    "name": "nfe_001234.pdf",
    "document_type": "invoice",
    "document_b64": "JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK..."
}

Campo	Tipo	Obrigatório	Descrição
name	string	Sim	Nome do arquivo, de 1 a 255 caracteres.
document_type	string	Sim	invoice (nota fiscal), bank_slip (boleto), calculation_memory (memória de cálculo), payment_receipt (comprovante de pagamento), settlement_term (termo de quitação), variance_justification (justificativa de diferença de valor) ou extra_document (documento adicional).
document_b64	string	Sim	Conteúdo em Base64, até 20 MB.

STATUS

201

Corpo da resposta

{
    "name": "nfe_001234.pdf",
    "document_key": "d4e5f6a7-b8c9-4123-def4-567890abcdef",
    "consolidation_analysis_key": "e3f4a5b6-c7d8-4e9f-8a0b-1c2d3e4f5a6b",
    "document_type": "invoice",
    "status": "in_manual_analysis"
}

Consultar e cancelar documento da análise

Para baixar um documento da análise:

Disponível em

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

URL base de cada host: Ambientes (Hosts).

ENDPOINT

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

MÉTODO

GET

Procura o documento em todas as análises da despesa, não só na vigente, e o devolve com document_url: o link para baixar o arquivo, válido por 24 horas e servido como application/pdf.

Para cancelar um documento da análise:

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita
Consultoria	consultant-api	Lançar e Editar Despesas ou Enviar Consolidações

URL base de cada host: Ambientes (Hosts).

ENDPOINT

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

MÉTODO

DELETE

Marca como canceled um documento da análise vigente. Vale com a análise em pending_submission ou reproved. Devolve 200 com o documento.

Abrir nova análise

Depois de uma reprovação, abre a análise seguinte em pending_submission. Valor, data e dados de pagamento são copiados da anterior; os documentos não. Vale com a análise vigente reproved e a despesa em pre_approved ou in_provision. Num rebate, o valor copiado precisa caber no saldo da taxa de gestão.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita
Consultoria	consultant-api	Lançar e Editar Despesas ou Enviar Consolidações

URL base de cada host: Ambientes (Hosts).

ENDPOINT

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

MÉTODO

POST

Esta chamada não leva corpo.

STATUS

201

A nova análise, na estrutura de atributos da análise, sem rebates.

Erros

Status	code	Quando acontece
400	EXP000164	A despesa não aceita análise de consolidação, ou a análise ou a despesa não está no status que a chamada exige.
400	EXP000163	Nova análise: a vigente não está reproved, ou a despesa não está em pre_approved nem in_provision.
400	EXP000087	Nova análise de rebate: o valor passa do saldo da taxa de gestão.
400	EXP000136	O documento não é Base64 válido.
400	EXP000137	O documento passa de 20 MB.
400	QIT000001	Corpo inválido: campo obrigatório ausente, document_type fora da lista ou campo não previsto.
400	EXP000069	A classe de fundo não é da gestora.
403	EXP000156	Você não lançou a despesa: a consultoria lançou e quem chama é a gestora, ou o contrário. Só quem lançou envia a nota, anexa e cancela documentos e abre nova análise.
404	EXP000010	A despesa não existe no fundo.
404	EXP000071	O documento não existe na análise.

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