Files
tms-erp-api/doc/nacos/third-party-api.yaml
T
2026-10-13 15:24:24 +08:00

175 lines
8.8 KiB
YAML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#第三方接口配置
thirdParty:
ocr:
# OCR磅单、车牌识别接口地址
baseUrl: ${OCR_BASE_URL:http://127.0.0.1:8080}
# OCR证件识别接口地址
baseOtherUrl: ${OCR_BASE_OTHER_URL:http://127.0.0.1:8080}
wps:
# WPS开放接口地址
baseUrl: ${WPS_BASE_URL:http://127.0.0.1:8080}
oa:
# OA开放接口地址
baseUrl: ${OA_BASE_URL:http://172.16.204.83:38000}
queryCompanyPageUrl: ${OA_QUERY_COMPANY_PAGE_URL:/gwzh/OA/OA_GET_COMPANY_LIST}
queryDepartmentPageUrl: ${OA_QUERY_DEPARTMENT_PAGE_URL:/gwzh/OA/OA_GET_DEPARTMENT_LIST}
queryPersonPageUrl: ${OA_QUERY_PERSON_PAGE_URL:/gwzh/OA/OA_GET_USER_LIST}
authorization: ${OA_AUTHORIZATION:${IAM_SSO_AUTHORIZATION:}}
lbs:
# LBS 网关地址(车辆实时定位)
baseUrl: ${LBS_BASE_URL:${OA_BASE_URL:http://172.16.204.83:38000}}
locateUrl: ${LBS_LOCATE_URL:/gwzh/LBS/LBS_LOCATE}
trackUrl: ${LBS_TRACK_URL:/gwzh/LBS/LBS_TRACK}
authorization: ${LBS_AUTHORIZATION:${OA_AUTHORIZATION:${IAM_SSO_AUTHORIZATION:}}}
track:
# 轨迹开放接口地址
baseUrl: ${TRACK_BASE_URL:http://127.0.0.1:8080}
mk:
# MK开放接口地址
baseUrl: ${MK_BASE_URL:http://127.0.0.1:8080}
wechat:
mini:
# 微信小程序 AppId / AppSecret(Nacos 配置,勿提交真实 secret)
appId: ${WECHAT_MINI_APP_ID:}
appSecret: ${WECHAT_MINI_APP_SECRET:}
bfi:
# 业财融合(BFI)开放接口地址
baseUrl: ${BFI_BASE_URL:http://172.16.203.134:8000/gwzh/BFI}
# 网关认证请求头 Authorization 的值
authorization: ${BFI_AUTHORIZATION:}
# 第三方应用系统编码,即 appId
clientId: ${BFI_CLIENT_ID:}
# 第三方应用AccessToken认证密钥,即 appSecret,敏感值通过环境变量注入
clientSecret: ${BFI_CLIENT_SECRET:}
# 访问用户名
username: ${BFI_USERNAME:}
# 数据中心ID
accountId: ${BFI_ACCOUNT_ID:}
# 语言字串,默认 zh_CN
language: ${BFI_LANGUAGE:zh_CN}
# 数据来源系统编码(推送金蝶公共参数:客商、付款申请等统一使用),默认 WLTMS(运输TMS)
srcSys: ${BFI_SRC_SYS:WLTMS}
# 付款申请推送配置(A103-3 付款申请保存)
payApply:
# 单据类型编码:ap_payapply_BT_S 采购付款申请、ap_payapply_oth_BT_S 其他付款申请
billtype: ${BFI_PAY_APPLY_BILLTYPE:ap_payapply_oth_BT_S}
# 组织编码、币种取自付款申请关联合同的所属组织与结算币种
# 汇率表编码
exratetable: ${BFI_PAY_APPLY_EXRATE_TABLE:01}
# 外部单据类型
srcType: ${BFI_PAY_APPLY_SRC_TYPE:0KzXs}
# 金蝶付款结果定时回写(A103-2 付款申请单查询 / A103-4 付款处理查询)
payResult:
# 回写任务开关
syncEnabled: ${BFI_PAY_RESULT_SYNC_ENABLED:false}
# 调度 cron,默认每10分钟
cron: ${BFI_PAY_RESULT_CRON:0 */10 * * * ?}
# 合同合规系统
hcs:
# 合同合规系统(HCS)开放接口地址(v4 接口说明:带网关前缀,直连可配,代码不感知)
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 两个头)
key-auth: ${HCS_KEY_AUTH:3F7e8yI6RV8S53mJ9tYa0672r3W4n279}
# 来源系统标识(fd_sources,约定值 WLTMS)
src-system: ${HCS_SRC_SYSTEM:WLTMS}
# 操作人登录名(fdLoginName / curUser.fdLoginName,全部合同接口共用,默认 srvadmin)
operator-login-name: ${HCS_OPERATOR_LOGIN_NAME:srvadmin}
# 创建单位 fdId(fd_creator_unit 等组织引用,HCS 组织主数据固定值,项目立项、合同等接口共用;与 name 任一为空回退单据开题部门名称仅传名称)
creator-unit-id: ${HCS_CREATOR_UNIT_ID:1j56etj23w358wne0ow2k5214nk4f24213w0}
# 创建单位名称(与 creator-unit-id 配套)
creator-unit-name: ${HCS_CREATOR_UNIT_NAME:广西物产城矿发展有限公司}
# 推送任务(审批通过即时推送 + 定时扫描兜底,HcsPushTask 五类任务独立开关)
push:
# 审批通过即时推送总开关(事务提交后异步推送,关闭时仅走扫描兜底)
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 待合规方提供)
template-code: ${HCS_PROJECT_TEMPLATE_CODE:template_15x0og}
# 合同(C103-1/11)
contract:
# 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": "CNY"}
# 合同 fdSepcailContract 固定 false(D15,配置项预留)
special-contract-enabled: ${HCS_CONTRACT_SPECIAL_ENABLED:false}
# 合同推送前是否强制客商风险校验
require-risk-check: ${HCS_CONTRACT_REQUIRE_RISK_CHECK:true}
# 履约规则(C103-9,一期暂不对接)
exe-stage:
# 履约规则行级同步开关(默认关,对接后打开)
sync-enabled: ${HCS_EXE_STAGE_SYNC_ENABLED:false}
# 金额类型默认值(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:
# 额度校验开关(默认关,关闭后特批无自动触发,对接后打开)
check-enabled: ${HCS_CREDIT_CHECK_ENABLED:false}
# 付款提交校验是否要求合同已推送合规
require-contract-synced: ${HCS_CREDIT_REQUIRE_CONTRACT_SYNCED:true}
# 结算付款特批(C106-3/4)
spec-pay:
# 单据状态(示例 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:}
# 开票登记(C111)
invoice:
# TMS 发票类型 -> HCS 发票类型字典值(§9-U3 待联调后配置)
invoice-type-mapping: {"electronic_normal": "", "electronic_special": ""}
# TMS 币种码 -> HCS 币种 fdId(经 C103-12 币种表缓存取值,§9-U3 待联调后配置)
currency-id-mapping: {"RMB": ""}
# 款项性质默认值(fdFundNature)
fund-nature-default: ${HCS_INVOICE_FUND_NATURE_DEFAULT:progress}
# 收票单(C109)
receipt-bill:
# TMS 发票类型 -> HCS 收票发票类型字典值(§9-U3 待联调后配置)
invoice-type-mapping: {}
# 履约记录(C108-1/2,一期暂不对接)
perf-record:
# 履约记录同步开关(默认关,对接后打开)
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 文件服务下载基址(拉取附件流用,必填否则附件转传失败)
file-download-base: ${HCS_ATTACHMENT_FILE_DOWNLOAD_BASE:}
# 主数据缓存(C103-6/7/12,启动/首次使用时拉取并缓存)
master-data:
# 缓存时长(分钟)
ttl-minutes: ${HCS_MASTER_DATA_TTL_MINUTES:120}