非常规摊还
概述
非常规摊还是指在常规还款计划之外减少某笔发行未偿余额的过程 — 例如发行人提前还款、在到期日之前结清分期，或对部分债务进行再融资。QI Tech 通过 API 接收该请求，校验金额并登记该事件以供后续清算，同时不影响在每个 due_date（到期日）生成的常规摊还。
典型场景包括发行人提前结清、提前支付一期或多期分期，以及部分再融资操作。在所有这些情形中，集成方按需发起流程，说明正在摊还哪一期（或哪几期）分期以及金额是多少。
每当你需要在常规还款计划之外变更未偿余额时，就会使用本 API。其结果始终是一个可追溯的事件，具备自身的 status 和财务记录。创建是 fire-and-forget 的：QI Tech 在内部编排清算、终结与取消，集成方无需调用额外的端点。
常规摊还与非常规摊还
常规摊还由 QI Tech 自动生成：在每个 due_date（到期日），分期清算流程会在内部创建，无需集成方任何操作。而非常规摊还始终是按需发起的，需通过显式的 API 调用。两者并存 — 登记一笔非常规摊还既不会取消也不会替代尚未到期的常规摊还；它只是在该资产上新增一个清算事件。
摊还类型
amortization_type 字段支持以下五种类型：
equal_amount（按比例分摊）— 先在已逾期的分期之间按比例分配所提供的金额，然后再分配到未来的分期。first_installments（前若干期）— 将金额依次应用于前 N 期分期，直至金额用尽。present_amount（现值）— 由集成方选择分期，并可提供total_discount；分配顺序为利息 → 罚金 → 本金。matured_installments（已到期分期）— 将金额仅应用于已经到期的分期。early_amortization（提前摊还）— 提前支付某笔未来分期。
只有 early_amortization 允许部分支付 — 其余四种都要求在容差范围内全额覆盖所声明的金额。
关键概念
event_conciliation— 对应某一期具体分期的对账事件。负责证券分期的付款和/或非常规摊还的对账行为。reference_date— 每次创建时由调用方提供的参考日期（必须与结清日期一致）。QI Tech 从不使用date.today()：所有与日期相关的逻辑（到期分类、现值预测、区分已逾期与未到期分期）均以该字段为起点。- 现值 — 在内部计算，并在事件创建过程中被消费。集成方无需在自己这一侧计算现值。
- 容差（
tolerance_amount） — 清算金额与预期分期金额之间可接受的最大差额。默认为 R$ 0.01。超出容差的差额会导致清算被拒绝。 - 派生的部分支付状态 — 当
paid_amount > 0且paid_amount < expected_amount时，该分期被视为部分已付。这里没有新增状态：该状态是从paid_amount和expected_amount两列派生出来的。pending_conciliation状态同时涵盖"尚未支付"和"部分支付"两种情况；只有当累计金额在容差范围内覆盖了预期金额时，才会出现paid。