Tipos de despesa e meios de pagamento

Os valores de type e de payment_method das despesas do fundo e as duas chamadas para usar antes do lançamento: listar os tipos de despesa, com o que cada um exige, e listar os contratos do fundo que aceitam um tipo.

Tipos de despesa

type	Descrição	Contrato	Lançamento pela API
administration_tax	Taxa de administração	Sim, da estruturação do fundo	Não: calculada pela QI Tech
management_tax	Taxa de gestão	Sim, da estruturação do fundo	Não: calculada pela QI Tech
performance_fee	Taxa de performance	Sim, da estruturação do fundo	Não: calculada pela QI Tech
custody_tax	Taxa de custódia	Sim	Não: calculada pela QI Tech
audit_tax	Taxa de auditoria	Sim	Sim
consulting_fee	Honorário de consultoria	Sim	Sim
distribution_fee	Taxa de distribuição	Sim (não no rebate)	Sim
bank_account	Conta bancária	Sim	Sim
bankslip_fee	Tarifa de boleto	Sim	Sim
sale_commission_tax	Comissão de venda	Sim	Sim
certifier_fee	Certificação	Sim	Sim
rating_agency_fee	Agência de rating	Sim	Sim
lawyer_fee	Advogados	Sim	Sim
bookkeeping_fee	Taxa de escrituração	Sim	Sim
insurance_fee	Seguro	Sim	Sim
collection_agent_fee	Taxa de agente de cobrança	Sim	Sim
servicing_fee	Taxa de servicing	Sim	Sim
fund_structuring_fee	Taxa de estruturação	Sim	Sim
credit_rights_registration_fee	Taxa de registro de direitos creditórios	Sim, da estruturação do fundo	Sim
origination_fee	Taxa de originação	Sim	Sim
pass_through_agent_fee	Taxa de agente de repasse	Sim	Não aceito
cvm_tax	Taxa CVM	Não	Sim
anbima_tax	Taxa ANBIMA	Não	Sim
cetip_tax	Taxa CETIP	Não	Não: calculada pela QI Tech
selic_tax	Taxa SELIC	Não	Não: calculada pela QI Tech
notary	Cartório	Não	Sim
court_fee	Custas judiciais	Não	Sim

Nos tipos com contrato, o fornecedor e o contrato precisam existir antes do lançamento. Nos tipos sem contrato, a despesa é lançada direto.

Meios de pagamento

payment_method	Descrição
transfer	TED para a conta em payment.target_account.
pix	Pix para a conta em payment.target_account, para a chave em payment.target_pix_key ou pelo QR Code em payment.pix_qrcode.
bank_slip	Pagamento do boleto em payment.bank_slip.digitable_line.
automatic_debit	Débito automático na conta do fundo em payment.source_account.

Listar tipos de despesa

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Leitura
Consultoria	consultant-api	Integração ativa

URL base de cada host: Ambientes (Hosts).

ENDPOINT

/expense/expense_types

MÉTODO

GET

STATUS

200

Corpo da resposta

{
    "data": [
        {
            "expense_type": "cvm_tax",
            "requires_contract": false,
            "requires_invoice": false
        },
        {
            "expense_type": "notary",
            "requires_contract": false,
            "requires_invoice": true
        },
        {
            "expense_type": "audit_tax",
            "requires_contract": true,
            "requires_invoice": true
        }
    ]
}

Campo	Descrição
expense_type	Tipo de despesa.
requires_contract	true quando o lançamento exige contract_key.
requires_invoice	true quando a análise de consolidação exige nota fiscal.

A lista traz os tipos que podem ser lançados: todos, menos os calculados pela QI Tech (cetip_tax, selic_tax, custody_tax, administration_tax, management_tax e performance_fee). pass_through_agent_fee aparece na lista, mas ainda não é aceito no lançamento pela API.

Listar contratos do fundo por tipo de despesa

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_type/{expense_type}/contracts

MÉTODO

GET

Parâmetros de caminho

Parâmetro	Tipo	Descrição
fund_class_key	string	Chave da classe de fundo (UUID).
expense_type	string	Tipo de despesa.

Parâmetros de consulta

Parâmetro	Tipo	Obrigatório	Descrição
limit	integer	Não	Itens por página, de 1 a 100. Padrão: 10.
page	integer	Não	Página, a partir de 0. Padrão: 0.

Lista os contratos do fundo que cobrem o tipo e estão em andamento ou active.

STATUS

200

Corpo da resposta

{
    "requires_contract": true,
    "automatic_calculation": null,
    "data": [
        {
            "contract_key": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
            "name": "Auditoria 2026",
            "status": "active",
            "accepts_expense": true,
            "vendor": {
                "vendor_key": "5d2e7b9a-3c4f-4e8a-b1d6-9f0a2c3e4b57",
                "name": "AUDITORES EXEMPLO S.A.",
                "document_number": "44.555.666/0001-81",
                "status": "registered",
                "agent_key": "a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c"
            }
        }
    ],
    "limit": 10,
    "page": 0,
    "is_last_page": true
}

Campo	Descrição
requires_contract	false para tipos sem contrato; nesse caso data vem vazio.
automatic_calculation	{"target": ...} quando o tipo é calculado automaticamente num dos contratos da página; senão null.
data[].accepts_expense	true quando o contrato aceita despesas do tipo lançadas pela gestora ou pela consultoria. Contratos ainda em análise aceitam, e a despesa espera em pending_contract_analysis. false quando o tipo é calculado automaticamente nesse contrato.
data[].vendor	Fornecedor do contrato, como em atributos do contrato.

Erros

Status	code	Quando acontece
400	EXP000069	A classe de fundo não é da gestora.
403	EXP000124	A consultoria não tem vínculo ativo com o fundo. Normalmente o consultant-api recusa antes, com 401 (CIT000018).
404	EXP000005	Tipo de despesa inexistente.
500	QIT000500	limit ou page fora do intervalo ou não inteiro. 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.