跳到主要内容

按 key 查询费用

按 key 查询单笔费用，包括其文件以及费用和合并分析的状态历史。如需按条件筛选列出费用，请参见查询费用。

按 key 查询费用​

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

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

ENDPOINT
/expense/fund_class/{fund_class_key}/expense/{expense_key}
方法
GET

路径参数​

参数类型描述
fund_class_keystring基金类别的 key（UUID）。
expense_keystring费用的 key（UUID）。

响应​

STATUS
200

响应包含列表中直到 payment_confirmation 的字段，另加 consolidation_analysis、contract、rebated_expense_key、permission_type 以及下列字段。不包含 rebate、gross_provisioned_value 和 approved_rebate_value。

Trecho da resposta
{
    "expense_key": "b7f1c8e2-5a7d-4c7f-9a0e-2c3d4e5f6a7b",
    "status": "pre_approved",
    "is_reimbursement": false,
    "reimbursement_recipient": null,
    "reproval_reason": null,
    "reproval_details": null,
    "documents": [
        {
            "document_key": "d4e5f6a7-b8c9-4123-def4-567890abcdef",
            "name": "memoria_de_calculo.pdf",
            "document_type": "calculation_memory",
            "status": "in_manual_analysis"
        }
    ],
    "status_events": [
        {
            "status": "created",
            "event_datetime": "2026-11-03T14:03:21Z",
            "author_type": "manager",
            "author_name": "Maria Souza"
        },
        {
            "status": "pending_submission",
            "event_datetime": "2026-11-03T14:03:21Z",
            "author_type": "manager",
            "author_name": "Maria Souza"
        },
        {
            "status": "pre_approved",
            "event_datetime": "2026-11-03T14:05:02Z",
            "author_type": "manager",
            "author_name": "Maria Souza"
        }
    ],
    "consolidation_status_events": [
        {
            "analysis_number": 1,
            "status": "created",
            "event_datetime": "2026-11-03T14:03:21Z",
            "author_type": "manager",
            "author_name": "Maria Souza",
            "reproval_reason": null,
            "reproval_details": null
        },
        {
            "analysis_number": 1,
            "status": "pending_submission",
            "event_datetime": "2026-11-03T14:03:21Z",
            "author_type": "manager",
            "author_name": "Maria Souza",
            "reproval_reason": null,
            "reproval_details": null
        }
    ]
}
字段类型描述
is_reimbursementboolean当该费用为报销时为 true。
reimbursement_recipientstring报销时为 manager 或 consultant；否则为 null。
reproval_reasonstring费用被拒绝的原因，或 null。
reproval_detailsstring拒绝的详细说明，或 null。
documentsarray费用的文件：document_key、name、document_type、status。如需下载，管理人使用文件查询；顾问则下载合并分析中的文件。
recurrenceobject仅限来源为 recurring_expense 的费用：recurring_expense_key、status、start_date、end_date、contract_key。
status_eventsarray费用的状态变更，按从早到晚排列：status、event_datetime、author_type、author_name。对于管理人或顾问录入的费用，第一个事件为 created。
consolidation_status_eventsarray所有合并分析的状态变更：analysis_number、status、event_datetime、author_type、author_name、reproval_reason、reproval_details。每次分析都以 created 和 pending_submission 开始。拒绝相关字段仅出现在每次分析的最后一个 reproved 事件中。

当门户用户执行变更时，author_type 为 manager 或 consultant；其名称在 author_name 中。其他情况（自动状态流转、QI Tech 的决定以及通过 API 使用集成密钥发起的调用）下，author_type 为 qitech，且 author_name: null。

错误​

状态code发生情形
400EXP000069该基金类别不属于该管理人。
404EXP000010该 expense_key 在此基金类别中不存在。
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 错误。