diff --git a/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/01-结算调整单列表-金蝶状态与推送入口.png b/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/01-结算调整单列表-金蝶状态与推送入口.png new file mode 100644 index 00000000..8303ad57 Binary files /dev/null and b/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/01-结算调整单列表-金蝶状态与推送入口.png differ diff --git a/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/02-新增调整单-回带结算单信息与费用明细.png b/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/02-新增调整单-回带结算单信息与费用明细.png new file mode 100644 index 00000000..8410d6d1 Binary files /dev/null and b/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/02-新增调整单-回带结算单信息与费用明细.png differ diff --git a/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/03-新增调整单-选单后金蝶冲销预检提示.png b/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/03-新增调整单-选单后金蝶冲销预检提示.png new file mode 100644 index 00000000..4d3bf538 Binary files /dev/null and b/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/03-新增调整单-选单后金蝶冲销预检提示.png differ diff --git a/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/04-重新推送-高危二次确认.png b/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/04-重新推送-高危二次确认.png new file mode 100644 index 00000000..6f20c8d9 Binary files /dev/null and b/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.assets/04-重新推送-高危二次确认.png differ diff --git a/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.md b/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.md index a33bdcc2..7e0a0b4d 100644 --- a/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.md +++ b/doc/docs/业务流程/2026-10-16-结算调整单接入金蝶设计（未推送自动推-已推送冲销后重推新单）.md @@ -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 防重键与新单号 diff --git a/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/01-结算调整单列表-各状态操作入口.png b/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/01-结算调整单列表-各状态操作入口.png new file mode 100644 index 00000000..992bc639 Binary files /dev/null and b/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/01-结算调整单列表-各状态操作入口.png differ diff --git a/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/02-新增调整单-选单回带与费用录入.png b/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/02-新增调整单-选单回带与费用录入.png new file mode 100644 index 00000000..8410d6d1 Binary files /dev/null and b/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/02-新增调整单-选单回带与费用录入.png differ diff --git a/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/03-新增调整单-金蝶冲销预检提示.png b/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/03-新增调整单-金蝶冲销预检提示.png new file mode 100644 index 00000000..4d3bf538 Binary files /dev/null and b/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/03-新增调整单-金蝶冲销预检提示.png differ diff --git a/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/04-提交审批二次确认.png b/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/04-提交审批二次确认.png new file mode 100644 index 00000000..5c1d4282 Binary files /dev/null and b/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/04-提交审批二次确认.png differ diff --git a/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/05-重新推送-高危二次确认.png b/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/05-重新推送-高危二次确认.png new file mode 100644 index 00000000..6f20c8d9 Binary files /dev/null and b/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.assets/05-重新推送-高危二次确认.png differ diff --git a/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.md b/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.md index 16522c1b..92290581 100644 --- a/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.md +++ b/doc/docs/业务流程/2026-10-17-结算调整单操作流程说明（分场景）.md @@ -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) + --- ## 四、分场景流程