docs: 结算调整单文档补充页面截图与总体流程图

设计文档补充列表、新增、预检、重推高危确认 4 张图；操作说明补充各状态操作入口、回带录入、预检、提交确认、重推确认 5 张图，并将总体流程图前移至第二章作为 2.2。
2026-10-29 17:19:54 +08:00
parent ad6864b730
commit d69c112eff
11 changed files with 47 additions and 2 deletions
@@ -20,6 +20,8 @@

 > 全程交互使用中文。

+![结算调整单列表：审批通过的调整单统一一个入口，未同步显示「推送金蝶」、已同步显示「重新推送（高危）」；列表带「金蝶单据状态 / 金蝶单据号」列](./2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/01-结算调整单列表-金蝶状态与推送入口.png)
+
 ## 2. 名词与接口速查

 | 代号 | 含义 |
@@ -119,6 +121,8 @@
 - 排除收付完成/尾款等不可调整（`adjustableFormalSettlement`，约 295）；
 - 保存时自动回带客商、调整类型、合同、原结算金额等。

+![新增结算调整单：选定关联结算单后自动回带客商、结算单类型、合同、原结算金额，并带出原单费用明细供录入调整金额](./2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/02-新增调整单-回带结算单信息与费用明细.png)
+
 ### 6.2 选单后金蝶冲销预检（新增，软提示）

 选定关联结算单号、回带信息后，前端调后端**预检接口**：
@@ -134,6 +138,8 @@
 - **降级**：金蝶查询超时/不可用/接口异常时，预检返回"未校验"，**不阻断**建单与回带，由后续审批分流与重推闸门兜底。
 - 预检结果**只用于提示**，不作为后续环节的结论缓存：审批（操作 2）、重推（操作 3）各自按**当下**状态重新判定。

+![选单后金蝶冲销预检：该结算单已推送金蝶且旧单尚未冲销时的醒目提示，仅为软提示，不阻断建单](./2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/03-新增调整单-选单后金蝶冲销预检提示.png)
+
 > 为什么不把硬拦截放在选单：冲销是金蝶侧**不可逆/需人工撤销**的对外操作，而审批只是 TMS 内部决策。若选单即要求已冲销，会出现"旧单已冲销、调整单却被驳回/删除"的**应付单空档**（详见第 13 节）。

 ## 7. 操作 2｜审批通过
@@ -179,6 +185,8 @@
 7. **原单收尾**：标记 `adjustStatus='已调整'` + 旧锁记录置 `unlocked`；追加重推变更记录。业务字段不动。
 8. **失败处理**：新单 `kingdeeSyncStatus=failed` + 失败原因，支持复用 `retryKingdeeFailed` 重试（重试即从第 4 步继续，克隆已存在则跳过，注意幂等）。

+![重新推送（高危）：点击后先弹高危二次确认，确认金蝶旧应付/应收单已由财务手工冲销后才真正生成新单](./2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/04-重新推送-高危二次确认.png)
+
 ## 9. 关键机制

 ### 9.1 防重键与新单号
@@ -34,7 +34,34 @@
 - 审批中：只能"通过"或"驳回"。
 - 审批通过：终态，只剩金蝶推送相关操作。

-### 2.2 各状态下的按钮
+### 2.2 总体流程图
+
+```
+                                调整单审批通过
+                                       │
+                               原结算单金蝶状态
+                   ┌───────────────────┴────────────────────┐
+                   ▼                                        ▼
+  未推送（场景 A）                       已推送（场景 B）
+  ① 调整回写原结算单                     ① 原结算单业务数据【零改动】
+  ② 原单追加变更记录                     ② 原单仅追加 1 条变更记录
+  ③ 调整单 → 审批通过                    ③ 调整单 → 审批通过
+  ④ 自动推送金蝶                         ④ 提示：请财务在金蝶手工冲销旧单
+     （应付/应收单 + 落锁 + 附件）       【财务在金蝶手工冲销旧单】
+  ⑤ 回填「已同步 + 金蝶单据号」          点「重新推送（高危）」并二次确认
+  ↓                                      ① 校验调整单已审批通过
+  金蝶应付/应收单（含调整金额）          ② 旧单必须已冲销，否则拒绝
+                                         ③ 克隆新正式结算单（应用调整）
+                                         ④ 用新单号推金蝶 → 全新应付/应收单
+                                         ⑤ 新单落锁 + 附件
+                                         ⑥ 调整单改挂新单 + 回填金蝶单据号
+                                         ⑦ 原单标「已调整」+ 旧锁解锁
+                                         ⑧ 推送失败置「生成失败」，可重试
+                                         ↓
+                                         金蝶【全新】应付/应收单（旧单已冲销）
+```
+
+### 2.3 各状态下的按钮

 | 状态 | 可用操作 | 说明 |
 |---|---|---|
@@ -43,7 +70,9 @@
 | 审批中 | 通过 / 驳回 | 审批人操作 |
 | 审批通过 | 推送金蝶 / 重新推送（合一按钮）| 按金蝶状态自动分流，高危确认 |

-### 2.3 金蝶同步状态（调整单上的展示字段）
+![结算调整单列表：草稿行显示「查看 / 编辑 / 删除 / 提交」，审批通过行只剩「查看」与推送类操作；金蝶状态为「已同步」时按钮变为红色的「重新推送（高危）」，未同步时为「推送金蝶」](./2026-10-17-结算调整单操作流程说明（分场景）.assets/01-结算调整单列表-各状态操作入口.png)
+
+### 2.4 金蝶同步状态（调整单上的展示字段）

 | 状态 | 含义 |
 |---|---|
@@ -67,6 +96,10 @@

 > 预检只是提示，不拦人；真正的拦截在"重新推送"那一步。填单时必须至少录入一条调整费用，否则无法提交。

+![新增调整单：选定关联正式结算单后自动回带客商、结算单类型、合同、原结算金额，并带出原单费用明细供录入调整金额](./2026-10-17-结算调整单操作流程说明（分场景）.assets/02-新增调整单-选单回带与费用录入.png)
+
+![选单后的金蝶冲销预检：该结算单已推送金蝶且旧单未冲销时，顶部弹出醒目提示"审批通过后需先由财务在金蝶完成冲销，才能重新推送"，但建单不受影响](./2026-10-17-结算调整单操作流程说明（分场景）.assets/03-新增调整单-金蝶冲销预检提示.png)
+
 ### 3.2 保存草稿 / 编辑 / 删除

 - 草稿和已驳回的单可反复编辑；删除仅限草稿，删除后单号作废、不留痕迹。
@@ -77,6 +110,8 @@
 - 草稿 / 已驳回 → 审批中，进入审批人的待办。
 - 提交后单据锁定，提交人不能再改。

+![提交审批：草稿行点「提交」后需二次确认，确认后单据进入审批中并锁定](./2026-10-17-结算调整单操作流程说明（分场景）.assets/04-提交审批二次确认.png)
+
 ### 3.4 审批通过 ★ 核心分流点

 审批人点"通过"后，系统按**原结算单是否推送过金蝶**自动走两条完全不同的路（见第四、五节场景 A / B）：
@@ -102,6 +137,8 @@

 按钮点击均有高危二次确认弹窗。

+![重新推送（高危）：确认金蝶旧应付/应收单已由财务手工冲销后才继续，系统将克隆新单并生成全新应付/应收单](./2026-10-17-结算调整单操作流程说明（分场景）.assets/05-重新推送-高危二次确认.png)
+
 ---

 ## 四、分场景流程