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

fix: 付款申请同步组织编码与币种改为取自关联合同并调整默认推送配置

Browse Source
This commit is contained in:
刘泉佳
2026-09-16 17:27:59 +08:00
parent 53b15e6093
commit 345d8ebe38
6 changed files with 60 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/docs/业务流程/付款申请同步金蝶（星瀚）技术文档.md
+10 -8
View File
@@ -130,12 +130,12 @@ TMS 付款申请审核通过
| 接口字段 | 含义 | 来源 | 说明 |
| --- | --- | --- | --- |
| awrp_src_code | 来源单据号（防重键） | `paymentNo` | 付款申请单号 |
| awrp_src_sys | 外部系统编号（防重键） | 配置 `payApply.srcSys` | 默认 `TMS` |
| settleorg_number / applyorg_number / payorg_number / purorg_number | 结算/申请/付款/采购组织编码 | 配置 `payApply.orgNumber` | 金蝶公司编码，必填 |
| billtype_number | 单据类型编码 | 配置 `payApply.billtype` | 默认 `ap_payapply_BT_S` 采购付款申请 |
| awrp_src_sys | 外部系统编号（防重键） | 配置 `payApply.srcSys` | 默认 `WLTMS` |
| settleorg_number / applyorg_number / payorg_number / purorg_number | 结算/申请/付款/采购组织编码 | 合同所属组织 | `organizationId` → 组织编码 `deptCode`，为空回退组织名称；缺失报错 |
| billtype_number | 单据类型编码 | 配置 `payApply.billtype` | 默认 `ap_payapply_oth_BT_S` 其他付款申请 |
| applydate | 申请日期 | `applyDate` | yyyy-MM-dd，空取当天 |
| applycause | 请款事由 | paymentType 映射 | 见 5.1 |
| paycurrency_number / settlecurrency_number | 付款/结算币种 | 配置 `payApply.currency` | 默认 `CNY` |
| paycurrency_number / settlecurrency_number | 付款/结算币种 | 合同结算币种 `settlementCurrency` | 缺失报错 |
| awrp_src_type | 外部单据类型 | 配置 `payApply.srcType` | 默认 `TMS付款申请` |
| exratetable_number | 汇率表编码 | 配置 `payApply.exratetable` | 默认 `01` |
| exratedate | 汇率日期 | 同 applydate | yyyy-MM-dd |
@@ -160,6 +160,8 @@ TMS 付款申请审核通过
未传的可选字段：purdept_number、awrp_department_number、e_duedate、e_settlementtype_number、e_costcenter_number、awrp_src_con_eno、awrp_splb_number。
> 前置校验：推送前按 `contractId` 加载合同，未关联合同、合同不存在、所属组织编码为空、结算币种为空时，同步失败并标记 `kingdeeStatus = failed`。
---
## 5. 字典与枚举对应关系
@@ -206,13 +208,13 @@ TMS 付款申请审核通过
| --- | --- | --- | --- |
| thirdParty.bfi.baseUrl | BFI_BASE_URL | — | 星瀚网关地址（已有） |
| thirdParty.bfi.clientId / clientSecret / username / accountId | BFI_* | — | OAuth2 凭证（已有） |
| thirdParty.bfi.payApply.srcSys | BFI_PAY_APPLY_SRC_SYS | TMS | 外部系统编号（防重键） |
| thirdParty.bfi.payApply.billtype | BFI_PAY_APPLY_BILLTYPE | ap_payapply_BT_S | 单据类型编码 |
| thirdParty.bfi.payApply.orgNumber | BFI_PAY_APPLY_ORG_NUMBER | 空（**必配**） | 金蝶公司编码，未配置同步报错 |
| thirdParty.bfi.payApply.currency | BFI_PAY_APPLY_CURRENCY | CNY | 币种编码 |
| thirdParty.bfi.payApply.srcSys | BFI_PAY_APPLY_SRC_SYS | WLTMS | 外部系统编号（防重键） |
| thirdParty.bfi.payApply.billtype | BFI_PAY_APPLY_BILLTYPE | ap_payapply_oth_BT_S | 单据类型编码（其他付款申请） |
| thirdParty.bfi.payApply.exratetable | BFI_PAY_APPLY_EXRATE_TABLE | 01 | 汇率表编码 |
| thirdParty.bfi.payApply.srcType | BFI_PAY_APPLY_SRC_TYPE | TMS付款申请 | 外部单据类型 |
> 组织编码与币种不走配置：分别取自付款申请关联合同的所属组织（`blade_contract_manage.organization_id` → 组织编码，为空回退组织名称）与结算币种（`settlement_currency`）。
---
## 7. 异常处理与批量语义
doc/nacos/blade-dev.yaml
+4 -7
View File
@@ -132,17 +132,14 @@ thirdParty:
# 付款申请推送配置（A103-3 付款申请保存）
payApply:
# 外部系统编号，与来源单据号共同防重
srcSys: ${BFI_PAY_APPLY_SRC_SYS:TMS}
srcSys: ${BFI_PAY_APPLY_SRC_SYS:WLTMS}
# 单据类型编码：ap_payapply_BT_S 采购付款申请、ap_payapply_oth_BT_S 其他付款申请
billtype: ${BFI_PAY_APPLY_BILLTYPE:ap_payapply_BT_S}
# 结算/申请/付款/采购组织编码（金蝶公司编码）
orgNumber: ${BFI_PAY_APPLY_ORG_NUMBER:}
# 付款及结算币种编码
currency: ${BFI_PAY_APPLY_CURRENCY:CNY}
billtype: ${BFI_PAY_APPLY_BILLTYPE:ap_payapply_oth_BT_S}
# 组织编码、币种取自付款申请关联合同的所属组织与结算币种
# 汇率表编码
exratetable: ${BFI_PAY_APPLY_EXRATE_TABLE:01}
# 外部单据类型
srcType: ${BFI_PAY_APPLY_SRC_TYPE:TMS付款申请}
srcType: ${BFI_PAY_APPLY_SRC_TYPE:0KzXs}
#百度OCR配置，API Key和Secret Key请通过环境变量注入
baidu:
doc/nacos/blade-prod.yaml
+4 -7
View File
@@ -104,17 +104,14 @@ thirdParty:
# 付款申请推送配置（A103-3 付款申请保存）
payApply:
# 外部系统编号，与来源单据号共同防重
srcSys: ${BFI_PAY_APPLY_SRC_SYS:TMS}
srcSys: ${BFI_PAY_APPLY_SRC_SYS:WLTMS}
# 单据类型编码：ap_payapply_BT_S 采购付款申请、ap_payapply_oth_BT_S 其他付款申请
billtype: ${BFI_PAY_APPLY_BILLTYPE:ap_payapply_BT_S}
# 结算/申请/付款/采购组织编码（金蝶公司编码）
orgNumber: ${BFI_PAY_APPLY_ORG_NUMBER:}
# 付款及结算币种编码
currency: ${BFI_PAY_APPLY_CURRENCY:CNY}
billtype: ${BFI_PAY_APPLY_BILLTYPE:ap_payapply_oth_BT_S}
# 组织编码、币种取自付款申请关联合同的所属组织与结算币种
# 汇率表编码
exratetable: ${BFI_PAY_APPLY_EXRATE_TABLE:01}
# 外部单据类型
srcType: ${BFI_PAY_APPLY_SRC_TYPE:TMS付款申请}
srcType: ${BFI_PAY_APPLY_SRC_TYPE:0KzXs}
#百度OCR配置，API Key和Secret Key请通过环境变量注入
baidu:
doc/nacos/third-party-api.yaml
+4 -7
View File
@@ -35,14 +35,11 @@ thirdParty:
# 付款申请推送配置（A103-3 付款申请保存）
payApply:
# 外部系统编号，与来源单据号共同防重
srcSys: ${BFI_PAY_APPLY_SRC_SYS:TMS}
srcSys: ${BFI_PAY_APPLY_SRC_SYS:WLTMS}
# 单据类型编码：ap_payapply_BT_S 采购付款申请、ap_payapply_oth_BT_S 其他付款申请
billtype: ${BFI_PAY_APPLY_BILLTYPE:ap_payapply_BT_S}
# 结算/申请/付款/采购组织编码（金蝶公司编码）
orgNumber: ${BFI_PAY_APPLY_ORG_NUMBER:}
# 付款及结算币种编码
currency: ${BFI_PAY_APPLY_CURRENCY:CNY}
billtype: ${BFI_PAY_APPLY_BILLTYPE:ap_payapply_oth_BT_S}
# 组织编码、币种取自付款申请关联合同的所属组织与结算币种
# 汇率表编码
exratetable: ${BFI_PAY_APPLY_EXRATE_TABLE:01}
# 外部单据类型
srcType: ${BFI_PAY_APPLY_SRC_TYPE:TMS付款申请}
srcType: ${BFI_PAY_APPLY_SRC_TYPE:0KzXs}