diff --git a/doc/docs/hcs合同/2026-10-29-履约计划与履约记录四场景业务说明(业务人员版).md b/doc/docs/hcs合同/2026-10-29-履约计划与履约记录四场景业务说明(业务人员版).md index 00447489..5fba57d5 100644 --- a/doc/docs/hcs合同/2026-10-29-履约计划与履约记录四场景业务说明(业务人员版).md +++ b/doc/docs/hcs合同/2026-10-29-履约计划与履约记录四场景业务说明(业务人员版).md @@ -56,7 +56,7 @@ | 业务动作 | 计划金额变化 | | --- | --- | -| 付款申请**审批通过** | 对应付款计划的金额 += 本次申请金额 | +| 付款申请**审批通过** | 对应付款计划的金额 += 本次申请金额(本地记账,**金蝶实际付款后**才同步到合规) | | 收款流水**认领完成** | 对应收款计划的金额 += 本次认领分摊金额 | 请注意: @@ -84,11 +84,11 @@ ``` 付款申请审批通过 - → 只更新计划金额,不产生履约付款记录 + → 本地累加计划金额(暂不同步合规),不产生履约付款记录 → 推送金蝶付款申请 金蝶完成实际付款 → 系统回写实付金额 - → 生成履约付款记录 + → 计划金额同步到合规 + 生成履约付款记录 ``` 业务要点: @@ -101,7 +101,7 @@ | 附件 | 付款场景会把付款附件一并传到合规 | | 特批 | 需要特批的付款,特批通过后也不会立刻生成记录,仍要等金蝶实际付款 | -> 常见误区:付款审批通过后就去合规找履约付款记录——此时还没有,属于正常现象,金蝶付款后才会出现。 +> 常见误区:付款审批通过后就去合规找履约付款记录——此时还没有,属于正常现象,金蝶付款后才会出现(付款计划金额的累加同样是金蝶实际付款后才同步到合规)。 --- diff --git a/doc/docs/hcs合同/2026-10-29-履约计划与履约记录四场景实现逻辑(付款-开票-收票-收款).md b/doc/docs/hcs合同/2026-10-29-履约计划与履约记录四场景实现逻辑(付款-开票-收票-收款).md index 762184ff..a305ae36 100644 --- a/doc/docs/hcs合同/2026-10-29-履约计划与履约记录四场景实现逻辑(付款-开票-收票-收款).md +++ b/doc/docs/hcs合同/2026-10-29-履约计划与履约记录四场景实现逻辑(付款-开票-收票-收款).md @@ -16,7 +16,7 @@ 合同审批通过 └─ 建默认履约计划行 → 推合同 C103-1(拿合同 hcs_fd_id) └─ 推履约计划 C103-9(拿计划 hcs_exeplan_id + 每行 hcs_stage_fd_id) - ├─ 付款:审批通过 → 计划金额累加 → 金蝶实际付款 → C108-1/C108-2 + ├─ 付款:审批通过 → 计划金额本地累加(不推合规) → 金蝶实际付款 → C103-9 重推 + C108-1/C108-2 ├─ 收款:认领提交 → 计划金额累加 → C107-1 → C108-1 ├─ 开票:金蝶开票完成、发票落库 → C111 登记 → 每张发票 C108-1 └─ 收票:收票单推合规 C109 成功 → 每条结算分摊行 C108-1 @@ -86,7 +86,7 @@ blade_receipt_claim_hcs_record.hcs_claim_record_fd_id C107-1 认领记录ID( | 入口 | 位置 | 门禁 | 说明 | | --- | --- | --- | --- | | 合同链 | `HcsContractSyncSupport#pushContract` 第⑤步 | `exe-stage.sync-enabled` | 合同起草/更新成功后、特批挂起前同步计划 | -| 付款链 | `HcsPaymentSyncSupport#pushPayment` 第②步 | `exe-stage.sync-enabled` | 特批门禁通过后,先重推计划,再推履约记录 | +| 付款链 | `HcsPaymentSyncSupport#pushPayment` 第③步 | `exe-stage.sync-enabled` | **金蝶实际付款门禁通过后**重推计划(审批通过仅本地累加金额不推送),再推履约记录 | | 收款链 | `HcsClaimSyncSupport#pushOneContract` 第①步 | `exe-stage.sync-enabled` | 先累加并重推计划,再推 C107-1/C108-1 | > 合同还没推合规时,计划行只做本地标记/累加,不报错,等合同链首推时一并带上。 @@ -110,13 +110,13 @@ blade_receipt_claim_hcs_record.hcs_claim_record_fd_id C107-1 认领记录ID( ``` 付款申请审批通过 - → hcs_sync_status=unsynced;计划金额 += 申请金额 - → 即时推送/扫描:先 C103-9 重推计划 - → 此时 paidAmount=0 → 跳过履约记录(日志“金蝶未实际付款”),整体仍置 synced + → hcs_sync_status=unsynced;计划金额本地累加(row_op=update,不推合规) + → 即时推送/扫描:paidAmount=0 → 履约计划与履约记录均不推送 + (提示“金蝶未实际付款”),整体仍置 synced 金蝶实际付款 → A103-2 回写(applyPayApplyResult) → paidAmount 首次>0 或金额变化 → hcs_sync_status=unsynced - → 扫描付款任务: + → 扫描付款任务:先 C103-9 重推累加金额的计划行 无 hcs_perf_fd_id → C108-1 新建,返回 fdId 立即落库 有 hcs_perf_fd_id → C108-2 更新(分期付款推进实际金额) ``` @@ -261,7 +261,7 @@ sequenceDiagram | 任务 | 默认 cron | 内容 | | --- | --- | --- | | contract | `0 1/5 * * * ?` | C103-1/C103-11 → C103-9 | -| payment | `0 2/5 * * * ?` | C106 特批 → C103-9 → C108-1/2 | +| payment | `0 2/5 * * * ?` | C106 特批 →(金蝶实际付款后)C103-9 → C108-1/2 | | invoice-application | `0 3/5 * * * ?` | C111 → 履约开票 C108-1 | | invoice-receipt | `0 4/5 * * * ?` | C109 → 履约收票 C108-1 | | 收款 | 无独立任务 | 认领事务提交后事件驱动 |