跳到主要内容

查询非常规摊还

本端点通过键值（extraordinary_event_conciliation_key）返回某笔特定的非常规摊还。可用它跟踪事件的对账状态 — 从 pending_conciliation（尚未支付或部分支付）一直到由 QI Tech 内部编排确定的终态（paid 或 canceled）。

该查询与日期无关，且不会触发任何状态转换：它只反映事件及其每一期关联分期的当前状态。

Request​

ENDPOINT
/event_conciliation/extraordinary_event/EXTRAORDINARY-EVENT-CONCILIATION-KEY
方法
GET

Path Params​

字段类型是否必填描述
extraordinary_event_conciliation_keystring (UUID)是待查询的非常规摊还事件的唯一键值。

调用示例：

GET /event_conciliation/extraordinary_event/11111111-1111-4111-8111-111111111111

Response​

STATUS
200
Response Body
{
  "extraordinary_event_conciliation_key": "11111111-1111-4111-8111-111111111111",
  "security_key": "971380d4-469e-48f6-a64b-3afb8a88109e",
  "investment_key": "44444444-4444-4444-8444-444444444444",
  "amortization_type": "early_amortization",
  "total_expected_amount": 1500.00,
  "total_discount_amount": 0,
  "total_paid_amount": 0.0,
  "status": "pending_conciliation",
  "reference_date": "2026-04-24",
  "due_date": "2026-04-24",
  "paid_at": null,
  "event_conciliation_list": [
    {
      "event_conciliation_key": "22222222-2222-4222-8222-222222222222",
      "installment_key": "33333333-3333-4333-8333-333333333333",
      "event_conciliation_status": "pending_conciliation",
      "event_conciliation_type": "extraordinary_event"
    }
  ]
}

Response Body Params​

字段类型描述
extraordinary_event_conciliation_keystring (UUID)所查询的非常规摊还事件的键值。
security_keystring (UUID)该事件所属资产（security）的键值。
investment_keystring (UUID)该事件目标投资的键值。
amortization_typestring该事件的摊还类型 — 回显创建时使用的值。
total_expected_amountnumber该事件的预期总金额（在各分期之间分配的总额），以 BRL 计。
total_discount_amountnumber已应用的折扣总额。仅在 present_amount 时不为零。
total_paid_amountnumber该事件已完成对账的金额（以 BRL 计）。尚无付款确认时为 0；部分支付时 > 0。
statusstring事件的当前状态：pending_conciliation、paid 或 canceled。
reference_datestring (date)创建时提供的参考日期。
due_datestring (date)创建时提供的目标清算日期。
paid_atstring (date)该事件完成清算的日期。在状态变为 paid 之前为 null。
event_conciliation_listarray该事件的 event_conciliation（每期分期的对账事件）列表。event_conciliation_list 对象。

event_conciliation_list 对象​

字段类型描述
event_conciliation_keystring (UUID)分期对账事件（event_conciliation）的键值。
installment_keystring (UUID)受该对账事件影响的分期的键值。
event_conciliation_statusstring分期对账事件的当前状态（pending_conciliation、paid、canceled）。
event_conciliation_typestringevent_conciliation 的类型。由本流程创建的事件恒为 extraordinary_event。
信息

status（以及每期分期的 event_conciliation_status）反映的是查询时刻的当前状态。转为 paid 或 canceled 由 QI Tech 的内部编排完成 — 集成方无需为此调用任何端点。

错误​

错误码HTTP含义
EVC100011404未找到与所提供的 extraordinary_event_conciliation_key 对应的非常规摊还。

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

另请参阅​