Consulta de despesas consolidadas

Endpoints para consultar as despesas de uma classe de fundo. Existem dois modos de consulta: a listagem paginada de todas as despesas de uma classe de fundo, e a consulta individual de uma despesa específica.

Quando utilizar

Utilize estes endpoints para acompanhar o status das despesas cadastradas, verificar valores provisionados e consolidados, e consultar os dados de pagamento de cada despesa.

Listagem de despesas

Retorna a lista paginada de todas as despesas de uma classe de fundo, com suporte a diversos filtros.

Request

ENDPOINT

/expense/fund_class/{fund_class_key}/expenses

MÉTODO

GET

Query params

Parâmetro	Tipo	Obrigatoriedade	Descrição
page	integer	opcional	Número da página (começa em 0). Padrão: 0.
limit	integer	opcional	Quantidade de registros por página. Mínimo: 0. Máximo: 100. Padrão: 10.
reference_date	string	opcional	Filtra despesas pela data de referência exata, no formato YYYY-MM-DD.
from_end_deferral_date	string	opcional	Filtra despesas com data de encerramento de diferimento maior ou igual à data informada, no formato YYYY-MM-DD.
to_end_deferral_date	string	opcional	Filtra despesas com data de encerramento de diferimento menor ou igual à data informada, no formato YYYY-MM-DD.
status	string	opcional	Filtra pelo status da despesa. Aceita múltiplos valores separados por vírgula (ex: paid,consolidated). Veja enumeradores de status.
expense_type	string	opcional	Filtra pelo tipo da despesa. Aceita múltiplos valores separados por vírgula (ex: management_tax,custody_tax). Veja enumeradores de type.
expense_status_to_ignore	string	opcional	Exclui da listagem despesas com o status informado.
expense_type_to_ignore	string	opcional	Exclui da listagem despesas com o tipo informado.
ignore_paid_on_future	boolean	opcional	Quando true, exclui despesas que já foram pagas mas com data de confirmação posterior à data de referência.

Exemplo de chamada

GET /expense/fund_class/{fund_class_key}/expenses?page=0&limit=10&status=consolidated,paid

Response

STATUS

200

Response Body

{
    "data": [
        {
            "expense_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "fund_class": {
                "name": "Fundo de Investimento XYZ",
                "manager": {
                    "name": "Gestora ABC",
                    "manager_key": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
                    "document_number": "12.345.678/0001-90"
                },
                "fund_class_key": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
                "document_number": "98.765.432/0001-10",
                "accounting_date": "2025-06-10"
            },
            "status": "consolidated",
            "type": "management_tax",
            "reference_date": "2025-06-10",
            "start_deferral_date": "2025-06-01",
            "end_deferral_date": "2025-06-30",
            "consolidated_value": 1500.00,
            "provisioned_value": 1500.00,
            "recognized_value": 1500.00,
            "payment": null,
            "expense_datetime": "2025-06-01T00:00:00Z",
            "description": "Taxa de gestão referente ao mês de junho/2025",
            "payment_method": "transfer",
            "payment_date": "2025-06-30",
            "payment_confirmation": {
                "confirmation_date": "2025-06-30"
            }
        }
    ],
    "limit": 10,
    "page": 0,
    "is_last_page": true
}

Atributos da resposta

Campo	Tipo	Descrição
data	array	Lista de objetos de despesa. Veja Atributos de cada despesa.
page	integer	Número da página atual.
limit	integer	Quantidade de registros por página.
is_last_page	boolean	Indica se esta é a última página de resultados.

Atributos de cada despesa (objetos dentro de data)

Campo	Tipo	Descrição
expense_key	string	Identificador único da despesa (UUID).
fund_class	object	Dados da classe de fundo à qual a despesa pertence. Veja Atributos de fund_class.
status	string	Status atual da despesa. Veja enumeradores de status.
type	string	Tipo da despesa. Veja enumeradores de type.
reference_date	string	Data de referência da despesa no formato YYYY-MM-DD.
start_deferral_date	string	Data de início do diferimento no formato YYYY-MM-DD.
end_deferral_date	string	Data de encerramento do diferimento no formato YYYY-MM-DD.
consolidated_value	number	Valor consolidado da despesa. Pode ser null quando a despesa ainda não foi consolidada.
provisioned_value	number	Valor provisionado da despesa. Pode ser null quando ainda não há provisão.
recognized_value	number	Valor reconhecido da despesa.
payment	object	Dados do pagamento associado à despesa. Pode ser null quando não há pagamento vinculado.
expense_datetime	string	Data e hora de criação da despesa no formato ISO 8601 (ex: 2025-06-01T00:00:00Z).
description	string	Descrição textual da despesa.
payment_method	string	Método de pagamento da despesa. Veja enumeradores de payment_method.
payment_date	string	Data de pagamento no formato YYYY-MM-DD. Presente somente quando a despesa possui data de pagamento definida.
payment_confirmation	object	Dados de confirmação de pagamento. Presente somente quando o pagamento foi confirmado. Veja Atributos de payment_confirmation.

Atributos de fund_class

Campo	Tipo	Descrição
name	string	Nome da classe de fundo.
fund_class_key	string	Identificador único da classe de fundo (UUID).
document_number	string	CNPJ da classe de fundo.
accounting_date	string	Data de contabilização da classe de fundo no formato YYYY-MM-DD.
manager	object	Dados do gestor responsável. Veja Atributos de manager.

Atributos de manager

Campo	Tipo	Descrição
name	string	Nome do gestor.
manager_key	string	Identificador único do gestor (UUID).
document_number	string	CNPJ do gestor.

Atributos de payment_confirmation

Campo	Tipo	Descrição
confirmation_date	string	Data de confirmação do pagamento no formato YYYY-MM-DD.

---

Consulta de despesa específica

Retorna os dados completos de uma despesa específica de uma classe de fundo.

Request

ENDPOINT

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

MÉTODO

GET

Path params

Parâmetro	Tipo	Descrição
fund_class_key	string	Identificador único (UUID) da classe de fundo à qual a despesa pertence.
expense_key	string	Identificador único (UUID) da despesa a ser consultada.

Exemplo de chamada

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

Response

STATUS

200

Response Body

{
    "expense_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "fund_class": {
        "name": "Fundo de Investimento XYZ",
        "manager": {
            "name": "Gestora ABC",
            "manager_key": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
            "document_number": "12.345.678/0001-90"
        },
        "fund_class_key": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
        "document_number": "98.765.432/0001-10",
        "accounting_date": "2025-06-10"
    },
    "status": "consolidated",
    "type": "management_tax",
    "reference_date": "2025-06-10",
    "start_deferral_date": "2025-06-01",
    "end_deferral_date": "2025-06-30",
    "consolidated_value": 1500.00,
    "provisioned_value": 1500.00,
    "recognized_value": 1500.00,
    "payment": null,
    "expense_datetime": "2025-06-01T00:00:00Z",
    "description": "Taxa de gestão referente ao mês de junho/2025",
    "payment_method": "transfer",
    "payment_date": "2025-06-30",
    "payment_confirmation": {
        "confirmation_date": "2025-06-30"
    }
}

Atributos da resposta

A resposta possui a mesma estrutura de cada objeto do array data retornado pela listagem de despesas.

---

Possíveis erros

STATUS

404

Despesa não encontrada

O expense_key informado não corresponde a nenhuma despesa cadastrada para esta classe de fundo. Verifique se os identificadores estão corretos.

{
  "title": "Expense not Found",
  "description": "The Expense with key {expense_key} was not found in Fund Class with key {fund_class_key}.",
  "translation": "A Despesa com a chave {expense_key} nao foi encontrada na classe de fundos com a chave {fund_class_key}.",
  "code": "EXP000010"
}

---

Enumeradores de status

Valor	Descrição
created	Despesa criada, ainda não iniciou o processo de provisionamento.
in_provision	Despesa em processo de provisionamento diário.
on_demand_recognition	Despesa com reconhecimento sob demanda (manual).
consolidated	Despesa consolidada — valor total reconhecido e pronto para pagamento.
paid	Despesa paga.
canceled	Despesa cancelada.
completed	Despesa encerrada.

Enumeradores de type

Valor	Descrição
administration_tax	Taxa de administração.
management_tax	Taxa de gestão.
performance_fee	Taxa de performance.
custody_tax	Taxa de custódia.
distribution_fee	Taxa de distribuição.
consulting_fee	Taxa de consultoria.
audit_tax	Taxa de auditoria.
cvm_tax	Taxa CVM.
cetip_tax	Taxa CETIP.
anbima_tax	Taxa ANBIMA.
selic_tax	Taxa SELIC.
notary	Cartório.
bank_account	Conta bancária.
bankslip_fee	Taxa de boleto.
sale_commission_tax	Taxa de comissão de venda.
certifier_fee	Taxa de certificadora.
rating_agency_fee	Taxa de agência de rating.
lawyer_fee	Honorários advocatícios.
bookkeeping_fee	Taxa de escrituração.
insurance_fee	Taxa de seguro.
collection_agent_fee	Taxa de agente cobrador.
servicing_fee	Taxa de serviços.
fund_structuring_fee	Taxa de estruturação do fundo.
credit_rights_registration_fee	Taxa de registro de direitos creditórios.
origination_fee	Taxa de originação.

Enumeradores de payment_method

Valor	Descrição
transfer	Transferência bancária.
automatic_debit	Débito automático.
bank_slip	Boleto bancário.