From 7def08ab2f82747a9e2cd53787a55f55048ee4a0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=88=98=E6=B3=89=E4=BD=B3?= <1107186916@qq.com> Date: Tue, 13 Oct 2026 15:20:40 +0800 Subject: [PATCH] =?UTF-8?q?:chore:=20=E5=AF=B9=E9=BD=90third-party-api.yam?= =?UTF-8?q?l=E7=9A=84HCS=E6=8E=A8=E9=80=81=E9=85=8D=E7=BD=AE=E7=BB=93?= =?UTF-8?q?=E6=9E=84=EF=BC=88=E5=8D=B3=E6=97=B6=E6=8E=A8=E9=80=81=E6=80=BB?= =?UTF-8?q?=E5=BC=80=E5=85=B3+=E4=BA=94=E7=B1=BB=E6=89=AB=E6=8F=8F?= =?UTF-8?q?=E7=8B=AC=E7=AB=8B=E5=BC=80=E5=85=B3=EF=BC=8C=E4=BF=AE=E6=AD=A3?= =?UTF-8?q?baseUrl=E7=BD=91=E5=85=B3=E5=89=8D=E7=BC=80=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/nacos/third-party-api.yaml | 27 ++++++++++++++++++++------- 1 file changed, 20 insertions(+), 7 deletions(-) diff --git a/doc/nacos/third-party-api.yaml b/doc/nacos/third-party-api.yaml index a33c6293..1c3b959e 100644 --- a/doc/nacos/third-party-api.yaml +++ b/doc/nacos/third-party-api.yaml @@ -67,7 +67,7 @@ thirdParty: # 合同合规系统 hcs: # 合同合规系统（HCS）开放接口地址（v4 接口说明：带网关前缀，直连可配，代码不感知） - baseUrl: ${HCS_BASE_URL:http://172.16.203.134:8000/gwzh/BFI} + baseUrl: ${HCS_BASE_URL:http://172.16.203.134:8000/gwzh/HTHG} # Authorization 请求头整值（含 Basic 前缀，敏感值通过环境变量注入） authorization: ${HCS_AUTHORIZATION:Basic d2NjazprJDdQcVIyIXNCdjkmbkc0} # Key-Auth 请求头值（v4 接口说明：所有接口固定携带 Authorization + Key-Auth 两个头） @@ -80,16 +80,25 @@ thirdParty: creator-unit-id: ${HCS_CREATOR_UNIT_ID:1j56etj23w358wne0ow2k5214nk4f24213w0} # 创建单位名称（与 creator-unit-id 配套） creator-unit-name: ${HCS_CREATOR_UNIT_NAME:广西物产城矿发展有限公司} - # 推送任务（扫描首推/补偿，P1 接线） + # 推送任务（审批通过即时推送 + 定时扫描兜底，HcsPushTask 五类任务独立开关） push: - # 总开关（默认关，灰度打开） - sync-enabled: ${HCS_PUSH_SYNC_ENABLED:false} - # 扫描调度 cron，默认每5分钟 - cron: ${HCS_PUSH_CRON:0 */5 * * * ?} + # 审批通过即时推送总开关（事务提交后异步推送，关闭时仅走扫描兜底） + immediate-enabled: ${HCS_PUSH_IMMEDIATE_ENABLED:false} # 每类单据单轮扫描批量 batch-size: ${HCS_PUSH_BATCH_SIZE:50} # 推送失败自动重试上限，超限仅人工重推 max-retry: ${HCS_PUSH_MAX_RETRY:5} + # 五类扫描任务独立开关（cron 有代码默认值错峰每5分钟，无需配置） + project: + sync-enabled: ${HCS_PUSH_PROJECT_ENABLED:false} + contract: + sync-enabled: ${HCS_PUSH_CONTRACT_ENABLED:false} + payment: + sync-enabled: ${HCS_PUSH_PAYMENT_ENABLED:false} + invoice-application: + sync-enabled: ${HCS_PUSH_INVOICE_APP_ENABLED:false} + invoice-receipt: + sync-enabled: ${HCS_PUSH_INVOICE_RCV_ENABLED:false} # 项目立项（C102） project: # 立项 bpmOperation.templateCode（环境相关值，§9-U9 待合规方提供） @@ -99,6 +108,10 @@ thirdParty: # TMS 合同类别 -> HCS 模板ID（§9-U7 合规方提供模板清单；中文键必须用 "[...]" 括号记法，否则绑定失败） template-mapping: "[承运商合同]": "1jvnp5s7mw13gw5q4w4g9qin1n1a2rn14gw0" + # TMS 审核状态 -> HCS 合同状态（CONTRACT_STATUS 必填，§9-U3 待联调确认字典值后启用） + #status-mapping: + # approved: approved + # change_approved: approved # 币种：TMS 币种码 -> HCS 币种名称（照金蝶 RMB->CNY 映射惯例） currency-name-mapping: {"RMB": "人民币"} # 合同 fdSepcailContract 固定 false（D15，配置项预留） @@ -153,7 +166,7 @@ thirdParty: attachment: # 附件转传总开关 transfer-enabled: ${HCS_ATTACHMENT_TRANSFER_ENABLED:true} - # TMS 文件服务下载基址（拉取附件流用） + # TMS 文件服务下载基址（拉取附件流用，必填否则附件转传失败） file-download-base: ${HCS_ATTACHMENT_FILE_DOWNLOAD_BASE:} # 主数据缓存（C103-6/7/12，启动/首次使用时拉取并缓存） master-data: