docs: 金蝶BFI对接操作手册汇总结算调整单与预付操作手册并按收票指定应付改造修订

① 合并《结算调整单操作流程说明》《预付转正式结算单与项目预付操作手册》为手册 3.11/3.2-3.6/3.14 节；② 按 11-01/11-02 代码修订收票后款认领：发票登记移至付款结算单工具栏、弹窗回显已认领收票单、匹配结算单金额可手动修改、查看页新增是否已指定应付列与重新推送入口、列表指定失败悬浮展示聚合原因；③ A302-6 指定应付定时自动补偿改开关控制默认关闭改人工兜底；④ 菜单拆分更名对齐（预付结算单/付款结算单/收款结算单）；⑤ 截图更新：playwright 重截 8 张、并入两手册 18 张、下线 3 张过时旧图
2026-11-03 00:33:27 +08:00
parent ada300835b
commit ba23fe2960
30 changed files with 394 additions and 92 deletions
@@ -1,9 +1,10 @@
 # 金蝶（星瀚）BFI 对接操作手册（纯操作版）

-> 整理日期：2026-10-14（2026-10-31 修订）
+> 整理日期：2026-10-14（2026-11-03 汇总修订）
 > 适用对象：TMS 业务操作人员（财务/业务）、系统管理员、实施运维。
 > 本文只讲**怎么操作**：在哪个页面、点什么按钮、前提是什么、成功的标志是什么、失败了怎么处理。
-> 接口与代码细节见同目录《2026-10-14-金蝶（星瀚）BFI全链路梳理（前端-后端-定时任务·业务域汇总与操作手册）》。
+> 接口与代码细节见同目录《2026-10-14-金蝶（星瀚）BFI全链路梳理（前端-后端-定时任务·业务域汇总与操作手册）》；
+> 预付与结算调整的深度说明见《2026-10-18-预付转正式结算单与项目预付操作手册（纯操作·带状态）》《2026-10-17-结算调整单操作流程说明（分场景）》（本文已汇总其操作要点）。

 ## 修改记录

@@ -11,7 +12,8 @@
 |---|---|
 | 2026-10-14 | 初版 |
 | 2026-10-19 | 核对并补充 4.2 定时任务运转逻辑（cron 默认值、错峰、终态不轮询、防呆与自愈行为） |
-| 2026-10-31 | ① **3.6 收票登记改「先票后款」**：收票登记只选票推金蝶收票单（不再关联结算单，新增手选结算组织/发票明细），「认领收票单+指定应付」移到付款结算单（编辑器选收票单 / 行内「发票登记」）；② **3.7 收款流水与认领改口径**：数据源改金蝶收款单（A301-1）、「推送金蝶」「查询金蝶认领结果」按钮下线、认领只登记本地、作废同步合同合规；③ **3.1 客商建档**：新增供应商编码自动获取与收款信息开户行带出联行号操作；④ 2 节准备事项、4 节定时任务清单、5 节 FAQ、6 节速查表同步更新；⑤ 截图更新（收票登记先票后款表单、发票登记弹窗、收款流水新列表、认领记录、客商供应商编码） |
+| 2026-10-31 | ① 收票登记改「先票后款」：收票登记只选票推金蝶收票单（不再关联结算单，新增手选结算组织/发票明细），「认领收票单+指定应付」移到付款结算单；② 收款流水与认领改口径：数据源改金蝶收款单（A301-1）、「推送金蝶」「查询金蝶认领结果」按钮下线、认领只登记本地、作废同步合同合规；③ 客商建档新增供应商编码自动获取与收款信息开户行带出联行号操作；④ 准备事项、定时任务清单、FAQ、速查表同步更新 |
+| 2026-11-03 | **四文档汇总修订（合并《2026-10-17 结算调整单》《2026-10-18 预付与项目预付》两本手册 + 按 11-01/11-02 代码与界面更新）**：① 全篇菜单更名对齐系统实际（预付结算单/付款结算单/收款结算单，新增 1.4 页面名称对照）；② 1.1 状态表补页面显示别名与「已指定应付」列；③ 新增 3.3 进度预付、3.4 项目预付（含客商风险与付款特批）、3.5 项目预付核销、3.6 尾款结算、3.10 结算调整单、3.14 作废与撤销；④ 开票申请按「剩余可开票金额」累计控制（放开必须未开票限制）、分摊发票金额系统自动分摊；⑤ **收票后款认领按 11-02 改造更新**：发票登记移到付款结算单工具栏、弹窗回显已认领收票单、「匹配结算单金额」支持手动修改、查看页新增「是否已指定应付」列与「重新推送」入口、列表指定失败悬浮展示原因；⑥ **A302-6 指定应付定时自动补偿改开关控制（默认关闭）改人工兜底**；⑦ 4/5/6 节同步更新，截图全面更新（付款结算单列表与发票登记弹窗、选择收票单、查看页发票信息、指定失败悬浮、付款管理已指定应付列、收票登记表单去税率） |

 ---

@@ -26,29 +28,64 @@

 ### 1.1 金蝶单据状态含义（列表里看到的字段）

-| 状态值 | 含义 | 还会变吗 |
-|---|---|---|
-| unsynced | 未推送金蝶 | 会（推送成功变 synced） |
-| synced | 已推送金蝶，金蝶受理 | 会（继续走后续状态） |
-| failed | 推送失败（有失败原因） | 会（重推成功变 synced） |
-| pushed | 金蝶收票单已生成（收票推送到此为止）；已推送金蝶（收款流水） | 会（收票被付款结算单认领且应付单推送后变 assigned；收款流水状态随同步刷新） |
-| paying | 金蝶付款中（仅付款申请） | 会（付款完成变 paid） |
-| paid / closed | 已付款 / 已关闭（终态） | 不变 |
-| invoiced | 已开票（终态，开票申请） | 不变 |
-| assigned | 已指定应付（终态，收票——由付款结算单侧认领并在应付单推送后指定） | 不变 |
-| exist | 金蝶已有该客商且审核通过（终态，客商） | 不变 |
+各列表的「金蝶单据状态」列是同一个字段，但不同页面的**显示文案**不同（下表「页面显示」列），看到哪个词都对得上：
+
+| 状态值 | 页面显示 | 含义 | 还会变吗 |
+|---|---|---|---|
+| unsynced | 未同步（结算/收票/开票/客商）·未生成（付款申请） | 未推送金蝶 | 会（推送成功变 synced） |
+| synced | 已同步 ·已生成 | 已推送金蝶，金蝶受理 | 会（继续走后续状态） |
+| failed | 同步失败 ·生成失败 | 推送失败（悬浮状态标签可看失败原因） | 会（重推成功变 synced） |
+| paying | 付款中 | 金蝶付款中（仅付款申请） | 会（付款完成变 paid） |
+| paid / closed | 已付款 / 已关闭 | 已付款 / 已关闭（终态） | 不变 |
+| invoiced | 开票完成 | 已开票（终态，开票申请） | 不变 |
+| pushed | 已推送（收票）/ 已推送（收款流水） | 金蝶收票单已生成（收票推送到此为止）；已推送金蝶（收款流水） | 会（收票被付款结算单认领并指定应付后变 assigned） |
+| assigned | 已指定应付 | 已指定应付（终态，收票——由付款结算单侧认领并在应付单推送后指定） | 不变 |
+| exist | 金蝶已有该客商且审核通过 | 金蝶已审核（终态，客商） | 不变 |
+
+结算单列表、付款管理列表还有一列「**已指定应付**」（聚合本单认领收票单的指定状态）：**已指定应付**（绿）/ **指定失败**（红，悬浮展示聚合的各票失败原因）/ **未指定**（灰）/ `-`（本单未认领收票单）。

 ### 1.2 「金蝶锁定」标签是什么

 结算单、付款申请、开票申请推送成功后，TMS 会**自动锁定金蝶侧单据**。列表出现红色「金蝶锁定中」标签时：**该单据不可修改、不可作废**。要改动只能先在金蝶侧解锁/删单，金蝶会回调 TMS 自动还原本地状态。

+| 列显示 | 含义 | 影响 |
+|---|---|---|
+| 金蝶锁定中（红标） | 金蝶已锁单 | 不可编辑、不可作废 |
+| 锁定失败·补偿中 | 加锁没成功 | 系统每 5 分钟自动补偿重锁（≤5 次） |
+| 锁定失败·已达上限 | 自动补偿 5 次都没成功 | 不再自动重试；重新点一次「同步金蝶」即可重置计数补锁，必要时联系管理员 |
+| 金蝶删单 / 金蝶解锁（留痕） | 金蝶侧把单删了或解锁过 | 付款申请→金蝶状态变"生成失败"待重推；结算单/开票申请→系统自动作废（见 3.14） |
+
 ### 1.3 两条推送路径

 - **自动**：审批「通过」时系统自动推送金蝶（需管理员开启对应开关，见第 4 节）；开启后审批接口会直接返回推送结果，失败时页面提示「审批通过，但自动同步金蝶失败：xxx」。
- **手动**：列表勾选单据点工具栏「同步金蝶 / 批量同步」按钮。开关没开时用这条路径。（收款流水认领没有推送动作——认领只登记本地并自动推合同合规，见 3.7。）
+- **手动**：列表勾选单据点工具栏「同步金蝶 / 批量同步」按钮。开关没开时用这条路径。（收款流水认领没有推送动作——认领只登记本地并自动推合同合规，见 3.12。）

 两条路径效果完全一样，重复点不会重复推送（系统自动查重）。

+### 1.4 页面名称对照（先看这个）
+
+系统菜单已按"应付 / 应收"拆分，本文全部使用系统里的实际名称（旧的「正式结算单/预结算单」叫法已不再使用）：
+
+| 本文场景 | 系统菜单位置 | 页面名称 |
+|---|---|---|
+| 预付结算单（原预结算单） | 结算管理 | **预付结算单** |
+| 应付正式结算单 | 结算管理 | **付款结算单** |
+| 应收正式结算单 | 结算管理 | **收款结算单** |
+| 结算调整 | 结算管理 | 结算调整单 |
+| 付款申请列表 | 收付款管理 | **付款管理** |
+| 开票申请列表 | 收付款管理 | **开票管理** |
+| 收票登记 | 收付款管理 | 收票管理 |
+| 收款流水/认领记录 | 收付款管理 | 收款流水、认领记录 |
+| 客商档案 | 客商管理 | 客商档案 |
+
+付款申请的**付款类型**有三种，列表和表单里都按这个名称显示：
+
+| 类型值 | 页面显示 | 用途 |
+|---|---|---|
+| 进度预付 | 进度预付 | 挂预付结算单提前付款 |
+| 项目预付 | 项目预付 | 不挂结算单，按项目+承运商合同预付 |
+| 尾款付款 | 尾款付款 | 挂付款结算单付尾款 |
+
 ---

 ## 2. 一次性准备（实施/管理员操作）
@@ -97,38 +134,146 @@

 > 注意：审批通过后的**档案变更不会重新推送金蝶**。改了信用代码等关键信息需人工确认金蝶侧一致性。

-### 3.2 预结算单（正式结算与预付款的前置）
+### 3.2 预付结算单（进度预付与尾款结算的前置）

-**页面：结算管理 → 预结算单**
+**页面：结算管理 → 预付结算单**（原「预结算单」，本身不推送金蝶）

-预结算单**本身不推送金蝶**（列表无金蝶状态字段），它是正式结算和进度预付的前置单据，与金蝶的关联有两处：①非人民币项目在此维护汇率（从金蝶自动带出）；②进度预付款在金蝶付讫后自动回写本单的垫资记录。
+预付结算单**本身不推送金蝶**（列表无金蝶状态字段），它是进度预付和尾款结算（付款结算单）的前置单据，与金蝶的关联有两处：①非人民币项目在此维护汇率（从金蝶自动带出）；②进度预付款在金蝶付讫后自动回写本单的垫资记录。

-![预结算单列表：工具栏「新增 / 预付申请 / 尾款结算」；草稿行可 编辑/删除/提交，审批中可 通过/驳回](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/11-预结算单列表.png)
+![预付结算单列表：工具栏「新增 / 预付申请 / 尾款结算 / 打印结算单 / 导出」，需先勾选才能点预付申请或尾款结算；行内操作按状态显示 查看/编辑/删除/提交/通过/驳回/作废](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/31-预付结算单列表.png)

 1. 制单：「新增」录入结算金额与明细；**非人民币项目**：选择币种和汇率日期 → 系统自动从金蝶带出结算汇率并重算本位币。
-   ![预结算单编辑页：汇率日期/结算汇率字段（人民币时禁用为 1.00，外币选择日期后自动带出）](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/12-预结算单-汇率字段.png)
+   ![预付结算单编辑页：汇率日期/结算汇率字段（人民币时禁用为 1.00，外币选择日期后自动带出）](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/12-预结算单-汇率字段.png)
 2. 提交审批 → 审批「通过」（或驳回后修改重新提交）。
 3. 审批通过后的三个出口：
-   - **发起预付**：工具栏「预付申请」（限应付且已审批、未转正式）→ 生成进度预付付款申请，走 3.4 预付款推送金蝶；
-   - **转正式结算**：在正式结算单页面新建时选择本预结算单作为来源（可多张合并）→ 转入 3.3 正式结算推送；转正式后本单被锁定（节点显示「已锁定（正式结算）」并回写正式结算单号）；
-   - **尾款结算**：应付单生成尾款结算单号（同样需先转入正式结算推金蝶）。
-4. 注意：**正式结算单的汇率不自动继承预结算单**，转正式后需在正式结算单编辑时重新选汇率日期带出（见 3.8），否则推送金蝶不带汇率。
-5. 金蝶付款回写联动：进度预付在金蝶付讫（paid）后，系统自动在本单垫资记录回写付款金额与金蝶付款单号，并刷新已付/未付汇总——无需手工登记（异常时管理员可用回写接口手工补）。
+   - **发起进度预付**：工具栏「预付申请」（限应付且已审批、未转付款结算、同一合同可多选）→ 跳转付款申请新增页，见 3.3；
+   - **项目预付核销**：付款结算单/预付结算单编辑页「项目预付核销」分区，见 3.5；
+   - **尾款结算（转付款结算单）**：工具栏「尾款结算」→ 见 3.6；转后本单被锁定（不能再发起预付、不能作废）。
+4. 注意：**付款结算单的汇率不自动继承预付结算单**，转正式后需在编辑时重新选汇率日期带出（见 3.13），否则推送金蝶不带汇率。
+5. 金蝶付款回写联动：进度预付在金蝶付讫（已付款）后，系统自动在本单垫资记录回写付款金额与金蝶付款单号，并刷新「申请预付金额 / 已付款金额」两列——无需手工登记（异常时管理员可用回写接口手工补）。

-### 3.3 结算单推送（应付 / 应收）
+### 3.3 进度预付（预付结算单 → 付款申请）

-**页面：结算管理 → 正式结算单（应付 / 应收 Tab）**
+**页面：结算管理 → 预付结算单 →（预付申请）→ 收付款管理 → 付款管理**

-![正式结算单：应付/应收同页两个 Tab；工具栏「同步金蝶」需先勾选一条审批通过的单据；列表含结算汇率、金蝶单据状态、金蝶锁状态等列](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/03-正式结算单-同步金蝶.png)
+**前提**：预付结算单是**应付**、状态**审批通过**、还没转付款结算。

-前提：结算单已审批通过；非人民币结算单已维护汇率（见 3.8）；客商已 synced/exist。
+1. 进「预付结算单」列表，勾选单据（**同一合同**可多选；不满足"应付+审批通过+未转付款结算+同合同"会按钮拦截提示）。
+2. 点工具栏「**预付申请**」→ 自动跳到「付款申请新增页」：**付款类型固定为"进度预付"不可改**，所选预付结算单已带入、结算单号只读，"结算金额 / 可付款金额"自动带出。
+
+![付款申请表单（进度预付）：付款类型=进度预付且锁定，结算单号只读带出，结算金额/可付款金额自动显示，需填申请付款金额、付款方式、收款方](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/32-付款申请表单-进度预付.png)
+
+3. 如果是空表单进来，可点「结算单号」右侧「**选择**」，在弹窗「选择预付结算单」里按结算单号 / 项目 / 合同名称搜索后勾选。
+
+![选择预付结算单弹窗：按结算单号/项目/合同名称搜索，列示结算金额与可付款金额，可付款金额为 0 的单选了也付不了](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/33-付款申请-选择预付结算单弹窗.png)
+
+4. 填「申请付款金额」（不超过可付款金额）、「付款方式」（选承兑汇票时要再选汇票台账）、「收款方」→「**保存**」。
+5. 回到「付款管理」列表 → 找到该单 →「提交」→ 审批人「通过」。
+
+**状态变化**：付款申请 `草稿 → 审批中 → 审批通过`；随后系统自动推金蝶，金蝶状态 `未生成 → 已生成 → 付款中 → 已付款`（推送与回写见 3.8）。
+**同时发生**：预付结算单列表出现「申请预付金额 / 已付款金额」两列并随付款进度更新；预付结算单仍可继续「尾款结算」。
+
+> 若提交/通过后看到黄色警告写着金蝶推送失败：审批结果**不受影响**，稍后自动重推，或到付款管理列表勾选后点「批量同步」。
+
+### 3.4 项目预付（不挂结算单）
+
+**页面：收付款管理 → 付款管理 →（新增付款申请，付款类型=项目预付）**
+
+**前提**：项目已建、**承运商合同**已建；金额不超过项目额度与客户额度。
+
+**入口（注意）**：进「付款管理」列表 → 点「**新增付款申请**」→ 把「**付款类型**」选成「**项目预付**」。
+付款管理工具栏还有一个「预付申请」按钮——那个是**进度预付**（配合预付结算单用的），项目预付**必须**走新增+手选类型。
+
+![付款申请表单（项目预付）：付款类型=项目预付，需先选所属项目再选合同名称，不显示结算单/结算信息区](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/34-付款申请表单-项目预付.png)
+
+1. 填写：**所属项目**（必选）→ **合同名称**（必选，**选了项目后才能选**，只能选承运商合同）→ 申请付款金额、付款方式、付款方/收款方等。本类型不挂结算单，不显示结算信息与发票相关内容。
+2. 「保存」→「付款管理」列表「提交」→ 审批人「通过」。
+
+**会被拦截的情况（提示原文）**：
+- "申请付款金额不能超过项目额度"（项目额度 = 项目资金需求额度 + **审批通过且在有效期内**的临时额度；按单笔申请金额比较）
+- "申请付款金额不能超过客户额度"（按收款方匹配客商档案的信用额度）
+- "项目预付必须选择有效合同"、"付款申请只能选择承运商合同"
+- "申请付款金额不能超过可付款金额"（项目预付的可付款金额=项目资金需求×10000）
+
+**状态变化**：同 3.3。**务必等到金蝶状态「已付款」**，否则下一步核销（3.5）做不了。
+
+**客商风险与付款特批（所有付款申请提交时通用）**：
+- 提交时如果**收款方是高风险/黑名单客商**：会被拦截——"收款方[x]为高风险/黑名单客商，必须上传「特批附件」类型附件后再提交审批"。先在附件区上传类型为「特批附件」的文件再提交。
+- 如果触发**合规额度超额**（HCS 口径）：**不会拦截提交**，单据转入「付款特批」流程，特批完成后才会推金蝶。
+- 审批人点「通过」后，弹窗提示可能带一句话，常见三种：
+  - "审批通过，已发起付款特批，特批通过后将自动推送履约数据并同步金蝶" → 等特批完成，系统自动推；
+  - "审批通过，已同步金蝶：XXX" → 已经推成功；
+  - "审批通过，但自动同步金蝶失败：…" → 审批不受影响，稍后自动重推或手动「批量同步」。
+
+### 3.5 项目预付核销（在结算单上抵扣）
+
+**页面：结算管理 → 预付结算单 / 付款结算单（编辑页「项目预付核销」分区）**
+
+**前提**：有一笔**已付款**的项目预付（金蝶状态=已付款），且与本次结算单**同一合同**，还有剩余可核销金额。
+
+![付款结算单编辑页的「项目预付核销」分区：右上角「选择」按钮带出核销行，列为 预付单号/项目预付金额/可核销金额/本次核销金额/金蝶预付单号/创建人/创建时间；下方发票信息区的「选择收票单」是收票功能，不要点错](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/35-项目预付核销分区.png)
+
+1. 打开结算单（**预付结算单**或**付款结算单**都行）的编辑页，滚动到「项目预付核销」分区。
+2. 点分区右上角「**选择**」（没选合同会提示"请先选择合同"）。
+3. 弹窗「**选择项目预付单**」里勾选要抵扣的预付单（已选的行会灰掉，不能重复选）→「确定」。
+
+![选择项目预付单弹窗：只列示 同合同+审批通过+金蝶已付款+仍有可核销余额 的项目预付单，列含 预付单号/项目预付金额/可核销金额/金蝶预付单号](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/36-选择项目预付单弹窗.png)
+
+4. 在「**本次核销金额**」列：默认已按"可核销金额"填满，可以改小。
+5. 「保存」。
+
+**会被拦截的情况（提示原文）**：
+- "预付单 XXX 本次核销金额必须大于 0"
+- "预付单 XXX 本次核销金额不能超过可核销金额"
+- "项目预付核销合计不能超过结算单金额"
+- "仅可选择审核通过的项目预付单"
+- "预付单 XXX 尚未付款，项目预付须金蝶付款完成后方可核销"
+- "同一项目预付单不可重复核销"
+- "项目预付单与结算单合同不一致"
+
+**状态变化**：结算单「**已付金额（含预付、核销）**」立刻增大、「剩余未付金额」减小；核销金额会同时计入"已申请付款金额"和"已付金额"两个口径；列表上"申请付款金额（含预付）/已收已付合计（含预付）/剩余可付/收付款状态"同步变化。
+
+### 3.6 尾款结算（预付结算单转付款结算单，容纳预付）
+
+**页面：结算管理 → 预付结算单 →（尾款结算）→ 新增付款结算单**
+
+**前提**：预付结算单**审批通过**，且所选单据**同一项目**、**应付**。
+
+1. 进「预付结算单」列表，勾选（可多选，须同项目）→ 点工具栏「**尾款结算**」。
+2. 系统跳到「**新增付款结算单**」页，把所选预付结算单的明细、费用项合并进来。
+3. 检查结算合计区底部的三个金额（**付款结算单才有**）：
+   - **结算合计（原金额）**：费用合计，**始终全额**，不会因为预付/核销而变小；
+   - **已付金额（含预付、核销）**：把来源预付结算的已付预付 + 本次核销都算进去；
+   - **剩余未付金额** = 结算合计 − 已付。
+
+![编辑付款结算单：结算合计区底部一行显示 结算合计（原金额）/已付金额（含预付、核销）/剩余未付金额，下方依次为 结算明细/附件/项目预付核销/发票信息 分区](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/37-付款结算单编辑页-结算合计三口径.png)
+
+4. 「项目预付核销」区会**自动带出来源预付结算上已核销的行**，可增/删/改金额（口径见 3.5）。
+5. 「保存」（草稿）→「提交」→ 审批人「通过」。
+
+**会被拦截的情况**：
+- "仅审核通过的预付结算单可转付款结算"
+- "尾款结算只能选择同一项目下的预付结算单"
+- "该预结算单存在在途预付申请，无法尾款结算"（**审批中或已审批但还没付完款的预付申请都算在途**，先把预付处理完/付完再来转）
+
+**状态变化**：付款结算单 `草稿 → 审批中 → 审批通过`；预付结算单被标记为已转付款结算（来源被锁定：不能再发起预付、不能作废）。随后走 3.7 推送金蝶。
+
+### 3.7 结算单推送（付款结算单 / 收款结算单）
+
+**页面：结算管理 → 付款结算单（应付）/ 收款结算单（应收）**
+
+![付款结算单列表（应付）：工具栏 新增/付款申请/发票登记/同步金蝶/打印结算单/导出；列表含 金蝶单据号/金蝶单据状态/金蝶锁状态/已指定应付/附件同步 列；图中 FJS2026110200002 已同步且指定失败、FJS2026110200001 已同步且已指定应付](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/16-付款结算单列表-发票登记与已指定应付列.png)
+
+![收款结算单列表（应收）：与付款结算单同构，工具栏含 同步金蝶；金蝶单据状态需为「已同步」才能开票](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/40-收款结算单列表-应收.png)
+
+前提：结算单已审批通过；非人民币结算单已维护汇率（见 3.13）；客商已 synced/exist。

 1. **自动路径**：审批「通过」时自动推送（开关开启时）。
-2. **手动路径**：勾选一条单据 → 工具栏「同步金蝶」。
-   - 按钮是单选操作，一次推一张。
-3. 成功标志：列表出现**金蝶单号**，状态变 **synced**，并出现「金蝶锁定中」标签。
-4. 失败处理：状态变 failed → 看失败原因 → 常见原因：
-   - 「请先同步金蝶应付单」类 → 关联结算单还没推（付款/开票依赖结算单先推，见 3.6 后款步骤）；
+2. **手动路径**：勾选一条或多条单据 → 工具栏「同步金蝶」。
+   - 应付单（A102-2）/ 应收单（A302-2）按结算类型自动分流，无需选择。
+3. 成功标志：列表出现**金蝶单据号**，状态变 **已同步**，并出现「金蝶锁定中」标签。
+4. 失败处理：状态变 **同步失败** → 鼠标悬浮状态标签看失败原因 → 常见原因：
+   - 「请先同步金蝶应付单」类 → 关联结算单还没推（付款/开票依赖结算单先推，见 3.8/3.9）；
   - 客商编码取不到 → 先完成 3.1；
   - 部门金蝶组织编码缺失 → 找管理员维护。
 5. 纠偏：如果怀疑推送实际成功但本地状态没更新，等定时勾稽（或联系运维手动触发），系统会自动核对金蝶侧并纠正状态/补单号。
@@ -139,27 +284,27 @@

 ![金蝶财务应收单与 TMS 结算单对照：应收金额、费用合计对应，明细行物料/车号/运输货物逐行对应](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/bfi-effect-a302-应收单对照.png)

-### 3.4 付款申请推送与结果回写
+### 3.8 付款申请推送与结果回写

 **页面：收付款管理 → 付款管理**

-![付款管理：工具栏「批量同步」推送付款申请；列表自带「金蝶单据号 / 金蝶单据状态 / 金蝶锁状态 / 附件同步」列——图中首行即「已生成 + 金蝶锁定中 + 附件已上传」的已推送单据](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/04-付款管理-批量同步.png)
+![付款管理：工具栏 新增付款申请/批量同步/申请付尾款/预付申请/导出；付款类型列按 进度预付/项目预付/尾款付款 展示；金蝶单据号/金蝶单据状态/已指定应付/金蝶锁状态/附件同步 列在表格右侧（见下图）](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/04-付款管理-批量同步.png)

-前提：付款申请已审批通过，且**关联的结算单已推送金蝶（synced）**。
+前提：付款申请已审批通过，且**关联的结算单已推送金蝶（已同步）**（尾款从金蝶应付单下推，必须先推结算单）。

 1. 推送：
   - 自动路径：审批「通过」时自动下推。
   - 手动路径：勾选**审批通过**的单据 → 工具栏「批量同步」（一次可多张，单张失败不影响其他）。
-   - 预付款（项目垫资/进度垫资）走同样的按钮，系统自动走预付款通道。
-2. 成功标志：状态 **synced** + 金蝶单号 + 锁定标签。
+   - 预付款（进度预付/项目预付）走同样的按钮，系统自动走预付款通道。
+2. 成功标志：状态 **已生成** + 金蝶单号 + 锁定标签。
 3. 查付款结果：
   - 正常等定时任务回写（默认每 10 分钟，开关开启时）；
   - 急用点工具栏「**同步付款结果**」（勾选单据后显示；若未见到该按钮，说明当前环境以定时回写为主，等下一轮即可）。
-4. 结果状态流转：synced → **paying**（金蝶付款中）→ **paid**（已付款，含付款记录/凭证信息）/ **closed**（关闭）。
+4. 结果状态流转：已生成 → **付款中** → **已付款**（含付款记录/凭证信息）/ **已关闭**（关闭）。
 5. 失败与特殊场景：
-   - failed → 修复后重推（批量同步按钮即可，系统会自动跳过金蝶已有的）；
-   - 单据在金蝶被删：回调后自动置 failed 并清单号，直接重推；
-   - 金蝶删了但回调丢了：约 20 分钟后系统自动检测到「查不到」并解锁置 failed，再重推。
+   - **生成失败** → 鼠标悬浮状态标签看失败原因，修复后重推（批量同步按钮即可，系统会自动跳过金蝶已有的）；系统每 10 分钟也会自动重推。
+   - 单据在金蝶被删：回调后自动置生成失败并清单号，直接重推；
+   - 金蝶删了但回调丢了：约 20 分钟后系统自动检测到「查不到」并解锁置生成失败，再重推。

 推送成功后金蝶侧效果（供确认推送结果时对照）：

@@ -169,34 +314,56 @@

 > 注意：推送后单据被金蝶锁定，**不能改金额、不能作废**。发现金额错误必须先金蝶侧处理。

-### 3.5 开票申请推送与开票结果
+### 3.9 开票申请推送与开票结果

 **页面：收付款管理 → 开票管理**

 ![开票管理：工具栏「批量同步」逐张推送（按发票张次拆单）；搜索区可按「金蝶单据状态」筛选](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/05-开票管理-批量同步.png)

-前提：开票申请已审批通过，且**关联结算单的应收单已推送金蝶**。
+前提：有一张**收款结算单**（应收），**审批通过**、未作废、**剩余可开票金额 > 0**，且已完成 3.7 应收推送（开票前系统会先检查金蝶里有没有这张单的应收单）。
+> 已放开"必须未开票"的限制：**部分开票过的结算单只要还有剩余可开票金额，可以再次选择继续开**，累计额度自动控制（可开票金额=结算金额 − 已被其他未作废开票申请占用的金额）。

-1. 推送：审批「通过」自动推送，或勾选后工具栏「批量同步」（逐张处理）。
+1. 新增：进「开票管理」列表 → 点「新增」→ 「结算单」右侧「**选择**」→ 弹窗「**选择应收正式结算单**」→ 按结算单号/项目/合同搜索并勾选 →「确定」（**合并开票必须同一合同**）。
+
+![选择应收正式结算单弹窗：列示 结算金额/已申请开票金额/可开票金额，已申请开票金额是所有未作废开票申请的累计占用](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/39-选择应收正式结算单弹窗.png)
+
+   - 「项目」「开票单位」自动带出；受票方开票信息按客商档案自动带出。
+2. 填「发票类型」等；选**电子专票**时，纳税人识别号、开户行、开户账号、注册地址**必填**。
+3. 填「开票内容」（发票张次 + 商品行），系统自动算「**本次开票金额**」；注意"运费不能与其他费用合并开在同一张发票中"。
+
+![开票申请新增页：开票基本信息 + 开票内容（按发票张次分 sheet）+ 结算信息](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/38-开票申请表单.png)
+
+4. 「结算信息」表里的「**分摊发票金额**」由**系统按选择顺序自动分摊**（先选的先摊、摊满为止），该列**只读**；点表单底部「**同步**」可刷新分摊结果。
+5. 「保存」→「提交」→ 审批人「通过」→ 系统按发票张次逐张推金蝶（自动路径开关开启时；或勾选后工具栏「**批量同步**」逐张处理）。
   - 系统按**发票张次**拆分：一张申请 3 张发票会生成 3 张金蝶开票申请单。
-2. 成功标志：状态 **synced**，金蝶单号多张时逗号拼接显示；逐张锁定。
-3. 查开票结果：等定时回写（默认每 10 分钟），状态变 **invoiced**（终态）。
-4. 查看发票文件：正式结算单详情 →「开票发票」区 → 查看/下载（PDF 优先）。
+6. 成功标志：状态 **已同步**，金蝶单号多张时逗号拼接显示；逐张锁定。
+7. 查开票结果：等定时回写（默认每 10 分钟），状态变 **开票完成**（终态，全部发票张次都有回写结果才到这一步）。
+8. 查看发票文件：正式结算单详情 →「开票发票」区 → 查看/下载（PDF 优先）。
+
+**会被拦截的情况（提示原文）**：
+- "只能选择审批通过、未作废的应收正式结算单"
+- "合并开票的结算单必须属于同一合同"
+- "本次开票金额不能超过可开票金额" / "本次开票金额必须大于 0"
+- "电子专票的纳税人识别号/开户行/开户账号/注册地址…"（必填校验）
+- "运费不能与其他费用合并开在同一张发票中"
+- 推金蝶时提示"正式结算单[x]财务应收单未在金蝶生成，请先在正式付款单页面同步金蝶"（先做 3.7 应收推送）
+
+**限制**：开票申请一旦推到金蝶（已同步/开票完成）就**锁定不能改**；数电票已经开出来的只能走红冲，不能在本系统作废。**预付和核销不影响开票金额**，开票始终按结算单的**全额**来匹配。

 推送成功后金蝶侧效果（供确认推送结果时对照）：

 ![开票申请按发票张次拆分：TMS 开票内容第1张/第2张分别生成金蝶开票申请单，购销方、不含税金额逐项对应](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/bfi-effect-a303-1-开票张次对照.png)

-### 3.6 收票登记（进项发票·先票后款）
+### 3.10 收票登记（进项发票·先票后款）

 **页面：收付款管理 → 收票管理（先票）+ 结算管理 → 付款结算单（后款）**

-收票改成**两段式**：
+收票是**两段式**：

- **先票（收票登记）**：只做「收票」——从金蝶票池选发票推金蝶收票单，**不再关联结算单/合同**；
+- **先票（收票登记）**：只做「收票」——从金蝶票池选发票推金蝶收票单，**不关联结算单/合同**；
 - **后款（付款结算单）**：在付款结算单上认领收票单，应付单推送金蝶后系统自动完成「指定应付」。

-![收票管理：工具栏「批量同步」推送收票单（终态 pushed）；不再需要先关联结算单](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/06-收票管理-批量同步.png)
+![收票管理：工具栏「批量同步」推送收票单（终态已推送）；不再需要先关联结算单](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/06-收票管理-批量同步.png)

 **第一步：先票——收票登记**

@@ -211,25 +378,52 @@
 2. 选**结算组织**（合同承办部门）——推送金蝶时按它确定结算组织编码，必填。
 3. 保存：系统自动**重查金蝶票池校验可用性**——票已被别人登记/认领/红冲/作废会保存失败并提示原因。
 4. 提交审批 → 审批「通过」自动推送，或勾选 → 工具栏「批量同步」。
-5. 成功标志：状态 **pushed**（金蝶收票单已生成）。**到这里收票就完成了**——指定应付由付款结算单负责（见第二步）。
+5. 成功标志：状态 **已推送（pushed）**（金蝶收票单已生成）。**到这里收票就完成了**——指定应付由付款结算单负责（见第二步）。
   - failed 且提示发票状态异常（红冲/作废）→ 该票在金蝶已不可用，需人工处理，不要重推。
   - failed 且提示「供应商代码/往来户」→ 发票销方未建档或未同步金蝶，先完成 3.1 客商建档再重推。
   - failed 且提示免税/零税率行 → 该票存在系统无法映射的税率行，人工核实后联系金蝶方约定编码。
 6. 附件：表单附件区可查看/下载发票原件（系统自动从金蝶取，PDF 优先）。

-![收票登记表单（先票后款改造后）：发票号码选金蝶票据池发票带出票面与「发票明细」；新增「结算组织（合同承办部门）」必选；「结算信息」区只读——认领关系由付款结算单侧维护](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/13-收票登记-先票后款表单.png)
+![收票登记表单（先票后款改造后）：发票号码选金蝶票据池发票带出票面与「发票明细」；「结算组织（合同承办部门）」必选；「结算信息」区只读——认领关系由付款结算单侧维护](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/13-收票登记-先票后款表单.png)

 **第二步：后款——付款结算单认领收票单并指定应付**

-前提：收票登记已审批通过且已推送（pushed）；付款结算单（正式结算单应付 Tab）为审批通过状态。
+前提：收票登记已审批通过且已推送（pushed）；付款结算单为审批通过状态。认领有三条入口，效果一致：

-1. **编辑/新增时认领**：结算单编辑页发票信息区点「选择收票单」→ 候选为**审批通过且未被认领**的收票登记 → 选择后按**发票金额全额认领**（不再校验发票合计是否超过结算金额）→ 保存。
-2. **审批后补认领（发票登记）**：列表行内「发票登记」→ 选收票单 → 保存认领 → 弹窗「是否将发票匹配数据推送金蝶?」→ 确认后系统调金蝶「指定应付」。
-   ![付款结算单「发票登记」弹窗：结算基本信息（已匹配发票金额/金蝶同步状态）+ 认领收票单（选择收票单 → 发票号/开票单位（销方）/发票金额/匹配结算单金额）→ 保存认领](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/14-付款结算单-发票登记.png)
-3. **系统自动指定应付**：结算单推送金蝶（应付单生成）后，系统对**本单认领且已推送**的收票单逐张执行「指定应付」，收票状态推进为 **assigned**（已指定应付，终态）。指定失败不影响结算单推送，定时任务会自动补发。
-   - 一张收票单只能被一张付款结算单认领（重复认领会拦截）。
-   - 收票单一直卡在 pushed：说明还没被任何付款结算单认领（或认领它的结算单应付单还没推送成功），认领并推送后自动接上。
-   - 结算单作废/移除认领**不会**自动通知金蝶解除指定，需金蝶侧人工处理后重推。
+**入口 A：编辑/新增时认领（编辑器）**
+1. 付款结算单编辑页发票信息区点「**选择收票单**」→ 候选弹窗（**分页**，按发票号/销方/购方搜索）只列出**审批通过且未被其他付款结算单认领**的收票单；行内「推送状态」悬浮可看该票上次推送失败的原因。
+
+![选择收票单弹窗（新增/编辑付款结算单入口）：分页列示候选收票单（发票号码/开票日期/发票类型/开票单位（销方）/受票单位（购方）/发票金额（含税）/推送状态），底部提示"仅列出审批通过且未被其他付款结算单认领的收票单"，勾选后「确定」带回](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/18-选择收票单弹窗-分页候选.png)
+
+2. 勾选后确认 → 发票信息区出现该票行，「**匹配结算单金额**」**默认=发票金额全额，可手动改小/改回**（0 ≤ 金额 ≤ 发票金额）。
+3. 保存：系统按发票号同步认领关系——一张收票单只能被一张付款结算单认领（重复认领会拦截）；**不再校验「匹配合计 ≤ 结算金额」**，匹配合计可以超过结算金额（覆盖即视为完成收票）。
+
+**入口 B：审批后补认领（工具栏「发票登记」）**
+1. 付款结算单列表勾选一条**审批通过**的付款结算单 → 工具栏「**发票登记**」。
+2. 弹窗上半部是**结算基本信息**（结算单号/结算总金额/已匹配发票金额/金蝶同步状态等）；下半部「认领收票单」表**自动回显本单已认领的收票单**（带「已认领」标记、匹配金额只读、不可移除）。
+3. 点「**选择收票单**」追加新票（同入口 A 的候选弹窗）→ 新增行「匹配结算单金额」默认=发票金额，可修改 → 点「**保存认领**」。
+4. 弹窗「**是否将发票匹配数据推送金蝶?**」→ 确认后系统调金蝶「指定应付」；成功提示「**结算单[FJSxxx]发票登记推送金蝶成功：认领收票单已指定应付**」（提示带结算单号）。
+
+![付款结算单「发票登记」弹窗（工具栏入口）：结算基本信息 + 认领收票单表回显本单已认领的收票单（「已认领」标记、匹配金额只读），点「选择收票单」追加新票，「匹配结算单金额」新增行可手动修改（默认=发票金额），底部「保存认领」](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/17-付款结算单-发票登记弹窗.png)
+
+**入口 C：查看页「重新推送」（指定失败/pushed 票的一步式重推）**
+1. 打开付款结算单**查看页**，发票信息区对 **failed（指定失败）/ pushed（已推送）** 的票显示「**重新推送**」链接（前提：本单审批通过且已同步金蝶）。
+2. 指定失败行的「匹配结算单金额」在查看页也可编辑（改完随重推生效）。
+3. 点「重新推送」→ 确认「确认重新推送发票xxx到金蝶并指定应付?」→ 系统一步式：重推金蝶收票单（A303-2，幂等防重）+ 指定应付（A302-6）→ 完成后自动刷新状态。
+
+![付款结算单查看页「发票信息」区：列为 发票号/开票日期/发票类型/发票金额/可匹配发票金额/匹配结算单金额（指定失败行可编辑）/「是否已指定应付」（未指定·指定失败·已指定应付）＋操作列 查看/下载/重新推送；下方付款信息区回显付款申请金蝶单号](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/19-查看页发票信息-指定应付状态与重新推送.png)
+
+**系统自动指定应付**：付款结算单推送金蝶（应付单生成，见 3.7）后，系统对**本单认领且已推送**的收票单逐张执行「指定应付」，收票状态推进为 **assigned**（已指定应付，终态）。指定失败不影响结算单推送——失败票用入口 B/C 人工重推兜底。
+
+![付款结算单列表「指定失败」悬浮：聚合展示本单各票的失败原因（如"发票xxx：推送金蝶收票单失败：…"），无需翻日志](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/16b-付款结算单列表-指定失败原因悬浮.png)
+
+![付款管理列表「已指定应付」列：按付款申请关联的结算单聚合展示 已指定应付（绿）/指定失败（红）/未指定，失败原因悬浮可见](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/20-付款管理-指定失败原因悬浮.png)
+
+**口径与注意**：
+- 一张收票单只能被一张付款结算单认领；匹配金额合计可超结算金额（覆盖即完成收票）。
+- 收票单一直卡在 pushed：说明还没被任何付款结算单认领（或认领它的结算单应付单还没推送成功），认领并推送后自动接上；已认领但指定失败的，用入口 B/C 重推。
+- ⚠️ **定时自动补发指定默认关闭**（2026-11-02 起）：收票结果回写任务不再自动对「pushed+已认领」的票补发指定应付（开关 `thirdParty.bfi.receivedInvoiceResult.assignCompensationEnabled`，默认 false），**由人工入口兜底**（发票登记推送 / 查看页重新推送）；需要恢复自动补发时由运维开启该开关（见 4.1）。
+- 结算单作废/移除认领**不会**自动通知金蝶解除指定，需金蝶侧人工处理后重推。

 推送成功后金蝶侧状态与效果（供确认推送结果时对照）：

@@ -239,7 +433,76 @@

 ![结算单详情「发票信息」区：认领的发票可 查看/下载（系统从金蝶取原件，PDF 优先）；付款信息区回显付款申请金蝶单号](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/bfi-effect-a801-2-发票查看下载.png)

-### 3.7 收款流水与认领
+### 3.11 结算调整单（结算单金额调整）
+
+**页面：结算管理 → 结算调整单**
+
+正式结算单（付款/收款结算单）**审批通过后不允许直接改金额**，一切费用调整都必须通过「结算调整单」完成：
+
+- **作用**：对一张已审批通过的正式结算单，调整其费用项目和金额（调增、调减可为负数、新增手工费用）。
+- **单号规则**：`TZ + 日期 + 4 位流水`，保存草稿时自动生成。
+- **只能手工新增**；**没有作废功能**：一旦提交走审批，错了只能"驳回 → 修改"或重新建单。
+- **支持附件材料**：新建/编辑时可上传附件（单个 ≤500M，最多 20 个）。
+- 按钮只有一枚、按金蝶状态自动分流：**未同步/同步失败 → 「推送金蝶」（直接执行）；已同步 → 「重新推送（高危）」（红色，有二次确认）**。
+
+![结算调整单列表：草稿行显示「查看 / 编辑 / 删除 / 提交」，已驳回行为「查看 / 编辑 / 提交」，审批中行为「查看 / 通过 / 驳回」，审批通过行只剩推送类操作；金蝶状态为「已同步」时按钮变为红色的「重新推送（高危）」，未同步/同步失败时为「推送金蝶」](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/21-结算调整单列表-各状态操作入口.png)
+
+**第一步：新增调整单**
+
+前置：必须先选定一张**可调整的正式结算单**——① 审批通过；② 未完成收款/付款；③ 未发起尾款结算/尾款付款；④ 无生效中的结算类付款申请关联。不满足的单在选单列表里搜不到。
+
+1. 「新增」→ 选定结算单后自动回带客商、结算类型、合同、项目、原结算金额，并带出原单费用明细；在"调整金额（含税）"列填数（**可为负数**），或点「添加费用」新增手工费用行。
+2. 选单后系统做一次**金蝶冲销预检（软提示，不拦人）**：① 原单未推送金蝶 → 提示"审批通过后将自动推送原单"；② 已推送且旧单已冲销 → 提示"审批后可直接重新推送新单"；③ 已推送且旧单未冲销 → 黄色警告"审批通过后需先由财务在金蝶完成冲销，才能重新推送"；④ 金蝶查不到/超时 → 提示"未校验"。
+
+![新增调整单：选定关联正式结算单后自动回带客商、结算单类型、合同、项目、原结算金额，带出原单费用明细并录入调整金额；顶部同时弹出金蝶冲销预检提示](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/22-结算调整单新增-选单回带与费用录入.png)
+
+![选单后的金蝶冲销预检：该结算单已推送金蝶且旧单未冲销时，顶部弹出黄色警告"该结算单已推送金蝶且旧单尚未冲销，审批通过后需先由财务在金蝶完成冲销，才能重新推送"，但建单不受影响](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/23-结算调整单新增-金蝶冲销预检提示.png)
+
+3. 编辑弹窗底部「取消 / 同步 / 保存」：**同步**=重新拉取关联结算单最新费用明细（已录入的调整金额保留）；**保存**=存草稿。
+4. 提交：草稿/已驳回 → 审批中（提交前校验至少一条调整费用、费项必填等）。
+
+**第二步：审批（★核心分流点）**
+
+审批人点「通过」先弹确认"**审批通过后将更新关联正式结算单，确认继续？**"。确认后系统按**原结算单是否推送过金蝶**自动走两条路：
+
+| 场景 | 系统行为 | 结果 |
+|---|---|---|
+| **A：原单未推送金蝶**（最常见，全自动） | ① 调整直接回写原结算单（费用、明细、合计、结算金额全部更新）；② 原单追加变更记录；③ 调整单审批通过；④ 重算收付汇总（含核销）；⑤ **自动推送金蝶**（应付/应收单 + 落锁 + 附件） | 原单即调整后金额，调整单回填"已同步 + 金蝶单据号"；推送失败则置"同步失败"，审批结果不受影响，等定时重推或点「推送金蝶」 |
+| **B：原单已推送金蝶**（原单冻结） | ① **原单业务数据零改动**，只追加 1 条变更记录；② 调整单审批通过（金蝶状态保持"已同步"）；③ 前端提示：**"原结算单已推送金蝶，请财务人员在金蝶手工完成旧应付/应收单冲销处理后再重新推送"** | 财务在**金蝶侧手工冲销旧单**后，业务回到 TMS 点「重新推送（高危）」 |
+
+![审批通过二次确认：明确提示"审批通过后将更新关联正式结算单"，确认后系统按原单金蝶状态自动分流](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/25-结算调整单审批通过二次确认.png)
+
+> 为什么已推送场景不自动推：金蝶侧已有一张旧单，直接再推会重复生成应付/应收单；必须先冲销旧单，且冲销只能由财务在金蝶完成，TMS 无法代办。
+
+**第三步（场景 B）：重新推送（高危）**
+
+财务在金蝶冲销旧单后，业务点「**重新推送（高危）**」并二次确认，系统依次：
+1. **硬闸门**：按原结算单号查金蝶旧单，**必须已冲销**（部分冲销也算已冲销），未冲销/被删除直接拒绝；
+2. **克隆一张新的正式结算单**（全新单号）应用调整，直接置为审批通过（新单不再走审批流）；
+3. **项目预付核销行随迁新单**并从原单删除（避免预付额度被新旧两单双占）；
+4. 用新单号推送金蝶 → 全新应付/应收单 + 落锁 + 附件；
+5. 调整单改挂新单并回填金蝶单据号；原单标记「**已调整**」并解锁旧锁。
+6. 失败处理：已克隆的新单不回滚、置"同步失败"；再点「重新推送」会**复用已克隆的新单**从推送步骤续推，不会重复建单（幂等）。
+
+![重新推送（高危）：确认金蝶旧应付/应收单已由财务手工冲销后才继续，系统将克隆新单并生成全新应付/应收单](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/24-结算调整单重新推送-高危二次确认.png)
+
+完成后列表里**新旧两张正式结算单并存**，带标识区分：
+
+![正式结算单列表（新单）：重推克隆出的单据调整标识显示「调整后单」，来源原单号列显示原单号](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/27-正式结算单列表-调整后单标识.png)
+
+![正式结算单列表（原单）：被重推过的原单调整标识显示「已调整」，金蝶单据号保留，此单仅作存档不可再用于付款](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/28-正式结算单列表-原单已调整标识.png)
+
+**失败原因与边界**：
+- 调整单「同步失败」：**鼠标悬浮状态标签**直接看失败原因；用「推送金蝶」重试或等定时重推。
+
+![金蝶同步失败原因悬浮：状态列「同步失败」标签上悬浮即可看到后端落库的失败原因，无需翻日志](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/26-结算调整单金蝶生成失败原因悬浮.png)
+
+- 调整后结算金额**不得低于该项目预付核销合计**，否则审批（场景 A）或重推克隆（场景 B）直接拒绝，提示"请先调减项目预付核销"。
+- **「已调整」原单只能看不能用**：直接付款和付款申请选单都会被拦截，付款请一律使用调整后的新单。
+- 原单的下游关联（开票申请、收款认领、对账）**不迁移**，留在原单；新单发票状态、收付款状态从零开始（应收新单显示"未开票/未收款"属正常）。
+- 已审批通过的调整单**无法驳回、无法作废、无法撤回**；金额再错就新建调整单二次调整。
+
+### 3.12 收款流水与认领

 **页面：收付款管理 → 收款流水、认领记录**

@@ -257,9 +520,9 @@
   ![认领记录：仅显示本人认领记录；行内「作废」回退金额并同步作废合同合规系统认领记录；原「查询金蝶认领结果」按钮已删除](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/09-认领记录-列表.png)
   - 作废不会影响金蝶收款单本身（金蝶侧红冲由财务人工处置）。

-### 3.8 汇率维护（非人民币结算）
+### 3.13 汇率维护（非人民币结算）

-结算单（预结算/正式结算）编辑时：选择非 RMB 币种 → 选择**汇率日期** → 系统自动从金蝶带出汇率并重算本位币金额。带不出（金蝶该日无汇率）→ 换日期或联系金蝶侧确认。
+结算单（预付结算单/付款结算单/收款结算单）编辑时：选择非 RMB 币种 → 选择**汇率日期** → 系统自动从金蝶带出汇率并重算本位币金额。带不出（金蝶该日无汇率）→ 换日期或联系金蝶侧确认。**预付结算单的汇率不自动继承到付款结算单**，转正式后需重新维护。

 ![结算单详情：汇率日期/结算汇率字段由金蝶汇率接口自动带出，本位币金额随之重算](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/10-结算单-汇率自动带出.png)

@@ -267,6 +530,23 @@

 ![金蝶侧效果：汇率 6.7367、金额(本位币)自动换算，与 TMS 结算单的本位币合计一致](./2026-10-14-金蝶（星瀚）BFI对接操作手册（纯操作版）.assets/bfi-effect-a801-4-外币汇率推送.png)

+### 3.14 作废与撤销：能做什么、状态怎么变
+
+| 我想…… | 前提 | 操作位置 | 状态变化 |
+|---|---|---|---|
+| 作废付款申请 | 状态=审批通过，且**未被金蝶锁定** | 付款管理列表行内「作废」（需填作废原因） | 单据→已作废；**未付的预付记录联动作废，相关项目预付核销行被删除**，受影响结算单的已付金额回落（已付出去的钱不会回退） |
+| 作废付款/收款结算单 | **审批通过且未同步金蝶**（已同步金蝶的不能直接作废） | 结算单列表行内「作废」（需填作废原因） | 单据→已作废；本单的项目预付核销行被删除，可核销额度释放；未审批通过的单据不走作废，走驳回后删除 |
+| 作废预付结算单 | 审批通过、未转付款结算，且**无关联预付申请**（有则提示"请先作废预付申请"） | 预付结算单列表行内「作废」（需填作废原因） | 单据→已作废；预付结算上的核销行被删除 |
+| 作废开票申请 | 状态=审批通过，且**未被金蝶锁定**（即还没推金蝶/还没开票） | 开票管理列表行内「作废」 | 单据→已作废；来源结算单的开票状态自动回落 |
+| 删除 | 状态=草稿 | 各列表行内「删除」 | 草稿被删除 |
+| 金蝶侧删付款申请 | — | 金蝶操作后系统自动处理 | 付款申请金蝶状态→生成失败，金蝶单号被清空；**未付的预付记录联动作废**；人工核实后重推，重推成功会重新建档；**已核销的行不会自动删**，需要人工作废该预付款才回落 |
+| 金蝶侧删结算单 | — | 金蝶操作后系统自动处理 | 结算单被**系统自动作废**，同步状态还原，核销行删除 |
+| 金蝶侧删开票申请 | — | 金蝶操作后系统自动处理 | 开票申请被**系统自动作废**，来源结算单开票状态回落 |
+| 结算调整 | 结算单已审批通过（含已同步金蝶） | 结算调整单（3.11） | 金额调整走调整单：原单标记"已调整"并禁止再付款，调整后的新单自动迁移核销行与金蝶推送 |
+| 作废收票认领 | — | 结算单移除认领后金蝶侧人工解除 | 移除认领/结算单作废**不会**自动通知金蝶解除指定，需金蝶侧人工处理（3.10） |
+
+> 一句话记住：**预付一旦真付出去（已付款），作废不会把钱退回**，只会把台账和核销额度清掉。
+
 ---

 ## 4. 定时任务与开关（运维视角）
@@ -275,8 +555,9 @@

 | 任务 | 干什么 | 开关键 | cron 键（默认值） | 手动替代按钮 |
 |---|---|---|---|---|
-| 付款结果回写 | 付款状态（paid/closed）+ 付款记录/凭证回写；顺带应收勾稽纠偏、开票结果回写 | `thirdParty.bfi.payResult.syncEnabled`（样例已开） | `…payResult.cron`（默认 `0 1/10 * * * ?`） | 付款「同步付款结果」、开票结果手动端点、结算勾稽手动端点 |
-| 收票结果回写 | 收票单状态回写、pushed+已认领自动补发指定应付 | `…receivedInvoiceResult.syncEnabled` | `…receivedInvoiceResult.cron`（默认 `0 8/10 * * * ?`） | 收票「同步金蝶结果」 |
+| 付款结果回写 | 付款状态（已付款/已关闭）+ 付款记录/凭证回写；顺带应收勾稽纠偏、开票结果回写 | `thirdParty.bfi.payResult.syncEnabled`（样例已开） | `…payResult.cron`（默认 `0 1/10 * * * ?`） | 付款「同步付款结果」、开票结果手动端点、结算勾稽手动端点 |
+| 收票结果回写 | 收票单状态回写、发票状态异常回收、assigned 单号补登；**pushed+已认领自动补发指定应付受下述开关控制** | `…receivedInvoiceResult.syncEnabled` | `…receivedInvoiceResult.cron`（默认 `0 8/10 * * * ?`） | 收票「同步金蝶结果」、付款结算单「发票登记」/查看页「重新推送」 |
+| —— A302-6 指定应付自动补偿 | pushed 且已认领的收票单由回写任务自动重发指定应付（★2026-11-02 起独立开关，**默认关闭**改人工兜底：发票登记推送/查看页重新推送） | `…receivedInvoiceResult.assignCompensationEnabled`（默认 false） | 随收票结果回写任务调度 | 付款结算单「发票登记」/查看页「重新推送」/手动端点 `POST /formal-settlement/invoice-assign-kingdee` |
 | 客商同步 | 金蝶审核状态复查（synced→exist）、停用联动、failed 重推 | `…customer.syncEnabled` | `…customer.cron`（默认 `0 0 2 * * ?`） | 客商「同步金蝶」 |
 | 全票池同步 | 拉金蝶全票池发票到本地镜像（含发票明细）、补绑定 | `…invoiceReceipt.syncEnabled` | `…invoiceReceipt.cron`（默认 `0 16/30 * * * ?`） | 手动端点 `POST /invoice-receipt/sync-invoice-pool` |
 | failed 重推 | 自动重推所有推送失败的结算/付款/开票/收票单 | `…autoSync.retryEnabled` | `…autoSync.retryCron`（默认 `0 5/10 * * * ?`） | 各页面「同步金蝶」 |
@@ -288,39 +569,39 @@

 **共性规则（先读这个）**

- **终态不轮询**：付款 paid（已付款）/closed（已关闭）、开票 invoiced（已开票）、客商 exist（金蝶已审核）后自动退出扫描范围；收票 assigned（已指定应付，终态）仅剩补登单号——任务只处理「还没走完」的单据，越跑越轻，不会重复处理。
+- **终态不轮询**：付款 已付款/已关闭、开票 开票完成、客商 exist（金蝶已审核）后自动退出扫描范围；收票 已指定应付（终态）仅剩补登单号——任务只处理「还没走完」的单据，越跑越轻，不会重复处理。
 - **定时与手动同一套逻辑**：每个任务与它的「手动替代按钮」调用同一个服务方法，效果完全一致；区别只是触发方式。
- **单条失败不拖批次**：一轮里某条单据失败只记录原因，同批其余照常处理；失败的下轮自动再试（兜底见 ⑤ failed 重推）。
+- **单条失败不拖批次**：一轮里某条单据失败只记录原因，同批其余照常处理；失败的下轮自动再试（兜底见 failed 重推）。
 - **默认执行时间错峰**（付款 ：01、failed 重推 ：05、收票 ：08、锁补偿每 5 分钟的 ：02、票池每 30 分钟的 ：16），互不挤占；自行改 cron 时建议保留错峰。

 **① 付款结果回写（10 分钟）**
-扫「审批通过且已推送 / 付款中 / 推送失败」的付款申请 → 到金蝶查付款申请单和付款处理单 → 推进 synced（已推送受理）→ paying（金蝶付款中）→ **paid（已付款）/ closed（已关闭）**，paid 时回写付款记录/凭证，并联动刷新预结算垫资、结算付款记录（3.4 第 3 步的「正常等定时回写」就是它）。
- 自愈一（应收勾稽）：已推送但失败、或缺金蝶单号的**应收结算单**，查金蝶有则自动补单号、纠回 synced——「实际推成功但本地显示失败」的场景自动痊愈；
- 自愈二（开票结果）：已受理的开票申请自动落发票信息并推进 **invoiced（已开票，终态）**（3.5 第 3 步的定时回写就是它）；
- 防呆（金蝶删单）：synced（已推送受理）/paying（金蝶付款中）的单据**连续 2 轮（约 20 分钟）在金蝶查不到** → 判定金蝶侧已删，自动解锁置 failed（推送失败）并清空金蝶单号，等人工核实后重推；重推带幂等预检，金蝶单据其实还在时会自动回填，不会重复生成。
+扫「审批通过且已推送 / 付款中 / 推送失败」的付款申请 → 到金蝶查付款申请单和付款处理单 → 推进 已生成 → 付款中 → **已付款 / 已关闭**，已付款时回写付款记录/凭证，并联动刷新预付结算垫资、结算付款记录（3.8 第 3 步的「正常等定时回写」就是它）。
+- 自愈一（应收勾稽）：已推送但失败、或缺金蝶单号的**应收结算单**，查金蝶有则自动补单号、纠回已同步——「实际推成功但本地显示失败」的场景自动痊愈；
+- 自愈二（开票结果）：已受理的开票申请自动落发票信息并推进 **开票完成（终态）**（3.9 第 7 步的定时回写就是它）；
+- 防呆（金蝶删单）：已生成/付款中的单据**连续 2 轮（约 20 分钟）在金蝶查不到** → 判定金蝶侧已删，自动解锁置生成失败并清空金蝶单号，等人工核实后重推；重推带幂等预检，金蝶单据其实还在时会自动回填，不会重复生成。

 **② 收票结果回写（10 分钟）**
-扫 pushed（金蝶收票单已生成）/ assigned（已指定应付）的收票登记，按近 **30 天**回看窗口查金蝶收票单，一轮处理三种情况：
- 票在金蝶被作废/红冲 → 置 failed（推送失败）并提示人工处理（**不要重推**，见 3.6）；
- pushed 且**已被付款结算单认领** → 自动补发「指定应付」推进 **assigned（已指定应付，终态）**；pushed 且未被认领 → 跳过不动（认领后自动接上，见 3.6 第二步）；
+扫 已推送（pushed）/ 已指定应付（assigned）的收票登记，按近 **30 天**回看窗口查金蝶收票单，一轮处理三种情况：
+- 票在金蝶被作废/红冲 → 置 failed（推送失败）并提示人工处理（**不要重推**，见 3.10）；
+- pushed 且**已被付款结算单认领** → 自动补发「指定应付」推进 已指定应付（终态）——**受开关 `…receivedInvoiceResult.assignCompensationEnabled` 控制，默认关闭**：关闭时跳过补发并记日志，由人工入口（发票登记推送/查看页重新推送）指定；pushed 且未被认领 → 跳过不动（认领后由结算单侧接上，见 3.10）；
 - assigned 但缺金蝶收票单号 → 自动补登单号。
 窗口内查不到的保持现状不动（不判删除），由人工重推兜底。

 **③ 客商同步（每天 02:00）**
 一次扫全部审批通过客商，干三件事：
- **未推送/推送失败** → 先复查金蝶：已有且已审核的直接置 **exist（金蝶已有该客商且审核通过，终态）**（不重复建档）；金蝶侧审核中则置 failed（推送失败）提示稍后；确实没有才推送；
- **已推送（synced，已推送受理）** → 金蝶审核通过自动升级 **exist（金蝶已审核，终态）**（3.1 第 5 步的定时升级就是它）；
+- **未推送/推送失败** → 先复查金蝶：已有且已审核的直接置 **exist（终态）**（不重复建档）；金蝶侧审核中则置 failed 提示稍后；确实没有才推送；
+- **已推送（synced）** → 金蝶审核通过自动升级 **exist（终态）**（3.1 第 5 步的定时升级就是它）；
 - **金蝶侧停用（enable=0）** → TMS 档案联动停用；金蝶恢复可用**不会**自动启用（单向联动，需人工启用）。

 **④ 全票池同步（30 分钟）**
-按近 **30 天**增量窗口分页拉取金蝶全票池发票到本地镜像表（含发票明细行），收票选票、发票明细带出、票池查询全部走本地镜像——所以**刚在金蝶开的票要等同步后才能选到**；急用可让运维手动触发同步端点，或用票号精确搜索（会自动去金蝶现查，见 3.6）。
+按近 **30 天**增量窗口分页拉取金蝶全票池发票到本地镜像表（含发票明细行），收票选票、发票明细带出、票池查询全部走本地镜像——所以**刚在金蝶开的票要等同步后才能选到**；急用可让运维手动触发同步端点，或用票号精确搜索（会自动去金蝶现查，见 3.10）。

 **⑤ failed 重推（10 分钟）**
 只重推 **failed（推送失败）** 单据（结算 → 付款 → 开票 → 收票四个域依次处理）；**unsynced（审批通过但从未推送）不会自动推**——历史存量单不会被上线后批量补推，仍走手动按钮。前置没就绪（如销方供应商代码缺失、镜像明细缺失）会再次 failed、下轮继续；前置就绪后自动续推成功。
 ⚠️ 重推**没有次数上限**：根因不修（联行号缺失、组织编码缺失等）会每 10 分钟失败一次刷日志，修复根因是唯一正解（呼应 4.4）。

 **⑥ 锁单补偿（5 分钟）**
-扫「推送成功但金蝶锁定失败」的锁记录，重试加锁，**最多 5 次**；超过 5 次放弃，需运维调手动补偿端点 `POST /formal-settlement/retry-kingdee-bill-lock`（对应 FAQ 的「锁定失败」标签）。
+扫「推送成功但金蝶锁定失败」的锁记录，重试加锁，**最多 5 次**；超过 5 次放弃，需运维调手动补偿端点 `POST /formal-settlement/retry-kingdee-bill-lock`（对应 1.2 的「锁定失败·已达上限」标签）。

 ### 4.3 审批自动同步开关（按业务域独立）

@@ -331,6 +612,7 @@
 - 所有定时任务带**分布式锁**：多实例部署只跑一份；手动按钮和定时共用锁，定时运行中手动触发会直接跳过（属正常）。
 - 开了「failed 重推」后，持续失败的单据每 10 分钟会重试一次，**修复根因**（配置/数据）比反复观察更重要。
 - 手动触发全票池同步与定时是同一逻辑，数据量大时耐心等待，不要反复点。
+- **A302-6 指定应付补偿开关**默认关闭（安全兜底）：pushed+已认领的收票单不会自动变"已指定应付"，业务用「发票登记」/查看页「重新推送」人工指定；确需自动补偿时在 Nacos 开 `thirdParty.bfi.receivedInvoiceResult.assignCompensationEnabled=true`。

 ---

@@ -338,7 +620,7 @@

 | 现象 | 原因 | 处理 |
 |---|---|---|
-| 推送结算单不带汇率 | 正式结算单没维护汇率（预结算单的汇率**不自动继承**到正式结算单） | 在正式结算单编辑页重选汇率日期自动带出后再推 |
+| 推送结算单不带汇率 | 结算单没维护汇率（预付结算单的汇率**不自动继承**到付款结算单） | 在结算单编辑页重选汇率日期自动带出后再推 |
 | 推送报「客商编码」类错误 | 客商未推送金蝶或档案缺数据 | 先完成客商同步（3.1），再推单据 |
 | 推送报「请先同步金蝶应付单/应收单」 | 前置单据未推送 | 顺序：结算单(应付/应收) → 付款/开票（收票登记已不依赖结算单，仅付款结算单指定应付需要应付单先推送） |
 | 推送报组织/部门编码类错误 | 部门没维护金蝶组织编码 | 管理员补维护后重推 |
@@ -348,14 +630,28 @@
 | 列表「锁定失败」标签 | 推送成功但金蝶锁单接口失败 | 系统自动补偿（≤5 次）；急用让运维调手动补偿端点 |
 | 单据要改但显示「金蝶锁定中」 | 已推送并被金蝶锁定 | 到金蝶侧解锁/删单 → TMS 自动还原后即可编辑；不可强行作废 |
 | 付款状态长时间不更新 | 回写定时未开启或金蝶侧未处理 | 点「同步付款结果」；仍无 → 金蝶侧查付款处理单 |
-| 开票申请 synced 但没发票信息 | 开票结果未回写 | 等定时/联系运维手动触发；确认金蝶票易通已开票 |
+| 付款申请审批通过了，但金蝶那边没有单 | 推送失败（生成失败）或走了付款特批 | 看「金蝶单据状态」：生成失败勾选后点「批量同步」或等 10 分钟自动重推；提示"已发起付款特批"要等特批完成 |
+| 开票申请已同步但没发票信息 | 开票结果未回写 | 等定时/联系运维手动触发；确认金蝶票易通已开票 |
 | 票池选票查不到 | 镜像未同步到该票种 | 检查票种白名单配置；运维手动触发全票池同步；票号精确搜索可触发自动现查 |
 | 保存收票登记被拦「可用金额为0」 | 票已被占用/认领/红冲 | 换票或在金蝶确认票据状态 |
 | 收票推送报「供应商代码/往来户」类错误 | 发票销方未建档或未同步金蝶（取不到金蝶供应商代码） | 先完成客商建档与同步（3.1），再重推 |
 | 收票推送报免税/零税率行 | 系统无法映射该税率行编码 | 人工核实票面，联系金蝶方约定编码后放开 |
 | 收票推送报结算组织/平台公司类错误 | 手选部门上溯不到带金蝶编码的平台公司 | 找管理员维护组织金蝶编码后重推 |
-| 收票卡在 pushed 不动 | 未被付款结算单认领，或认领它的结算单应付单未推送成功 | 在付款结算单「发票登记」/编辑认领收票单并确保结算单已 synced；已认领的由定时自动补发指定 |
+| 收票卡在已推送（pushed）不动 | 未被付款结算单认领，或认领它的结算单应付单未推送成功；或已认领但指定失败且自动补偿开关关闭 | 在付款结算单「发票登记」/查看页「重新推送」处理；未认领的先认领；已认领失败的用人工入口重推（3.10） |
+| 结算单/付款管理「已指定应付」列显示指定失败 | 认领的收票单 A302-6 指定失败 | **悬浮状态标签看聚合失败原因** → 付款结算单查看页对该票「重新推送」（可先改匹配金额），或工具栏「发票登记」重推 |
 | 认领收票单被拦「一张收票单只能被一张付款结算单认领」 | 已被其他有效付款结算单认领 | 先在原结算单移除认领（金蝶侧人工解除指定）再认领 |
+| 为什么选不到某张预付结算单发起预付 | 需要**应付**、**审批通过**、**未转付款结算**、且所选单据**同一合同** | 按 3.3 前提检查 |
+| 付款管理工具栏的「预付申请」发起的是哪种预付 | 固定是**进度预付**（配合预付结算单） | **项目预付**要点「新增付款申请」后手动把付款类型选成"项目预付"（3.4） |
+| 为什么核销弹窗里找不到那笔项目预付 | 必须与结算单**同一合同**、**审批通过**、**金蝶已付款**、还有**剩余可核销额** | 按 3.5 前提检查 |
+| 为什么新增开票申请时选不到某张收款结算单 | 需要**审批通过、未作废、剩余可开票金额>0**；跨合同不能合并开票 | 已申请开票金额（未作废的占用）会扣减可开票额；部分开票过的单只要还有余额可以再选 |
+| 开票提示要先去同步金蝶 | 开票前系统检查金蝶应收单 | 先在「收款结算单」列表点「同步金蝶」（3.7） |
+| 结算单已付金额比我算的多/少 | 已付金额**含**进度预付、项目预付核销；核销金额同时计入"已申请付款金额"和"已付金额" | 属正常口径 |
+| 结算单金额写错了怎么改 | 审批通过后不能直接改 | 走「结算调整单」（3.11） |
+| 结算调整单选不到某张结算单 | 已完成收付款 / 已发起尾款 / 有关联付款申请在途 / 未审批通过 | 按 3.11 前提检查 |
+| 结算调整单重推被拦「旧单未冲销」 | 原单已推送金蝶且财务还没在金蝶冲销 | 财务在金蝶手工冲销旧单后再点「重新推送（高危）」（部分冲销视同已冲销） |
+| 结算调整单重推失败，新单显示同步失败 | 克隆新单已生成但推送金蝶失败 | 再点「重新推送」复用新单续推，不会重复建单；失败原因悬浮看新单 |
+| 对「已调整」原单发起付款被拦 | 原单已作废（被调整单重推替代） | 使用调整后的新单发起付款 |
+| 单据上的「作废」是灰的/没有 | 状态不是审批通过；结算单已同步金蝶；已被金蝶锁定 | 见 3.14 作废前提 |
 | 收款流水同步为空/报组织编码错误 | 组织管理未维护「平台公司」金蝶编码，或窗口内无数据 | 找管理员维护组织金蝶编码；需要更早流水时调大同步窗口天数配置 |
 | 认领/作废后合规侧没有记录 | 合同合规推送失败（只落标记不重试） | 让运维查合规推送记录失败原因，人工在合规侧补录；认领/作废本身不受影响 |
 | 想作废认领 | — | 认领记录页本人记录直接「作废」：本地回退金额并自动同步合规作废；金蝶收款单本身不受影响（红冲由金蝶财务人工处置） |
@@ -370,19 +666,25 @@
 | 客商档案 | （表单）录信用代码 | 自动查金蝶回填工商信息 + 金蝶供应商编码 |
 | 客商档案 | （表单）收款信息开户行 | 失焦按行名从金蝶带出联行号；保存前按行号校验 |
 | 客商档案 | 行内「同步金蝶」 | 失败重推客商 |
-| 预结算单 | 工具栏「预付申请」/「尾款结算」 | 审批通过后发起进度预付 / 生成尾款结算号（预结算本身不推金蝶） |
-| 正式结算单 | 新建时选择来源预结算单 | 预结算转正式结算（转后预结算锁定） |
-| 正式结算单 | 工具栏「同步金蝶」（单选） | 推送应付/应收单到金蝶 |
-| 正式结算单 | （编辑）汇率日期 | 自动带出金蝶汇率 |
-| 付款结算单 | （编辑）发票信息「选择收票单」 | 候选=审批通过未认领的收票登记，全额认领 |
-| 付款结算单 | 行内「发票登记」 | 审批后补认领收票单，可确认推送「指定应付」 |
+| 预付结算单 | 工具栏「预付申请」 | 审批通过后发起**进度预付**（跳转付款申请表单，类型锁定） |
+| 预付结算单 | 工具栏「尾款结算」 | 转付款结算单（容纳预付与核销；转后本单锁定） |
+| 付款管理 | 工具栏「新增付款申请」→ 类型=项目预付 | 发起**项目预付**（不挂结算单） |
+| 预付/付款结算单编辑页 | 「项目预付核销」分区「选择」 | 选择金蝶已付款的项目预付单抵扣（本次核销金额可改小） |
+| 付款结算单 | 工具栏「同步金蝶」 | 推送应付/应收单到金蝶（收款结算单同） |
+| 付款结算单 | 工具栏「发票登记」 | 审批后认领收票单（回显已认领），保存认领后可推送「指定应付」 |
+| 付款结算单查看页 | 发票行「重新推送」 | failed/pushed 票一步式重推收票单+指定应付（可带匹配金额） |
+| 付款结算单查看页 | 发票行「匹配结算单金额」 | 指定失败行可编辑匹配金额，随重推生效 |
+| 结算单（预付/付款/收款） | （编辑）汇率日期 | 自动带出金蝶汇率 |
 | 付款申请 | 工具栏「批量同步」 | 下推付款申请/预付款到金蝶 |
 | 付款申请 | 工具栏「同步付款结果」 | 立即回写付款状态与付款记录 |
 | 开票申请 | 工具栏「批量同步」 | 按发票张次推送开票申请 |
+| 开票申请新增 | 「分摊发票金额」 | 系统按选择顺序自动分摊（只读），底部「同步」刷新 |
 | 收票登记 | （表单）发票号放大镜 | 从金蝶票池选票（带出发票明细） |
 | 收票登记 | （表单）结算组织 | 手选合同承办部门（必选） |
-| 收票登记 | 工具栏「批量同步」 | 推送金蝶收票单（终态 pushed；指定应付由付款结算单完成） |
+| 收票登记 | 工具栏「批量同步」 | 推送金蝶收票单（终态已推送；指定应付由付款结算单完成） |
 | 收票登记 | （表单）附件查看/下载 | 从金蝶取发票原件（PDF 优先） |
+| 结算调整单 | 「新增/提交/审批」 | 对已审批通过的结算单调整费用金额（原单未推送场景审批后自动推金蝶） |
+| 结算调整单 | 「推送金蝶」/「重新推送（高危）」 | 未同步直接推送；已同步需金蝶旧单已冲销后克隆新单重推 |
 | 收款流水 | 工具栏「手动同步流水」 | 拉取金蝶收款单（A301-1，窗口默认 60 天） |
 | 收款流水 | （详情/工具栏「批量认领」）认领 | 本地认领到结算单（不推金蝶，自动推合同合规） |
 | 认领记录 | 行内「作废」 | 回退认领金额并同步作废合同合规系统认领记录 |
@@ -394,4 +696,4 @@

 ---

-> 本文基于 2026-10-14 代码现状整理；2026-10-19 核对补充 4.2 定时任务运转逻辑；**2026-10-31 按先票后款改造（收票登记两段式）与收款流水 A301-1 改造修订 3.1/3.6/3.7、4 节、5 节、6 节**。系统升级后按钮与提示如有出入，以页面实际为准，并核对全链路总纲文档的更新说明。
+> 本文基于 2026-10-14 代码整理；2026-10-19 核对补充定时任务运转逻辑；2026-10-31 按先票后款改造与收款流水 A301-1 改造修订；**2026-11-03 汇总《2026-10-17 结算调整单》《2026-10-18 预付与项目预付》两本操作手册，并按 2026-11-01/11-02 代码修订收票指定应付链路（发票登记工具栏入口、匹配金额可改、查看页重新推送、已指定应付列、A302-6 自动补偿开关默认关闭）**。系统升级后按钮与提示如有出入，以页面实际为准，并核对全链路总纲文档的更新说明。