fix: BFI请求实体按接口文档标注必填字段

2026-09-16 20:04:51 +08:00
parent 1177c179e6
commit 6da70c5271
30 changed files with 135 additions and 135 deletions
@@ -46,11 +46,11 @@ public class BfiApBillQueryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 页码，从1开始
+	 * 【必填】页码，从1开始
 	 */
 	private Integer pageNo;
 	/**
-	 * 页数
+	 * 【必填】页数
 	 */
 	private Integer pageSize;
 	/**
@@ -95,17 +95,17 @@ public class BfiApBillSaveDTO implements Serializable {
 	 */
 	private String billno;
 	/**
-	 * 单据类型.编码[ApFin_pur_BT_S:标准采购应付, ApFin_fee_BT_S:费用采购应付, ApFin_purfee_BT_S:采购费用应付, ap_finapbill_asset_BT_S:资产采购应付, ApFin_service_BT_S:服务采购应付, ApFin_product_BT_S:产品委外应付, ApFin_other_BT_S:其他应付, ApFin_borr_BT_S:借贷项调整]，城矿常用 ApFin_pur_BT_S
+	 * 【必填】单据类型.编码[ApFin_pur_BT_S:标准采购应付, ApFin_fee_BT_S:费用采购应付, ApFin_purfee_BT_S:采购费用应付, ap_finapbill_asset_BT_S:资产采购应付, ApFin_service_BT_S:服务采购应付, ApFin_product_BT_S:产品委外应付, ApFin_other_BT_S:其他应付, ApFin_borr_BT_S:借贷项调整]，城矿常用 ApFin_pur_BT_S
 	 */
 	@JsonProperty("billtypeid_number")
 	private String billtypeidNumber;
 	/**
-	 * 结算组织.编码
+	 * 【必填】结算组织.编码
 	 */
 	@JsonProperty("org_number")
 	private String orgNumber;
 	/**
-	 * 单据日期，格式：yyyy-MM-dd HH:mm:ss，城矿传创建时间
+	 * 【必填】单据日期，格式：yyyy-MM-dd HH:mm:ss，城矿传创建时间
 	 */
 	private String bizdate;
 	/**
@@ -117,20 +117,20 @@ public class BfiApBillSaveDTO implements Serializable {
 	 */
 	private String bookdate;
 	/**
-	 * 往来类型[bd_supplier:供应商, bos_user:人员, bd_customer:客户]，城矿传供应商
+	 * 【必填】往来类型[bd_supplier:供应商, bos_user:人员, bd_customer:客户]，城矿传供应商
 	 */
 	private String asstacttype;
 	/**
-	 * 往来户.编码
+	 * 【必填】往来户.编码
 	 */
 	@JsonProperty("asstact_number")
 	private String asstactNumber;
 	/**
-	 * 付款方式[CASH:现购, CREDIT:赊购]，现购代表系统自动100%推付款，赊购可自由调整后续付款金额
+	 * 【必填】付款方式[CASH:现购, CREDIT:赊购]，现购代表系统自动100%推付款，赊购可自由调整后续付款金额
 	 */
 	private String purmode;
 	/**
-	 * 结算币别.货币代码，如 CNY
+	 * 【必填】结算币别.货币代码，如 CNY
 	 */
 	@JsonProperty("currency_number")
 	private String currencyNumber;
@@ -144,12 +144,12 @@ public class BfiApBillSaveDTO implements Serializable {
 	@JsonProperty("exratetable_number")
 	private String exratetableNumber;
 	/**
-	 * 付款组织.编码
+	 * 【必填】付款组织.编码
 	 */
 	@JsonProperty("payorg_number")
 	private String payorgNumber;
 	/**
-	 * 款项性质.编码，如 2001 材料采购
+	 * 【必填】款项性质.编码，如 2001 材料采购
 	 */
 	@JsonProperty("payproperty_number")
 	private String paypropertyNumber;
@@ -277,12 +277,12 @@ public class BfiApBillSaveDTO implements Serializable {
 	 */
 	private String billsrctype;
 	/**
-	 * 外部系统编号，候选键
+	 * 【必填】外部系统编号，候选键
 	 */
 	@JsonProperty("awrp_src_sys")
 	private String awrpSrcSys;
 	/**
-	 * 外部系统来源单据号，候选键，建议拼接
+	 * 【必填】外部系统来源单据号，候选键，建议拼接
 	 */
 	@JsonProperty("awrp_src_code")
 	private String awrpSrcCode;
@@ -297,12 +297,12 @@ public class BfiApBillSaveDTO implements Serializable {
 	@JsonProperty("awrp_src_con_no")
 	private String awrpSrcConNo;
 	/**
-	 * 外部单据类型
+	 * 【必填】外部单据类型
 	 */
 	@JsonProperty("awrp_src_type")
 	private String awrpSrcType;
 	/**
-	 * 明细分录
+	 * 【必填】明细分录
 	 */
 	@JsonProperty("detailentry")
 	private List<BfiApBillSaveEntryDTO> detailentry;
@@ -42,7 +42,7 @@ public class BfiApBillSaveEntryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 物料编码.编码，城矿对应物料（如 BYWL02.0141 废钢、WCY01.0001）
+	 * 【必填】物料编码.编码，城矿对应物料（如 BYWL02.0141 废钢、WCY01.0001）
 	 */
 	@JsonProperty("material_number")
 	private String materialNumber;
@@ -52,17 +52,17 @@ public class BfiApBillSaveEntryDTO implements Serializable {
 	@JsonProperty("expenseitem_number")
 	private String expenseitemNumber;
 	/**
-	 * 项目.项目编码，项目字段必填、若不涉及项目传编码999
+	 * 【必填】项目.项目编码，项目字段必填、若不涉及项目传编码999
 	 */
 	@JsonProperty("project_number")
 	private String projectNumber;
 	/**
-	 * 计量单位.编码，城矿传吨/千克
+	 * 【必填】计量单位.编码，城矿传吨/千克
 	 */
 	@JsonProperty("measureunit_number")
 	private String measureunitNumber;
 	/**
-	 * 数量，城矿传重量
+	 * 【必填】数量，城矿传重量
 	 */
 	private BigDecimal quantity;
 	/**
@@ -121,7 +121,7 @@ public class BfiApBillSaveEntryDTO implements Serializable {
 	@JsonProperty("e_tax")
 	private BigDecimal eTax;
 	/**
-	 * 外部系统来源分录标识，候选键，传明细行行ID或行编码
+	 * 【必填】外部系统来源分录标识，候选键，传明细行行ID或行编码
 	 */
 	@JsonProperty("awrp_entry_code")
 	private String awrpEntryCode;
@@ -88,7 +88,7 @@ public class BfiApBillSavePlanDTO implements Serializable {
 	@JsonProperty("planexpenseitem_number")
 	private String planexpenseitemNumber;
 	/**
-	 * 项目.项目编码，项目字段必填、若不涉及项目传编码999
+	 * 【必填】项目.项目编码，项目字段必填、若不涉及项目传编码999
 	 */
 	@JsonProperty("planproject_number")
 	private String planprojectNumber;
@@ -42,12 +42,12 @@ public class BfiApBillSavePreEntryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 单据类型[cas_paybill:付款处理, ap_paidbill:期初预付单]
+	 * 【必填】单据类型[cas_paybill:付款处理, ap_paidbill:期初预付单]
 	 */
 	@JsonProperty("y_billtype")
 	private String yBilltype;
 	/**
-	 * 预付款单id，对应星瀚单据的id
+	 * 【必填】预付款单id，对应星瀚单据的id
 	 */
 	@JsonProperty("y_billid")
 	private String yBillid;
@@ -46,11 +46,11 @@ public class BfiArBillQueryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 页码，从1开始
+	 * 【必填】页码，从1开始
 	 */
 	private Integer pageNo;
 	/**
-	 * 页数
+	 * 【必填】页数
 	 */
 	private Integer pageSize;
 	/**
@@ -96,17 +96,17 @@ public class BfiArBillSaveDTO implements Serializable {
 	 */
 	private String billno;
 	/**
-	 * 单据类型.编码[arfin_standard_BT_S:标准销售应收, arfin_sersal_BT_S:服务销售应收, arfin_salefee_BT_S:销售费用应收, arfin_other_BT_S:其他应收, arfin_borrowar_BT_S:借贷项调整]
+	 * 【必填】单据类型.编码[arfin_standard_BT_S:标准销售应收, arfin_sersal_BT_S:服务销售应收, arfin_salefee_BT_S:销售费用应收, arfin_other_BT_S:其他应收, arfin_borrowar_BT_S:借贷项调整]
 	 */
 	@JsonProperty("billtype_number")
 	private String billtypeNumber;
 	/**
-	 * 结算组织.编码，城矿传 WCCK
+	 * 【必填】结算组织.编码，城矿传 WCCK
 	 */
 	@JsonProperty("org_number")
 	private String orgNumber;
 	/**
-	 * 单据日期，格式：yyyy-MM-dd HH:mm:ss，城矿传创建时间
+	 * 【必填】单据日期，格式：yyyy-MM-dd HH:mm:ss，城矿传创建时间
 	 */
 	private String bizdate;
 	/**
@@ -118,11 +118,11 @@ public class BfiArBillSaveDTO implements Serializable {
 	 */
 	private String bookdate;
 	/**
-	 * 往来类型[bd_supplier:供应商, bos_user:人员, bd_customer:客户]，城矿传客户
+	 * 【必填】往来类型[bd_supplier:供应商, bos_user:人员, bd_customer:客户]，城矿传客户
 	 */
 	private String asstacttype;
 	/**
-	 * 往来户.编码
+	 * 【必填】往来户.编码
 	 */
 	@JsonProperty("asstact_number")
 	private String asstactNumber;
@@ -132,16 +132,16 @@ public class BfiArBillSaveDTO implements Serializable {
 	@JsonProperty("recorg_number")
 	private String recorgNumber;
 	/**
-	 * 付款方式[CASH:现销, CREDIT:赊销]
+	 * 【必填】付款方式[CASH:现销, CREDIT:赊销]
 	 */
 	private String paymode;
 	/**
-	 * 款项性质.编码，如 1001 一般销售
+	 * 【必填】款项性质.编码，如 1001 一般销售
 	 */
 	@JsonProperty("payproperty_number")
 	private String paypropertyNumber;
 	/**
-	 * 结算币别.货币代码，如 CNY
+	 * 【必填】结算币别.货币代码，如 CNY
 	 */
 	@JsonProperty("currency_number")
 	private String currencyNumber;
@@ -249,12 +249,12 @@ public class BfiArBillSaveDTO implements Serializable {
 	 */
 	private String billsrctype;
 	/**
-	 * 外部系统编号，候选键
+	 * 【必填】外部系统编号，候选键
 	 */
 	@JsonProperty("awrp_src_sys")
 	private String awrpSrcSys;
 	/**
-	 * 外部系统来源单据号，候选键
+	 * 【必填】外部系统来源单据号，候选键
 	 */
 	@JsonProperty("awrp_src_code")
 	private String awrpSrcCode;
@@ -269,12 +269,12 @@ public class BfiArBillSaveDTO implements Serializable {
 	@JsonProperty("awrp_src_con_no")
 	private String awrpSrcConNo;
 	/**
-	 * 外部单据类型
+	 * 【必填】外部单据类型
 	 */
 	@JsonProperty("awrp_src_type")
 	private String awrpSrcType;
 	/**
-	 * 明细分录
+	 * 【必填】明细分录
 	 */
 	private List<BfiArBillSaveEntryDTO> entry;
 	/**
@@ -42,7 +42,7 @@ public class BfiArBillSaveEntryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 物料编码.编码
+	 * 【必填】物料编码.编码
 	 */
 	@JsonProperty("e_material_number")
 	private String eMaterialNumber;
@@ -52,17 +52,17 @@ public class BfiArBillSaveEntryDTO implements Serializable {
 	@JsonProperty("e_expenseitem_number")
 	private String eExpenseitemNumber;
 	/**
-	 * 项目.项目编码，项目字段必填、若不涉及项目传编码999
+	 * 【必填】项目.项目编码，项目字段必填、若不涉及项目传编码999
 	 */
 	@JsonProperty("project_number")
 	private String projectNumber;
 	/**
-	 * 计量单位.编码
+	 * 【必填】计量单位.编码
 	 */
 	@JsonProperty("e_measureunit_number")
 	private String eMeasureunitNumber;
 	/**
-	 * 数量
+	 * 【必填】数量
 	 */
 	@JsonProperty("e_quantity")
 	private BigDecimal eQuantity;
@@ -137,7 +137,7 @@ public class BfiArBillSaveEntryDTO implements Serializable {
 	@JsonProperty("awrp_src_con_eno")
 	private String awrpSrcConEno;
 	/**
-	 * 外部系统来源分录标识，候选键
+	 * 【必填】外部系统来源分录标识，候选键
 	 */
 	@JsonProperty("awrp_entry_code")
 	private String awrpEntryCode;
@@ -71,7 +71,7 @@ public class BfiArBillSavePlanDTO implements Serializable {
 	@JsonProperty("planexpenseitem_number")
 	private String planexpenseitemNumber;
 	/**
-	 * 项目.项目编码，项目字段必填、若不涉及项目传编码999
+	 * 【必填】项目.项目编码，项目字段必填、若不涉及项目传编码999
 	 */
 	@JsonProperty("planproject_number")
 	private String planprojectNumber;
@@ -45,15 +45,15 @@ public class BfiClaimAnnounceQueryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 参与认领用户名
+	 * 【必填】参与认领用户名
 	 */
 	private String claimusers;
 	/**
-	 * 页码，从1开始
+	 * 【必填】页码，从1开始
 	 */
 	private Integer pageNo;
 	/**
-	 * 页数
+	 * 【必填】页数
 	 */
 	private Integer pageSize;
 }
@@ -65,38 +65,38 @@ public class BfiClaimPushDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 认领公告id
+	 * 【必填】认领公告id
 	 */
 	private Long billid;
 	/**
-	 * 来源系统编码
+	 * 【必填】来源系统编码
 	 */
 	@JsonProperty("awrp_src_sys")
 	private String awrpSrcSys;
 	/**
-	 * 来源系统单据编码
+	 * 【必填】来源系统单据编码
 	 */
 	@JsonProperty("awrp_src_code")
 	private String awrpSrcCode;
 	/**
-	 * 收款类型.编码，如 101
+	 * 【必填】收款类型.编码，如 101
 	 */
 	@JsonProperty("recpaytype_number")
 	private String recpaytypeNumber;
 	/**
-	 * 付款人类型，如 bd_supplier
+	 * 【必填】付款人类型，如 bd_supplier
 	 */
 	private String paymenttype;
 	/**
-	 * 付款人名称
+	 * 【必填】付款人名称
 	 */
 	private String recviewpayer;
 	/**
-	 * 付款人id
+	 * 【必填】付款人id
 	 */
 	private String recpayer;
 	/**
-	 * 单据体分录
+	 * 【必填】单据体分录
 	 */
 	private List<BfiClaimPushEntryDTO> entryentity;
 }
@@ -42,7 +42,7 @@ public class BfiClaimPushEntryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 应收金额
+	 * 【必填】应收金额
 	 */
 	@JsonProperty("e_receivableamt")
 	private BigDecimal eReceivableamt;
@@ -41,11 +41,11 @@ public class BfiCustomerBankEntryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 银行账号，候选键，城矿对应 b_customer_info.bank_account
+	 * 【必填】银行账号，候选键，城矿对应 b_customer_info.bank_account
 	 */
 	private String bankaccount;
 	/**
-	 * 账户名称，城矿对应 b_customer_info.bank_name
+	 * 【必填】账户名称，城矿对应 b_customer_info.bank_name
 	 */
 	private String accountname;
 	/**
@@ -63,12 +63,12 @@ public class BfiCustomerBankEntryDTO implements Serializable {
 	 */
 	private String iban;
 	/**
-	 * 币种.货币代码，候选键，城矿传 CNY
+	 * 【必填】币种.货币代码，候选键，城矿传 CNY
 	 */
 	@JsonProperty("currency_number")
 	private String currencyNumber;
 	/**
-	 * 开户银行.编码（行号），候选键
+	 * 【必填】开户银行.编码（行号），候选键
 	 */
 	@JsonProperty("bank_number")
 	private String bankNumber;
@@ -43,12 +43,12 @@ public class BfiCustomerGroupEntryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 分类标准.编码，城矿固定 JBFLBZ
+	 * 【必填】分类标准.编码，城矿固定 JBFLBZ
 	 */
 	@JsonProperty("standardid_number")
 	private String standardidNumber;
 	/**
-	 * 分类.编码，城矿传 1102（外部客户）
+	 * 【必填】分类.编码，城矿传 1102（外部客户）
 	 */
 	@JsonProperty("groupid_number")
 	private String groupidNumber;
@@ -42,11 +42,11 @@ public class BfiCustomerQueryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 页码，从1开始
+	 * 【必填】页码，从1开始
 	 */
 	private Integer pageNo;
 	/**
-	 * 页数
+	 * 【必填】页数
 	 */
 	private Integer pageSize;
 	/**
@@ -75,7 +75,7 @@ public class BfiCustomerSaveDTO implements Serializable {
 	 */
 	private String number;
 	/**
-	 * 名称，城矿对应 b_customer_info.customer_name
+	 * 【必填】名称，城矿对应 b_customer_info.customer_name
 	 */
 	private String name;
 	/**
@@ -83,7 +83,7 @@ public class BfiCustomerSaveDTO implements Serializable {
 	 */
 	private String status;
 	/**
-	 * 伙伴类型[1:法人企业, 2:非法人企业, 3:非企业单位, 4:个人, 5:个体户, 6:民营企业, 7:非我区国有企业, 8:我区国有企业, 9:政府事业单位等, 10:农民专业合作社, 11:民政部门, 12:其他, 13:境外客商, 14:工会, 15:司法行政, 16:虚拟客商, 17:集体经济组织]，需与财务确认，城矿常用 4/6/8/9/16
+	 * 【必填】伙伴类型[1:法人企业, 2:非法人企业, 3:非企业单位, 4:个人, 5:个体户, 6:民营企业, 7:非我区国有企业, 8:我区国有企业, 9:政府事业单位等, 10:农民专业合作社, 11:民政部门, 12:其他, 13:境外客商, 14:工会, 15:司法行政, 16:虚拟客商, 17:集体经济组织]，需与财务确认，城矿常用 4/6/8/9/16
 	 */
 	private String type;
 	/**
@@ -106,7 +106,7 @@ public class BfiCustomerSaveDTO implements Serializable {
 	@JsonProperty("bizpartner_fax")
 	private String bizpartnerFax;
 	/**
-	 * 统一社会信用代码（个人填写身份证号或手机号），候选键，城矿对应 b_customer_info.registration_code
+	 * 【必填】统一社会信用代码（个人填写身份证号或手机号），候选键，城矿对应 b_customer_info.registration_code
 	 */
 	private String societycreditcode;
 	/**
@@ -153,7 +153,7 @@ public class BfiCustomerSaveDTO implements Serializable {
 	@JsonProperty("awrp_datasourcesys")
 	private String awrpDatasourcesys;
 	/**
-	 * 是否为贸易客商[A:是, B:否]，城矿传 A
+	 * 【必填】是否为贸易客商[A:是, B:否]，城矿传 A
 	 */
 	@JsonProperty("awrp_cusfortrade")
 	private String awrpCusfortrade;
@@ -187,7 +187,7 @@ public class BfiCustomerSaveDTO implements Serializable {
 	@JsonProperty("internal_company_number")
 	private String internalCompanyNumber;
 	/**
-	 * 分类标准分录，城矿固定传 standardid_number=JBFLBZ、groupid_number=1102（外部客户）
+	 * 【必填】分类标准分录，城矿固定传 standardid_number=JBFLBZ、groupid_number=1102（外部客户）
 	 */
 	@JsonProperty("entry_groupstandard")
 	private List<BfiCustomerGroupEntryDTO> entryGroupstandard;
@@ -54,17 +54,17 @@ public class BfiInvoiceApplyOpenApiBodyDTO implements Serializable {
 	 */
 	private String requestId;
 	/**
-	 * 来源系统，城矿传 WCCK
+	 * 【必填】来源系统，城矿传 WCCK
 	 */
 	@JsonProperty("businessSystemCode")
 	private String businessSystemCode;
 	/**
-	 * 接口编码，固定为 BILL.INVOICE.QUERY
+	 * 【必填】接口编码，固定为 BILL.INVOICE.QUERY
 	 */
 	@JsonProperty("interfaceCode")
 	private String interfaceCode;
 	/**
-	 * 请求 data，内容需加密成 base64 字符串
+	 * 【必填】请求 data，内容需加密成 base64 字符串
 	 */
 	private String data;
 }
@@ -41,11 +41,11 @@ public class BfiInvoiceApplyOpenApiQueryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 单据编号，即开票申请单的 billno 字段，多个用英文逗号隔开，上限50个
+	 * 【必填】单据编号，即开票申请单的 billno 字段，多个用英文逗号隔开，上限50个
 	 */
 	private String serialNo;
 	/**
-	 * 销方税号，即开票申请单的 salertaxno 字段
+	 * 【必填】销方税号，即开票申请单的 salertaxno 字段
 	 */
 	private String sellerTaxpayerId;
 }
@@ -46,11 +46,11 @@ public class BfiInvoiceApplyQueryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 页码，从1开始
+	 * 【必填】页码，从1开始
 	 */
 	private Integer pageNo;
 	/**
-	 * 页数
+	 * 【必填】页数
 	 */
 	private Integer pageSize;
 	/**
@@ -86,28 +86,28 @@ public class BfiInvoiceApplySaveDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 组织.编码，候选键，如 01.01.21.01
+	 * 【必填】组织.编码，候选键，如 01.01.21.01
 	 */
 	@JsonProperty("orgid_number")
 	private String orgidNumber;
 	/**
-	 * 业务单据编号，候选键，如 KPSQ-JCZX-202509-002283
+	 * 【必填】业务单据编号，候选键，如 KPSQ-JCZX-202509-002283
 	 */
 	private String billno;
 	/**
-	 * 单据日期，格式：yyyy-MM-dd HH:mm:ss
+	 * 【必填】单据日期，格式：yyyy-MM-dd HH:mm:ss
 	 */
 	private String billdate;
 	/**
-	 * 单据性质[-1:负数, 1:正数]
+	 * 【必填】单据性质[-1:负数, 1:正数]
 	 */
 	private String billproperties;
 	/**
-	 * 发票种类[10xdp:数电发票（普通发票）, 08xdp:数电发票（增值税专用发票）]
+	 * 【必填】发票种类[10xdp:数电发票（普通发票）, 08xdp:数电发票（增值税专用发票）]
 	 */
 	private String invoicetype;
 	/**
-	 * 征税方式[0:普通征税, 1:减按计征, 2:差额征税, 01:差额征税-全额开票, 02:差额征税-差额开票, 3:减按征税]
+	 * 【必填】征税方式[0:普通征税, 1:减按计征, 2:差额征税, 01:差额征税-全额开票, 02:差额征税-差额开票, 3:减按征税]
 	 */
 	private String taxationstyle;
 	/**
@@ -123,7 +123,7 @@ public class BfiInvoiceApplySaveDTO implements Serializable {
 	 */
 	private String reviewer;
 	/**
-	 * 发票推送邮箱，邮箱必填
+	 * 【必填】发票推送邮箱，邮箱必填
 	 */
 	private String buyeremail;
 	/**
@@ -135,11 +135,11 @@ public class BfiInvoiceApplySaveDTO implements Serializable {
 	 */
 	private String buyerphone;
 	/**
-	 * 购方企业类型[0:企业, 1:个人, 2:非企业单位]
+	 * 【必填】购方企业类型[0:企业, 1:个人, 2:非企业单位]
 	 */
 	private String buyerproperty;
 	/**
-	 * 购方纳税人识别号
+	 * 【必填】购方纳税人识别号
 	 */
 	private String buyertaxno;
 	/**
@@ -159,11 +159,11 @@ public class BfiInvoiceApplySaveDTO implements Serializable {
 	 */
 	private String buyerbank;
 	/**
-	 * 销方名称
+	 * 【必填】销方名称
 	 */
 	private String salername;
 	/**
-	 * 销方纳税人识别号
+	 * 【必填】销方纳税人识别号
 	 */
 	private String salertaxno;
 	/**
@@ -183,7 +183,7 @@ public class BfiInvoiceApplySaveDTO implements Serializable {
 	 */
 	private String salerbank;
 	/**
-	 * 申请价税合计
+	 * 【必填】申请价税合计
 	 */
 	private BigDecimal totalamount;
 	/**
@@ -199,7 +199,7 @@ public class BfiInvoiceApplySaveDTO implements Serializable {
 	 */
 	private String specialtype;
 	/**
-	 * 购方名称
+	 * 【必填】购方名称
 	 */
 	private String buyername;
 	/**
@@ -239,7 +239,7 @@ public class BfiInvoiceApplySaveDTO implements Serializable {
 	 */
 	private Boolean taxadjust;
 	/**
-	 * 客户.编码
+	 * 【必填】客户.编码
 	 */
 	@JsonProperty("customnameid_number")
 	private String customnameidNumber;
@@ -256,7 +256,7 @@ public class BfiInvoiceApplySaveDTO implements Serializable {
 	 */
 	private BigDecimal contractamount;
 	/**
-	 * 项目.项目编码
+	 * 【必填】项目.项目编码
 	 */
 	@JsonProperty("awrp_project_number")
 	private String awrpProjectNumber;
@@ -286,7 +286,7 @@ public class BfiInvoiceApplySaveDTO implements Serializable {
 	@JsonProperty("bizcontroltype_number")
 	private String bizcontroltypeNumber;
 	/**
-	 * 申请部门.编码
+	 * 【必填】申请部门.编码
 	 */
 	@JsonProperty("awrp_orgfield_number")
 	private String awrpOrgfieldNumber;
@@ -47,7 +47,7 @@ public class BfiInvoiceApplySaveEntryDTO implements Serializable {
 	@JsonProperty("expenseitem_number")
 	private String expenseitemNumber;
 	/**
-	 * 税收分类编码.编码，如 304060299
+	 * 【必填】税收分类编码.编码，如 304060299
 	 */
 	@JsonProperty("taxratecodeid_number")
 	private String taxratecodeidNumber;
@@ -96,15 +96,15 @@ public class BfiInvoiceApplySaveEntryDTO implements Serializable {
 	 */
 	private String goodscode;
 	/**
-	 * 商品名称
+	 * 【必填】商品名称
 	 */
 	private String goodsname;
 	/**
-	 * 简称，如 鉴证咨询服务
+	 * 【必填】简称，如 鉴证咨询服务
 	 */
 	private String goodssimplename;
 	/**
-	 * 基准类型[0:数量基准, 1:金额基准]
+	 * 【必填】基准类型[0:数量基准, 1:金额基准]
 	 */
 	private String benchmark;
 	/**
@@ -134,7 +134,7 @@ public class BfiInvoiceApplySaveEntryDTO implements Serializable {
 	@JsonProperty("materielfield_number")
 	private String materielfieldNumber;
 	/**
-	 * 行性质[1:折扣行, 2:商品行]，折扣行需紧跟被折扣行后面
+	 * 【必填】行性质[1:折扣行, 2:商品行]，折扣行需紧跟被折扣行后面
 	 */
 	private String rowtype;
 	/**
@@ -156,7 +156,7 @@ public class BfiInvoiceApplySaveEntryDTO implements Serializable {
 	@JsonProperty("awrp_entry_code")
 	private String awrpEntryCode;
 	/**
-	 * 外部单据类型
+	 * 【必填】外部单据类型
 	 */
 	@JsonProperty("awrp_src_type")
 	private String awrpSrcType;
@@ -59,11 +59,11 @@ public class BfiInvoiceAssignBodyDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 指定关系数据
+	 * 【必填】指定关系数据
 	 */
 	private List<BfiInvoiceAssignItemDTO> data;
 	/**
-	 * 操作类型[assign:指定, unassign:取消指定]
+	 * 【必填】操作类型[assign:指定, unassign:取消指定]
 	 */
 	private String op;
 }
@@ -42,12 +42,12 @@ public class BfiInvoiceAssignItemDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 收票单（来源系统单号+来源系统编码）
+	 * 【必填】收票单（来源系统单号+来源系统编码）
 	 */
 	@JsonProperty("ap_invoice")
 	private List<BfiInvoiceAssignRefDTO> apInvoice;
 	/**
-	 * 财务应付单（来源系统单号+来源系统编码），op 为 assign 时必录
+	 * 【必填】财务应付单（来源系统单号+来源系统编码），op 为 assign 时必录
 	 */
 	@JsonProperty("ap_finapbill")
 	private List<BfiInvoiceAssignRefDTO> apFinapbill;
@@ -41,12 +41,12 @@ public class BfiInvoiceAssignRefDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 来源系统单号
+	 * 【必填】来源系统单号
 	 */
 	@JsonProperty("awrp_src_code")
 	private String awrpSrcCode;
 	/**
-	 * 来源系统编码
+	 * 【必填】来源系统编码
 	 */
 	@JsonProperty("awrp_src_sys")
 	private String awrpSrcSys;
@@ -48,7 +48,7 @@ public class BfiInvoiceDownloadDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 文件url，如票池发票的 downloadUrl/imageUrl
+	 * 【必填】文件url，如票池发票的 downloadUrl/imageUrl
 	 */
 	private String path;
 }
@@ -51,7 +51,7 @@ public class BfiInvoicePoolQueryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 查询参数，键值对形式，如 invoiceNo（发票号码），字段明细参考 https://open.piaozone.com/api-145421056
+	 * 【必填】查询参数，键值对形式，如 invoiceNo（发票号码），字段明细参考 https://open.piaozone.com/api-145421056
 	 */
 	private Map<String, Object> queryParam;
 }
@@ -47,20 +47,20 @@ public class BfiRecBillQueryDTO implements Serializable {
 	@Serial
 	private static final long serialVersionUID = 1L;
 	/**
-	 * 页码，从1开始
+	 * 【必填】页码，从1开始
 	 */
 	private Integer pageNo;
 	/**
-	 * 页数
+	 * 【必填】页数
 	 */
 	private Integer pageSize;
 	/**
-	 * 开始业务日期，格式：yyyy-MM-dd，限定时间范围不可超过1个月
+	 * 【必填】开始业务日期，格式：yyyy-MM-dd，限定时间范围不可超过1个月
 	 */
 	@JsonProperty("begin_bizdate")
 	private String beginBizdate;
 	/**
-	 * 结束业务日期，格式：yyyy-MM-dd
+	 * 【必填】结束业务日期，格式：yyyy-MM-dd
 	 */
 	@JsonProperty("end_bizdate")
 	private String endBizdate;
@@ -61,11 +61,11 @@ public class BfiReceivedInvoiceQueryDTO implements Serializable {
 	 */
 	private String billstatus;
 	/**
-	 * 修改时间-开始，格式：yyyy-MM-dd HH:mm:ss
+	 * 【必填】修改时间-开始，格式：yyyy-MM-dd HH:mm:ss
 	 */
 	private String modifytime;
 	/**
-	 * 修改时间-结束，格式：yyyy-MM-dd HH:mm:ss
+	 * 【必填】修改时间-结束，格式：yyyy-MM-dd HH:mm:ss
 	 */
 	private String modifytimeE;
 	/**
@@ -77,7 +77,7 @@ public class BfiReceivedInvoiceQueryDTO implements Serializable {
 	 */
 	private String asstactname;
 	/**
-	 * 购方名称
+	 * 【必填】购方名称
 	 */
 	private String buyername;
 }
@@ -93,12 +93,12 @@ public class BfiReceivedInvoiceSaveDTO implements Serializable {
 	 */
 	private String billno;
 	/**
-	 * 外部系统编号，候选键
+	 * 【必填】外部系统编号，候选键
 	 */
 	@JsonProperty("awrp_src_sys")
 	private String awrpSrcSys;
 	/**
-	 * 外部系统来源单据号，候选键
+	 * 【必填】外部系统来源单据号，候选键
 	 */
 	@JsonProperty("awrp_src_code")
 	private String awrpSrcCode;
@@ -111,19 +111,19 @@ public class BfiReceivedInvoiceSaveDTO implements Serializable {
 	 */
 	private String invoicecode;
 	/**
-	 * 收票日期，格式：yyyy-MM-dd HH:mm:ss
+	 * 【必填】收票日期，格式：yyyy-MM-dd HH:mm:ss
 	 */
 	private String receivedate;
 	/**
-	 * 开票日期，格式：yyyy-MM-dd HH:mm:ss
+	 * 【必填】开票日期，格式：yyyy-MM-dd HH:mm:ss
 	 */
 	private String issuedate;
 	/**
-	 * 业务类型[PUR:采购, FEE:费用]
+	 * 【必填】业务类型[PUR:采购, FEE:费用]
 	 */
 	private String biztype;
 	/**
-	 * 发票类型.编码[1:增值税电子普通发票, 2:增值税电子专用发票, 10:飞机票, 11:其他发票, 12:机动车销售统一发票, 13:二手车销售统一发票, 14:定额发票, 15:道路通行费电子普通发票, 16:汽车票, 17:过路（过桥）费发票, 19:税收完税证明, 20:轮船票, 21:海关缴款书, 23:通用机打电子发票, 24:火车票退票凭证, 25:财政电子票据, 26:数电发票（普通发票）, 27:数电发票（增值税专用发票）, 28:数电发票（航空运输电子客票行程单）, 29:数电发票（铁路电子客票）]
+	 * 【必填】发票类型.编码[1:增值税电子普通发票, 2:增值税电子专用发票, 10:飞机票, 11:其他发票, 12:机动车销售统一发票, 13:二手车销售统一发票, 14:定额发票, 15:道路通行费电子普通发票, 16:汽车票, 17:过路（过桥）费发票, 19:税收完税证明, 20:轮船票, 21:海关缴款书, 23:通用机打电子发票, 24:火车票退票凭证, 25:财政电子票据, 26:数电发票（普通发票）, 27:数电发票（增值税专用发票）, 28:数电发票（航空运输电子客票行程单）, 29:数电发票（铁路电子客票）]
 	 */
 	@JsonProperty("invoicetypef7_number")
 	private String invoicetypef7Number;
@@ -132,30 +132,30 @@ public class BfiReceivedInvoiceSaveDTO implements Serializable {
 	 */
 	private String remark;
 	/**
-	 * 付款方式[CASH:现购, CREDIT:赊购]
+	 * 【必填】付款方式[CASH:现购, CREDIT:赊购]
 	 */
 	private String paymenttype;
 	/**
-	 * 往来类型[bd_supplier:供应商, bos_user:人员, bd_customer:客户]
+	 * 【必填】往来类型[bd_supplier:供应商, bos_user:人员, bd_customer:客户]
 	 */
 	private String asstacttype;
 	/**
-	 * 结算组织.编码
+	 * 【必填】结算组织.编码
 	 */
 	@JsonProperty("org_number")
 	private String orgNumber;
 	/**
-	 * 结算币别.货币代码，如 CNY
+	 * 【必填】结算币别.货币代码，如 CNY
 	 */
 	@JsonProperty("currency_number")
 	private String currencyNumber;
 	/**
-	 * 往来户.编码
+	 * 【必填】往来户.编码
 	 */
 	@JsonProperty("receivablessupp_number")
 	private String receivablessuppNumber;
 	/**
-	 * 汇率表.编码，如 01
+	 * 【必填】汇率表.编码，如 01
 	 */
 	@JsonProperty("exratetable_number")
 	private String exratetableNumber;
@@ -200,7 +200,7 @@ public class BfiReceivedInvoiceSaveDTO implements Serializable {
 	 */
 	private String selleracct;
 	/**
-	 * 销方名称
+	 * 【必填】销方名称
 	 */
 	private String asstactname;
 	/**
@@ -221,7 +221,7 @@ public class BfiReceivedInvoiceSaveDTO implements Serializable {
 	 */
 	private String buyerbank;
 	/**
-	 * 购方名称
+	 * 【必填】购方名称
 	 */
 	private String buyername;
 	/**
@@ -230,12 +230,12 @@ public class BfiReceivedInvoiceSaveDTO implements Serializable {
 	@JsonProperty("buyer_number")
 	private String buyerNumber;
 	/**
-	 * 外部单据类型
+	 * 【必填】外部单据类型
 	 */
 	@JsonProperty("awrp_src_type")
 	private String awrpSrcType;
 	/**
-	 * 明细分录
+	 * 【必填】明细分录
 	 */
 	private List<BfiReceivedInvoiceSaveEntryDTO> entry;
 	/**
@@ -46,30 +46,30 @@ public class BfiReceivedInvoiceSaveEntryDTO implements Serializable {
 	 */
 	private Long id;
 	/**
-	 * 价税合计
+	 * 【必填】价税合计
 	 */
 	@JsonProperty("e_pricetaxtotal")
 	private BigDecimal ePricetaxtotal;
 	/**
-	 * 数量
+	 * 【必填】数量
 	 */
 	private BigDecimal quantity;
 	/**
-	 * 单价
+	 * 【必填】单价
 	 */
 	private BigDecimal price;
 	/**
-	 * 物料编码.编码
+	 * 【必填】物料编码.编码
 	 */
 	@JsonProperty("material_number")
 	private String materialNumber;
 	/**
-	 * 税收分类.编码
+	 * 【必填】税收分类.编码
 	 */
 	@JsonProperty("e_taxclass_number")
 	private String eTaxclassNumber;
 	/**
-	 * 税率.编码，如 V13
+	 * 【必填】税率.编码，如 V13
 	 */
 	@JsonProperty("taxrateid_number")
 	private String taxrateidNumber;
@@ -84,7 +84,7 @@ public class BfiReceivedInvoiceSaveEntryDTO implements Serializable {
 	@JsonProperty("e_tax")
 	private BigDecimal eTax;
 	/**
-	 * 外部系统来源分录标识，候选键
+	 * 【必填】外部系统来源分录标识，候选键
 	 */
 	@JsonProperty("awrp_entry_code")
 	private String awrpEntryCode;