Files
tms-erp-api/doc/nacos/third-party-api.yaml
T
刘泉佳 455927c18b Merge branch 'master' into feature/20261103-bfi-warehouse-material
# Conflicts:
#	blade-service/blade-transport/src/main/java/org/springblade/transport/support/KingdeeReceivedInvoiceSyncSupport.java
#	doc/docs/业务流程/2026-10-17-结算调整单操作流程说明(分场景).md
#	doc/sql/transport/lqj/20261102/06_blade_invoice_receipt_supplier_code_menu_20261031.sql
#	doc/sql/transport/lqj/20261102/19_blade_dict_fee_category_warehouse_20261103.sql
2026-11-04 17:27:58 +08:00

317 lines
18 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}
# 身份证 OCR 服务地址(POST /ShenFenZheng,formData 字段 image_file)
idCardBaseUrl: ${OCR_ID_CARD_BASE_URL:http://124.71.22.123:8500}
# 营业执照 OCR 服务地址(POST /businessLicense,JSON:img_path、data_type)
businessLicenseBaseUrl: ${OCR_BUSINESS_LICENSE_BASE_URL:http://124.71.22.123:8888}
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:
# 业财融合(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}
# BFI 客户端本地 Mock 开关(联调自测用,生产必须 false):
# true 时 IBfiClient 有桩用桩({mockDir}/{接口方法名}.json)、无桩透传真实 Feign 接口,调用侧零改动
mock-enabled: ${BFI_MOCK_ENABLED:false}
# Mock 桩文件目录:文件名为接口方法名,如 getToken.json、payApplyQuery.json;文件每次调用现读,改文件即生效
mockDir: ${BFI_MOCK_DIR:./mock/bfi}
# 数据来源系统编码(推送金蝶公共参数:客商、付款申请等统一使用),默认 WLTMS(运输TMS)
srcSys: ${BFI_SRC_SYS:WLTMS}
# 金蝶黑名单查询(A801-5 客商提审拦截):禁止交易类(A)始终拦截;
# 风险警示类(B)默认放行告警,开启后一并拦截
blacklist:
blockRiskWarning: ${BFI_BLACKLIST_BLOCK_RISK_WARNING:false}
# 应付/应收/收票单分录物料映射(A102-2/A302-2/A303-2 共用,未配置使用代码默认值):
# 运输类按项目业务模式映射——国内运输按运单运输方式映射、国际运输映射国际货代服务;
# 装卸大类及手动添加的非运费杂费映射装卸物料;仓储大类(档案编码 A05)及手动添加仓储费用映射仓储物料
# 注意:Map 的中文 key 必须用 ["中文"] 方括号写法,否则 Spring Boot 绑定失败、服务启动报错
material:
# 国内运输:运单运输方式 -> 金蝶物料编码(公路运输/铁路运输/水路运输/航空运输四种)
domestic:
"[公路运输]": ${BFI_MATERIAL_DOMESTIC_ROAD:XDWL11010001}
"[road]": ${BFI_MATERIAL_DOMESTIC_ROAD:XDWL11010001}
"[铁路运输]": ${BFI_MATERIAL_DOMESTIC_RAIL:XDWL11010002}
"[水路运输]": ${BFI_MATERIAL_DOMESTIC_WATER:XDWL11010003}
"[航空运输]": ${BFI_MATERIAL_DOMESTIC_AIR:Item-00001082}
# 国际运输业务模式物料编码(国际货运代理服务)
international: ${BFI_MATERIAL_INTERNATIONAL:Item-00001081}
# 装卸大类、手动添加非运费杂费物料编码(装卸)
loading: ${BFI_MATERIAL_LOADING:XDWL11002004}
# 仓储大类、手动添加仓储费用物料编码(仓储)
warehouse: ${BFI_MATERIAL_WAREHOUSE:XDWL11002001}
# 付款申请推送配置(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}
# 收款流水同步配置(A301-1 收款单查询)
recBillSync:
# 业务日期窗口天数
days: ${BFI_RECBILL_SYNC_DAYS:60}
# 金蝶付款结果定时回写(A103-2 付款申请单查询 / A103-4 付款处理查询)
payResult:
# 回写任务开关
syncEnabled: ${BFI_PAY_RESULT_SYNC_ENABLED:false}
# 调度 cron,默认每10分钟
cron: ${BFI_PAY_RESULT_CRON:0 1/10 * * * ?}
# A103-4 付款处理查询业务日期窗口天数
queryWindowDays: ${BFI_PAY_RESULT_QUERY_WINDOW_DAYS:60}
# 金蝶收票单结果定时回写(A801-3 异常回收/指定补偿/单号补登)
receivedInvoiceResult:
# 回写任务开关,默认关闭(联调稳定后开启)
syncEnabled: ${BFI_RECEIVED_INVOICE_RESULT_SYNC_ENABLED:false}
# 调度 cron,默认每10分钟(:08 起步,错峰避让其他金蝶任务)
cron: ${BFI_RECEIVED_INVOICE_RESULT_CRON:0 8/10 * * * ?}
# A302-6 指定应付自动补偿开关:pushed 且已认领的收票单自动重发指定应付;
# 默认关闭(安全兜底),不自动推送指定应付,由人工入口(发票登记推送/认领发票重推按钮)触发
assignCompensationEnabled: ${BFI_RECEIVED_INVOICE_RESULT_ASSIGN_COMPENSATION_ENABLED:false}
# 收款认领推送金蝶定时任务(A301-3 收款认领结果推送)
receiptClaimPush:
# 推送任务开关,默认关闭(联调稳定后开启)
syncEnabled: ${BFI_RECEIPT_CLAIM_PUSH_SYNC_ENABLED:false}
# 调度 cron,默认每10分钟
cron: ${BFI_RECEIPT_CLAIM_PUSH_CRON:0 4/10 * * * ?}
# single-flight 分布式锁租约秒数,须大于最坏一轮耗时(逐认领人远程查公告+逐条推送),
# 进程异常退出时锁在租约到期后自动释放
lockLeaseSeconds: ${BFI_RECEIPT_CLAIM_PUSH_LOCK_LEASE_SECONDS:1800}
# 金蝶单据锁定定时补偿
billLock:
# 锁定/解锁总开关(推送后锁定+解锁回调+补偿重锁共用),默认开启保持既有行为
enabled: ${BFI_BILL_LOCK_ENABLED:false}
# 锁定补偿开关,默认关闭(安全兜底)
retryEnabled: ${BFI_BILL_LOCK_RETRY_ENABLED:false}
# 补偿调度 cron,默认每5分钟(:02 起步,错峰避让其他金蝶任务)
retryCron: ${BFI_BILL_LOCK_RETRY_CRON:0 2/5 * * * ?}
# 收款认领公告查询配置(A301-2)
claimAnnounce:
# 查询时间窗口(月数)
months: ${BFI_CLAIM_ANNOUNCE_MONTHS:6}
# 认领人:配置后公告查询固定使用该值,不再按当前登录用户姓名查询
claimusers: ${BFI_CLAIM_ANNOUNCE_CLAIMUSERS:徐媛}
# 收票管理金蝶全票池发票定时绑定(A801-1 查询全票池发票数据)
invoiceReceipt:
# 绑定任务开关,默认关闭(联调稳定后开启)
syncEnabled: ${BFI_INVOICE_RECEIPT_SYNC_ENABLED:false}
# 调度 cron,默认每30分钟(:16 起步,错峰避让其他金蝶任务)
cron: ${BFI_INVOICE_RECEIPT_CRON:0 16/30 * * * ?}
# 增量窗口天数(按票池更新时间滚动)
incrementDays: ${BFI_INVOICE_RECEIPT_INCREMENT_DAYS:30}
# 同步发票种类白名单(逗号分隔票易通编码,如 26,27 数电普票/专票),为空不限制
invoiceTypes: ${BFI_INVOICE_RECEIPT_INVOICE_TYPES:26,27}
# 客商单位过滤开关:开启后只同步开票单位(销方)与受票单位(购方)税号均已登记在客商发票信息中的发票,前端票池展示查询同用此开关过滤
customerUnitsOnly: ${BFI_INVOICE_RECEIPT_CUSTOMER_UNITS_ONLY:false}
# 补偿绑定单轮限量(未绑定登记按发票号码精确补查条数上限)
compensateLimit: ${BFI_INVOICE_RECEIPT_COMPENSATE_LIMIT:200}
# single-flight 分布式锁租约秒数,须大于最坏一轮耗时;进程异常退出时锁在租约到期后自动释放
lockLeaseSeconds: ${BFI_INVOICE_RECEIPT_LOCK_LEASE_SECONDS:1800}
# 审批通过自动同步金蝶(事件触发:结算单A102-2/A302-2、付款申请A103-1/A103-3、开票申请A303-1、收票A303-2+A302-6)
autoSync:
# 结算单审批后自动推送开关
settlement: ${BFI_AUTO_SYNC_SETTLEMENT:true}
# 付款申请审批后自动推送开关
payment: ${BFI_AUTO_SYNC_PAYMENT:true}
# 开票申请审批后自动推送开关
invoiceApply: ${BFI_AUTO_SYNC_INVOICE_APPLY:true}
# 收票登记审批后自动推送开关
receipt: ${BFI_AUTO_SYNC_RECEIPT:true}
# failed 单据定时重推开关(仅重推生成失败,不扫 unsynced 存量)
retryEnabled: ${BFI_AUTO_SYNC_RETRY_ENABLED:false}
# 重推调度 cron,默认每10分钟
retryCron: ${BFI_AUTO_SYNC_RETRY_CRON:0 5/10 * * * ?}
# 客商金蝶数据定时同步(A902-1 复查 / A902-2 推送)
customer:
# 同步任务开关,默认关闭
syncEnabled: ${BFI_CUSTOMER_SYNC_ENABLED:false}
# 同步调度 cron,默认每天 02:00 执行
cron: ${BFI_CUSTOMER_SYNC_CRON:0 0 2 * * ?}
# 同步 single-flight 锁租约秒数,须大于最坏一轮耗时(复查 + 批量推送 + 停用联动)
lockLeaseSeconds: ${BFI_CUSTOMER_SYNC_LOCK_LEASE_SECONDS:1800}
# 合同合规系统
hcs:
# 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} # uat
baseUrl: ${HCS_BASE_URL:https://contract-sit.gxwuzi.com}
# Authorization 请求头整值(含 Basic 前缀,敏感值通过环境变量注入)
authorization: ${HCS_AUTHORIZATION:Basic d2Njazp0RzQjd044JWpYNmM=}
# 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:13737128880}
# 创建单位 fdId(fd_creator_unit 等组织引用,HCS 组织主数据固定值,项目立项、合同等接口共用;与 name 任一为空回退单据开题部门名称仅传名称)
# 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:广西桂物智慧科技有限公司}
# 推送任务(审批通过即时推送 + 定时扫描兜底,HcsPushTask 五类任务独立开关)
push:
# 审批通过即时推送总开关(事务提交后异步推送,关闭时仅走扫描兜底)
immediate-enabled: ${HCS_PUSH_IMMEDIATE_ENABLED:true}
# 每类单据单轮扫描批量
batch-size: ${HCS_PUSH_BATCH_SIZE:50}
# 推送失败自动重试上限,超限仅人工重推
max-retry: ${HCS_PUSH_MAX_RETRY:5}
# 五类扫描任务独立开关(灰度逐类打开;扫描只认审批通过且未同步/失败未超限的单据,失败由下轮自动补偿,超限人工重推)
# 各任务 cron 有代码默认值每5分钟、分钟位 0/1/2/3/4 错峰,无需配置;多实例按任务 Redis 分布式锁防重扫(TTL 240s)
project:
# 项目立项(C102)定时推送
sync-enabled: ${HCS_PUSH_PROJECT_ENABLED:false}
contract:
# 合同(C103)定时推送(含风险校验/附件转传/履约规则 C103-9,及特批 C103-4 结果查询兜底)
sync-enabled: ${HCS_PUSH_CONTRACT_ENABLED:false}
payment:
# 付款链定时推送(特批 C106-3 + 履约记录 C108)
sync-enabled: ${HCS_PUSH_PAYMENT_ENABLED:false}
invoice-application:
# 开票登记(C111)定时推送(含金蝶开票完成后回填)
sync-enabled: ${HCS_PUSH_INVOICE_APP_ENABLED:false}
invoice-receipt:
# 收票单(C109)定时推送
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" # uat临时
"[承运商合同]": "1j5tddhugw3w2kiwumvajq27ediq26fp5aw0"
"[客户合同]": "1j5tddhugw3w2kiwumvajq27ediq26fp5aw0"
# TMS 币种码 -> HCS 币种名称(照金蝶 RMB->CNY 映射惯例)
currency-name-mapping: {
"RMB": "人民币",
"CNY": "人民币",
"USD": "美元",
}
# 合同 fdSepcailContract 固定 false(D15,配置项预留)
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: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}
# 客商风险每日定时刷新开关(刷新合同期限内生效合同关联客商并落库,支撑列表展示与筛选,默认关)
refresh-enabled: ${HCS_RISK_REFRESH_ENABLED:false}
# 客商风险刷新调度 cron,默认每天 02:30(错开金蝶客商同步 02:00)
refresh-cron: ${HCS_RISK_REFRESH_CRON:0 30 2 * * ?}
# 黑名单是否阻断(合同置 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:
# 付款特批走合同合规开关(false 时不再发起 C106-3/4、不挂起"特批审核"、不拦金蝶推送;提交时特批附件必传逻辑保留)
enabled: ${HCS_SPEC_PAY_ENABLED:false}
# 单据状态(示例 10)
doc-status: ${HCS_SPEC_PAY_DOC_STATUS:10}
# 付款用途/性质/类型字典值(§9-U3 待联调后配置)
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:
# 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}