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

:feat: 特批结果回传校验来源系统标识，不符抛出来源系统标识错误异常

Browse Source
This commit is contained in:
刘泉佳
2026-10-12 11:48:13 +08:00
parent e44270e6f0
commit b8d93bc921
4 changed files with 19 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/docs/hcs合同/2026-10-11-hcs合同推送流程梳理.md
+1 -1
View File
@@ -210,7 +210,7 @@ TMS 审批通过（approved / change_approved）
| `POST /hcs/contractLegal/result`（公开端点，网关注册映射 `/gwzh/HTHG/contractLegal/result`） | `requestId` = TMS 合同ID | 合同特批结果联动 |
| `POST /hcs/paymentLegal/result`（公开端点，网关注册映射 `/gwzh/HTHG/paymentLegal/result`） | `requestId` = TMS 付款申请ID | 付款特批回写 `hcs_spec_status`（不联动付款审批状态） |
报文两接口共用（`HcsLegalResultDTO`）：`{sourceSystem, requestId, status, reason}`；`status=APPROVED`（通过）/ `REJECTED`（驳回，reason 为驳回原因如"特批说明材料不完整，请补充"），大小写不敏感识别，其他值仅留痕不落状态。报文原文（含 reason）全量留痕 `blade_hcs_check_log`；未定位到单据或状态未识别时仅留痕返回，不报错。
报文两接口共用（`HcsLegalResultDTO`）：`{sourceSystem, requestId, status, reason}`；先校验 `sourceSystem` 与 `third-party.hcs.src-system` 配置一致（不符抛出"来源系统标识错误"异常，不落库不留痕）；`status=APPROVED`（通过）/ `REJECTED`（驳回，reason 为驳回原因如"特批说明材料不完整，请补充"），大小写不敏感识别，其他值仅留痕不落状态。报文原文（含 reason）全量留痕 `blade_hcs_check_log`；未定位到单据或状态未识别时仅留痕返回，不报错。
| 特批结果 | 合同联动 |
| --- | --- |
doc/docs/hcs合同/2026-10-12-合同特批与结算付款特批流程梳理.md
+2 -2
View File
@@ -108,7 +108,7 @@ none（默认） ──触发──▶ need（挂起"特批审核"）──发
| 路径 | 接口 | 实现 |
| --- | --- | --- |
| 合规推送 | `POST /hcs/contractLegal/result`（`HcsSyncController`，blade.secure 放行，网关注册 `/gwzh/HTHG/contractLegal/result`） | `handleLegalResult`：`requestId`=合同ID（selectById）定位 → `status=APPROVED/REJECTED` 大小写不敏感识别（其他值仅留痕）→ 原文（含 reason）留痕，报文模型 `HcsLegalResultDTO` |
| 合规推送 | `POST /hcs/contractLegal/result`（`HcsSyncController`，blade.secure 放行，网关注册 `/gwzh/HTHG/contractLegal/result`） | `handleLegalResult`：先校验 `sourceSystem`（不符抛"来源系统标识错误"异常）→ `requestId`=合同ID（selectById）定位 → `status=APPROVED/REJECTED` 大小写不敏感识别（其他值仅留痕）→ 原文（含 reason）留痕，报文模型 `HcsLegalResultDTO` |
| 人工确认 | `POST /hcs/contract/spec/confirm`（:251-257） | `confirmSpecResult`（:139-157，仅 processing 可确认） |
联动 `syncContractOnSpecResult`（:312-320）：
@@ -229,7 +229,7 @@ none（默认） ──触发──▶ need（挂起"特批审核"）──发
特批结果由合规系统审批完成后主动推送（2026-10-12 起，替代原计划的 B103，§9-U1 已闭环）：
- `POST /hcs/paymentLegal/result`（`HcsSyncController`，blade.secure 放行，网关注册 `/gwzh/HTHG/paymentLegal/result`）→ `HcsPaymentSyncSupport#handleLegalResult`：`requestId`=付款申请ID 定位，`status=APPROVED/REJECTED` 回写 `hcs_spec_status`，不联动付款审批状态；
- `POST /hcs/paymentLegal/result`（`HcsSyncController`，blade.secure 放行，网关注册 `/gwzh/HTHG/paymentLegal/result`）→ `HcsPaymentSyncSupport#handleLegalResult`：先校验 `sourceSystem`（不符抛"来源系统标识错误"异常），`requestId`=付款申请ID 定位，`status=APPROVED/REJECTED` 回写 `hcs_spec_status`，不联动付款审批状态；
- 等效兜底：页面人工确认 `POST /hcs/spec-pay/confirm`（仅 `processing` 可确认，置 `approved/rejected`）；
- **付款特批结果不联动付款审批状态**（与合同特批的 `syncContractOnSpecResult` 不同，无驳回联动）。