feat: 定义ACS空木箱入库协议（任务1/4）

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;

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;
+}

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;
+}

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;
+}