docs: 金蝶BFI全链路梳理与操作手册按先票后款及收款流水A301-1改造修订

- 两份文档首部增加修改记录（2026-10-31，基线 933fb37d）
- 收票域重写为先票后款两段式：A303-2 终态 pushed、A302-6 移付款结算单侧、报文按发票明细行组装
- 收款认领重写：数据源 A301-2 改 A301-1，A301-3 链路下线，认领本地化并推合同合规
- 客商域补 A901-1 供应商编码与 A905-3 行名行号；付款域补金蝶实付门禁
- 接口清单/防重键/全景/状态机/定时任务/操作手册/风险清单同步更新
- 新增 TMS 侧截图 11 张（playwright 实拍），下线 A301-2/A301-3 旧效果截图

doc/docs/hcs合同/2026-10-23-HCS合同管理操作手册.md

@@ -1,11 +1,18 @@
 # HCS 合同管理操作手册
 
-> **文档日期**：2026-10-23
+> **文档日期**：2026-10-23（最近更新：2026-11-01）
 > **适用系统**：运输板块数字化管理平台（TMS）
 > **适用对象**：合同经办人、合同负责人、合同审批人、合规管理员
 > **文档目的**：介绍合同新增、审批、变更、附件归档及 HCS 合规同步的完整操作方法
 > **截图说明**：本文截图取自测试环境，合同编号、客商名称、金额等均为测试数据；不同环境因角色权限、功能开关不同，页面按钮和状态可能略有差异，以实际页面为准。
 
+## 修改记录
+
+| 日期 | 修改内容 |
+| --- | --- |
+| 2026-11-01 | ① 客商黑名单口径调整：黑名单以金蝶黑名单查询（A801-5）命中为准（含失信类别、列入事由），合同合规系统 C101-1 的黑名单状态不再用于展示与筛选；合同列表/详情"客商风险"改为实时关联客商档案组装，红色标签悬浮可查看甲乙双方风险明细（新增 16、17、18 截图）。② 新增客商风险每日定时刷新任务（每天 02:30，`risk.refresh-enabled` / `risk.refresh-cron`），刷新合同期限内生效合同关联客商并落库客商档案（新增 12.7 节）。③ 归档状态即时同步合规：上传"双章归档文件"后即时调 C103-11 更新合规归档状态（fdArchiveStatus=toarchive）并挂载归档附件；未推送合同首次推送报文自带归档状态（更新 9.4 节）。④ 付款链履约数据推送时点调整：金蝶实际付款门禁——未实付时履约计划（C103-9）与履约记录（C108）均不推送，金蝶付款回写后自动推送（同步更新纯操作版 3.11/4.5）。⑤ 合同推送报文新增业务合同号（fdBusContractNumber，=合同编号）与归档状态（fdArchiveStatus）字段；币种映射样例更新为 RMB/CNY→人民币、USD→美元。⑥ 新增 19 项目立项列表、20 付款申请列表截图；常见问题补充 3 条。 |
+| 2026-10-23 | 首次整理。 |
+
 ---
 
 ## 1. 先了解合同管理与 HCS
@@ -29,6 +36,8 @@
 | 合规合同ID | 合同成功推送 HCS 后，由 HCS 返回的合同唯一标识 |
 | 金蝶合同ID | 合同在 HCS 完成合规及金蝶同步后，回写到 TMS 的金蝶合同编号 |
 | 特批 | 高风险或黑名单客商合同，需经集团特批后才能完成合规流程 |
+| 黑名单 | 客商被列入外部（国资委）黑名单，**以金蝶黑名单查询（A801-5）命中为准**，命中记录含失信类别与列入事由；金蝶分 A 类（禁止交易类）和 B 类（风险警示类） |
+| 风险等级 | 合同合规系统（HCS）对客商的风险评级：0=低风险、1=中风险、2=高风险 |
 | 临时合同 | 用于提前生效的合同，审批通过后有 **30 天** 临时效力 |
 | 正式合同 | 完成正式审批、可长期履约的合同，是 HCS 合规同步与归档的主要对象 |
 | 合同变更 | 正式合同内容发生变化时发起的变更审批流程 |
@@ -38,7 +47,7 @@
 - 页面中带 `*` 的字段为必填项；保存草稿时可先填写部分信息，提交临时合同或正式合同前需补全。
 - 合同编号可不填写，系统会按合同负责部门配置的规则自动生成；如业务要求手工编号，可直接填写。
 - 临时合同审批通过后有效期为 **30 天**（自提交临时合同审批之日起算），到期前应及时转为正式合同。
-- 高风险、黑名单客商合同，**提交审批前必须上传“特批附件”**，否则系统会阻止提交。
+- 高风险、黑名单客商合同，**提交审批前必须上传“特批附件”**，否则系统会阻止提交。黑名单口径见 12.7 节。
 - 合同审批通过后，系统会将合同推送 HCS；正式合同与合同变更是合规同步、归档的主要场景。是否自动推送由环境开关决定，也可在页面手动推送。
 - 合同已推送 HCS 后，如需修改合同信息，必须走“变更”流程，**不要重复新增合同**，否则会在合规系统产生重复合同。
 - 合同列表默认按创建时间倒序排列。
@@ -150,6 +159,7 @@ flowchart TD
 | 合同阶段 | 草稿 / 临时合同 / 正式合同 / 已终止 |
 | 审核状态 | 当前审批状态 |
 | 归档状态 | 未归档 / 已归档 |
+| 客商风险 | 甲方/乙方客商的风险等级与黑名单组合展示（如“低风险、黑名单”）；红色标签鼠标悬浮可查看风险明细；数据实时关联客商档案组装 |
 | 合规状态 | 待推送 / 已推送 / 推送失败；鼠标悬停可查看失败原因 |
 | 金蝶合同ID | 合规同步完成后回写的金蝶合同编号 |
 | 当前节点 / 当前处理人 | 当前审批节点及处理人 |
@@ -384,10 +394,14 @@ flowchart TD
 | --- | --- |
 | 合规同步状态 | 待推送 / 已推送 / 推送失败 |
 | 合规合同ID | HCS 返回的合同唯一标识 |
-| 客商风险 | 是否黑名单、风险等级 |
+| 客商风险 | 甲方/乙方客商风险等级与黑名单组合展示（如“高风险、黑名单”）；黑色标签为命中风险，鼠标悬浮可查看明细（失信类别、列入事由、风险等级） |
 | 特批状态 | 待特批 / 特批中 / 特批通过 / 特批驳回 |
 | 特批说明 | 特批原因或处理说明 |
 
+![合同列表客商风险悬浮明细](images/18-合同列表-客商风险悬浮.png)
+
+> 合同列表“客商风险”列：红色标签为高风险/黑名单客商，鼠标悬浮展示甲乙双方风险明细（失信类别、列入事由、风险等级）。
+
 ### 8.3 用印材料与附件
 
 向下滚动可查看用印材料、计费信息、结算单规则、付款比例设置、附件（佐证材料等）。
@@ -438,6 +452,7 @@ flowchart TD
 
 - 上传附件类型为 **双章归档文件** 后，合同归档状态会在审批通过或附件保存后变为“已归档”。
 - 双章归档文件属于用印材料，请在“附件位置”中选择“用印材料”。
+- **归档状态即时同步合规**：上传双章归档文件保存后，若合同已推送合规（已有合规合同ID），系统会立即调 C103-11 更新合规侧归档状态为“待归档”（fdArchiveStatus=toarchive），并将归档附件挂载到合规合同的其他附件面板；若合同尚未推送合规，首次推送报文会自带归档状态。合规侧后续的归档流转（归档中/已归档/归档异常）由合规系统自行维护。
 
 ---
 
@@ -513,7 +528,7 @@ flowchart TD
 | ① 客商风险校验 | 校验甲乙双方是否高风险/黑名单（C101-1） |
 | ② 附件转传 | 将合同附件转传到合规系统（C103-2） |
 | ③ 合同判重 | 按合同编号等信息判断合规系统是否已存在（C103-3） |
-| ④ 起草 / 更新 | 首次推送起草合同（C103-1）；已有合规合同ID时更新合同（C103-11） |
+| ④ 起草 / 更新 | 首次推送起草合同（C103-1）；已有合规合同ID时更新合同（C103-11）。报文含业务合同号（fdBusContractNumber，取值同合同编号）与归档状态（fdArchiveStatus，已上传双章归档文件时传“待归档”） |
 | ⑤ 履约计划同步 | 同步合同履约计划/履约规则（C103-9），系统自动创建默认履约计划，无需人工维护 |
 | ⑥ 特批 | 高风险/黑名单客商合同自动进入特批流程 |
 
@@ -569,8 +584,8 @@ flowchart TD
 
 当合同甲方或乙方为外部客商，且命中以下任一情况时，需要走特批流程：
 
-- 客商为黑名单；
-- 客商风险等级为高风险。
+- 客商为黑名单（以金蝶黑名单查询 A801-5 命中为准，见 12.7 节）；
+- 客商风险等级为高风险（合同合规系统 C101-1 评级）。
 
 ### 12.2 提交前：上传特批附件
 
@@ -629,6 +644,27 @@ flowchart TD
 
 合同详情页右上角的 **发起特批** 是旧版独立发起入口。当前合规接口已改为随合同推送自动发起特批，正常流程**无需点击该按钮**；点击后如提示接口不存在，不影响合同数据。如特批状态长时间停留在“待特批”，请联系系统管理员重新推送合同。
 
+### 12.7 客商风险数据与每日刷新
+
+合同列表、详情和客商档案展示的“客商风险”来自两个外部系统，每日自动更新到客商档案：
+
+| 数据 | 来源 | 说明 |
+| --- | --- | --- |
+| 风险等级 | 合同合规系统（C101-1） | 低风险 / 中风险 / 高风险 |
+| 金蝶黑名单 | 金蝶（星瀚）· 国资委黑名单（A801-5） | 命中记录失信类别（A 类禁止交易类 / B 类风险警示类）与列入事由 |
+
+- **刷新时机**：系统每天凌晨 02:30 自动刷新（合同期限内生效合同的甲乙方关联客商）；当天新增的客商在客商档案表单里有实时风险提示，列表数据次日刷新后生效。
+- **展示口径**：黑名单仅指金蝶黑名单命中；风险等级与黑名单组合展示（等级在前，如“高风险、黑名单”）；内部组织客商不查询风险，默认“无风险”。
+- **悬浮明细**：红色标签（黑名单/高风险）鼠标悬浮可查看明细，格式：`【客商名称】：被列入外部黑名单（失信类别：xx）；列入事由 xx；风险等级：xx`。
+
+![客商档案列表客商风险列](images/16-客商档案列表-客商风险.png)
+
+> 客商档案列表：搜索栏“客商风险”下拉可筛选黑名单/高风险/中风险/低风险；红色标签为命中风险客商。
+
+![客商风险悬浮明细](images/17-客商风险悬浮明细.png)
+
+> 红色标签悬浮明细：失信类别、列入事由、风险等级。
+
 ---
 
 ## 13. 常见问题
@@ -681,6 +717,18 @@ A：说明该合同没有关联外部审批流程实例。请以列表/详情中
 
 A：批量推送只允许“审批通过/变更审批通过”且未同步的合同。请取消勾选不符合条件的合同，或单独对符合条件的合同发起推送。
 
+**Q13：客商档案/合同列表的“客商风险”列显示“-”是为什么？**
+
+A：该客商不在任何合同期限内生效合同的关联范围内，尚未被每日刷新任务（每天 02:30）查询过；或客商档案刚创建、数据次日才落库。当天需要确认时，可在客商档案新增/编辑表单填写客商名称，系统会实时查询并显示风险提示。
+
+**Q14：客商明明命中了金蝶黑名单，列表为什么只显示风险等级、没有“黑名单”？**
+
+A：黑名单标签需要金蝶黑名单记录的失信类别/列入事由数据（每日刷新任务落库）。数据缺失时只显示风险等级；等待次日刷新或联系管理员执行刷新后恢复完整展示。
+
+**Q15：付款特批通过后，为什么合规系统里迟迟没有履约计划和履约记录？**
+
+A：付款链的履约数据以金蝶实际付款为门禁：付款审批通过只做本地计划金额累加，**金蝶完成实际付款并回写实付金额后**，系统才自动推送履约计划（C103-9）与履约记录（C108）。实付前属正常等待，不是推送失败。
+
 ---
 
 ## 14. 操作权限速查

doc/docs/hcs合同/2026-10-23-HCS合同管理操作手册（纯操作版）.md

@@ -1,11 +1,18 @@
 # HCS 合同管理操作手册（纯操作版）
 
-> 整理日期：2026-10-23
+> 整理日期：2026-10-23（最近更新：2026-11-01）
 > 适用对象：合同经办人、合同负责人、合同审批人、合规管理员、实施运维。
 > 本文只讲**怎么操作**：在哪个页面、点什么按钮、前提是什么、成功的标志是什么、失败了怎么处理。
-> 第 1–3 节为业务操作（合同、项目立项、付款特批）；第 4 节为实施运维使用的五类 HCS 定时任务逻辑、接口与配置。
+> 第 1–3 节为业务操作（合同、项目立项、付款特批、客商风险）；第 4 节为实施运维使用的定时任务逻辑、接口与配置。
 > 完整字段说明、状态字典与流程背景见同目录《2026-10-23-HCS合同管理操作手册》；接口与代码细节见同目录 HCS 相关梳理文档。
 
+## 修改记录
+
+| 日期 | 修改内容 |
+|---|---|
+| 2026-11-01 | ① 客商黑名单口径调整：黑名单以金蝶黑名单查询（A801-5）命中为准（含失信类别、列入事由），C101-1 黑名单状态不再用于展示与筛选；合同列表/详情“客商风险”改为实时关联客商档案组装，红色标签悬浮查看甲乙双方明细（新增 1.6、3.12 节与截图 16/17/18）。② 新增客商风险每日定时刷新任务（02:30，`risk.refresh-enabled`/`refresh-cron`），第 4 章任务数 5→6。③ 归档状态即时同步合规：上传双章归档文件后即时调 C103-11 传 fdArchiveStatus=toarchive 并挂归档附件（更新 3.9）。④ 付款链履约数据改金蝶实际付款门禁：未实付不推履约计划 C103-9 与履约记录 C108，实付回写后自动推送（更新 3.11、4.5）；付款链履约计划重推纳入 `exe-stage.sync-enabled` 控制。⑤ 合同推送报文新增业务合同号（=合同编号）与归档状态字段；币种映射样例更新。⑥ 常见问题补 3 条。 |
+| 2026-10-23 | 首次整理。 |
+
 ---
 
 合同系统
@@ -64,6 +71,7 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）
 - 付款申请收款方为高风险/黑名单客商时，提交前必须上传“特批附件”，否则提交被拦截。
 - 付款申请审批通过后系统自动发起付款特批；特批中“当前节点”为“特批审核”，特批未通过前不推送履约数据、不同步金蝶。
 - 付款特批驳回后付款申请变“已驳回”，修改后重新提交审批会重新发起特批。
+- 上传“双章归档文件”保存后，已推送合规的合同会即时更新 HCS 归档状态（待归档）并挂载归档附件；未推送合同首次推送自带归档状态。
 
 ### 1.5 推送与环境前提
 
@@ -92,6 +100,20 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）
 2. `thirdParty.hcs.spec-pay.template-id` 已配置，付款用途/性质/类型字典值正确。
 3. 收款方为高风险/黑名单时，已上传“特批附件”。
 
+### 1.6 客商风险与黑名单口径
+
+客商风险数据来自两个外部系统，每日自动刷新到客商档案（详见 3.12、4.8 节）：
+
+| 数据 | 来源 | 说明 |
+|---|---|---|
+| 风险等级 | 合同合规系统（C101-1） | 低风险 / 中风险 / 高风险 |
+| 金蝶黑名单 | 金蝶（星瀚）· 国资委黑名单（A801-5） | 命中记录失信类别（A 类禁止交易类 / B 类风险警示类）与列入事由 |
+
+- **黑名单仅指金蝶黑名单命中**；合同合规系统返回的黑名单状态字段只用于付款提交强制校验，不在列表展示。
+- 合同列表/详情、客商档案的“客商风险”列为等级+黑名单组合展示（等级在前，如“高风险、黑名单”）；红色标签悬浮可查看明细（失信类别、列入事由、风险等级）。
+- 内部组织客商不查询风险，默认“无风险”。
+- 数据每天 02:30 刷新（合同期限内生效合同关联客商）；当天新增客商以表单实时提示为准，列表次日生效。
+
 ---
 
 ## 2. 一次性准备（实施/管理员操作）
@@ -102,7 +124,7 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）
 | 2 | 来源与操作人 | 运维 | `thirdParty.hcs.src-system`（约定 WLTMS）、`operator-login-name` | 合规侧来源/操作人不符合约定 |
 | 3 | 合同类别模板映射 | 运维 | `thirdParty.hcs.contract.template-mapping`，为**每个合同类别**配置 HCS 模板ID | 未映射的类别推送必失败，提示“合同类别未配置合规模板ID” |
 | 4 | 附件下载基址 | 运维 | `thirdParty.hcs.attachment.file-download-base`；保持 `transfer-enabled=true` | 合同有附件时转传失败 |
-| 5 | 币种映射 | 运维 | `thirdParty.hcs.contract.currency-name-mapping`（如 RMB→人民币） | 币种传错或为空 |
+| 5 | 币种映射 | 运维 | `thirdParty.hcs.contract.currency-name-mapping`（样例：RMB/CNY→人民币、USD→美元） | 币种传错或为空 |
 | 6 | 风险校验开关 | 运维 | `thirdParty.hcs.contract.require-risk-check` 保持 `true` | 关闭后高风险合同不会触发特批 |
 | 7 | 履约计划同步 | 运维 | `thirdParty.hcs.exe-stage.sync-enabled`，一期默认 `false` | 不推送 C103-9 履约计划，不影响合同主流程 |
 | 8 | 推送开关 | 运维 | 按需开启 `push.immediate-enabled`（项目/合同即时）、`push.project/contract/payment.sync-enabled`（定时扫描） | 只能靠手动按钮推送；付款审批即时特批不受 `push.immediate-enabled` 控制 |
@@ -112,10 +134,11 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）
 | 12 | 付款特批模板与字典 | 运维 | `thirdParty.hcs.spec-pay.template-id`、`payment-purpose`、`payment-nature`、`payment-type` | 付款特批发起失败 |
 | 13 | 付款履约记录 | 运维 | `thirdParty.hcs.perf-record.sync-enabled`（一期默认 `false`）；开启时同时配置 `perf-record.xform-id` | 开启但未配模板ID时履约记录推送失败 |
 | 14 | 付款额度校验 | 运维 | 如需“超额自动转特批”，开启 `thirdParty.hcs.credit.check-enabled` | 关闭时超额付款不会自动进入特批 |
+| 15 | 客商风险每日刷新 | 运维 | `thirdParty.hcs.risk.refresh-enabled` 上线置 `true`（默认 `false`）、`refresh-cron` 默认每天 02:30 | 客商档案/合同列表“客商风险”列无数据或长期不更新 |
 
 > 模板映射的中文键在 Nacos YAML 中必须使用括号写法，例如 `"[承运商合同]": "模板ID"`，否则配置无法正确绑定。
 >
-> 当前 Nacos 样例只映射了“承运商合同”。客户合同、补充协议如果也要推送，必须在上线前逐类确认并补齐映射。
+> 当前 Nacos 样例已映射“承运商合同”“客户合同”。补充协议等其他类别如果也要推送，必须在上线前逐类确认并补齐映射。
 
 ---
 
@@ -242,10 +265,12 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）
 |---|---|
 | 合规同步状态 | 待推送 / 已推送 / 推送失败；失败时可悬停查看原因 |
 | 合规合同ID | HCS 返回的合同唯一标识，推送成功后回填 |
-| 客商风险 | 是否黑名单、风险等级 |
+| 客商风险 | 甲方/乙方客商等级+黑名单组合展示；红色标签悬浮查看明细（失信类别、列入事由、风险等级），口径见 1.6 |
 | 特批状态 | 待特批 / 特批中 / 特批通过 / 特批驳回 |
 | 特批说明 | 特批原因或处理说明 |
 
+![合同列表客商风险列：红色标签悬浮展示甲乙双方风险明细（失信类别、列入事由、风险等级）](./2026-10-23-HCS合同管理操作手册（纯操作版）.assets/18-合同列表-客商风险悬浮.png)
+
 **推送成功的判断标准**：合规状态为“已推送”，且“合规合同ID”不为空。
 
 > 金蝶合同ID由 HCS 完成金蝶同步后回写，可能存在延迟；暂时为空可稍后刷新列表查看。“已推送”只代表 HCS 已受理，不代表特批和金蝶同步已经完成。
@@ -382,6 +407,7 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）
 
 - 上传附件类型为 **双章归档文件**，且附件位置选择“用印材料”时，合同审批通过或附件保存后归档状态变为 **已归档**。
 - 其他附件类型不会改变归档状态。
+- **即时同步合规**：双章归档文件保存后，已推送合规的合同会立即调 C103-11 更新合规侧归档状态为“待归档”（fdArchiveStatus=toarchive）并挂载归档附件；尚未推送的合同在首次推送报文中自带归档状态。合规侧后续归档流转由合规系统自行维护。
 
 ![合同详情附件区：可查看、下载用印材料和佐证材料](./2026-10-23-HCS合同管理操作手册（纯操作版）.assets/07-合同详情-附件佐证材料.png)
 
@@ -477,7 +503,7 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）
 
 | 提示 | 含义 | 后续 |
 |---|---|---|
-| 审批通过，已发起付款特批，特批通过后将自动推送履约数据并同步金蝶 | 特批已发起 | 列表“当前节点”显示“特批审核”，等待结果 |
+| 审批通过，已发起付款特批，特批通过后将自动推送履约数据并同步金蝶 | 特批已发起 | 列表“当前节点”显示“特批审核”，等待结果；履约数据在金蝶实际付款后才推送（见“特批通过后”） |
 | 审批通过，付款特批待发起，可在详情页重推合规 | 特批尚未发起（并发跳过或前置条件不满足） | 当前页面没有重推按钮；联系实施检查模板、合同合规ID后重推 |
 | 审批通过，但发起付款特批/推送合规失败：xxx，可稍后重推合规 | 审批已生效，特批发起或推送失败 | 按原因修复后联系实施重推，**不要重复审批** |
 | 审批通过，已同步金蝶：xxx / 审批通过，但自动同步金蝶失败：xxx | 未走特批，直接同步金蝶的结果 | 金蝶失败按提示原因处理 |
@@ -497,8 +523,8 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）
 
 **特批通过后：**
 
-1. 当前节点恢复“审批通过”。
-2. 系统自动补推履约计划（C103-9）和履约记录（C108，若开启），并自动同步金蝶。
+1. 当前节点恢复“审批通过”，系统自动同步金蝶付款申请。
+2. **金蝶实际付款后**，系统才自动推送履约计划（C103-9，受 `exe-stage.sync-enabled` 控制）和履约记录（C108，若开启）：付款审批通过只做本地计划金额累加，未实付时推送结果提示“金蝶未实际付款，待付款后推送履约计划与履约记录”，属正常等待，不是推送失败。
 3. 金蝶单据号、金蝶单据状态稍后回填，可刷新列表查看。
 
 **特批驳回后：**
@@ -525,25 +551,56 @@ HCS 正常情况下通过 `paymentLegal/result` 回传结果。长时间停留
 
 任一条件不满足时，审批仍会成功，但特批发起失败；按审批提示或日志修复后重推。
 
+### 3.12 客商档案客商风险（查看与筛选）
+
+**页面：客商管理 → 客商档案（`/vehicle/customer-archive`）**
+
+客商风险数据每天 02:30 自动刷新（合同期限内生效合同的甲乙方关联客商），供客商档案展示、筛选，以及合同/付款环节风险管控使用。
+
+![客商档案列表：展开搜索后可见“客商风险”下拉筛选，列表客商风险列为等级+黑名单组合标签](./2026-10-23-HCS合同管理操作手册（纯操作版）.assets/16-客商档案列表-客商风险.png)
+
+**查看规则：**
+
+| 客商情况 | 显示 | 颜色 |
+|---|---|---|
+| 等级 + 黑名单命中（组合展示，等级在前） | 高风险、黑名单 / 中风险、黑名单 / 低风险、黑名单 | 红 |
+| 仅黑名单命中（无等级数据） | 黑名单 | 红 |
+| 仅高风险 | 高风险 | 红 |
+| 中风险 | 中风险 | 黄 |
+| 低风险 | 低风险 | 绿 |
+| 内部组织客商 | 无风险（默认，不查询） | 绿 |
+| 尚未查询到数据 | - | — |
+
+**操作：**
+
+1. 筛选：搜索栏点 **展开**，“客商风险”下拉选黑名单/高风险/中风险/低风险后点 **查询**。
+2. 查明细：红色标签 **鼠标悬浮**，展示失信类别、列入事由、风险等级。
+3. 当天新增客商：在新增/编辑客商表单填写客商名称后失焦，系统实时查询并在名称下方显示红色风险提示（悬浮见明细）；列表落库数据次日刷新后生效。
+
+![客商风险悬浮明细：被列入外部黑名单（失信类别、列入事由）与风险等级](./2026-10-23-HCS合同管理操作手册（纯操作版）.assets/17-客商风险悬浮明细.png)
+
+> 合同列表“客商风险”列与本页同口径，实时关联客商档案组装（见 3.5 节截图）。数据未刷新或金蝶黑名单类别/事由缺失时只显示等级段，等待次日刷新或联系运维执行刷新。
+
 ---
 
 ## 4. 定时任务与接口（运维视角）
 
-HCS 推送由五个独立定时任务和一组手动接口组成。五个任务各有自己的开关与 cron，互不影响；定时任务、手动接口和审批即时推送共用同一套推送逻辑。
+HCS 推送由五个推送定时任务、一个客商风险每日刷新任务和一组手动接口组成。五个推送任务各有自己的开关与 cron，互不影响；定时任务、手动接口和审批即时推送共用同一套推送逻辑。客商风险刷新任务独立于推送框架（不抢推送锁、不走合规状态回写），详见 4.8。
 
-### 4.1 五类定时任务总览
+### 4.1 定时任务总览
 
 | 任务 | bizType | 扫描对象 | 推送链路（HCS 接口） | 独立开关 | 默认 cron | 手动触发 |
 |---|---|---|---|---|---|---|
 | 项目立项 C102 | `project` | 项目立项：审批通过/变更审批通过，待推送/失败未超限 | C102-3 判重 → C102-1 新建 / C102-2 更新 | `push.project.sync-enabled`（默认 `false`） | `0 */5 * * * ?` | `POST /hcs/sync/project/{id}`、`/hcs/sync/project`、`/hcs/sync/project/batch` |
-| 合同 C103 | `contract` | 合同：审批通过/变更审批通过，待推送/失败未超限；同轮补查特批结果 | C101-1 风险 → C103-2 附件 → C103-3 判重 → C103-1 起草 / C103-11 更新 → C103-9 履约规则（开关）→ 高风险挂特批 | `push.contract.sync-enabled`（默认 `false`） | `0 1/5 * * * ?` | `POST /hcs/sync/contract/{id}`、`/hcs/sync/contract`、`/hcs/sync/contract/batch` |
-| 付款链 C106/C108 | `payment` | 付款申请：审批通过，待推送/失败未超限 | C106-3/C106-4 特批（`hcs_spec_status=need` 时）→ C103-9 履约规则重推 → C108-1/C108-2 履约记录（开关） | `push.payment.sync-enabled`（默认 `false`） | `0 2/5 * * * ?` | `POST /hcs/sync/payment/{id}`、`/hcs/sync/payment` |
+| 合同 C103 | `contract` | 合同：审批通过/变更审批通过，待推送/失败未超限；同轮补查特批结果 | C101-1 风险 → C103-2 附件 → C103-3 判重 → C103-1 起草 / C103-11 更新（含业务合同号、归档状态）→ C103-9 履约规则（开关）→ 高风险挂特批 | `push.contract.sync-enabled`（默认 `false`） | `0 1/5 * * * ?` | `POST /hcs/sync/contract/{id}`、`/hcs/sync/contract`、`/hcs/sync/contract/batch` |
+| 付款链 C106/C108 | `payment` | 付款申请：审批通过，待推送/失败未超限 | C106-3/C106-4 特批（`hcs_spec_status=need` 时）→ 金蝶实际付款门禁 → C103-9 履约规则重推（开关）→ C108-1/C108-2 履约记录（开关） | `push.payment.sync-enabled`（默认 `false`） | `0 2/5 * * * ?` | `POST /hcs/sync/payment/{id}`、`/hcs/sync/payment` |
 | 开票登记 C111 | `invoice-application` | 开票申请：审批通过，待推送/失败未超限 | C111-1 判重 → C111-2 新增 → C111-3 更新（金蝶已开票/已有ID） | `push.invoice-application.sync-enabled`（默认 `false`） | `0 3/5 * * * ?` | `POST /hcs/sync/invoice-application/{id}`、`/hcs/sync/invoice-application` |
 | 收票单 C109 | `invoice-receipt` | 收票单：审批通过，待推送/失败未超限 | C109-1 新建 / C109-2 更新 | `push.invoice-receipt.sync-enabled`（默认 `false`） | `0 4/5 * * * ?` | `POST /hcs/sync/invoice-receipt/{id}`、`/hcs/sync/invoice-receipt` |
+| 客商风险刷新（C101-1 + A801-5） | — | 合同期限内生效合同的甲乙方关联客商 | 逐个 C101-1 风险等级 + 批量 A801-5 金蝶黑名单，落库客商档案 | `risk.refresh-enabled`（默认 `false`） | `0 30 2 * * ?` | 无手动接口（可临时改 cron 或调 `refreshCustomerRiskForActiveContracts()`） |
 
-> - **即时推送**：项目立项、合同审批通过后立即推送（受 `push.immediate-enabled` 控制）；付款申请审批通过后立即发起特批/推送履约数据（**不受**该开关控制）；开票登记、收票单没有即时推送，只能靠定时扫描或手动接口。
-> - 五个扫描开关默认全部 `false`，按业务灰度打开；手动接口不受开关限制。
-> - 只有合同扫描任务额外承担“特批结果兜底查询”，其他任务没有这个动作。
+> - **即时推送**：项目立项、合同审批通过后立即推送（受 `push.immediate-enabled` 控制）；付款申请审批通过后立即发起付款特批/推送合规（**不受**该开关控制，但履约计划与履约记录要等金蝶实际付款后才推送）；开票登记、收票单没有即时推送，只能靠定时扫描或手动接口。
+> - 五个推送扫描开关默认全部 `false`，按业务灰度打开；客商风险刷新开关 `risk.refresh-enabled` 同样默认 `false`（上线需置 `true`）；手动接口不受推送开关限制。
+> - 只有合同扫描任务额外承担“特批结果兜底查询”，其他推送任务没有这个动作。
 
 ### 4.2 公共执行框架
 
@@ -592,10 +649,10 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 **推送逻辑**：
 
 1. **特批挂起门禁**：`hcs_spec_status=processing` 的合同跳过推送，等待特批结果；手动重推直接报“合同特批审核中，禁止重推”。
-2. **客商风险 C101-1**（`contract.require-risk-check=true`）：甲乙双方分别查询；客商档案匹配不到或为内部组织时跳过该方，不阻断；任一方高风险或黑名单只做标记，**不阻断推送**，推送成功后自动转特批。
+2. **客商风险 C101-1**（`contract.require-risk-check=true`）：甲乙双方分别查询；客商档案匹配不到或为内部组织时跳过该方，不阻断；任一方高风险（C101-1 评级）或金蝶黑名单命中（A801-5，`HcsCreditCheckSupport` 公共判定）只做标记，**不阻断推送**，推送成功后自动转特批。
 3. **附件转传 C103-2**（`attachment.transfer-enabled=true`）：附件转传失败会导致整次推送失败。
-4. **首次推送**：无合规合同ID时先调 C103-3 判重（`fdNumber=合同编号`）；命中直接回填已有ID并置已推送，未命中调 C103-1 起草；起草成功后立即回填合规合同ID，再继续后续步骤。
-5. **变更推送**：已有合规合同ID时调 C103-11 更新。
+4. **首次推送**：无合规合同ID时先调 C103-3 判重（`fdNumber=合同编号`）；命中直接回填已有ID并置已推送，未命中调 C103-1 起草；起草成功后立即回填合规合同ID，再继续后续步骤。报文含业务合同号（`fdBusContractNumber`，取值同合同编号）与归档状态（`fdArchiveStatus`，已上传双章归档文件时传 `toarchive` 待归档）。
+5. **变更推送**：已有合规合同ID时调 C103-11 更新，报文同样携带业务合同号与归档状态；已推送合同上传双章归档文件后也会即时单独触发一次 C103-11 归档状态更新（见 3.9 节）。
 6. **履约规则 C103-9**（`exe-stage.sync-enabled=true`）：按履约计划行级新增/更新/删除；无可同步行时返回“履约规则无待同步行”；同步失败会把整条合同置 `failed`。由于第 4 步已先回填合规ID，下一轮重推会走 C103-11 更新，不会重复起草。
 7. **高风险挂起特批**：风险命中时置 `hcs_spec_status=processing`、当前节点“特批审核”，等待 HCS 特批结果。
 
@@ -628,9 +685,10 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 **推送逻辑**：
 
 1. `hcs_spec_status=need`：无特批流程ID（`hcs_spec_fd_id`）时调 C106-3 发起特批，已有特批流程ID时调 C106-4 更新。C106-3 依赖 `spec-pay.template-id` 与关联合同的合规合同ID；成功后回填特批流程ID、置 `processing`、当前节点“特批审核”。
-2. 关联合同已推送合规（合同 `hcs_fd_id` 非空）时，调 C103-9 重推履约规则；无待同步行自动跳过。该动作**不受** `exe-stage.sync-enabled` 控制，与合同任务不同。
-3. `perf-record.sync-enabled=false`：直接置整体 `synced` 结束；`true`：无履约记录ID调 C108-1 新建，已有调 C108-2 更新。
-4. 整体合规状态 `synced` 只代表本轮推送完成，**不代表特批已通过**；特批中（`processing`）的付款也可能显示已推送。
+2. **金蝶实际付款门禁**：付款审批通过只做本地计划金额累加，`paid_amount` 为空或 ≤0 时履约计划与履约记录均不推送，整体照常回写 `synced`，结果说明为“金蝶未实际付款，待付款后推送履约计划与履约记录”；金蝶付款回写推进后会重新置待同步，由扫描任务自动触发再次推送。
+3. 关联合同已推送合规（合同 `hcs_fd_id` 非空）且通过实付门禁时，调 C103-9 重推履约规则；无待同步行自动跳过。该动作受 `exe-stage.sync-enabled` 控制，与合同链、收款链一致。
+4. `perf-record.sync-enabled=false`：直接置整体 `synced` 结束；`true`：无履约记录ID调 C108-1 新建，已有调 C108-2 更新。
+5. 整体合规状态 `synced` 只代表本轮推送完成，**不代表特批已通过、也不代表已实际付款**；特批中（`processing`）或未实付的付款也可能显示已推送。
 
 **特批结果**：HCS 通过 `paymentLegal/result` 回调，或用 `/hcs/spec-pay/confirm` 人工确认。通过后恢复“审批通过”并重新触发金蝶自动同步；驳回后付款审批状态置 `returned`（已驳回），需修改后重新提交审批、重新发起特批。
 
@@ -686,7 +744,22 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 | `POST /hcs/sync/invoice-receipt/{id}` | 单条重推 | 仅 `approved` 可推；先重置 `unsynced`、失败次数清零 |
 | `POST /hcs/sync/invoice-receipt` | 按扫描逻辑推一轮 | 不检查开关、不抢任务锁；**无批量 ID 接口** |
 
-### 4.8 配置项
+### 4.8 客商风险每日刷新任务（C101-1 + A801-5）
+
+**任务类**：`CustomerRiskRefreshTask`；**开关**：`risk.refresh-enabled`（默认 `false`，上线需置 `true`）；**调度**：`risk.refresh-cron`（默认 `0 30 2 * * ?`，每天 02:30，错开金蝶客商同步 02:00）。
+
+**刷新范围**：合同期限内（起止日期或临时期限覆盖当天）且审核通过、未终止的合同，其甲乙方关联客商；内部组织客商跳过（默认无风险）。
+
+**执行逻辑**：
+
+1. 一次 SQL 取期限内生效合同的甲乙方名称，按名称反查客商档案。
+2. 外部客商按 **200/批**：每批调一次 A801-5 金蝶黑名单批量查询 + 逐个调 C101-1 风险等级查询（该接口仅支持单编号）。
+3. 批内结果立即落库 `blade_customer_archive`（`hcs_risk_level`、`kingdee_black_status`、`hcs_risk_time`、`kingdee_black_category`、`kingdee_black_reason`）并留痕 `blade_hcs_check_log`；**批间互不影响，单批失败不中断其余批次**。
+4. 该任务不走推送框架：不抢推送任务锁、不改单据合规状态、无手动触发接口；临时补刷可把 `refresh-cron` 改为近时刻执行后改回，或调用 `HcsCreditCheckSupport#refreshCustomerRiskForActiveContracts()`。
+
+**结果用途**：客商档案/合同列表“客商风险”列展示与筛选、红色标签悬浮明细、合同推送与付款提交的风险判定数据源。查询逐次留痕，日志关键字“定时刷新客商风险”。
+
+### 4.9 配置项
 
 > 下表键名省略公共前缀 `thirdParty.hcs.`。例如 `push.immediate-enabled` 的完整键为 `thirdParty.hcs.push.immediate-enabled`。
 
@@ -708,7 +781,7 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 | `attachment.file-download-base` | 空 | TMS 文件下载基址 | 有附件时转传失败 |
 | `master-data.ttl-minutes` | `120` | 模板/分类/币种缓存时长 | 主数据变更最长延迟 120 分钟生效 |
 
-**五个任务开关与 cron**
+**五个推送任务与风险刷新开关、cron**
 
 | 任务 | 开关（默认） | cron 键 | 默认 cron |
 |---|---|---|---|
@@ -717,16 +790,17 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 | 付款链 | `push.payment.sync-enabled`（`false`） | `push.payment.cron` | `0 2/5 * * * ?` |
 | 开票登记 | `push.invoice-application.sync-enabled`（`false`） | `push.invoice-application.cron` | `0 3/5 * * * ?` |
 | 收票单 | `push.invoice-receipt.sync-enabled`（`false`） | `push.invoice-receipt.cron` | `0 4/5 * * * ?` |
+| 客商风险刷新 | `risk.refresh-enabled`（`false`，上线置 `true`） | `risk.refresh-cron` | `0 30 2 * * ?` |
 
-> 五个开关默认全关，按业务灰度打开；cron 不配置时使用代码默认值（每 5 分钟，分钟位 0–4 错峰）。
+> 五个推送开关默认全关，按业务灰度打开；客商风险刷新上线需单独开启。推送 cron 不配置时使用代码默认值（每 5 分钟，分钟位 0–4 错峰）。
 
 **各任务业务配置**
 
 | 配置键 | 默认/样例 | 影响任务 | 说明 |
 |---|---|---|---|
 | `project.template-code` | `template_15x0og` | 项目立项 C102-1 | 未配置时推送失败 |
-| `contract.template-mapping` | 样例仅 `[承运商合同]` | 合同 C103-1 | 合同类别未映射必失败；中文键必须写成 `"[承运商合同]"` |
-| `contract.currency-name-mapping` | `RMB→人民币`（另一环境样例 `CNY`） | 合同 C103-1 | 币种传错或为空；上线前与合规方确认取值 |
+| `contract.template-mapping` | 样例含 `[承运商合同]`、`[客户合同]` | 合同 C103-1 | 合同类别未映射必失败；中文键必须写成 `"[承运商合同]"` |
+| `contract.currency-name-mapping` | `RMB`/`CNY`→人民币，`USD`→美元 | 合同 C103-1 | 币种传错或为空；上线前与合规方确认取值 |
 | `contract.require-risk-check` | `true` | 合同 C101-1 | 关闭后不做风险校验，高风险合同不会触发特批 |
 | `exe-stage.sync-enabled` | `false` | 合同 C103-9 | 关闭时合同任务不推履约规则 |
 | `exe-stage.fund-type` | `byAmount` | 合同 C103-9 | 金额类型传错会被合规校验拒绝 |
@@ -745,20 +819,22 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 
 > 不同环境样例中的币种名称映射可能不同（`CNY` 与 `人民币`），上线前必须与合规方确认 HCS 主数据实际取值。
 
-### 4.9 运维注意
+### 4.10 运维注意
 
-- **开关灰度**：五个扫描开关默认全关且互相独立；项目立项/合同的即时推送受 `push.immediate-enabled` 控制，付款审批即时特批不受该开关控制；手动接口始终可用，不受开关限制。
+- **开关灰度**：五个推送扫描开关默认全关且互相独立；项目立项/合同的即时推送受 `push.immediate-enabled` 控制，付款审批即时特批不受该开关控制；客商风险刷新开关 `risk.refresh-enabled` 上线需单独置 `true`；手动接口始终可用，不受推送开关限制。
 - **先看存量再开扫描**：扫描不区分“从未推送”和“推送失败”，开关一开，所有审批通过且未同步的历史单据都会进入扫描范围（每轮最多 50 条）。上线前先确认待推送数据量。
 - **修复根因优先**：失败单据每 5 分钟自动重试，达到 `push.max-retry`（默认 5）后停止；人工重推会清零次数，但不修复配置/数据会反复失败。
 - **付款依赖合同**：C106-3 要求关联合同已有合规合同ID，C103-9 也以合同 `hcs_fd_id` 为前提；合同未推送合规时付款特批/履约规则相关步骤会失败或跳过。
+- **付款履约数据看实付**：付款链履约计划/履约记录以金蝶实际付款为门禁，未实付时整体状态照常回写 `synced`，不要把“金蝶未实际付款，待付款后推送…”当失败处理。
+- **客商风险刷新依赖合同范围**：刷新范围是合同期限内生效合同的关联客商，期限外客商风险列显示“-”属正常；金蝶黑名单类别/事由来自 A801-5，缺失时列表只显示等级段。客商黑名单与风险等级专项说明见《2026-10-30-客商黑名单与风险等级运维手册（运维侧）》（doc/docs/业务流程/）。
 - **开票必配币种映射**：`invoice.currency-id-mapping` 的 `RMB` 必须配置为 HCS 币种 fdId，否则开票登记每轮都会失败。
 - **收票合同关联**：回溯不到合同且未人工补录 `hcs_contract_id` / `hcs_contract_no` 时不会失败，但合同字段为空；需要完整合同信息时先补录再重推。
-- **模板映射逐个类别确认**：样例只配了承运商合同；客户合同、补充协议未配置时推送必失败。Nacos YAML 中文键必须写成 `"[承运商合同]"`。
+- **模板映射逐个类别确认**：样例只配了承运商合同、客户合同；补充协议未配置时推送必失败。Nacos YAML 中文键必须写成 `"[承运商合同]"`。
 - **附件下载基址必配**：合同有附件时，`attachment.file-download-base` 为空会导致附件转传失败。
 - **生产禁用 Mock**：`thirdParty.hcs.mock-enabled` 生产环境必须为 `false`。
 - **主数据刷新**：模板映射调整后，可调用 `POST /hcs/master-data/refresh` 刷新模板/分类/币种缓存并校验映射。
 - **多实例与手动接口**：定时任务按 bizType 抢 Redis 锁（TTL 240 秒），抢不到本轮跳过；手动接口不抢锁，避免与定时任务同一时刻执行。
-- **日志排查**：服务日志按单据编号、合规ID、`hcs` 关键字检索；本地日志目录为 `F:\home\tms\blade-transport`。
+- **日志排查**：服务日志按单据编号、合规ID、`hcs` 关键字检索；客商风险刷新日志按“定时刷新客商风险”检索；本地日志目录为 `F:\home\tms\blade-transport`。
 
 ---
 
@@ -775,7 +851,7 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 | 提示“合同类别 [xxx] 未配置合规模板ID” | Nacos 模板映射缺该类合同 | 运维补齐 `contract.template-mapping` 后重推 |
 | 提示附件转传失败 | 下载基址为空、附件不可下载、文件超限或 HCS 附件接口异常 | 检查 `attachment.file-download-base` 和附件，修正后重推 |
 | 提示 C101-1 客商风险查询失败 | HCS 风险接口异常/无响应 | 联系 HCS 侧确认接口，恢复后重推 |
-| 高风险客商没有触发特批 | 客商名称与档案不匹配导致风险校验被跳过，或 HCS 返回的风险等级不是高风险/黑名单 | 核对甲乙方名称与客商档案；在 HCS 侧确认客商风险等级和黑名单状态 |
+| 高风险客商没有触发特批 | 客商名称与档案不匹配导致风险校验被跳过，或风险等级不是高风险且未命中金蝶黑名单 | 核对甲乙方名称与客商档案；黑名单以金蝶黑名单命中（A801-5）为准，核对客商档案金蝶黑名单字段与 HCS 风险等级 |
 | 提示 C103-1/C103-11 合同发起/更新失败 | HCS 业务校验不通过 | 按返回 msg 修正模板、字段或主数据后重推 |
 | 特批状态一直是“待特批” | 存量数据或推送未成功，未进入特批流程 | 联系管理员重新推送；推送成功后会自动转“特批中” |
 | 特批中想重推 | 特批流程未结束 | 不允许重推，等待 HCS 回传或人工确认结果 |
@@ -799,6 +875,9 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 | 付款审批提示“已发起付款特批”但迟迟没有金蝶单据 | 特批仍在审批，特批通过后才同步金蝶 | 等待特批结果；长时间无结果联系实施人工确认 |
 | 付款特批发起失败（模板未配/合同未推送） | `spec-pay.template-id` 为空或关联合同无合规ID | 运维修复后重推；不要重复审批 |
 | 付款特批中能否重复审批 | 特批中审核状态已是“审批通过” | 不需要也不能重复审批；等待 HCS 结果 |
+| 客商档案/合同列表“客商风险”列显示“-” | 客商不在合同期限内生效合同关联范围，或档案刚创建未被每日刷新任务查询过 | 等次日 02:30 刷新；当天可在客商表单按名称实时查询风险提示 |
+| 客商命中金蝶黑名单但列表没有“黑名单” | 黑名单展示依赖金蝶记录的失信类别/列入事由（每日刷新落库），数据缺失时只显示等级段 | 等待次日刷新或联系运维执行刷新；确认 `risk.refresh-enabled` 已开启 |
+| 付款特批通过后合规里没有履约计划/履约记录 | 付款链履约数据以金蝶实际付款为门禁，未实付不推送 | 正常等待金蝶付款回写后自动推送；整体状态显示“金蝶未实际付款，待付款后推送履约计划与履约记录”属正常 |
 
 ---
 
@@ -825,6 +904,8 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 | 付款申请表单 | 附件类型“特批附件” | 高风险/黑名单收款方提交前必传 |
 | 付款申请列表 | 行内“通过” | 审批通过后自动发起付款特批 |
 | 付款申请列表 | “当前节点”列 | 查看“特批审核/审批通过/已驳回”判断特批进度 |
+| 客商档案列表 | 搜索栏“客商风险”筛选 | 按黑名单/高风险/中风险/低风险筛选客商（数据每日 02:30 刷新） |
+| 客商档案列表 | 客商风险列红色标签悬浮 | 查看失信类别、列入事由、风险等级明细 |
 | 运维专用 | `POST /hcs/sync/project/{id}` | 单条重推项目立项 |
 | 运维专用 | `POST /hcs/sync/project/batch` | 按勾选ID批量重推项目立项 |
 | 运维专用 | `POST /hcs/spec-pay/confirm` | 人工确认付款特批结果（参数 `id`、`result`；页面无按钮） |
@@ -838,4 +919,4 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 
 ---
 
-> 本文基于 2026-10-23 代码与页面现状整理；按钮、提示和环境开关以实际页面为准。临时合同推送、旧版“发起特批”入口、变更页“终止合同”未开放属于当前版本现状，后续版本调整时请同步核对。
+> 本文基于 2026-10-23 代码与页面现状整理，2026-11-01 按最新实现更新（客商风险口径、归档即时同步、付款履约实付门禁、客商风险刷新任务）；按钮、提示和环境开关以实际页面为准。临时合同推送、旧版“发起特批”入口、变更页“终止合同”未开放属于当前版本现状，后续版本调整时请同步核对。