From 73293a4ea52f1e5a3dcfe53d231b77a24b37bc96 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, 29 Sep 2026 16:50:25 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E6=8E=A8=E9=80=81?=
 =?UTF-8?q?=E9=87=91=E8=9D=B6=E4=BB=98=E6=AC=BE=E7=94=B3=E8=AF=B7=E5=BF=85?=
 =?UTF-8?q?=E5=A1=AB=E5=AD=97=E6=AE=B5=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../impl/PaymentApplicationServiceImpl.java   | 30 ++++++++++++++++---
 1 file changed, 26 insertions(+), 4 deletions(-)

diff --git a/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/PaymentApplicationServiceImpl.java b/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/PaymentApplicationServiceImpl.java
index 54ff9c7c..ac064ecb 100644
--- a/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/PaymentApplicationServiceImpl.java
+++ b/blade-service/blade-transport/src/main/java/org/springblade/transport/service/impl/PaymentApplicationServiceImpl.java
@@ -1019,20 +1019,35 @@ public class PaymentApplicationServiceImpl extends BaseServiceImpl<PaymentApplic
 		String applyDateText = bfiDateTimeText(entity);
 		BigDecimal applyAmount = money(entity.getAppliedAmount()).setScale(2, RoundingMode.HALF_UP);
 		BfiPayApplySaveDTO param = new BfiPayApplySaveDTO();
+		// 【必填】外部系统来源单据号（防重候选键）：付款申请号
 		param.setAwrpSrcCode(entity.getPaymentNo());
+		// 【必填】外部系统编号
 		param.setAwrpSrcSys(bfiProperties.getSrcSys());
+		// 结算组织.编码
 		param.setSettleorgNumber(orgNumber);
+		// 【必填】单据类型.编码
 		param.setBilltypeNumber(bfiProperties.getPayApply().getBilltype());
+		// 【必填】申请日期：yyyy-MM-dd HH:mm:ss（各接口统一格式）
 		param.setApplydate(applyDateText);
+		// 【必填】申请组织.编码
 		param.setApplyorgNumber(orgNumber);
+		// 【必填】付款组织.编码
 		param.setPayorgNumber(orgNumber);
+		// 采购组织.编码（非必传）
 		// param.setPurorgNumber(orgNumber);
+		// 请款事由（非必传）
 		param.setApplycause(bfiApplyCause(entity.getPaymentType()));
+		// 【必填】付款币种.编码
 		param.setPaycurrencyNumber(currency);
+		// 【必填】结算币.编码
 		param.setSettlecurrencyNumber(currency);
+		// 【必填】外部单据类型
 		param.setAwrpSrcType(bfiProperties.getPayApply().getSrcType());
+		// 【必填】汇率表.编码
 		param.setExratetableNumber(bfiProperties.getPayApply().getExratetable());
+		// 【必填】汇率日期
 		param.setExratedate(applyDateText);
+		// 付款渠道（非必传）
 		param.setAwrpTextfield1(bfiPaymentMethodLabel(entity.getPaymentMethod()));
 
 		// 来源单据
@@ -1043,20 +1058,27 @@ public class PaymentApplicationServiceImpl extends BaseServiceImpl<PaymentApplic
 		// }
 
 		BfiPayApplySaveEntryDTO entry = new BfiPayApplySaveEntryDTO();
+		// 【必填】付款类型.编码：结算付款 201（正式）、预付款 202
 		entry.setEPaymenttypeNumber(TransportBusiConstant.PAYMENT_TYPE_SETTLEMENT.equals(entity.getPaymentType()) ? KingdeeBfiConstant.BFI_PAYMENT_TYPE_FORMAL : KingdeeBfiConstant.BFI_PAYMENT_TYPE_PREPAY);
+		// 【必填】往来类型
 		entry.setEAsstacttype(kingdeeApBillSyncSupport.bfiAsstactType(contract));
-		// 往来户.编码：合同乙方关联客商档案客商编码
+		// 【必填】往来户.编码：合同乙方关联客商档案客商编码
 		entry.setEAsstactNumber(kingdeeApBillSyncSupport.bfiAsstactNumber(contract, context));
+		// 【必填】往来账户：乙方（收款方）银行账号
 		entry.setEAssacct(entity.getBankAccount());
-		// 往来银行.编码：与 A103-1 统一口径，取付款申请所选客商收款账户联行号（未维护即拦截）
+		// 【必填】往来银行.编码：与 A103-1 统一口径，取付款申请所选客商收款账户联行号（未维护即拦截）
 		entry.setEBebankNumber(this.bfiBebankNumber(entity, context));
-		// 应付金额
+		// 应付金额（非必传）
 		// entry.setEPayamount(applyAmount);
-		// 申请金额
+		// 【必填】申请金额：取付款申请填写的申请付款金额
 		entry.setEApplyamount(applyAmount);
+		// 期望付款日（非必传）
 		// entry.setEExpaydate(applyDateText);
+		// 【必填】项目.项目编码
 		entry.setProjectNumber(bfiProjectNumber(entity, context));
+		// 【必填】对方系统唯一行id（不能重复）：付款申请号-1
 		entry.setAwrpEntryCode(bfiEntryCode(entity.getPaymentNo(), 1));
+		// 备注（非必传）
 		entry.setERemark(entity.getRemark());
 		param.setEntry(List.of(entry));