✨ 正式结算单新增全票池发票认领查询端点（多条件+内存精确分页）

2026-09-20 19:41:19 +08:00
parent 31a039245c
commit 9a35d408dc
5 changed files with 278 additions and 0 deletions
@@ -0,0 +1,74 @@
+/**
+ * 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.transport.pojo.dto;
+
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+
+/**
+ * 正式结算单认领查询 全票池发票查询条件
+ *
+ * @author Chill
+ */
+@Data
+public class FormalSettlementInvoicePoolQueryDTO implements Serializable {
+	@Serial
+	private static final long serialVersionUID = 1L;
+	/**
+	 * 页码，默认 1
+	 */
+	private Long current = 1L;
+	/**
+	 * 每页条数，默认 10，最大 500
+	 */
+	private Long size = 10L;
+	/**
+	 * 发票号码
+	 */
+	private String invoiceNo;
+	/**
+	 * 开票日期起 yyyy-MM-dd
+	 */
+	private String invoiceDateStart;
+	/**
+	 * 开票日期止 yyyy-MM-dd
+	 */
+	private String invoiceDateEnd;
+	/**
+	 * 销方税号
+	 */
+	private String salerTaxNo;
+	/**
+	 * 购方税号
+	 */
+	private String buyerTaxNo;
+	/**
+	 * 单据使用状态，多个用英文逗号分隔[1未用,30在用,60已用,65已入账]
+	 */
+	private String expenseStatus;
+}
@@ -0,0 +1,87 @@
+/**
+ * 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.transport.pojo.vo;
+
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+import java.math.BigDecimal;
+
+/**
+ * 正式结算单认领查询 全票池发票VO
+ *
+ * @author Chill
+ */
+@Data
+public class FormalSettlementInvoicePoolVO implements Serializable {
+	@Serial
+	private static final long serialVersionUID = 1L;
+	/**
+	 * 发票号码
+	 */
+	private String invoiceNo;
+	/**
+	 * 发票流水号
+	 */
+	private String serialNo;
+	/**
+	 * 开票日期
+	 */
+	private String invoiceDate;
+	/**
+	 * 发票类型名称
+	 */
+	private String invoiceTypeName;
+	/**
+	 * 税率（百分数，如 13）；票池明细缺失时为 null
+	 */
+	private BigDecimal taxRate;
+	/**
+	 * 发票金额（含税，取票池价税合计）
+	 */
+	private BigDecimal invoiceAmount;
+	/**
+	 * 可匹配发票金额（含税，本次口径等于价税合计）
+	 */
+	private BigDecimal availableInvoiceAmount;
+	/**
+	 * 认领金额（默认等于可匹配金额，由前端按结算余额分配）
+	 */
+	private BigDecimal matchedAmount;
+	/**
+	 * 开票单位（销方名称）
+	 */
+	private String salerName;
+	/**
+	 * 受票单位（购方名称）
+	 */
+	private String buyerName;
+	/**
+	 * 附件信息JSON，结构 {"source":"piaozone","path":"A801-2下载path","name":"文件名"}
+	 */
+	private String attachmentJson;
+}