From ed6346e7a10aca99f114ab2da6d248b2bdabd387 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=88=98=E6=B3=89=E4=BD=B3?= <1107186916@qq.com>
Date: Sun, 18 Oct 2026 15:50:07 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=E9=A2=84=E4=BB=98?=
 =?UTF-8?q?=E8=BD=AC=E6=AD=A3=E5=BC=8F=E7=BB=93=E7=AE=97=E5=8D=95=E4=B8=8E?=
 =?UTF-8?q?=E9=A1=B9=E7=9B=AE=E9=A2=84=E4=BB=98=E6=93=8D=E4=BD=9C=E6=89=8B?=
 =?UTF-8?q?=E5=86=8C=EF=BC=88=E7=BA=AF=E6=93=8D=E4=BD=9C=C2=B7=E5=B8=A6?=
 =?UTF-8?q?=E7=8A=B6=E6=80=81=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...�正式结算单与项目预付操作手册（纯操作·带状态）.md | 279 ++++++++++++++++++
 1 file changed, 279 insertions(+)
 create mode 100644 doc/docs/业务流程/2026-10-18-预付转正式结算单与项目预付操作手册（纯操作·带状态）.md

diff --git a/doc/docs/业务流程/2026-10-18-预付转正式结算单与项目预付操作手册（纯操作·带状态）.md b/doc/docs/业务流程/2026-10-18-预付转正式结算单与项目预付操作手册（纯操作·带状态）.md
new file mode 100644
index 00000000..2dbb4807
--- /dev/null
+++ b/doc/docs/业务流程/2026-10-18-预付转正式结算单与项目预付操作手册（纯操作·带状态）.md
@@ -0,0 +1,279 @@
+# 预付转正式结算单与项目预付操作手册（纯操作·带状态）
+
+> 整理日期：2026-10-18
+> 定位：**给操作者和实施/培训用的纯操作手册**。只讲"在哪个页面、点哪个按钮、填什么、会看到什么状态"，不含接口、表名、代码。
+> 配套逻辑说明见同目录《2026-10-18-预付转正式结算单与项目预付操作流程说明（分场景·前端后端）.md》。
+
+---
+
+## 一、先认状态（每个场景都对着这几张表看）
+
+### 1.1 单据审批状态（所有单据通用）
+
+```
+新建/保存 ──→ 草稿 ──提交──→ 审批中 ──通过──→ 审批通过
+                ↑               │
+                │             驳回
+                └── 已驳回 ←────┘   （改完再提交）
+
+草稿 / 审批中 / 审批通过 ──(可作废时)──→ 已作废（终态）
+```
+
+| 状态 | 能做什么 |
+|---|---|
+| 草稿 | 编辑 / 删除 / 提交 |
+| 已驳回 | 编辑（保存后回到草稿）/ 提交 |
+| 审批中 | 通过 / 驳回（审批人操作） |
+| 审批通过 | 看后续：同步金蝶、付款申请、开票申请、作废（未锁定时） |
+| 已作废 | 终态，只读 |
+
+### 1.2 付款申请的金蝶状态
+
+```
+未同步 ──推送──→ 已同步 ──→ 付款中 ──→ 已付款
+   │                                        │
+   └────────── 生成失败（可重推）            └──→ 已关闭
+```
+
+- **已付款**：钱已付出。**项目预付只有到"已付款"才能在结算单上核销**。
+- **生成失败**：系统每 10 分钟自动重推；也可在列表勾选后点「批量同步」手动重推。
+
+### 1.3 正式结算单上的四个状态
+
+| 状态位 | 取值 | 看什么 |
+|---|---|---|
+| 审批状态 | 草稿 / 审批中 / 审批通过 / 已驳回 / 已作废 | 单据走到哪一步 |
+| 金蝶同步状态 | 未同步 / 已同步 / 同步失败 | 有没有在金蝶生成应付单（应付）/应收单（应收） |
+| 收付款状态 | 未收/付款 / 部分收/付款 / 已收/付款 | 收付进度（**已含预付、核销**） |
+| 发票状态 | 应付=未收票/部分收票/已收票；应收=未开票/部分开票/已开票 | 票开/收到哪一步 |
+
+### 1.4 金蝶锁定状态
+
+| 显示 | 含义 | 影响 |
+|---|---|---|
+| 锁定中 | 正在向金蝶加锁 | 稍等 |
+| 已锁定 | 金蝶已锁 | **不可编辑、不可作废** |
+| 锁定失败·补偿中 / 已达上限 | 加锁未成功 | 定时自动补偿；必要时联系管理员 |
+
+### 1.5 开票申请的金蝶状态
+
+```
+未同步 ──推送──→ 已同步 ──金蝶回写──→ 开票完成
+   │
+   └── 生成失败（可重推）
+```
+
+---
+
+## 二、应付侧操作（钱付出去）
+
+### 场景 1：预结算单直接发起「进度预付」
+
+**前提**：预结算单是**应付**、状态**审批通过**、还没转正式结算。
+
+1. 进「**预结算单**」列表，勾选预结算单（**同一合同**可多选）。
+2. 点工具栏「**预付申请**」。
+3. 自动跳到「付款申请」页面（类型已固定为进度预付）：结算单只读，"结算金额/可付款金额"自动带出。
+4. 填「申请付款金额」（不超过可付款金额）、「付款方式」→「保存」。
+5. 回到「付款申请」列表 → 找到该单 →「**提交**」。
+6. 审批人点「**通过**」。
+
+**状态变化**：付款申请 `草稿 → 审批中 → 审批通过`；随后系统自动推金蝶，金蝶状态 `未同步 → 已同步 → 已付款`。
+**同时发生**：预结算单上出现「申请预付金额 / 已预付金额」；预结算单仍然可以继续「尾款结算」。
+
+> 若提交/通过后看到黄色警告写着金蝶推送失败：审批结果**不受影响**，稍后自动重推，或到付款申请列表点「批量同步」。
+
+---
+
+### 场景 2：发起「项目预付」（不挂结算单）
+
+**前提**：项目已建、**承运商合同**已建；金额不超过项目额度与客户额度。
+
+1. 进「**付款申请**」列表 → 点工具栏「**预付申请**」（注意：这个入口是从付款申请页进的，和场景 1 从预结算单进不同）。
+2. 页面类型已固定为项目预付，填写：
+   - **所属项目**（必选）
+   - **合同名称**（必选，**只能选承运商合同**，选了项目后才能选）
+   - 申请付款金额、付款方式、付款方/收款方等
+   - 本类型不挂结算单，不显示发票信息与付款记录
+3. 「保存」→ 列表「提交」→ 审批人「通过」。
+
+**会被拦截的情况**：
+- "申请付款金额不能超过项目额度"（项目额度 = 项目额度 + 有效期内的临时额度）
+- "申请付款金额不能超过客户额度"
+
+**状态变化**：同场景 1。**务必等到金蝶状态「已付款」**，否则下一步核销做不了。
+
+---
+
+### 场景 3：结算单上「项目预付核销」
+
+**前提**：有一笔**已付款**的项目预付（金蝶状态=已付款），且与本次结算单**同一合同**，还有剩余可核销金额。
+
+1. 打开结算单（**预结算单**或**正式结算单**都行）的编辑页。
+2. 找到「**项目预付核销**」分区 → 点「**选择**」。
+3. 弹窗「选择项目预付单」里勾选要抵扣的预付单（已选的会灰掉，不能重复选）→「确定」。
+4. 在「本次核销金额」列：默认已按"可核销金额"填满，可以改小。
+5. 「保存」。
+
+**会被拦截的情况（提示文案）**：
+- "预付单 XXX 本次核销金额必须大于 0"
+- "本次核销金额不能超过可核销金额"
+- "项目预付核销合计不能超过结算单金额"
+- "仅可选择审核通过的项目预付单"
+- "预付单 XXX 尚未付款，项目预付须金蝶付款完成后方可核销"
+- "同一项目预付单不可重复核销"
+- "项目预付单与结算单合同不一致"
+
+**状态变化**：结算单「**已付金额（含预付、核销）**」立刻增大，「剩余未付金额」减小；列表上"申请付款金额（含预付）/已收已付合计（含预付）/剩余可付/收付款状态"同步变化。
+
+---
+
+### 场景 4：预结算单转「正式结算单」（容纳预付）
+
+**前提**：预结算单**审批通过**，且**同一项目**。
+
+1. 进「**预结算单**」列表，勾选（可多选，须同项目）→ 点工具栏「**尾款结算**」。
+2. 系统跳到「正式结算单」新增页，把所选预结算单的明细、费用项合并进来。
+3. 检查三处金额（**应付结算单才有**）：
+   - **结算合计（原金额）**：费用合计，**始终全额**，不会因为预付/核销而变小；
+   - **已付金额（含预付、核销）**：把来源预结算的已付预付 + 本次核销都算进去；
+   - **剩余未付金额** = 结算合计 − 已付。
+4. 「项目预付核销」区会**自动带出来源预结算上已核销的行**，可增/删/改金额。
+5. 「保存」（草稿）→「提交」→ 审批人「通过」。
+
+**状态变化**：正式结算单 `草稿 → 审批中 → 审批通过`；预结算单会被标记为已转正式结算（来源被锁定）。
+**注意**：如果预结算单上还有**审批中或已审批但没结束的预付申请**，走"轻量转正式"会被拦住，需要先把预付处理完。
+
+---
+
+### 场景 5：正式结算单「同步金蝶」
+
+**前提**：结算单**审批通过**。
+
+1. 进「**正式结算单**」列表，切到「**应付**」页签。
+2. 勾选 **1 条**（按钮只允许选一条）→ 点工具栏「**同步金蝶**」。
+3. 成功后会提示"同步成功，金蝶单据号：XXX"；列表「金蝶同步状态」变为**已同步**，「金蝶锁定状态」变为**已锁定/锁定中**。
+
+**生成失败怎么办**：列表金蝶状态显示"同步失败"，重新点「同步金蝶」即可。
+**提示"该单附件未全部上传，可重推补传"**：单据已同步成功，附件稍后重推会自动补传。
+
+> 审批通过时系统也会自动推一次；若失败，只弹黄色警告，审批照样通过，按上面手动补推。
+
+---
+
+### 场景 6：正式结算单「付款申请」（付尾款）
+
+**前提**：正式结算单是**应付**、**审批通过**、**同一合同**、还有剩余可付金额。
+
+1. 「正式结算单」列表（应付）→ 勾选 1 条或多条（同合同）→ 工具栏「**付款申请**」。
+2. 弹窗里确认各单的「申请付款金额」（默认已填=剩余可申请金额，**已扣掉核销**）→「提交」。
+3. 到「付款申请」列表「提交」→ 审批人「通过」。
+
+**会被拦截的情况**：
+- "仅审批通过的应付正式结算单允许发起付款申请"
+- "付款申请必须选择同一个合同的正式结算单"
+- 提示需要先在正式结算单页面同步金蝶（说明该单在金蝶还没有应付单，尾款是从应付单下推的，**必须先做场景 5**）
+
+**状态变化**：正式结算单「收付款状态」`未付款 → 部分付款 → 已付款`，金额按付款结果自动重算。
+**金额错了怎么办**：正式结算单**审批通过后不能直接改金额**，走「**结算调整单**」（见《2026-10-17-结算调整单操作流程说明（分场景）.md》）。
+
+---
+
+## 三、应收侧操作（票开出去）
+
+### 场景 7：应收正式结算单「同步金蝶」
+
+1. 「正式结算单」列表切到「**应收**」页签 → 勾选 1 条 → 工具栏「**同步金蝶**」。
+2. 列表「金蝶同步状态」变**已同步**，可见金蝶单据号。
+
+**必须做这一步**：正式结算单开票要求先有金蝶应收单，没做这步，开票申请推不出去。
+
+---
+
+### 场景 8：创建并推送「开票申请」
+
+**前提**：有一张**应收**正式结算单，**审批通过**、未作废、发票状态还是「**未开票**」，且已完成场景 7。
+
+1. 进「**开票申请**」列表 → 点「**新增**」。
+2. 「开票基本信息」里点「结算单」右侧的「**选择**」→ 弹窗「选择应收正式结算单」→ 搜索并勾选 →「确定」。
+   - 「项目」「开票单位」自动带出；「**可开票金额**」= 所选结算单剩余可开票额之和。
+   - 受票方开票信息按客商档案自动带出。
+3. 填「发票类型」等；选**电子专票**时，纳税人识别号、开户行、开户账号、注册地址**必填**。
+4. 填「开票内容」（发票张次 + 商品行），系统自动算「**本次开票金额**」。
+5. 在「结算信息」表里给每张结算单填「**分摊开票金额**」（不超过该单剩余可开票金额）。
+6. 「开票明细」里勾选明细 →「保存」→「提交」→ 审批人「通过」。
+
+**会被拦截的情况**：
+- "只能选择审批通过、未作废、未收票的应收正式结算单"
+- "结算单 XXX 的分摊金额超过剩余可开票金额"
+- "本次开票金额必须大于 0"
+- "请选择受票方有效的开票信息"
+- "未找到正式结算单受票方对应的客商档案"
+
+**状态变化**
+| 对象 | 状态变化 |
+|---|---|
+| 开票申请 | 审批 `草稿 → 审批中 → 审批通过`；金蝶 `未同步 → 已同步 → 开票完成` |
+| 来源正式结算单 | 发票状态 `未开票 → 部分开票 → 已开票`（按分摊与回写自动算） |
+
+**看发票结果**：开票申请详情页的发票信息里能看到发票号、开票日期、价税合计、发票文件。金蝶回写是定时的，没出来可以先等，或在开票申请列表点「**批量同步**」推一把。
+
+**限制**：开票申请一旦推到金蝶（已同步/开票完成）就**锁定不能改**；数电票已经开出来的只能走红冲，不能在本系统作废。**预付和核销不影响开票金额**，开票始终按结算单的**全额**来匹配。
+
+---
+
+## 四、作废与撤销：能做什么、状态怎么变
+
+| 我想…… | 前提 | 操作位置 | 状态变化 |
+|---|---|---|---|
+| 作废付款申请 | 状态=审批通过，且**未被金蝶锁定** | 付款申请列表「作废」 | 单据→已作废；**未付的预付记录联动作废，相关核销行被删除**，受影响结算单的已付金额回落（已付出去的钱不会回退） |
+| 作废正式结算单 | 未审批通过，或审批通过但**未锁定** | 正式结算单列表「作废」 | 单据→已作废；本单的核销行被删除，可核销额度释放 |
+| 作废预结算单 | 无关联预付申请（有则先作废预付） | 预结算单列表「作废」 | 单据→已作废；预结算上的核销行被删除 |
+| 作废开票申请 | 状态=审批通过，且**未锁定**（即还没推金蝶/还没开票） | 开票申请列表「作废」 | 单据→已作废 |
+| 删除 | 状态=草稿 | 各列表「删除」 | 草稿被删除 |
+| 金蝶侧反审核删单 | — | 金蝶操作后由系统处理 | 付款申请金蝶状态→生成失败，金蝶单号被清空；**未付的预付记录联动作废**；人工核实后重推，重推成功会重新建档；**已核销的行不会自动删**，需要人工作废该预付款才回落 |
+
+> 一句话记住：**预付一旦真付出去（已付款），作废不会把钱退回**，只会把台账和核销额度清掉。
+
+---
+
+## 五、操作者常见疑问
+
+| 问题 | 答案 |
+|---|---|
+| 为什么选不到某张预结算单发起预付？ | 需要**应付**、**审批通过**、**未转正式结算**、且所选单据**同一合同**。 |
+| 为什么核销弹窗里找不到那笔项目预付？ | 它必须已**金蝶付款完成（已付款）**，且与结算单**同一合同**、还有剩余可核销额。 |
+| 为什么新增开票申请时选不到某张应收结算单？ | 需要**审批通过、未作废、发票状态=未开票**；已被别的开票申请占用的会扣掉可开票额。 |
+| 开票提示要先去同步金蝶？ | 正式结算开票前，必须先在该应收结算单上点「同步金蝶」生成金蝶应收单。 |
+| 付款申请审批通过了，但金蝶那边没有单？ | 看金蝶状态：若"生成失败"，点「批量同步」重推或等自动重推。 |
+| 结算单已付金额比我算的多/少？ | 已付金额**含**进度预付、项目预付核销；核销金额同时计入"已付"和"剩余可付"的计算，属正常口径。 |
+| 结算单金额写错了怎么改？ | 审批通过后不能直接改，走「结算调整单」。 |
+| 单据上的「作废」是灰的？ | 可能已被金蝶锁定，或状态不满足（只有审批通过且未锁定才能作废）。 |
+
+---
+
+## 六、一眼看懂整个流程（操作版）
+
+```
+【应付·进度预付】
+预结算单(审批通过) →「预付申请」→ 付款申请(提交→通过) → 金蝶付款(已付款)
+                                        └ 预结算单出现"已预付金额"
+
+【应付·项目预付】
+付款申请页「预付申请」→ 选项目+承运商合同 → 提交→通过 → 金蝶付款(已付款)
+
+【预结算 → 正式结算（容纳预付）】
+预结算单(审批通过·同项目) →「尾款结算」→ 正式结算单
+   结算合计(全额) / 已付(含预付、核销) / 剩余未付
+   项目预付核销自动带入 → 保存 → 提交 → 通过
+        └ 「同步金蝶」(应付单已同步)
+
+【应付·尾款】
+正式结算单(应付·审批通过) →「付款申请」→ 付款申请 → 金蝶应付下推 → 已付款
+        └ 结算单收付款状态：未付款 → 部分付款 → 已付款
+
+【应收·开票】
+应收正式结算单(审批通过·未开票) →「同步金蝶」(应收单已同步)
+   →「开票申请」新增 → 选结算单 → 填开票内容与分摊 → 提交 → 通过
+        → 金蝶开票(已同步 → 开票完成) → 结算单发票状态：未开票 → 部分开票 → 已开票
+```