跳到主要内容

模拟特别摊销现值

本端点用于模拟 present_amount 类型的特别摊销，但不会创建任何事件——它是纯计算，没有任何副作用。服务会根据 installment_list 中指定的分期，计算并返回将要创建的特别事件的总 amount（现值），以及每个分期对应的 event_conciliation（extraordinary 类型）的现值——集成方无需在自己一侧计算现值。

请求中不发送 amortization_type：由于这是现值模拟，类型始终为 present_amount。amount 也不发送——它是计算的结果。reference_date 由调用方提供，是服务用于判定逾期分期并按比例（pro-rata）折算现值的唯一时间参考；在模拟中，due_date 被视为等于 reference_date。

响应即为可直接使用的创建请求体：只需移除仅作展示用途的 event_conciliation_list 字段，再将其作为创建特别摊销的请求体发送，即可执行所模拟的摊销。

Request​

ENDPOINT
/event_conciliation/extraordinary_event/present_value_simulation
METHOD
POST

Request Body​

{
  "security_key": "971380d4-469e-48f6-a64b-3afb8a88109e",
  "investment_key": "<investment_key>",
  "reference_date": "2026-04-24",
  "installment_list": [1, 2]
}

Request Body Params​

字段类型必填说明
security_keystring (UUID)是将被模拟摊销的资产（security）的唯一键。
investment_keystring (UUID)是目标投资的键。用作现值计算的比例基础。
reference_datestring (date)是YYYY-MM-DD 格式的参考日期。由调用方提供——服务将其作为"今天"来判定逾期分期并应用现值的按比例折算。在模拟中也用作 due_date。
installment_listarray of integers (≥ 1)是目标分期的 installment_number 列表（不是 UUID），minItems: 1。服务会将每个编号与 security 的 installment_number 进行匹配；不存在的编号返回 EVC000007。

与创建不同，amortization_type、amount 和 due_date 不需要发送：类型始终为 present_amount，amount 由服务计算，due_date 被视为等于 reference_date。

Response​

STATUS
200
Response Body
{
  "security_key": "971380d4-469e-48f6-a64b-3afb8a88109e",
  "investment_key": "<investment_key>",
  "amortization_type": "present_amount",
  "amount": 4750.00,
  "reference_date": "2026-04-24",
  "due_date": "2026-04-24",
  "installment_list": [1, 2],
  "event_conciliation_list": [
    {
      "installment_number": 1,
      "amount": 2400.00
    },
    {
      "installment_number": 2,
      "amount": 2350.00
    }
  ]
}

Response Body Params​

字段类型说明
security_keystring (UUID)资产键——回显所发送的值。
investment_keystring (UUID)目标投资键——回显所发送的值。
amortization_typestring始终为 present_amount——由服务填充，用于组成创建请求体。
amountnumber为特别事件计算出的总现值（等于 event_conciliation_list 中各 amount 之和）。
reference_datestring (date)参考日期——回显所发送的值。
due_datestring (date)目标结算日期——等于所发送的 reference_date。
installment_listarray of integers目标分期——回显所发送的值。
event_conciliation_listarray将要生成的各分期 event_conciliation（extraordinary 类型）的现值。仅供展示——不属于创建请求体。 Object event_conciliation_list。
信息

event_conciliation_list 字段仅用于展示每个分期的现值模拟结果——不得包含在特别事件的创建请求体中。要执行所模拟的摊销，请移除 event_conciliation_list 后，将响应作为创建特别摊销的请求体发送。

Object event_conciliation_list​

字段类型说明
installment_numberinteger此对账事件所对应分期的编号（installment_number）。
amountnumber为该分期的 event_conciliation（extraordinary 类型）计算出的现值。

Errors​

代码HTTP含义
EVC100002400installment_list 为必填且不能为空。
EVC100004400某个所提供的分期不属于目标 security。
EVC000007404installment_list 中的某个整数与 security 的任何 installment_number 都不匹配（InstallmentNumberNotFound）。
QIT000001400Schema 校验失败——例如 installment_list 的某项不是 ≥ 1 的整数。
EVC100008400该分期已存在待处理的特别摊销——请先取消，再进行模拟/创建。
EVC100013424依赖服务暂时不可用（Failed Dependency）。为暂时性问题——恢复后请重试。

EVC100005（amount 不足）不适用于模拟——amount 由服务计算，无需发送。

完整的错误处理请参阅错误目录。

See also​