docs: 补充推送金蝶付款申请必填字段注释

This commit is contained in:
刘泉佳
2026-09-29 16:50:25 +08:00
parent 952b735a53
commit 73293a4ea5
@@ -1019,20 +1019,35 @@ public class PaymentApplicationServiceImpl extends BaseServiceImpl<PaymentApplic
String applyDateText = bfiDateTimeText(entity); String applyDateText = bfiDateTimeText(entity);
BigDecimal applyAmount = money(entity.getAppliedAmount()).setScale(2, RoundingMode.HALF_UP); BigDecimal applyAmount = money(entity.getAppliedAmount()).setScale(2, RoundingMode.HALF_UP);
BfiPayApplySaveDTO param = new BfiPayApplySaveDTO(); BfiPayApplySaveDTO param = new BfiPayApplySaveDTO();
// 【必填】外部系统来源单据号(防重候选键):付款申请号
param.setAwrpSrcCode(entity.getPaymentNo()); param.setAwrpSrcCode(entity.getPaymentNo());
// 【必填】外部系统编号
param.setAwrpSrcSys(bfiProperties.getSrcSys()); param.setAwrpSrcSys(bfiProperties.getSrcSys());
// 结算组织.编码
param.setSettleorgNumber(orgNumber); param.setSettleorgNumber(orgNumber);
// 【必填】单据类型.编码
param.setBilltypeNumber(bfiProperties.getPayApply().getBilltype()); param.setBilltypeNumber(bfiProperties.getPayApply().getBilltype());
// 【必填】申请日期:yyyy-MM-dd HH:mm:ss(各接口统一格式)
param.setApplydate(applyDateText); param.setApplydate(applyDateText);
// 【必填】申请组织.编码
param.setApplyorgNumber(orgNumber); param.setApplyorgNumber(orgNumber);
// 【必填】付款组织.编码
param.setPayorgNumber(orgNumber); param.setPayorgNumber(orgNumber);
// 采购组织.编码(非必传)
// param.setPurorgNumber(orgNumber); // param.setPurorgNumber(orgNumber);
// 请款事由(非必传)
param.setApplycause(bfiApplyCause(entity.getPaymentType())); param.setApplycause(bfiApplyCause(entity.getPaymentType()));
// 【必填】付款币种.编码
param.setPaycurrencyNumber(currency); param.setPaycurrencyNumber(currency);
// 【必填】结算币.编码
param.setSettlecurrencyNumber(currency); param.setSettlecurrencyNumber(currency);
// 【必填】外部单据类型
param.setAwrpSrcType(bfiProperties.getPayApply().getSrcType()); param.setAwrpSrcType(bfiProperties.getPayApply().getSrcType());
// 【必填】汇率表.编码
param.setExratetableNumber(bfiProperties.getPayApply().getExratetable()); param.setExratetableNumber(bfiProperties.getPayApply().getExratetable());
// 【必填】汇率日期
param.setExratedate(applyDateText); param.setExratedate(applyDateText);
// 付款渠道(非必传)
param.setAwrpTextfield1(bfiPaymentMethodLabel(entity.getPaymentMethod())); param.setAwrpTextfield1(bfiPaymentMethodLabel(entity.getPaymentMethod()));
// 来源单据 // 来源单据
@@ -1043,20 +1058,27 @@ public class PaymentApplicationServiceImpl extends BaseServiceImpl<PaymentApplic
// } // }
BfiPayApplySaveEntryDTO entry = new BfiPayApplySaveEntryDTO(); 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.setEPaymenttypeNumber(TransportBusiConstant.PAYMENT_TYPE_SETTLEMENT.equals(entity.getPaymentType()) ? KingdeeBfiConstant.BFI_PAYMENT_TYPE_FORMAL : KingdeeBfiConstant.BFI_PAYMENT_TYPE_PREPAY);
// 【必填】往来类型
entry.setEAsstacttype(kingdeeApBillSyncSupport.bfiAsstactType(contract)); entry.setEAsstacttype(kingdeeApBillSyncSupport.bfiAsstactType(contract));
// 往来户.编码:合同乙方关联客商档案客商编码 // 【必填】往来户.编码:合同乙方关联客商档案客商编码
entry.setEAsstactNumber(kingdeeApBillSyncSupport.bfiAsstactNumber(contract, context)); entry.setEAsstactNumber(kingdeeApBillSyncSupport.bfiAsstactNumber(contract, context));
// 【必填】往来账户:乙方(收款方)银行账号
entry.setEAssacct(entity.getBankAccount()); entry.setEAssacct(entity.getBankAccount());
// 往来银行.编码:与 A103-1 统一口径,取付款申请所选客商收款账户联行号(未维护即拦截) // 【必填】往来银行.编码:与 A103-1 统一口径,取付款申请所选客商收款账户联行号(未维护即拦截)
entry.setEBebankNumber(this.bfiBebankNumber(entity, context)); entry.setEBebankNumber(this.bfiBebankNumber(entity, context));
// 应付金额 // 应付金额(非必传)
// entry.setEPayamount(applyAmount); // entry.setEPayamount(applyAmount);
// 申请金额 // 【必填】申请金额:取付款申请填写的申请付款金额
entry.setEApplyamount(applyAmount); entry.setEApplyamount(applyAmount);
// 期望付款日(非必传)
// entry.setEExpaydate(applyDateText); // entry.setEExpaydate(applyDateText);
// 【必填】项目.项目编码
entry.setProjectNumber(bfiProjectNumber(entity, context)); entry.setProjectNumber(bfiProjectNumber(entity, context));
// 【必填】对方系统唯一行id(不能重复):付款申请号-1
entry.setAwrpEntryCode(bfiEntryCode(entity.getPaymentNo(), 1)); entry.setAwrpEntryCode(bfiEntryCode(entity.getPaymentNo(), 1));
// 备注(非必传)
entry.setERemark(entity.getRemark()); entry.setERemark(entity.getRemark());
param.setEntry(List.of(entry)); param.setEntry(List.of(entry));