✨ 新增业财融合(BFI)A103付款接口请求参数DTO

This commit is contained in:
刘泉佳
2026-09-15 18:47:51 +08:00
parent 1258bf0a81
commit e50d519700
8 changed files with 717 additions and 0 deletions
@@ -0,0 +1,47 @@
/**
* BladeX Commercial License Agreement
* Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
* <p>
* Use of this software is governed by the Commercial License Agreement
* obtained after purchasing a license from BladeX.
* <p>
* 1. This software is for development use only under a valid license
* from BladeX.
* <p>
* 2. Redistribution of this software's source code to any third party
* without a commercial license is strictly prohibited.
* <p>
* 3. Licensees may copyright their own code but cannot use segments
* from this software for such purposes. Copyright of this software
* remains with BladeX.
* <p>
* Using this software signifies agreement to this License, and the software
* must not be used for illegal purposes.
* <p>
* THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
* not liable for any claims arising from secondary or illegal development.
* <p>
* Author: Chill Zhuang (bladejava@qq.com)
*/
package org.springblade.thirdparty.bfi.pojo.dto;
import lombok.Data;
import java.io.Serial;
import java.io.Serializable;
import java.util.List;
/**
* 业财融合(BFI)A103-1 付款申请保存(根据星瀚应付下推付款申请)请求体,结构为 data 数组
*
* @author Chill
*/
@Data
public class BfiPayApplyPushBodyDTO implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
/**
* 单据数据
*/
private List<BfiPayApplyPushDTO> data;
}
@@ -0,0 +1,115 @@
/**
* BladeX Commercial License Agreement
* Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
* <p>
* Use of this software is governed by the Commercial License Agreement
* obtained after purchasing a license from BladeX.
* <p>
* 1. This software is for development use only under a valid license
* from BladeX.
* <p>
* 2. Redistribution of this software's source code to any third party
* without a commercial license is strictly prohibited.
* <p>
* 3. Licensees may copyright their own code but cannot use segments
* from this software for such purposes. Copyright of this software
* remains with BladeX.
* <p>
* Using this software signifies agreement to this License, and the software
* must not be used for illegal purposes.
* <p>
* THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
* not liable for any claims arising from secondary or illegal development.
* <p>
* Author: Chill Zhuang (bladejava@qq.com)
*/
package org.springblade.thirdparty.bfi.pojo.dto;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Data;
import java.io.Serial;
import java.io.Serializable;
import java.util.List;
/**
* 业财融合(BFI)A103-1 付款申请保存(根据星瀚应付下推付款申请)参数
*
* @author Chill
*/
@Data
public class BfiPayApplyPushDTO implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
/**
* 外部系统来源单据号,与 awrp_src_sys 组成候选键用于防重
*/
@JsonProperty("awrp_src_code")
private String awrpSrcCode;
/**
* 外部系统编号
*/
@JsonProperty("awrp_src_sys")
private String awrpSrcSys;
/**
* 申请日期,格式:yyyy-MM-dd
*/
private String applydate;
/**
* 付款组织.编码,不传时根据应付单自动带出
*/
@JsonProperty("payorg_number")
private String payorgNumber;
/**
* 采购组织.编码,不传时根据应付单自动带出
*/
@JsonProperty("purorg_number")
private String purorgNumber;
/**
* 采购组.编码,可不传
*/
@JsonProperty("purdept_number")
private String purdeptNumber;
/**
* 部门.编码
*/
@JsonProperty("awrp_department_number")
private String awrpDepartmentNumber;
/**
* 请款事由
*/
private String applycause;
/**
* 汇率表.编码,不传时根据应付单自动带出
*/
@JsonProperty("exratetable_number")
private String exratetableNumber;
/**
* 付款渠道
*/
@JsonProperty("awrp_textfield1")
private String awrpTextfield1;
/**
* 申请人工号
*/
@JsonProperty("creator_number")
private String creatorNumber;
/**
* 申请人
*/
@JsonProperty("creator_name")
private String creatorName;
/**
* 汇率日期,格式:yyyy-MM-dd,不传时根据应付单自动带出
*/
private String exratedate;
/**
* 外部单据类型
*/
@JsonProperty("awrp_src_type")
private String awrpSrcType;
/**
* 付款申请分录
*/
private List<BfiPayApplyPushEntryDTO> entry;
}
@@ -0,0 +1,110 @@
/**
* BladeX Commercial License Agreement
* Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
* <p>
* Use of this software is governed by the Commercial License Agreement
* obtained after purchasing a license from BladeX.
* <p>
* 1. This software is for development use only under a valid license
* from BladeX.
* <p>
* 2. Redistribution of this software's source code to any third party
* without a commercial license is strictly prohibited.
* <p>
* 3. Licensees may copyright their own code but cannot use segments
* from this software for such purposes. Copyright of this software
* remains with BladeX.
* <p>
* Using this software signifies agreement to this License, and the software
* must not be used for illegal purposes.
* <p>
* THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
* not liable for any claims arising from secondary or illegal development.
* <p>
* Author: Chill Zhuang (bladejava@qq.com)
*/
package org.springblade.thirdparty.bfi.pojo.dto;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Data;
import java.io.Serial;
import java.io.Serializable;
import java.math.BigDecimal;
/**
* 业财融合(BFI)A103-1 付款申请保存(根据星瀚应付下推付款申请)分录参数
*
* @author Chill
*/
@Data
public class BfiPayApplyPushEntryDTO implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
/**
* 付款类型.编码,如 201 采购付款
*/
@JsonProperty("e_paymenttype_number")
private String ePaymenttypeNumber;
/**
* 结算单分录id,传来源系统结算单分录id,用于关联星瀚对应的应付单行,
* 对应财务应付单传的 awrp_entry_code 字段
*/
@JsonProperty("awrp_finapbill_entryid")
private String awrpFinapbillEntryid;
/**
* 对方系统唯一行id,不能重复
*/
@JsonProperty("awrp_entry_code")
private String awrpEntryCode;
/**
* 往来账户
*/
@JsonProperty("e_assacct")
private String eAssacct;
/**
* 往来银行.编码
*/
@JsonProperty("e_bebank_number")
private String eBebankNumber;
/**
* 申请金额
*/
@JsonProperty("e_applyamount")
private BigDecimal eApplyamount;
/**
* 期望付款日,格式:yyyy-MM-dd,不传时根据应付单自动带出
*/
@JsonProperty("e_expaydate")
private String eExpaydate;
/**
* 到期日,格式:yyyy-MM-dd,不传时根据应付单自动带出
*/
@JsonProperty("e_duedate")
private String eDuedate;
/**
* 结算方式.编码,不传时根据应付单自动带出
*/
@JsonProperty("e_settlementtype_number")
private String eSettlementtypeNumber;
/**
* 项目.项目编码,必填,若不涉及项目传编码 999
*/
@JsonProperty("project_number")
private String projectNumber;
/**
* 成本中心.编码,不传时根据应付单自动带出
*/
@JsonProperty("e_costcenter_number")
private String eCostcenterNumber;
/**
* 备注
*/
@JsonProperty("e_remark")
private String eRemark;
/**
* 商品类别.编码
*/
@JsonProperty("awrp_splb_number")
private String awrpSplbNumber;
}
@@ -0,0 +1,67 @@
/**
* BladeX Commercial License Agreement
* Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
* <p>
* Use of this software is governed by the Commercial License Agreement
* obtained after purchasing a license from BladeX.
* <p>
* 1. This software is for development use only under a valid license
* from BladeX.
* <p>
* 2. Redistribution of this software's source code to any third party
* without a commercial license is strictly prohibited.
* <p>
* 3. Licensees may copyright their own code but cannot use segments
* from this software for such purposes. Copyright of this software
* remains with BladeX.
* <p>
* Using this software signifies agreement to this License, and the software
* must not be used for illegal purposes.
* <p>
* THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
* not liable for any claims arising from secondary or illegal development.
* <p>
* Author: Chill Zhuang (bladejava@qq.com)
*/
package org.springblade.thirdparty.bfi.pojo.dto;
import lombok.Data;
import java.io.Serial;
import java.io.Serializable;
import java.util.List;
/**
* 业财融合(BFI)A103-2 付款申请单查询参数
*
* @author Chill
*/
@Data
public class BfiPayApplyQueryDTO implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
/**
* 页码,从1开始
*/
private Integer pageNo;
/**
* 页数
*/
private Integer pageSize;
/**
* 来源单据号,业务系统对应的单据号,高频查询需要推送该字段
*/
private List<String> awrpSrcCode;
/**
* 系统编号
*/
private String awrpSrcSys;
/**
* 修改时间-开始,格式:yyyy-MM-dd HH:mm:ss,限定时间范围不可超过1个月
*/
private String modifytimeS;
/**
* 修改时间-结束,格式:yyyy-MM-dd HH:mm:ss,限定时间范围不可超过1个月
*/
private String modifytimeE;
}
@@ -0,0 +1,47 @@
/**
* BladeX Commercial License Agreement
* Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
* <p>
* Use of this software is governed by the Commercial License Agreement
* obtained after purchasing a license from BladeX.
* <p>
* 1. This software is for development use only under a valid license
* from BladeX.
* <p>
* 2. Redistribution of this software's source code to any third party
* without a commercial license is strictly prohibited.
* <p>
* 3. Licensees may copyright their own code but cannot use segments
* from this software for such purposes. Copyright of this software
* remains with BladeX.
* <p>
* Using this software signifies agreement to this License, and the software
* must not be used for illegal purposes.
* <p>
* THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
* not liable for any claims arising from secondary or illegal development.
* <p>
* Author: Chill Zhuang (bladejava@qq.com)
*/
package org.springblade.thirdparty.bfi.pojo.dto;
import lombok.Data;
import java.io.Serial;
import java.io.Serializable;
import java.util.List;
/**
* 业财融合(BFI)A103-3 预付款申请(付款申请保存)请求体,结构为 data 数组
*
* @author Chill
*/
@Data
public class BfiPayApplySaveBodyDTO implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
/**
* 单据数据
*/
private List<BfiPayApplySaveDTO> data;
}
@@ -0,0 +1,140 @@
/**
* BladeX Commercial License Agreement
* Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
* <p>
* Use of this software is governed by the Commercial License Agreement
* obtained after purchasing a license from BladeX.
* <p>
* 1. This software is for development use only under a valid license
* from BladeX.
* <p>
* 2. Redistribution of this software's source code to any third party
* without a commercial license is strictly prohibited.
* <p>
* 3. Licensees may copyright their own code but cannot use segments
* from this software for such purposes. Copyright of this software
* remains with BladeX.
* <p>
* Using this software signifies agreement to this License, and the software
* must not be used for illegal purposes.
* <p>
* THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
* not liable for any claims arising from secondary or illegal development.
* <p>
* Author: Chill Zhuang (bladejava@qq.com)
*/
package org.springblade.thirdparty.bfi.pojo.dto;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Data;
import java.io.Serial;
import java.io.Serializable;
import java.util.List;
/**
* 业财融合(BFI)A103-3 预付款申请(付款申请保存)参数
*
* @author Chill
*/
@Data
public class BfiPayApplySaveDTO implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
/**
* 外部系统来源单据号,与 awrp_src_sys 组成候选键用于防重
*/
@JsonProperty("awrp_src_code")
private String awrpSrcCode;
/**
* 外部系统编号
*/
@JsonProperty("awrp_src_sys")
private String awrpSrcSys;
/**
* 结算组织.编码
*/
@JsonProperty("settleorg_number")
private String settleorgNumber;
/**
* 单据类型.编码:ap_payapply_BT_S 采购付款申请、ap_payapply_oth_BT_S 其他付款申请
*/
@JsonProperty("billtype_number")
private String billtypeNumber;
/**
* 申请日期,格式:yyyy-MM-dd
*/
private String applydate;
/**
* 申请组织.编码
*/
@JsonProperty("applyorg_number")
private String applyorgNumber;
/**
* 付款组织.编码
*/
@JsonProperty("payorg_number")
private String payorgNumber;
/**
* 采购组织.编码
*/
@JsonProperty("purorg_number")
private String purorgNumber;
/**
* 采购组.编码,可不传
*/
@JsonProperty("purdept_number")
private String purdeptNumber;
/**
* 部门.编码
*/
@JsonProperty("awrp_department_number")
private String awrpDepartmentNumber;
/**
* 请款事由
*/
private String applycause;
/**
* 付款币种.编码,如 CNY
*/
@JsonProperty("paycurrency_number")
private String paycurrencyNumber;
/**
* 结算币.编码,如 CNY
*/
@JsonProperty("settlecurrency_number")
private String settlecurrencyNumber;
/**
* 外部单据类型
*/
@JsonProperty("awrp_src_type")
private String awrpSrcType;
/**
* 汇率表.编码,如 01
*/
@JsonProperty("exratetable_number")
private String exratetableNumber;
/**
* 汇率日期,格式:yyyy-MM-dd
*/
private String exratedate;
/**
* 付款渠道
*/
@JsonProperty("awrp_textfield1")
private String awrpTextfield1;
/**
* 来源单据,有上游合同时传 awrp_contract_info
*/
@JsonProperty("awrp_src_bt")
private String awrpSrcBt;
/**
* 上游外部系统单据号,即上游合同号
*/
@JsonProperty("awrp_src_con_no")
private String awrpSrcConNo;
/**
* 付款申请分录
*/
private List<BfiPayApplySaveEntryDTO> entry;
}
@@ -0,0 +1,124 @@
/**
* BladeX Commercial License Agreement
* Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
* <p>
* Use of this software is governed by the Commercial License Agreement
* obtained after purchasing a license from BladeX.
* <p>
* 1. This software is for development use only under a valid license
* from BladeX.
* <p>
* 2. Redistribution of this software's source code to any third party
* without a commercial license is strictly prohibited.
* <p>
* 3. Licensees may copyright their own code but cannot use segments
* from this software for such purposes. Copyright of this software
* remains with BladeX.
* <p>
* Using this software signifies agreement to this License, and the software
* must not be used for illegal purposes.
* <p>
* THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
* not liable for any claims arising from secondary or illegal development.
* <p>
* Author: Chill Zhuang (bladejava@qq.com)
*/
package org.springblade.thirdparty.bfi.pojo.dto;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Data;
import java.io.Serial;
import java.io.Serializable;
import java.math.BigDecimal;
/**
* 业财融合(BFI)A103-3 预付款申请(付款申请保存)分录参数
*
* @author Chill
*/
@Data
public class BfiPayApplySaveEntryDTO implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
/**
* 付款类型.编码,预付款传 202
*/
@JsonProperty("e_paymenttype_number")
private String ePaymenttypeNumber;
/**
* 往来类型:bd_supplier 供应商、bos_user 人员、bos_org 公司、bd_customer 客户
*/
@JsonProperty("e_asstacttype")
private String eAsstacttype;
/**
* 往来户.编码,根据所选往来类型传对应编码
*/
@JsonProperty("e_asstact_number")
private String eAsstactNumber;
/**
* 往来账户
*/
@JsonProperty("e_assacct")
private String eAssacct;
/**
* 往来银行.编码
*/
@JsonProperty("e_bebank_number")
private String eBebankNumber;
/**
* 应付金额
*/
@JsonProperty("e_payamount")
private BigDecimal ePayamount;
/**
* 申请金额
*/
@JsonProperty("e_applyamount")
private BigDecimal eApplyamount;
/**
* 期望付款日,格式:yyyy-MM-dd
*/
@JsonProperty("e_expaydate")
private String eExpaydate;
/**
* 到期日,格式:yyyy-MM-dd
*/
@JsonProperty("e_duedate")
private String eDuedate;
/**
* 项目.项目编码,必填,若不涉及项目传编码 999
*/
@JsonProperty("project_number")
private String projectNumber;
/**
* 成本中心.编码
*/
@JsonProperty("e_costcenter_number")
private String eCostcenterNumber;
/**
* 结算方式.编码
*/
@JsonProperty("e_settlementtype_number")
private String eSettlementtypeNumber;
/**
* 明细.上游分录号
*/
@JsonProperty("awrp_src_con_eno")
private String awrpSrcConEno;
/**
* 对方系统唯一行id,不能重复
*/
@JsonProperty("awrp_entry_code")
private String awrpEntryCode;
/**
* 商品类别.编码
*/
@JsonProperty("awrp_splb_number")
private String awrpSplbNumber;
/**
* 备注
*/
@JsonProperty("e_remark")
private String eRemark;
}
@@ -0,0 +1,67 @@
/**
* BladeX Commercial License Agreement
* Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
* <p>
* Use of this software is governed by the Commercial License Agreement
* obtained after purchasing a license from BladeX.
* <p>
* 1. This software is for development use only under a valid license
* from BladeX.
* <p>
* 2. Redistribution of this software's source code to any third party
* without a commercial license is strictly prohibited.
* <p>
* 3. Licensees may copyright their own code but cannot use segments
* from this software for such purposes. Copyright of this software
* remains with BladeX.
* <p>
* Using this software signifies agreement to this License, and the software
* must not be used for illegal purposes.
* <p>
* THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
* not liable for any claims arising from secondary or illegal development.
* <p>
* Author: Chill Zhuang (bladejava@qq.com)
*/
package org.springblade.thirdparty.bfi.pojo.dto;
import lombok.Data;
import java.io.Serial;
import java.io.Serializable;
import java.util.List;
/**
* 业财融合(BFI)A103-4 付款处理查询参数
*
* @author Chill
*/
@Data
public class BfiPayBillQueryDTO implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
/**
* 页码,从1开始
*/
private Integer pageNo;
/**
* 页数
*/
private Integer pageSize;
/**
* 开始业务日期,格式:yyyy-MM-dd,限定时间范围不可超过1个月
*/
private String beginBizdate;
/**
* 结束业务日期,格式:yyyy-MM-dd,限定时间范围不可超过1个月
*/
private String endBizdate;
/**
* 单据编号
*/
private List<String> billno;
/**
* 付款人(公司).编码
*/
private List<String> orgNumber;
}