跳到主要内容

查询合并分析

列出需由管理人或顾问提供发票的每笔费用当前有效的合并分析：待发送、审核中、等待管理人决定以及已作出决定的发票。管理人可查看其旗下所有基金；顾问须指定基金。

如需查看某笔特定费用的分析，请使用查询当前有效的分析。

列出分析​

适用范围
角色主机所需权限
管理人manager-api读取
顾问consultant-api读取合并

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

ENDPOINT
/expense/consolidation_analyses
方法
GET

查询参数​

参数类型是否必填描述
statusstring否分析状态，多个值以逗号分隔：pending_submission、in_manual_analysis、pending_manager_approval、approved、reproved、consolidated、canceled。
fund_class_keystring条件必填限定为某只基金。顾问必填。
limitinteger否每页条数，0 至 200。默认：10。
pageinteger否页码，从 0 开始。默认：0。
  • 处于 pending_submission 或 reproved 的分析，只有在费用为 pre_approved 或 in_provision 时才会出现，即已经可以发送发票时。
  • 对于顾问，列表包含所指定基金中所有需要发票的费用，包括管理人录入的费用和 QI Tech 计算的费用。如果顾问在该基金没有“读取合并”权限，响应为 403（EXP000219）。
  • 列表按分析从新到旧排序。
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 仅在管理费中有值，与合并分析相同。
  • expense 包含该费用在查询费用中直到 payment_confirmation 的字段。示例仅展示其中一部分。

错误​

状态code发生情形
400EXP000187status 的值不在允许列表中。
400EXP000188顾问未提供 fund_class_key。
403EXP000124顾问与 fund_class_key 对应的基金没有有效关联。
403EXP000219顾问在 fund_class_key 对应的基金中没有读取合并权限。
404EXP000018该管理人在费用服务中没有基金。
500QIT000500limit 或 page 超出范围。这些参数的校验错误会以内部错误返回：请修正参数后重试。

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