From 51843586c44ceb65a5c906cce597cf980d4ab459 Mon Sep 17 00:00:00 2001
From: zhouz <>
Date: Sat, 22 Aug 2026 12:02:35 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E5=AE=9A=E4=B9=89ACS=E7=A9=BA=E6=9C=A8?=
 =?UTF-8?q?=E7=AE=B1=E5=85=A5=E5=BA=93=E5=8D=8F=E8=AE=AE=EF=BC=88=E4=BB=BB?=
 =?UTF-8?q?=E5=8A=A11/4=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../acs/vo/AcsApplyInboundReqVO.java          |  4 ++--
 .../acs/vo/AcsEmptyBoxInboundApplyReqVO.java  | 24 +++++++++++++++++++
 .../acs/vo/AcsEmptyBoxInboundApplyRespVO.java | 21 ++++++++++++++++
 .../wms/enums/acs/AcsInboundTaskTypeEnum.java | 24 +++++++++++++++++++
 4 files changed, 71 insertions(+), 2 deletions(-)
 create mode 100644 nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/controller/acs/vo/AcsEmptyBoxInboundApplyReqVO.java
 create mode 100644 nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/controller/acs/vo/AcsEmptyBoxInboundApplyRespVO.java
 create mode 100644 nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/enums/acs/AcsInboundTaskTypeEnum.java

diff --git a/nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/controller/acs/vo/AcsApplyInboundReqVO.java b/nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/controller/acs/vo/AcsApplyInboundReqVO.java
index 5f2a8138..2dc58200 100644
--- a/nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/controller/acs/vo/AcsApplyInboundReqVO.java
+++ b/nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/controller/acs/vo/AcsApplyInboundReqVO.java
@@ -5,14 +5,14 @@ import lombok.Data;
 
 /**
  * acs请求入库任务
- * 6-申请空拖盘入库；7-申请空木箱入库；8-申请退货入库；9-申请成品入库
+ * 1-申请空托盘入库；2-申请空木箱入库；3-申请退货入库；4-申请成品入库
  * @Author: liyongde
  * @Date: 2026/8/4 9:52
  */
 @Data
 public class AcsApplyInboundReqVO {
     /**
-     * 类型：6-申请空拖盘入库；7-申请空木箱入库；8-申请退货入库；9-申请成品入库
+     * 类型：1-申请空托盘入库；2-申请空木箱入库；3-申请退货入库；4-申请成品入库
      */
     @NotEmpty(message = "入库请求类型不能为空")
     private String type;
diff --git a/nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/controller/acs/vo/AcsEmptyBoxInboundApplyReqVO.java b/nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/controller/acs/vo/AcsEmptyBoxInboundApplyReqVO.java
new file mode 100644
index 00000000..599e8f19
--- /dev/null
+++ b/nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/controller/acs/vo/AcsEmptyBoxInboundApplyReqVO.java
@@ -0,0 +1,24 @@
+package cn.code.nl.module.wms.controller.acs.vo;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+/**
+ * ACS 申请空木箱入库请求。
+ */
+@Data
+public class AcsEmptyBoxInboundApplyReqVO {
+
+    /** 申请入库的设备号。 */
+    @NotBlank(message = "设备号不能为空")
+    private String deviceCode;
+
+    /** 木箱类型编码。 */
+    @NotBlank(message = "木箱类型不能为空")
+    private String materialCode;
+
+    /** 入库业务类型，本接口只接受 2。 */
+    @NotNull(message = "任务类型不能为空")
+    private Integer taskType;
+}
diff --git a/nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/controller/acs/vo/AcsEmptyBoxInboundApplyRespVO.java b/nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/controller/acs/vo/AcsEmptyBoxInboundApplyRespVO.java
new file mode 100644
index 00000000..1c3ad754
--- /dev/null
+++ b/nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/controller/acs/vo/AcsEmptyBoxInboundApplyRespVO.java
@@ -0,0 +1,21 @@
+package cn.code.nl.module.wms.controller.acs.vo;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * ACS 申请空木箱入库结果。
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class AcsEmptyBoxInboundApplyRespVO {
+
+    /** 运输任务 ID。 */
+    private Long taskId;
+    /** 系统生成的虚拟空木箱号。 */
+    private String boxNo;
+    /** 分配并锁定的目标仓位编码。 */
+    private String targetStructCode;
+}
diff --git a/nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/enums/acs/AcsInboundTaskTypeEnum.java b/nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/enums/acs/AcsInboundTaskTypeEnum.java
new file mode 100644
index 00000000..016468bf
--- /dev/null
+++ b/nl-module-wms/nl-module-wms-server/src/main/java/cn/code/nl/module/wms/enums/acs/AcsInboundTaskTypeEnum.java
@@ -0,0 +1,24 @@
+package cn.code.nl.module.wms.enums.acs;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * ACS 入库申请业务类型。
+ */
+@Getter
+@AllArgsConstructor
+public enum AcsInboundTaskTypeEnum {
+
+    /** 申请空托盘入库。 */
+    EMPTY_PALLET(1),
+    /** 申请空木箱入库。 */
+    EMPTY_BOX(2),
+    /** 申请退货入库。 */
+    RETURNED_GOODS(3),
+    /** 申请成品入库。 */
+    FINISHED_GOODS(4);
+
+    /** 业务类型编码。 */
+    private final Integer code;
+}