fix: 合同文档提交

2026-10-23 19:03:45 +08:00
parent dc262f2377
commit 68061aea58
1 changed files with 201 additions and 7 deletions
@@ -3,11 +3,17 @@
 > 整理日期：2026-10-23
 > 适用对象：合同经办人、合同负责人、合同审批人、合规管理员、实施运维。
 > 本文只讲**怎么操作**：在哪个页面、点什么按钮、前提是什么、成功的标志是什么、失败了怎么处理。
-> 第 1–3 节为业务操作；第 4 节为实施运维使用的五类 HCS 定时任务逻辑、接口与配置。
+> 第 1–3 节为业务操作（合同、项目立项、付款特批）；第 4 节为实施运维使用的五类 HCS 定时任务逻辑、接口与配置。
 > 完整字段说明、状态字典与流程背景见同目录《2026-10-23-HCS合同管理操作手册》；接口与代码细节见同目录 HCS 相关梳理文档。

 ---

+合同系统
+    sit环境
+        https://contract-sit.gxwuzi.com/   13737128880  Mk13737128880@
+
+
+
 ## 1. 全局须知

 TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）。HCS 完成客商风险校验、合同合规校验、特批和金蝶同步，并把合规合同ID、金蝶合同ID、特批结果回写到 TMS。
@@ -29,6 +35,8 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）
 | approved | 特批通过 | 特批完成 | 合同恢复“审批通过”，继续后续流程 |
 | rejected | 特批驳回 | 特批未通过 | 合同审批联动“已驳回”，修改后重新提交、重新推送 |

+> 合同特批与付款特批使用同一组状态值。付款申请页面没有独立“特批状态”列，审批通过后看列表“当前节点”：显示“特批审核”即为特批中；通过后恢复“审批通过”，驳回则审核状态变为“已驳回”。
+
 ### 1.3 三条推送路径

 | 路径 | 触发时机 | 前提 | 说明 |
@@ -37,7 +45,11 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）
 | 定时扫描推送 | 每 5 分钟 | `thirdParty.hcs.push.contract.sync-enabled=true` | 扫“待推送/推送失败未超限”的合同；同时兜底查询特批结果 |
 | 手动推送 | 随时 | 合同已审批通过且未同步 | 列表“推送合规”或工具栏“批量推送合规” |

-三条路径共用同一套推送逻辑；HCS 侧有判重，重复触发不会重复生成合同。即时推送目前只覆盖合同和项目立项，付款链、开票登记、收票单没有即时推送，只能靠定时扫描或手动接口。
+三条路径共用同一套推送逻辑；HCS 侧有判重，重复触发不会重复生成合同。
+
+- **项目立项**：审批通过后即时推送（受 `push.immediate-enabled` 控制），另有定时扫描和列表手动/批量推送。
+- **付款申请**：审批通过后**无论 `push.immediate-enabled` 是否开启**都会立即发起付款特批/推送履约数据；定时扫描只做失败补偿。
+- **开票登记、收票单**：没有即时推送，只能靠定时扫描或手动接口。

 ### 1.4 硬规则

@@ -48,6 +60,10 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）
 - 合同类别必须在 Nacos 配置 HCS 模板映射，否则每次推送都会失败。
 - 推送失败默认自动重试，最多 5 次；超过后只能人工重推。人工重推会把失败次数清零。
 - 当前版本临时合同审批通过后也会进入推送范围（合规状态会变为待推送/已推送），不要因为合同是临时合同就忽略合规状态。
+- 项目立项只有审核状态为“审批通过/变更审批通过”才能推送；变更审批通过后按已有合规项目ID更新 HCS。
+- 付款申请收款方为高风险/黑名单客商时，提交前必须上传“特批附件”，否则提交被拦截。
+- 付款申请审批通过后系统自动发起付款特批；特批中“当前节点”为“特批审核”，特批未通过前不推送履约数据、不同步金蝶。
+- 付款特批驳回后付款申请变“已驳回”，修改后重新提交审批会重新发起特批。

 ### 1.5 推送与环境前提

@@ -63,6 +79,19 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）

 - 甲乙双方名称应能在客商档案中匹配到（全称或简称）。匹配不到不会阻断推送，但会**跳过该方风险校验**，可能导致高风险/黑名单客商未被识别、未触发特批。

+**项目立项推送需要：**
+
+1. 项目审核状态为“审批通过”或“变更审批通过”。
+2. 项目编号不为空（HCS 以项目编号判重）。
+3. `thirdParty.hcs.project.template-code` 已配置。
+4. HCS 连接配置可用。
+
+**付款特批需要：**
+
+1. 付款申请关联合同已推送合规（合同有合规合同ID）。
+2. `thirdParty.hcs.spec-pay.template-id` 已配置，付款用途/性质/类型字典值正确。
+3. 收款方为高风险/黑名单时，已上传“特批附件”。
+
 ---

 ## 2. 一次性准备（实施/管理员操作）
@@ -76,9 +105,13 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）
 | 5 | 币种映射 | 运维 | `thirdParty.hcs.contract.currency-name-mapping`（如 RMB→人民币） | 币种传错或为空 |
 | 6 | 风险校验开关 | 运维 | `thirdParty.hcs.contract.require-risk-check` 保持 `true` | 关闭后高风险合同不会触发特批 |
 | 7 | 履约计划同步 | 运维 | `thirdParty.hcs.exe-stage.sync-enabled`，一期默认 `false` | 不推送 C103-9 履约计划，不影响合同主流程 |
-| 8 | 推送开关 | 运维 | 按需开启 `push.immediate-enabled`、`push.contract.sync-enabled` | 只能靠手动按钮推送 |
+| 8 | 推送开关 | 运维 | 按需开启 `push.immediate-enabled`（项目/合同即时）、`push.project/contract/payment.sync-enabled`（定时扫描） | 只能靠手动按钮推送；付款审批即时特批不受 `push.immediate-enabled` 控制 |
 | 9 | 客商档案 | 业务 | 确保合同甲乙方名称与客商档案全称或简称一致 | 风险校验取不到客商，无法判定高风险/黑名单 |
 | 10 | 菜单与按钮权限 | 管理员 | 为经办人、审批人、合规管理员配置对应角色权限 | 页面看不到新增、审批或推送合规入口 |
+| 11 | 项目立项模板编码 | 运维 | `thirdParty.hcs.project.template-code`（环境值，向合规方获取） | 项目立项推送必失败 |
+| 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` | 关闭时超额付款不会自动进入特批 |

 > 模板映射的中文键在 Nacos YAML 中必须使用括号写法，例如 `"[承运商合同]": "模板ID"`，否则配置无法正确绑定。
 >
@@ -352,6 +385,146 @@ TMS 合同审批通过后，合同会推送到桂物合同合规系统（HCS）

 ![合同详情附件区：可查看、下载用印材料和佐证材料](./2026-10-23-HCS合同管理操作手册（纯操作版）.assets/07-合同详情-附件佐证材料.png)

+### 3.10 项目立项同步 HCS
+
+**页面：项目管理（`/business/project-apply`）**
+
+项目立项审批通过后，TMS 把项目信息推送到 HCS（C102）。项目没有客商风险特批；首次推送先按项目编号判重，变更审批通过后更新已推送项目。
+
+**前提：**
+
+- 项目审核状态为“审批通过”或“变更审批通过”。
+- 项目编号不为空（HCS 以项目编号判重）。
+- Nacos `thirdParty.hcs.project.template-code` 已配置。
+- HCS 连接配置可用。
+
+**推送方式：**
+
+| 方式 | 触发时机 | 说明 |
+|---|---|---|
+| 审批通过自动推送 | 审批人点“通过” | 受 `push.immediate-enabled` 控制；开启时页面显示“正在推送合规，请稍候…” |
+| 定时扫描 | 开关 `push.project.sync-enabled=true` | 每 5 分钟扫“待推送/推送失败未超限”的项目 |
+| 单条手动推送 | 列表行内“推送合规” | 审批通过且合规状态不是“已推送”时显示 |
+| 批量推送 | 勾选后工具栏“批量推送合规” | 选中项必须全部满足推送条件，否则整批提示不符合条数 |
+
+> 若启用 MK 审批，列表显示“流程”而不是“通过”，在外部审批页通过后同样会触发推送。
+
+**审批人操作：**
+
+1. 在项目列表操作列点 **通过**。
+2. 如开启即时推送，等待“正在推送合规，请稍候…”结束，不要重复点击。
+3. 根据提示判断：
+
+| 提示 | 含义 | 处理 |
+|---|---|---|
+| 通过成功 | 审批完成；即时推送成功，或当前未开启即时推送 | 查看合规状态；未推送则手动推或等待扫描 |
+| 审批通过，但合规推送失败：xxx | 审批已生效，HCS 推送失败 | 按原因修复后点“推送合规”，**不要重复审批** |
+
+**手动推送：**
+
+1. 合规状态筛选 **待推送** 或 **推送失败**；失败原因可悬停合规状态查看。
+2. 点行内 **推送合规** → 在确认弹窗点“确定” → 等待遮罩结束。
+3. 成功提示可能为：
+   - `项目立项新建成功：项目编号`：首次推送并在 HCS 新建成功。
+   - `项目立项更新成功：项目编号`：已有合规项目ID，按变更更新成功。
+   - `判重命中，回填已有合规项目ID`：HCS 已存在相同项目编号，直接回填，不重复新建。
+
+**成功标志：** 合规状态变为 **已推送**。列表中的“金蝶项目ID”“金蝶项目编号”由 HCS 金蝶同步结果回填，可能延迟；推送成功不代表金蝶项目已创建。
+
+**项目变更：**
+
+1. 审核状态为“审批通过/变更审批通过”的项目，点行内 **变更**。
+2. 修改后提交，审批人点 **通过**。
+3. 已有合规项目ID时更新 HCS（C102-2）；从未推送过的项目按首次推送处理（先判重，再新建）。
+
+**常见失败处理：**
+
+| 提示 | 原因 | 处理 |
+|---|---|---|
+| 立项表单模板编码未配置 | `project.template-code` 为空 | 运维补齐配置后重推 |
+| C102-3 项目立项判重查询失败 | HCS 查询接口异常/超时 | 稍后重推；持续失败联系 HCS 侧 |
+| C102-1 项目立项新建失败 | HCS 返回模板、必填字段或主数据校验错误 | 按返回 msg 修正项目数据后重推 |
+| C102-2 项目立项更新失败 | 变更数据不符合 HCS 校验 | 按返回 msg 修正后重新提交变更 |
+| 网络超时/连接失败 | HCS 服务不可用或网络抖动 | 恢复后重推；扫描开启时也会自动重试 |
+
+> 项目推送没有 HCS 特批环节；但 HCS 可能存在同名项目编号，手动重推会先判重，不会重复创建。失败超过 5 次后不再自动重试，需人工重推（会清零次数）。
+
+### 3.11 付款特批
+
+**页面：付款管理 → 付款申请（`/payment/payment-application`）**
+
+付款特批由付款申请审批通过后**自动发起**，页面没有独立“发起特批”按钮。是否需要特批，在提交和审批时由收款方风险、合同额度共同决定。
+
+**触发条件：**
+
+- 收款方为外部客商，C101-1 返回 **高风险** 或 **黑名单**：提交前必须上传“特批附件”，提交后标记为待特批。
+- 申请金额超出合同额度（C106-1，`credit.check-enabled=true`）：不拦截提交，自动转特批。
+- 收款方为内部组织客商时不查风险，也不会因风险触发特批。
+
+**提交前：**
+
+1. 新增或编辑付款申请，选择收款方。
+2. 基本信息出现“风险客商提示”时，在“附件”区新增一行，**附件类型选择“特批附件”**，上传特批材料。
+3. 提交审批；未上传特批附件会被拦截：
+
+> 收款方[xxx]为高风险/黑名单客商，必须上传「特批附件」类型附件后再提交审批
+
+**审批人操作：**
+
+1. 在付款申请列表操作列点 **通过**（启用 MK 审批时为“流程”，在外部审批页通过）。
+2. 审批生效后，系统立即发起付款特批（C106-3），**不受 `push.immediate-enabled` 开关控制**，无需人工发起。
+3. 根据审批响应提示判断：
+
+| 提示 | 含义 | 后续 |
+|---|---|---|
+| 审批通过，已发起付款特批，特批通过后将自动推送履约数据并同步金蝶 | 特批已发起 | 列表“当前节点”显示“特批审核”，等待结果 |
+| 审批通过，付款特批待发起，可在详情页重推合规 | 特批尚未发起（并发跳过或前置条件不满足） | 当前页面没有重推按钮；联系实施检查模板、合同合规ID后重推 |
+| 审批通过，但发起付款特批/推送合规失败：xxx，可稍后重推合规 | 审批已生效，特批发起或推送失败 | 按原因修复后联系实施重推，**不要重复审批** |
+| 审批通过，已同步金蝶：xxx / 审批通过，但自动同步金蝶失败：xxx | 未走特批，直接同步金蝶的结果 | 金蝶失败按提示原因处理 |
+| 审批通过 | 无特批、也没有即时同步结果 | 查看“当前节点”和金蝶单据状态 |
+
+**如何判断特批进度：**
+
+付款申请列表没有独立“特批状态”列，查看 **当前节点**：
+
+| 当前节点 | 审核状态 | 含义 |
+|---|---|---|
+| 特批审核 | 审批通过 | 特批中，等待 HCS 回传或人工确认 |
+| 审批通过 | 审批通过 | 特批已通过，或本单无需特批 |
+| 已驳回 | 已驳回 | 特批驳回，需要修改后重新提交 |
+
+> 特批中审核状态仍显示“审批通过”，不能只看审核状态判断流程是否结束。
+
+**特批通过后：**
+
+1. 当前节点恢复“审批通过”。
+2. 系统自动补推履约计划（C103-9）和履约记录（C108，若开启），并自动同步金蝶。
+3. 金蝶单据号、金蝶单据状态稍后回填，可刷新列表查看。
+
+**特批驳回后：**
+
+1. 审核状态变为 **已驳回**，当前节点“已驳回”。
+2. 点 **编辑** 修改付款申请，必要时重新上传特批附件。
+3. 重新 **提交** → 审批人再次 **通过**，系统会重新发起一张特批单，不复用旧特批单。
+
+**特批中注意：**
+
+- 特批未通过前不推送履约数据、不同步金蝶，这是正常等待，不是推送失败。
+- 不要重复审批；特批中审核状态已是“审批通过”，列表不会再显示“通过”。
+- 特批中请先等待结果；确需作废或终止，先联系实施确认 HCS 侧特批单的处理，避免状态冲突。
+
+**结果一直未回传：**
+
+HCS 正常情况下通过 `paymentLegal/result` 回传结果。长时间停留在“特批审核”时联系实施，用 `POST /hcs/spec-pay/confirm` 人工确认结果（`approved`/`rejected`）；当前付款页面没有人工确认按钮。
+
+**实施前置条件：**
+
+- 关联合同已推送合规，合同有合规合同ID。
+- `thirdParty.hcs.spec-pay.template-id` 已配置。
+- `spec-pay.payment-purpose`、`payment-nature`、`payment-type` 字典值正确。
+
+任一条件不满足时，审批仍会成功，但特批发起失败；按审批提示或日志修复后重推。
+
 ---

 ## 4. 定时任务与接口（运维视角）
@@ -368,7 +541,7 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 | 开票登记 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` |

-> - **即时推送只有项目立项和合同**：审批通过后立即推送（受 `push.immediate-enabled` 控制）。付款链、开票登记、收票单没有即时推送，只能靠定时扫描或手动接口。
+> - **即时推送**：项目立项、合同审批通过后立即推送（受 `push.immediate-enabled` 控制）；付款申请审批通过后立即发起特批/推送履约数据（**不受**该开关控制）；开票登记、收票单没有即时推送，只能靠定时扫描或手动接口。
 > - 五个扫描开关默认全部 `false`，按业务灰度打开；手动接口不受开关限制。
 > - 只有合同扫描任务额外承担“特批结果兜底查询”，其他任务没有这个动作。

@@ -450,7 +623,7 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务

 **扫描条件**：付款申请审核状态仅 `approved`（不含变更状态），合规状态为 `unsynced` / `failed`，失败次数未超限；单轮最多 `batch-size` 条。

-**特批从哪来**：付款提交时，收款方为高风险/黑名单（`risk.check-on-payment=true`，须先上传特批附件）或额度超额（`credit.check-enabled=true`）会置 `hcs_spec_status=need`。扫描任务负责把 `need` 的付款发起特批。
+**特批从哪来**：付款提交时，收款方为高风险/黑名单（`risk.check-on-payment=true`，须先上传特批附件）或额度超额（`credit.check-enabled=true`）会置 `hcs_spec_status=need`。审批通过时由审批接口（或 MK 审批回调）即时发起 C106-3，**不受 `push.immediate-enabled` 控制**；扫描任务负责失败补偿和存量 `need` 数据。

 **推送逻辑**：

@@ -528,7 +701,7 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 | `operator-login-name` | `srvadmin`（环境可改） | 操作人登录名 | 合规侧操作人异常 |
 | `creator-unit-id/name` | 环境固定值 | 创建单位 | 合同创建单位错误 |
 | `mock-enabled` | `false`（开发样例 `true`） | Mock 模式开关 | 生产误开会导致推送走本地桩，不真正调用 HCS |
-| `push.immediate-enabled` | `false`（开发样例 `true`） | 审批通过即时推送 | 只影响项目立项和合同；关闭后等扫描或手动 |
+| `push.immediate-enabled` | `false`（开发样例 `true`） | 审批通过即时推送 | 只影响项目立项和合同；关闭后等扫描或手动。付款审批即时特批不受此开关控制 |
 | `push.batch-size` | `50` | 单轮扫描条数上限 | 积压数据需多轮处理 |
 | `push.max-retry` | `5` | 失败自动重试上限 | 超限后仅能人工重推 |
 | `attachment.transfer-enabled` | `true` | 附件转传总开关 | 关闭后合同/开票附件不转传 |
@@ -574,7 +747,7 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务

 ### 4.9 运维注意

- **开关灰度**：五个扫描开关默认全关且互相独立；即时推送只有项目立项和合同，受 `push.immediate-enabled` 控制；手动接口始终可用，不受开关限制。
+- **开关灰度**：五个扫描开关默认全关且互相独立；项目立项/合同的即时推送受 `push.immediate-enabled` 控制，付款审批即时特批不受该开关控制；手动接口始终可用，不受开关限制。
 - **先看存量再开扫描**：扫描不区分“从未推送”和“推送失败”，开关一开，所有审批通过且未同步的历史单据都会进入扫描范围（每轮最多 50 条）。上线前先确认待推送数据量。
 - **修复根因优先**：失败单据每 5 分钟自动重试，达到 `push.max-retry`（默认 5）后停止；人工重推会清零次数，但不修复配置/数据会反复失败。
 - **付款依赖合同**：C106-3 要求关联合同已有合规合同ID，C103-9 也以合同 `hcs_fd_id` 为前提；合同未推送合规时付款特批/履约规则相关步骤会失败或跳过。
@@ -615,6 +788,17 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 | “流程”提示流程实例为空 | 合同未关联外部审批流程实例 | 以列表/详情的审核状态和当前节点为准；需要流转记录联系管理员 |
 | 变更页面“终止合同”不能提交 | 当前版本未开放终止入口 | 选择“合同信息变更”；确需终止联系管理员 |
 | 临时合同审批通过后也变成待推送/已推送 | 当前实现按审批状态扫描，未按合同阶段过滤 | 属当前版本行为，按合规状态正常处理即可 |
+| 项目审批通过后合规状态一直“待推送” | 未开启即时推送或项目扫描未开启/未到执行时间 | 列表点“推送合规”；或让运维开启 `push.project.sync-enabled` |
+| 项目推送成功但“金蝶项目ID”为空 | 金蝶同步结果尚未回传 | 稍后刷新；长时间为空联系管理员 |
+| 项目列表没有“推送合规”按钮 | 不是审批通过/变更审批通过，或已是“已推送” | 先完成审批；已推送项目需修改走“变更” |
+| 项目提示“立项表单模板编码未配置” | `project.template-code` 为空 | 运维补齐配置后重推 |
+| 付款审批通过后当前节点显示“特批审核” | 高风险/黑名单或额度超额，系统已自动发起付款特批 | 正常等待；特批通过后自动推送履约数据并同步金蝶 |
+| 付款页面看不到“特批状态” | 付款页面没有独立特批状态列 | 看列表“当前节点”；特批中为“特批审核”，审核状态仍是“审批通过” |
+| 高风险收款方提交付款被拦截 | 未上传“特批附件” | 在附件区新增一行，类型选“特批附件”后重新提交 |
+| 付款特批被驳回，审核状态变“已驳回” | HCS 特批未通过 | 编辑修改后重新提交、重新审批，系统会重新发起特批 |
+| 付款审批提示“已发起付款特批”但迟迟没有金蝶单据 | 特批仍在审批，特批通过后才同步金蝶 | 等待特批结果；长时间无结果联系实施人工确认 |
+| 付款特批发起失败（模板未配/合同未推送） | `spec-pay.template-id` 为空或关联合同无合规ID | 运维修复后重推；不要重复审批 |
+| 付款特批中能否重复审批 | 特批中审核状态已是“审批通过” | 不需要也不能重复审批；等待 HCS 结果 |

 ---

@@ -634,6 +818,16 @@ HCS 推送由五个独立定时任务和一组手动接口组成。五个任务
 | 合同管理列表 | 工具栏“批量推送合规” | 勾选多条合同批量推送 |
 | 合同管理列表 | 审批中行内“通过/驳回/撤回” | 审批合同；通过时尝试推送 HCS |
 | 合同详情 | 合规信息“确认特批结果” | 特批中人工确认 `approved`/`rejected` |
+| 项目管理列表 | 行内“通过” | 审批项目；通过时尝试推送 HCS |
+| 项目管理列表 | 行内“推送合规” | 单条推送/重推项目立项 |
+| 项目管理列表 | 工具栏“批量推送合规” | 勾选多条项目批量推送 |
+| 项目管理列表 | 行内“变更” | 项目变更；审批通过后更新 HCS |
+| 付款申请表单 | 附件类型“特批附件” | 高风险/黑名单收款方提交前必传 |
+| 付款申请列表 | 行内“通过” | 审批通过后自动发起付款特批 |
+| 付款申请列表 | “当前节点”列 | 查看“特批审核/审批通过/已驳回”判断特批进度 |
+| 运维专用 | `POST /hcs/sync/project/{id}` | 单条重推项目立项 |
+| 运维专用 | `POST /hcs/sync/project/batch` | 按勾选ID批量重推项目立项 |
+| 运维专用 | `POST /hcs/spec-pay/confirm` | 人工确认付款特批结果（参数 `id`、`result`；页面无按钮） |
 | 运维专用 | `POST /hcs/sync/contract/{id}` | 单条重推合同 |
 | 运维专用 | `POST /hcs/sync/contract` | 按扫描逻辑推送一轮待同步/失败合同 |
 | 运维专用 | `POST /hcs/sync/contract/batch` | 按勾选ID批量重推（请求体为ID数组） |