b2894lxlx/tms-erp-api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 同步付款特批通过后不推履约数据的口径与验证步骤

Browse Source
This commit is contained in:
刘泉佳
2026-10-29 11:04:10 +08:00
parent 3f571449d3
commit 4d16030999
1 changed files with 13 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/docs/hcs合同/2026-10-28-C108履约记录四场景推送改造流程梳理（收款-付款-开票-收票）.md
+13 -10
View File
@@ -28,7 +28,7 @@ C108-1（履约记录新建）、C108-2（履约记录更新）两个接口需
| 场景 | 改造前 | 改造后 |
|------|--------|--------|
| 收款 | 已实现（C108-1），履约日期=最近认领日期 | 履约日期改为交易日期；组装逻辑收敛到通用组件 |
| 付款 | 审批通过即 C108-1 新建，实际付款后 C108-2 更新 | 未实际付款不推送；首次实际付款 C108-1 新建；分期付款推进 C108-2 更新 |
| 付款 | 审批通过即 C108-1 新建，特批通过后补推履约计划与履约记录，实际付款后 C108-2 更新 | **特批通过后不推任何履约数据**；未实际付款不推送；首次实际付款 C108-1 新建；分期付款推进 C108-2 更新 |
| 开票 | 无（仅 C111 开票登记） | 新增：金蝶回写发票逐张推 C108-1，发票粒度幂等+重试 |
| 收票 | 无（仅 C109 收票单） | 新增：每条结算分摊行推 C108-1，分摊行粒度幂等+重试，且限 C109 已推送 |
@@ -87,14 +87,16 @@ C108-1（履约记录新建）、C108-2（履约记录更新）两个接口需
### 4.2 履约付款记录（对应付款记录，金蝶实际付款了再推）
```
付款申请审批通过（特批通过后）
→ HCS 推送链：C106-3 特批（如需）→ C103-9 履约计划重推
→ C108 履约记录环节：paidAmount 为空/0 → 跳过（提示"金蝶未实际付款，待付款后推送履约记录"）★改
整体状态照常置 synced
付款申请审批通过
→ 如需特批：发起 C106-3 挂起，特批通过后仅联动审批恢复 + 补推金蝶
★改：特批通过后不推履约计划与履约记录（履约数据统一在各业务环节推送）
→ 审批通过即时推送链不产生履约付款记录（paidAmount 为空/0 跳过，
提示"金蝶未实际付款，待付款后推送履约记录"，整体状态照常置 synced）
金蝶实际付款 → 定时任务 A103-2 付款结果回写（applyPayApplyResult）
→ paidAmount 首次 >0 或金额变化 → hcs_sync_status 置 unsynced ★改（原仅在有 fdId 时置）
→ HcsPushTask 付款任务下轮扫描 → pushPayment
C103-9 履约计划重推（付款审批累加金额行，exe-stage 开关门禁）
无 hcs_perf_fd_id → C108-1 新建（申请金额 + 实际金额）→ fdId 回填 hcs_perf_fd_id
有 hcs_perf_fd_id → C108-2 更新（分期付款推进实际金额）
```
@@ -219,11 +221,12 @@ HcsPushTask 开票任务（每5分钟）：
**场景 2｜履约付款记录（金蝶实际付款了再推）**
1. 付款申请审批通过并推金蝶（`POST /payment-application/sync-kingdee`）；此时**不应**产生履约付款记录——日志出现 `金蝶未实际付款，待付款后推送履约记录`，HCS 侧无记录。
2. 在金蝶完成实际付款后，手动回写：`POST /payment-application/sync-kingdee-result`。
3. 数据库：`SELECT paid_amount, hcs_sync_status FROM blade_payment_application WHERE id=?` → paid_amount>0 且 hcs_sync_status=unsynced。
4. 手动扫描：`POST /hcs/sync/payment` → 日志 `HCS履约记录新建成功`（C108-1）→ 数据库 `hcs_perf_fd_id` 回填。
5. 分期付款（金蝶再次付款）→ 再触发回写 → 金额变化置 unsynced → 再扫描 → 日志 `HCS履约记录更新成功`（C108-2）；HCS 侧 fd_fact_amount 与最新 paid_amount 一致。
6. 反向验证：`paying` 状态下连续两轮回写但金额不变 → 不置 unsynced、不重复推送。
2. 特批场景（高风险/黑名单收款方或额度超额）：提交后发起 C106-3 挂起；特批通过（回调 `paymentLegal/result` 或人工确认 `POST /hcs/spec-pay/confirm`）后，核对**无任何履约计划重推与履约记录推送动作**（仅审批恢复 + 金蝶补推），HCS 侧仍无履约付款记录。
3. 在金蝶完成实际付款后，手动回写：`POST /payment-application/sync-kingdee-result`。
4. 数据库：`SELECT paid_amount, hcs_sync_status FROM blade_payment_application WHERE id=?` → paid_amount>0 且 hcs_sync_status=unsynced。
5. 手动扫描：`POST /hcs/sync/payment` → 日志 `HCS履约记录新建成功`（C108-1）→ 数据库 `hcs_perf_fd_id` 回填。
6. 分期付款（金蝶再次付款）→ 再触发回写 → 金额变化置 unsynced → 再扫描 → 日志 `HCS履约记录更新成功`（C108-2）；HCS 侧 fd_fact_amount 与最新 paid_amount 一致。
7. 反向验证：`paying` 状态下连续两轮回写但金额不变 → 不置 unsynced、不重复推送。
**场景 3｜履约开票记录**