diff --git a/doc/nacos/third-party-api.yaml b/doc/nacos/third-party-api.yaml index e9750a85..6ead9824 100644 --- a/doc/nacos/third-party-api.yaml +++ b/doc/nacos/third-party-api.yaml @@ -157,7 +157,8 @@ thirdParty: # Mock 开关(true 时 IHcsClient 走本地 JSON 桩 F:/home/tms/mock/hcs/{方法名}.json,联调前自测用,生产必须 false;改配置需重启,改桩文件即时生效) mock-enabled: ${HCS_MOCK_ENABLED:false} # 合同合规系统(HCS)开放接口地址(v4 接口说明:带网关前缀,直连可配,代码不感知) - baseUrl: ${HCS_BASE_URL:http://172.16.203.134:8000/gwzh/HTHG} + # baseUrl: ${HCS_BASE_URL:http://172.16.203.134:8000/gwzh/HTHG} # uat + baseUrl: ${HCS_BASE_URL:https://contract-sit.gxwuzi.com} # Authorization 请求头整值(含 Basic 前缀,敏感值通过环境变量注入) authorization: ${HCS_AUTHORIZATION:Basic d2Njazp0RzQjd044JWpYNmM=} # Key-Auth 请求头值(v4 接口说明:所有接口固定携带 Authorization + Key-Auth 两个头) @@ -165,15 +166,20 @@ thirdParty: # 来源系统标识(fd_sources,约定值 WLTMS) src-system: ${HCS_SRC_SYSTEM:WLTMS} # 操作人登录名(fdLoginName / curUser.fdLoginName,全部合同接口共用,默认 srvadmin) - operator-login-name: ${HCS_OPERATOR_LOGIN_NAME:srvadmin} + operator-login-name: ${HCS_OPERATOR_LOGIN_NAME:13737128880} # 创建单位 fdId(fd_creator_unit 等组织引用,HCS 组织主数据固定值,项目立项、合同等接口共用;与 name 任一为空回退单据开题部门名称仅传名称) - creator-unit-id: ${HCS_CREATOR_UNIT_ID:1k4vq0lhsw98w1gkegw1d2g9nep42p9j1cw0} + # creator-unit-id: ${HCS_CREATOR_UNIT_ID:1j56etj23w358wne0ow2k5214nk4f24213w0} # uat + # creator-unit-id: ${HCS_CREATOR_UNIT_ID:1k4vq0lhsw98w1gkegw1d2g9nep42p9j1cw0} # 百色物产新源供应链有限公司 + creator-unit-id: ${HCS_CREATOR_UNIT_ID:1jj0tkeofw1pwkjstw3jqn806b7rpftb6dw0} # 广西桂物智慧科技有限公司 + # 创建单位名称(与 creator-unit-id 配套) - creator-unit-name: ${HCS_CREATOR_UNIT_NAME:百色物产新源供应链有限公司} + # creator-unit-name: ${HCS_CREATOR_UNIT_NAME:百色物产新源供应链有限公司} + creator-unit-name: ${HCS_CREATOR_UNIT_NAME:广西桂物智慧科技有限公司} + # 推送任务(审批通过即时推送 + 定时扫描兜底,HcsPushTask 五类任务独立开关) push: # 审批通过即时推送总开关(事务提交后异步推送,关闭时仅走扫描兜底) - immediate-enabled: ${HCS_PUSH_IMMEDIATE_ENABLED:false} + immediate-enabled: ${HCS_PUSH_IMMEDIATE_ENABLED:true} # 每类单据单轮扫描批量 batch-size: ${HCS_PUSH_BATCH_SIZE:50} # 推送失败自动重试上限,超限仅人工重推 @@ -201,29 +207,34 @@ thirdParty: template-code: ${HCS_PROJECT_TEMPLATE_CODE:template_15x0og} # 合同(C103-1/11) contract: - # TMS 合同类别 -> HCS 模板ID(§9-U7 合规方提供模板清单;中文键必须用 "[...]" 括号记法,否则绑定失败) + # TMS 合同类别 -> HCS 模板ID(§9-U7 待合规方提供模板清单) template-mapping: + # "[承运商合同]": "1jvnp5s7mw13gw5q4w4g9qin1n1a2rn14gw0" # uat临时 + "[承运商合同]": "1j5tddhugw3w2kiwumvajq27ediq26fp5aw0" - # TMS 审核状态 -> HCS 合同状态(CONTRACT_STATUS 必填,§9-U3 待联调确认字典值后启用) - #status-mapping: - # approved: approved - # change_approved: approved - # 币种:TMS 币种码 -> HCS 币种名称(照金蝶 RMB->CNY 映射惯例) - currency-name-mapping: {"RMB": "CNY"} + "[客户合同]": "1j5tddhugw3w2kiwumvajq27ediq26fp5aw0" + # TMS 币种码 -> HCS 币种名称(照金蝶 RMB->CNY 映射惯例) + currency-name-mapping: { + "RMB": "人民币", + "CNY": "人民币", + "USD": "美元", + } # 合同 fdSepcailContract 固定 false(D15,配置项预留) - special-contract-enabled: ${HCS_CONTRACT_SPECIAL_ENABLED:false} + special-contract-enabled: ${HCS_CONTRACT_SPECIAL_ENABLED:true} # 合同推送前是否强制客商风险校验 require-risk-check: ${HCS_CONTRACT_REQUIRE_RISK_CHECK:true} # 履约规则(C103-9,一期暂不对接) exe-stage: # 履约规则行级同步开关(默认关,对接后打开) - sync-enabled: ${HCS_EXE_STAGE_SYNC_ENABLED:false} + sync-enabled: ${HCS_EXE_STAGE_SYNC_ENABLED:true} # 金额类型默认值(fdFundType) fund-type: ${HCS_EXE_STAGE_FUND_TYPE:byAmount} # 客商风险校验(C101-1) risk: check-on-contract: ${HCS_RISK_CHECK_ON_CONTRACT:true} check-on-payment: ${HCS_RISK_CHECK_ON_PAYMENT:true} + # 黑名单是否阻断(合同置 failed / 付款提交拦截) + # block-blacklist: ${HCS_RISK_BLOCK_BLACKLIST:true} # 额度校验(C106-1,一期暂不对接) credit: # 额度校验开关(默认关,关闭后特批无自动触发,对接后打开) @@ -235,10 +246,10 @@ thirdParty: # 单据状态(示例 10) doc-status: ${HCS_SPEC_PAY_DOC_STATUS:10} # 付款用途/性质/类型字典值(§9-U3 待联调后配置) - payment-purpose: ${HCS_SPEC_PAY_PAYMENT_PURPOSE:} - payment-nature: ${HCS_SPEC_PAY_PAYMENT_NATURE:} - payment-type: ${HCS_SPEC_PAY_PAYMENT_TYPE:} - # 付款特批流程模板ID(fdTemplateId,每个环境/公司模板不同,按环境维护) + payment-purpose: ${HCS_SPEC_PAY_PAYMENT_PURPOSE:2001} + payment-nature: ${HCS_SPEC_PAY_PAYMENT_NATURE:1} + payment-type: ${HCS_SPEC_PAY_PAYMENT_TYPE:1} + # 付款特批流程模板ID(fdTemplateId,每个环境/公司模板不同,WLTMS 示例值,按环境维护) template-id: ${HCS_SPEC_PAY_TEMPLATE_ID:1k5hp8mu5w9dwajnhw1g78dm3pd4a1r11aw0} # 开票登记(C111) invoice: @@ -258,13 +269,15 @@ thirdParty: sync-enabled: ${HCS_PERF_RECORD_SYNC_ENABLED:false} # 表单模板ID(fd_xform_id,环境相关值,§9-U9 待合规方提供) xform-id: ${HCS_PERF_RECORD_XFORM_ID:} + # 附件转传(C103-2) attachment: # 附件转传总开关 transfer-enabled: ${HCS_ATTACHMENT_TRANSFER_ENABLED:true} - # TMS 文件服务下载基址(拉取附件流用,必填否则附件转传失败) + # TMS 文件服务下载基址(拉取附件流用) file-download-base: ${HCS_ATTACHMENT_FILE_DOWNLOAD_BASE:} # 主数据缓存(C103-6/7/12,启动/首次使用时拉取并缓存) master-data: # 缓存时长(分钟) ttl-minutes: ${HCS_MASTER_DATA_TTL_MINUTES:120} +