费用改期

更改您（管理人或顾问）录入的费用的付款日期并记录原因。适用于发票发送之前：费用处于 pre_approved 或 in_provision，合并分析处于 pending_submission 或 reproved。

返佣不能改期：它们沿用管理费的日期。

费用改期

适用范围

角色	主机	所需权限
管理人	`manager-api`	写入
顾问	`consultant-api`	录入和编辑费用或提交合并

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

ENDPOINT

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

方法

PUT

路径参数

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

Corpo da requisição
{
    "payment_date": "2026-12-10",
    "reason": "supplier_request",
    "reason_details": "Fornecedor pediu pagamento após a emissão da nota de dezembro."
}

请求体属性

字段	类型	是否必填	描述
`payment_date`	string	是	新的付款日期，`YYYY-MM-DD`，须为工作日，不早于今天，且不早于费用的参考日期。
`reason`	string	是	`supplier_request`（供应商要求）或 `liquidity_not_available`（基金流动性不足）。
`reason_details`	string	是	原因的详细说明，1 至 1000 个字符。

响应

STATUS

200

返回带有新 payment_date 的费用，结构与按 key 查询相同，不含 status_events 和 consolidation_status_events。状态不会改变。

错误

状态	`code`	发生情形
400	`EXP000058`	该费用是一笔返佣。
400	`EXP000057`	该费用既不处于 `pre_approved`，也不处于 `in_provision`，或发票已经发送。
400	`EXP000121`	新日期已经过去。
400	`EXP000122`	新日期不是工作日。
400	`EXP000037`	新日期早于费用的参考日期。
400	`EXP000159`	新日期晚于合同到期日。
400	`EXP000126`	该费用的合同在基金中已不存在。
400	`EXP000069`	该基金类别不属于该管理人。
403	`EXP000124`	顾问与该基金没有有效关联。通常 `consultant-api` 会先以 `401`（`CIT000018`）拒绝。
403	`EXP000156`	该费用不是由您录入的（`permission_type` 不是 `owner`）。由 QI Tech 计算的费用同样不能改期。
404	`EXP000010`	该费用在基金中不存在。
503	`EXP000132`	API 无法读取该合同。请重试。

Exemplo
{
  "title": "Expense reschedule Not Allowed For Status",
  "description": "Expense in status consolidated can't be rescheduled.",
  "translation": "Despesa no status consolidated nao pode ser reagendada",
  "code": "EXP000057"
}

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

费用改期​

路径参数​

请求体属性​

响应​

错误​

费用改期

路径参数

请求体属性

响应

错误