查询费用

列出某只基金或管理人旗下所有基金的费用。列表包含基金的全部费用：由管理人或顾问录入的费用（包括仍在审核中的）以及由 QI Tech 计算的费用。对于顾问，列表仅包含由代理方（管理人或顾问）录入的费用（expense_contract、expense、reimbursement 和 rebate_fee）。

状态和来源：费用生命周期。
按 key 查询单笔费用及其文件和历史记录：按 key 查询费用。

列出基金费用

适用范围

角色	主机	所需权限
管理人	`manager-api`	读取
顾问	`consultant-api`	读取费用或读取合并

各主机的 Base URL：环境（主机）。

ENDPOINT

/expense/fund_class/{fund_class_key}/expenses

方法

GET

路径参数

参数	类型	描述
`fund_class_key`	string	基金类别的 key（UUID）。

查询参数

均为可选。标记为列表的参数可接受多个以逗号分隔的值。

参数	类型	描述
`page`	integer	页码，从 `0` 开始。默认：`0`。
`limit`	integer	每页条数，`0` 至 `100`。默认：`10`。
`status`	列表	费用状态。未知的值不会报错，只是查不到结果。
`expense_status_to_ignore`	string	排除一个状态。
`expense_type`	列表	费用类型。
`expense_type_to_ignore`	列表	排除的费用类型。
`origin_type`	列表	费用来源。
`exclude_origin_type`	列表	排除的来源。使用 `rebate_fee` 可隐藏返佣。
`reference_date`	string	精确的参考日期，`YYYY-MM-DD`。
`from_end_deferral_date`	string	`end_deferral_date` 不早于该日期，`YYYY-MM-DD`。
`to_end_deferral_date`	string	`end_deferral_date` 不晚于该日期，`YYYY-MM-DD`。
`payment_date_start`	string	付款日期不早于该日期，`YYYY-MM-DD`。
`payment_date_end`	string	付款日期不晚于该日期，`YYYY-MM-DD`。不能早于 `payment_date_start`。
`ignore_paid_on_future`	boolean	`true` 时排除付款确认日期晚于参考日期的费用。
`contract_key`	string	某个合同的费用。
`vendor_key`	string	合同供应商的费用。
`recipient_name`	string	合同供应商或付款收款人名称的一部分。
`recipient_document`	string	供应商或收款人 CPF 或 CNPJ 的一部分，带或不带标点均可。
`rebated_expense_key`	string	某笔管理费的返佣。
`created_by_agent_type`	string	`manager` 或 `consultant`：录入该费用的一方。
`permission_type`	string	`owner` 或 `viewer`：查询方对该费用的权限。仅返回管理人或顾问录入的费用。
`description`	string	描述的一部分。
`kpi`	string	指标：`in_analysis`、`in_provision` 或 `pending_invoice`。排除已取消的费用和返佣。
`days`	integer	`kpi` 的统计周期，含今天：`1`、`7` 或 `30`。

列表按费用从新到旧排序。

Exemplo de chamada
GET /expense/fund_class/{fund_class_key}/expenses?status=consolidated,paid&exclude_origin_type=rebate_fee&limit=50

响应

STATUS

200

Corpo da resposta
{
    "data": [
        {
            "expense_key": "b7f1c8e2-5a7d-4c7f-9a0e-2c3d4e5f6a7b",
            "fund_class": {
                "name": "FIDC EXEMPLO",
                "manager": {
                    "name": "EXEMPLO GESTORA LTDA",
                    "manager_key": "a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c",
                    "document_number": "22.333.444/0001-81"
                },
                "fund_class_key": "c1d2e3f4-a5b6-4789-abcd-ef1234567890",
                "document_number": "33.444.555/0001-81",
                "accounting_date": "2026-11-06"
            },
            "status": "consolidated",
            "type": "audit_tax",
            "origin": {
                "origin_type": "expense_contract",
                "origin_key": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d"
            },
            "payment_value": 15000.0,
            "created_by": {
                "agent_key": "a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c",
                "agent_type": "manager",
                "name": "EXEMPLO GESTORA LTDA"
            },
            "reference_date": "2026-11-06",
            "start_deferral_date": null,
            "end_deferral_date": null,
            "consolidated_value": 15000.0,
            "provisioned_value": null,
            "recognized_value": 15000.0,
            "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"
                }
            },
            "expense_datetime": "2026-11-03T14:03:21Z",
            "last_updated": "2026-11-06T10:15:40Z",
            "description": "Auditoria do exercício 2026",
            "payment_method": "transfer",
            "payment_date": "2026-11-20",
            "consolidation_analysis": {
                "consolidation_analysis_key": "e3f4a5b6-c7d8-4e9f-8a0b-1c2d3e4f5a6b",
                "analysis_number": 1,
                "status": "approved"
            },
            "contract": {
                "contract_key": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
                "name": "Auditoria 2026",
                "status": "active",
                "vendor": {
                    "vendor_key": "5d2e7b9a-3c4f-4e8a-b1d6-9f0a2c3e4b57",
                    "name": "AUDITORES EXEMPLO S.A."
                }
            },
            "rebate": false,
            "rebated_expense_key": null,
            "permission_type": "owner"
        }
    ],
    "limit": 10,
    "page": 0,
    "is_last_page": true
}

每笔费用的属性

字段	类型	描述
`expense_key`	string	费用的 key（UUID）。
`fund_class`	object	基金类别：`name`、`fund_class_key`、`document_number`、`accounting_date`（当前会计日期，`YYYY-MM-DD`）和 `manager`（`name`、`manager_key`、`document_number`）。
`status`	string	费用状态。参见状态。
`type`	string	费用类型。参见类型。
`origin`	object	`origin_type` 和 `origin_key`。参见来源。
`payment_value`	number	应付金额，或 `null`。
`created_by`	object	录入方：`agent_key`、`agent_type`（`manager` 或 `consultant`）、`name`。由 QI Tech 计算的费用为 `null`。
`reference_date`	string	费用计入投资组合的日期，`YYYY-MM-DD`；处于提交阶段时为 `null`。
`start_deferral_date`	string	计提开始日期，`YYYY-MM-DD`，或 `null`。
`end_deferral_date`	string	计提结束日期，`YYYY-MM-DD`，或 `null`。
`consolidated_value`	number	合并金额，或 `null`。
`provisioned_value`	number	计提金额，或 `null`。
`recognized_value`	number	已在投资组合中确认的金额。
`payment`	object	付款数据：`target`（`name`、`document_number`），以及根据付款方式提供的 `target_account`、`target_pix_key`、`pix_qrcode`、`bank_slip`、`source_account`、`vendor_bank_account_key`、`conciliation_metadata`。可能为空（`{}`）。
`expense_datetime`	string	创建时间，UTC 的 ISO 8601（`2026-11-03T14:03:21Z`）。
`last_updated`	string	费用或分析的最后修改时间，UTC 的 ISO 8601。
`description`	string	描述。
`payment_method`	string	`transfer`、`pix`、`bank_slip` 或 `automatic_debit`，或 `null`。
`payment_date`	string	付款日期，`YYYY-MM-DD`。仅在已设定时出现。
`payment_confirmation`	object	`confirmation_date`（`YYYY-MM-DD`）。仅在付款后出现。
`consolidation_analysis`	object	当前有效的合并分析：`consolidation_analysis_key`、`analysis_number`、`status`。参见合并分析。
`contract`	object	费用的合同：`contract_key`、`name`、`status`、`vendor`（`vendor_key`、`name`）。无合同时为 `null`。
`rebate`	boolean	当该费用为管理费返佣时为 `true`。
`rebated_expense_key`	string	返佣对应的管理费，或 `null`。
`permission_type`	string	查询方录入了该费用时为 `owner`；由其他主体录入时为 `viewer`（对管理人而言，即顾问录入的费用）。由 QI Tech 计算的费用为 `null`。
`gross_provisioned_value`	number	仅限 `management_tax`：管理费的计提金额，不因返佣而减少（没有计提金额时为 `0`）。
`approved_rebate_value`	number	仅限 `management_tax`：分析已批准的返佣总额。

列出所有基金的费用

列出管理人旗下所有基金的费用，响应与基金费用列表相同。

适用范围

角色	主机	所需权限
管理人	`manager-api`	读取

各主机的 Base URL：环境（主机）。

ENDPOINT

/expense/expenses

方法

GET

接受与基金费用列表相同的筛选条件，但 reference_date、from_end_deferral_date、to_end_deferral_date 和 ignore_paid_on_future 会被忽略。另有两个参数：

参数	类型	描述
`fund_class_key`	string	限定为这些基金。可重复：`fund_class_key=...&fund_class_key=...`。
`payment_date`	string	精确的付款日期，`YYYY-MM-DD`。

Exemplo de chamada
GET /expense/expenses?fund_class_key={fund_class_key_1}&fund_class_key={fund_class_key_2}&payment_date=2026-11-20

错误

状态	`code`	发生情形
400	`EXP000069`	该基金类别不属于该管理人。
400	`EXP000186`	`created_by_agent_type`、`permission_type` 或 `kpi` 的值不在允许列表中，或 `payment_date_end` 早于 `payment_date_start`。
400	`EXP000185`	`days` 不是 `1`、`7` 或 `30`（`kpi` 筛选）。
404	`EXP000018`	所有基金列表：该管理人在费用服务中没有基金。
500	`QIT000500`	`limit` 或 `page` 超出范围、日期不符合 `YYYY-MM-DD` 格式，或布尔值无效（`ignore_paid_on_future`）。这些参数的校验错误会以内部错误返回：请修正参数后重试。

Exemplo
{
  "title": "Manager Not Associated with Fund Class",
  "description": "Manager with key a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c is not associated with Fund Class with key c1d2e3f4-a5b6-4789-abcd-ef1234567890.",
  "translation": "Gestor com chave a7498c6c-1893-42ec-a8f3-bc6ad0c6b52c nao esta associado com Fundo com chave c1d2e3f4-a5b6-4789-abcd-ef1234567890.",
  "code": "EXP000069"
}

认证、权限和主机相关错误：参见 API 错误。

列出基金费用​

路径参数​

查询参数​

响应​

每笔费用的属性​

列出所有基金的费用​

错误​

列出基金费用

路径参数

查询参数

响应

每笔费用的属性

列出所有基金的费用

错误