From 3055aced246e5a27acfd9b5a6def29685f4b0676 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=88=98=E6=B3=89=E4=BD=B3?= <1107186916@qq.com>
Date: Fri, 16 Oct 2026 19:46:52 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=E7=BB=93=E7=AE=97?=
 =?UTF-8?q?=E8=B0=83=E6=95=B4=E5=8D=95=E6=8E=A5=E5=85=A5=E9=87=91=E8=9D=B6?=
 =?UTF-8?q?=E8=AE=BE=E8=AE=A1=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...Ž¥å…¥é‡‘è�¶è®¾è®¡ï¼ˆæœªæŽ¨é€�自动推-已推é€�冲销å�Žé‡�推新å�•ï¼‰.md | 290 ++++++++++++++++++
 1 file changed, 290 insertions(+)
 create mode 100644 doc/docs/业务�程/2026-10-16-结算调整�接入金�设计（未推�自动推-已推�冲销��推新�）.md

diff --git a/doc/docs/业务�程/2026-10-16-结算调整�接入金�设计（未推�自动推-已推�冲销��推新�）.md b/doc/docs/业务�程/2026-10-16-结算调整�接入金�设计（未推�自动推-已推�冲销��推新�）.md
new file mode 100644
index 00000000..d671f903
--- /dev/null
+++ b/doc/docs/业务�程/2026-10-16-结算调整�接入金�设计（未推�自动推-已推�冲销��推新�）.md
@@ -0,0 +1,290 @@
+# 结算调整�接入金�设计（未推�自动推 · 已推�手工冲销��推新�）
+
+> 整�日期：2026-10-16
+> 目标：把「结算调整��正�接入金�链路。核心约�——**原正�结算�一旦推�过金�，其本地数�一律冻结�动**；调整�的数��在�推时新建的一张正�结算�上，用它�金�生�**全新**的财务应付/应收�。
+> ��：`2026-09-20-应付�与付款申请�步金�全链路业务�程（A102-2�存-A102-4查询-A103-1下推-A103-2回写）.md`�`2026-09-21-应收结算与开票申请�步金�全链路业务�程（A302-2�存-A302-4勾稽-A303-1新增-A303-4预检-A303-5回写）.md`�`2026-10-05-审批通过自动�步金�设计（事件触�+定时�推+手动兜底）.md`�`2026-10-09-金����定与解�业务�程（...）.md`�当�代�（探索核实）。
+
+---
+
+## 1. 背景与目标
+
+结算调整�（`blade_settlement_adjustment`）用于在正�结算�审批通过�调整其费用项目与金�。目�它�有本地审批与一个�的 `repush`（拼 `K3AP+时间戳`），并未真正接入金�。
+
+需��地的三段�作：
+
+| �作 | 内容 |
+|---|---|
+| �作 1 新增调整� | ��许选**审核通过**且**未下推付款申请**的正�结算�；自动回带客商�调整类型���等 |
+| �作 2 审批通过 | 回写/记录调整 → 按原结算�金�状�分�（未推�→推原�；已推�→�动金�，�示财务手工冲销） |
+| �作 3 �新推�（高�） | 旧应付/应收�已在金�冲销�，把**调整�的数�**以**全新�����**推�一张新的财务应付/应收� |
+
+> 全程交互使用中文。
+
+## 2. ��与接�速查
+
+| 代� | �义 |
+|---|---|
+| A102-2 | 财务应付�**�存**（推�） |
+| A102-4 | 财务应付�**查询**（幂等预检；返回 `BfiApBillVO`，� `iswrittenoff` / `hadwrittenoff`） |
+| A302-2 | 财务应收�**�存**（推�） |
+| A302-4 | 财务应收�**查询**（幂等预检，�上） |
+| 防�键 | 金������ `awrp_src_code`，由 `ExternalSrcCodeSupport.buildSrcCode(mainCode, partCodes)` 下划线拼接，规则 `结算��_明细���` |
+| 正�结算� | `blade_formal_settlement`，�� `FJS`(应付)/`SJS`(应收) + `yyyyMMdd` + 4 ��水（`nextNo`） |
+| 结算调整� | `blade_settlement_adjustment` |
+
+## 3. 现状与差�（代�核实）
+
+| # | �置 | 现状 | 差� |
+|---|---|---|---|
+| 1 | `SettlementAdjustmentServiceImpl.approve()`（约 221-261） | 仅改本地：回写原结算�费用�写�更记录�置 `approved`；`setKingdeeSyncStatus(formal.getKingdeeSyncStatus())`（推��快照） | 未触�金�推�；未回填推��的真实状�，导致�端「�新推��按钮（�件 `approved && kingdeeSyncStatus='synced'`）�出现 |
+| 2 | `SettlementAdjustmentServiceImpl.repush()`（约 207-217） | �实现：拼 `K3AP+时间戳` 直接置 synced | 未校验冲销�未生�新��未真正推� |
+| 3 | `FormalSettlementServiceImpl.syncKingdee/doSyncKingdee`（640/805） | 真实推� + �� + 失败�推链路；`doSyncKingdee` 在 `synced` 时**幂等早退** | �推�须�置状�，�则被早退 |
+| 4 | `KingdeeApBillSyncSupport.pushApBill`（220）/`queryApBillExistNos`（157） | A102-4 预检**�区分是�已冲销** | 冲销��键�推会被预检判为"已存在"而跳过 |
+| 5 | `BfiApBillVO` | 已� `iswrittenoff`（154）/`hadwrittenoff`（158） | 尚未用于冲销判定 |
+| 6 | `SettlementAdjustment` 实体 / `SettlementAdjustmentVO` | 实体无 `kingdeeBillNo`；VO 有（20） | 金���无处�库 |
+| 7 | `IKingdeeBillLockService` | `lockAfterPush` / `checkEditable`；**冲销�触�解�回调** | 原��记录会一直�在 `locked` |
+| 8 | `IKingdeeBillLockService.checkEditable` | 仅开票申请�付款申请调用；**正�结算�未调用** | 正�结算�的编辑�护主�在�端 + `voidBill` 的 `synced` 拦截 |
+
+## 4. 关键决策（已确认）
+
+| 决策 | 结论 |
+|---|---|
+| **A 原�去�** | 已推�场景下**原�业务数�零改动**（费用/金�/状�全�动），�加 1 ��更记录 + 标记 + 解�；新�是**全新独立�**，原�的下游关�（开票申请/收款认领/对账）**��移**，留在原� |
+| **B 展示标记** | 原�标「已调整�；新�标「调整���并显示原�� |
+| **B1 建�时机** | 「�新推��时新建，审批阶段�动 |
+| **B2 新�编�** | 走 `nextNo` 正��水（`FJS`/`SJS` + 日期 + 4 �），**�**加�缀 |
+| **B3 原�处�** | ��原状，��作废/删除 |
+| **B4 调整�挂载** | �推�调整�**改挂新�** |
+| **B5 ��预结算** | 新�**�建** `FormalSettlementSource` 行（接续原���） |
+| **B6 范围** | 应付�**应收都��**（应付 A102-2/A102-4，应收 A302-2/A302-4） |
+| **B7 列表** | 新旧两张�并存，带标识展示 |
+| **C 冲销判定** | �认 `hadwrittenoff=true`；部分冲销也放行 |
+| **D 原�旧�** | �推时把原�旧�标记为 `unlocked`，�改其它 |
+| **E 未推�场景** | 审批通过�**自动推**（�用既有 `KingdeeBillApprovedEvent` 机制） |
+| 新�状� | 克隆�直接置 `approvalStatus=approved`，��走审批 |
+| 原��更记录/unlock 时机 | �更记录审批时写；`unlock` + `已调整`标记在**�推时**执行（审批时财务�能还没冲销） |
+| **选�预检** | �作 1 选定结算��**预检**其金�冲销状�（软�示，�硬拦截）；金���用时�级放行 |
+| **�推冲销闸门** | 真正的**硬拦截**�留在�作 3 �推；预检�替代闸门 |
+
+## 5. 总体方案
+
+### 5.1 �程图
+
+> �作 1 选��会先�一次金�冲销**预检（软�示，�阻断）**，�第 6.2 节。
+
+```
+                               ┌── 原结算� kingdeeSyncStatus ──�
+�作2 调整�审批通过 ──────────┤                                │
+                               â–¼                                â–¼
+                        未推�(unsynced)                    已推�(synced)
+                               │                                │
+                     ① 回写原�费用/金�                ① 原�业务数��零改动】
+                     ② 原�写�更记录                    ② 原�仅写 1 ��更记录
+                     ③ �布 KingdeeBillApprovedEvent     ③ 调整�置 approved
+                        (formal-settlement, 原�id)       ④ toast：原结算�已推�金�，
+                     ④ AFTER_COMMIT → syncKingdee(原�)      请财务在金�手工完�旧应付�冲销处�
+                     ⑤ 回填调整� synced + kingdee_bill_no
+                               │                                │
+                               │                        �财务在金�手工冲销旧应付/应收�】
+                               │                                │
+                               │                       �作3 �新推�（高�）
+                               │                                │
+                               │                 ① 校验调整� approved
+                               │                 ② 旧键查 A102-4/A302-4 → �求 hadwrittenoff=true
+                               │                 ③ 克隆原� → 新正�结算�（+应用调整明细��建 source）
+                               │                 ④ 新��组新键推 A102-2/A302-2
+                               │                 ⑤ 新��� + 附件
+                               │                 ⑥ 调整�改挂新� + 回填 kingdee_bill_no/synced
+                               │                 ⑦ 原�：标记「已调整�+ 旧� unlocked
+                               │                 ⑧ 写�更记录；失败置 failed ��试
+                               â–¼                                â–¼
+                          金�应付/应收�                   金��全新】应付/应收�
+                          （�原����）                  （新����，旧�已冲销）
+```
+
+### 5.2 三����
+
+1. **原�一�推�金��冻结**：已推�场景下原�除「�更记录 / 标记 / 解��外，任何业务字段与状���改。
+2. **调整�的金��体现在新�**：未推�场景作用于原�；已推�场景作用于�推时克隆出的新�。两者共用�一段「应用调整到结算��的逻辑。
+3. **�推必须锚定金�侧已冲销**：以 A102-4/A302-4 的 `hadwrittenoff=true` 为唯一放行�件，����生�应付/应收�。
+
+## 6. �作 1｜新增调整�
+
+### 6.1 选���（��现状）
+
+选��� `candidateFormalSettlements`（`SettlementAdjustmentServiceImpl` 约 98）已符��求，�改：
+
+- 仅 `approvalStatus = approved` 的正�结算�；
+- 排除已下推付款申请的�（`tailPaymentSettlementIds`，约 324）；
+- 排除收付完�/尾款等��调整（`adjustableFormalSettlement`，约 295）；
+- �存时自动回带客商�调整类型����原结算金�等。
+
+### 6.2 选��金�冲销预检（新增，软�示）
+
+选定关�结算���回带信��，�端调�端**预检接�**：
+
+1. 若结算�**未推�金�**（`kingdeeSyncStatus != synced`）→ 返回"未推�"，正常继续，�续按设计文档走审批自动推分支；
+2. 若**已推�**→ 按防�键（`正�结算��_结算明细���`）批�调 A102-4（应付）/ A302-4（应收），读 `hadwrittenoff`：
+   - `hadwrittenoff = true` → 返回"已推�·旧�已冲销"，�示"旧应付/应收�已冲销，审批���新推�新�"；
+   - `hadwrittenoff != true`（�查询�到）→ 返回"已推�·旧�未冲销"，给出**醒目�示**："该结算�已推�金�且旧�尚未冲销，审批通过�需先由财务在金�完�冲销，�能�新推�"。
+
+**�径**：
+
+- 预检为**软�示**，�阻断建�（默认建议）；是��级为硬拦截由业务�行确认。
+- **�级**：金�查询超时/��用/接�异常时，预检返回"未校验"，**�阻断**建�与回带，由�续审批分�与�推闸门兜底。
+- 预检结果**�用于�示**，�作为�续环节的结论缓存：审批（�作 2）��推（�作 3）�自按**当下**状��新判定。
+
+> 为什么�把硬拦截放在选�：冲销是金�侧**��逆/需人工撤销**的对外�作，而审批�是 TMS 内部决策。若选���求已冲销，会出现"旧�已冲销�调整��被驳回/删除"的**应付�空档**（详�第 13 节）。
+
+## 7. �作 2｜审批通过
+
+### 7.1 未推�场景（原� `kingdeeSyncStatus != synced`）
+
+沿用现有 `approve()` 逻辑并补推�：
+
+1. `applyAdjustmentToSettlement(原�, 调整�)`：回写费用项目�明细��计��算结算金�（**抽�公共方法**）；
+2. 原�追加�更记录�挂载调整�；
+3. 调整�置 `approved`；
+4. 事务�交��布 `KingdeeBillApprovedEvent("formal-settlement", 原�id)`，由既有 `KingdeeApprovalSyncListener`（AFTER_COMMIT + 域开关 + 全� try/catch）调 `formalSettlementService.syncKingdee(原�id)` 完� A102-2/A302-2 推� + ��；
+5. 推��功回填调整� `kingdeeSyncStatus=synced` + `kingdeeBillNo`；失败置 `failed`（�改「已审批�结果，进入�推循环）。
+
+> �用 `2026-10-05-审批通过自动�步金�设计` 的事件机制，��写推�路径；自动推�失败�影�审批结果。
+
+### 7.2 已推�场景（原� `kingdeeSyncStatus = synced`）★ 关键约�
+
+**原�业务数�一律�动**，��：
+
+1. 原�追加 1 ��更记录：`结算调整�XX审批通过，调整金�XX，待�推金�`；
+2. 调整�置 `approved`（`kingdeeSyncStatus` �� `synced` 快照，�端�状�显示「�新推��入�）；
+3. 返回�端 toast �示：**「原结算�已推�金�，请财务人员在金�手工完�旧应付�冲销处��**。
+
+> ��：�回写原�费用/金���修改旧应付��自动推�新���作废原�。
+
+## 8. �作 3｜�新推�（高�）
+
+`repush(调整�id)` �写为：
+
+1. **�置校验**：调整� `approvalStatus = approved`；原�存在。
+2. **冲销校验（硬闸门）**：�调整�� + 原��，按旧键（`原结算��_明细���`）查 A102-4（应付）/ A302-4（应收）；�求存在且 `hadwrittenoff = true`，�则抛出「原应付/应收�尚未在金�冲销，�止�推�。
+3. **克隆新正�结算�**：`cloneFormalSettlement(原�, 调整�)`
+   - 新�由 `nextNo` �正��水（`FJS`/`SJS`+日期+4 �）；
+   - 克隆明细�明细费项�汇总费项��票�汇率等；
+   - 调 `applyAdjustmentToSettlement(新�, 调整�)` 应用调整（金� = 原� + 调整）；
+   - **�建** `FormalSettlementSource`（接续原���预结算）；
+   - `approvalStatus = approved`�`kingdeeSyncStatus = unsynced`�`originFormalSettlementNo = 原��`；
+   - 附件�制/挂载。
+4. **推�新�**：新��天然组�新防�键（`新结算��_明细���`），调 `syncKingdee(新�id)`（内部 A102-2/A302-2），**推�把新�状�置 `unsynced`** 以�被 `doSyncKingdee` 的 `synced` 早退。
+5. **��**：新� `lockAfterPush`（`TARGET_AP_BILL`/`TARGET_AR_BILL`）+ 附件上传。
+6. **改挂 + 回填**：调整� `formalSettlementId/No` 改指新�，回填 `kingdeeBillNo` + `kingdeeSyncStatus=synced`。
+7. **原�收尾**：标记 `adjustStatus='已调整'` + 旧�记录置 `unlocked`；追加�推�更记录。业务字段�动。
+8. **失败处�**：新� `kingdeeSyncStatus=failed` + 失败原因，支��用 `retryKingdeeFailed` �试（�试�从第 4 步继续，克隆已存在则跳过，注�幂等）。
+
+## 9. 关键机制
+
+### 9.1 防�键与新��
+
+- 金� `awrp_src_code = 结算��_明细���`。因为�推**新建了真实结算�记录**（新 `FJS/SJS` �），新键天然与原键��，**无需��外拼调整��**——早期「拼调整��改防�键�的方案已被「新建结算��覆盖。
+- 旧键（原结算��）用于查冲销；新键（新结算��）用于生�全新应付/应收�。
+
+### 9.2 冲销判定
+
+- �认 `hadwrittenoff = true`（`BfiApBillVO` 158 / `BfiArBillVO` 138）。部分冲销�样放行。
+- `iswrittenoff` ��独作为放行��。�地�需用 Apifox 实测 A102-4/A302-4 确实回传 `hadwrittenoff`。
+- **两处判定，用途��**：�作 1 选�预检 = 软�示（第 6.2 节）；�作 3 �推 = **硬闸门**（第 8 节）。预检�替代闸门——冲销在金��被撤销，且建�到�推期间状��能�化。
+
+### 9.3 克隆新正�结算�
+
+- �用现有「�存/组装�逻辑而��写：明细�费项�汇总����附件�汇率�收付款��等按原�快照�制。
+- 新���走审批�（直接 `approved`），因此�写审批�更记录以外的�程痕迹；是�补一�「由调整�XX生���更记录�选。
+
+### 9.4 金��
+
+- 新�推��功 → `lockAfterPush` ��，状�与既有一致。
+- 原�旧�：�推时置 `unlocked`（决策 D）。因正�结算�未调用 `checkEditable`，解�主�影��端标签，�构��端编辑�洞。
+
+### 9.5 失败与�试
+
+- �用 `markKingdeeSyncFailed` / `retryKingdeeFailed` 模�：失败� `failed` + 原因，�被定时�推任务扫�。
+- 克隆步骤需幂等：以 `originFormalSettlementNo + 调整�` 作为唯一判断，���试时��建�。
+
+### 9.6 展示标记
+
+| 对象 | 标记 | �� |
+|---|---|---|
+| 新正�结算� | 「调整���（并显示原��） | `origin_formal_settlement_no` �空 |
+| 原正�结算� | 「已调整� | `adjust_status = 'adjusted'` |
+| 结算调整� | 金�状� / 金���� | `kingdee_sync_status` / `kingdee_bill_no` |
+
+## 10. 数�模型改动（DDL）
+
+新增脚本 `doc/sql/transport/blade_settlement_adjustment_kingdee_20261016.sql`（多数�库脚本�步，排�规则 `utf8mb4_general_ci`）：
+
+```sql
+-- 结算调整�：�金����
+ALTER TABLE blade_settlement_adjustment ADD COLUMN kingdee_bill_no VARCHAR(64) NULL COMMENT '金����';
+
+-- 正�结算�：��原��（新�） + 调整标记（原�）
+ALTER TABLE blade_formal_settlement ADD COLUMN origin_formal_settlement_no VARCHAR(64) NULL COMMENT '��原正�结算��（结算调整�推生�）';
+ALTER TABLE blade_formal_settlement ADD COLUMN adjust_status VARCHAR(32) NULL COMMENT '调整状�：adjusted=已被结算调整';
+```
+
+�时生�新增按钮（「推�金��「�新推��）的���入 SQL。
+
+## 11. 改动清�（文件级）
+
+| # | 文件 | 改动 |
+|---|---|---|
+| 1 | `blade_service_api/.../pojo/entity/SettlementAdjustment.java` | 加 `kingdeeBillNo` |
+| 2 | `blade_service_api/.../pojo/entity/FormalSettlement.java` | 加 `originFormalSettlementNo`�`adjustStatus` |
+| 3 | `blade_service_api/.../pojo/vo/SettlementAdjustmentVO.java`�`FormalSettlementVO.java` | 补展示字段/翻译 |
+| 4 | `SettlementAdjustmentServiceImpl.approve()` | 未推�→� `KingdeeBillApprovedEvent` + 回填；已推�→仅�更记录 |
+| 5 | `SettlementAdjustmentServiceImpl.repush()` | �写：冲销校验 → 克隆新� → 推 → �� → 改挂 → 回填 → 原�标记/解� → 失败置 failed |
+| 6 | `SettlementAdjustmentServiceImpl` | 抽公共方法 `applyAdjustmentToSettlement(结算�, 调整�)` |
+| 7 | `FormalSettlementServiceImpl`（或新 support） | 新增 `cloneFormalSettlement(...)`（��建 `FormalSettlementSource`） |
+| 8 | `FormalSettlementServiceImpl` / `KingdeeApBillSyncSupport` | 冲销查询（A102-4/A302-4 读 `hadwrittenoff`）�装 |
+| 9 | `FormalSettlementWrapper` / 列表 Mapper | 回填 `adjustStatus` / `originFormalSettlementNo` |
+| 10 | �端 `settlement-adjustment.vue`�`settlementAdjustment.js` | 金�状�/��列�「推�金��「�新推��按钮（�推�冲销预检）；选��调预检接�并展示软�示 |
+| 11 | �端 `formal-settlement.vue` / `formal-settlement-table-panel.vue` / 详情 | 「调整�� / 已调整�标识�查看弹窗补�推入� |
+| 12 | `doc/sql/...` | DDL + �� SQL |
+| 13 | `SettlementAdjustmentServiceImpl` + `SettlementAdjustmentController` | 新增选�预检接�（返回 未推� / 已推�已冲销 / 已推�未冲销；金�异常�级返回未校验） |
+
+## 12. 边界场景推演
+
+| 场景 | 行为 |
+|---|---|
+| 调整�未审批就�推 | �置校验拒�（�求 approved） |
+| 旧应付�未冲销 | A102-4 返回 `hadwrittenoff=false`/�存在 → 拒�，�示先冲销 |
+| 部分冲销 | `hadwrittenoff=true` → 放行 |
+| 旧应付�被删除（�冲销） | 查询�到 → 拒�（�满足 `hadwrittenoff=true`） |
+| 已推�场景审批�财务未冲销 | �推被拦；原�与新��未产生��应付� |
+| �推推�失败 | 新�置 `failed` + 原因；原�已标「已调整�+ 解�；�试从推�步骤续上 |
+| �推�功但�库�崩溃 | �试时幂等判断：已存在�一��新�则跳过克隆，仅补推/补回填 |
+| 应收结算�（A302-2/A302-4） | 走�一套逻辑，应收侧下游关���移（决策 A） |
+| 原��残留 | �推时统一置 `unlocked` |
+| 未推�场景自动推失败 | 审批��功；调整� `failed`，走�推循环 |
+| 选�时结算�已推�且旧�未冲销 | 预检返回"未冲销"并**软�示**（�阻断建�）；审批�需先冲销��推 |
+| 选�时金�超时/��用 | 预检**�级为"未校验"**，�阻断建�；由审批分�与�推闸门判定 |
+| 建�时未推��审批时已被推�到金� | 审批按**当下**状�走"已推�"分支：�自动推��示财务冲销；预检结论�沿用 |
+| 选�时已冲销��推�被金�撤销冲销 | �推硬闸门�新查询 `hadwrittenoff` → 拦截，�示先冲销 |
+
+## 13. 风险与待验�
+
+1. **A102-4/A302-4 的 `hadwrittenoff` 实际回传**：必须先用 Apifox 实测，�则整套冲销判定�能推翻。
+2. **克隆新�**：`FormalSettlementSource` �建会牵动预结算�用（`PreSettlement.formalSettlementNo`），是最易产生�数�的一步，需�独�步验�。
+3. **原�下游关���移**（开票申请/收款认领/对账）：新�为全新独立�，应收场景下新�将显示「未开票/未收款�，属已确认�径，但需业务知悉。
+4. **�推幂等**：克隆需以��唯一键�����建�，验��试与并�（�一调整���点击）。
+5. **正�结算�无 `checkEditable`**：解��构��端�洞，但需确认�端在 `approved` 下��暴露编辑入�，��原�被改。
+6. **冲销�置到选�的风险（故��硬拦截）**：冲销是金�侧��逆/需人工撤销的对外�作，审批是 TMS 内部决策。若选��硬拦截（�求已冲销），会出现"旧�已冲销�调整��被驳回/删除"的**应付�空档**，需人工在金���冲销。故预检仅作软�示，硬闸门留在�推。
+7. **预检接����为�点**：金���用时必须�级放行，�则远程�赖会阻断调整�的建�与回带。
+
+---
+
+## 14. �地实现备注（2026-10-16）
+
+1. **未推�场景回填**：推��功/失败分别由 `FormalSettlementServiceImpl.doSyncKingdee` / `markKingdeeSyncFailed` 按 `formal_settlement_id + approval_status=approved` 回填调整� `kingdee_sync_status`（synced/failed）与 `kingdee_bill_no`，�用 §7.1 的事件自动推�链路，未新增推�路径。
+2. **�推为「�事务编排 + 段内事务�**：`repush` �次执行 —— 冲销硬闸门（旧键查 A102-4/A302-4，`hadwrittenoff=true`）→ 自代�事务 `cloneAndApplyForRepush`（克隆新� + 应用调整，原�）→ `syncKingdee(新�)` 推� → �功�调整�改挂新� + 原�标记「已调整�+ 旧�解�。推�失败**�回滚已克隆新�**，�试按 `origin_formal_settlement_no = 调整�当�关���` 幂等�用，从推�步骤续上（§8.8�§9.5）。
+3. **改挂时机**：调整�改挂新�在**推��功之�**，故�功��点�推会被冲销闸门拦截（无副作用）；如需彻底��，�端按「关��是�克隆��判断。
+4. **新��克隆�票**：�循决策 A「下游关���移�，新� `invoiceStatus=unreceived`�`paymentStatus=unpaid`，`invoiceAmount/paidAmount/appliedPaymentAmount` 归零，�票��制。
+5. **��**：新增按钮 `settlement_adjustment_sync`（推�金�）；`settlement_adjustment_repush`（�新推�）�用既有��，����入。
+6. **待实测**：A102-4/A302-4 的 `hadwrittenoff` 实际回传（§13.1）；克隆新�对 `PreSettlement` �用的影�（§13.2）。
+