修改请求入库、处理异常任务接口

ruoyi-admin/src/main/java/com/ruoyi/api/domain/wcs2wms/ResponseResult.java

@@ -0,0 +1,36 @@
+package com.ruoyi.api.domain.wcs2wms;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * 请求响应信息
+ */
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class ResponseResult {
+
+    /**
+     * 状态码：200 成功，500 失败，400 参数错误
+     */
+    private Integer code;
+
+    /**
+     * 请求是否成功
+     */
+    private Integer success;
+
+    /**
+     * 提示信息
+     */
+    private boolean message;
+
+    /**
+     * 成功时返回任务信息对象
+     */
+    private Object result;
+
+
+}

ruoyi-admin/src/main/java/com/ruoyi/api/domain/wcs2wms/exception/TaskExceptionReceive.java

@@ -0,0 +1,36 @@
+package com.ruoyi.api.domain.wcs2wms.exception;
+
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+
+/**
+ * 出入库异常信息上报响应信息
+ *
+ * 【常见错误】
+ * 任务编号不可为空	未传 taskCode
+ * 未找到该任务信息xxxxx	taskCode 对应的任务在系统中不存在
+ */
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class TaskExceptionReceive {
+
+    /**
+     * 系统生成的任务编号（唯一）
+     */
+    private String taskCode;
+
+    /**
+     * 异请求时传入的 reqCode，原样回传
+     */
+    private String reqCode;
+
+    /**
+     * 转存库位编号
+     */
+    private String siteCode;
+
+}

ruoyi-admin/src/main/java/com/ruoyi/api/domain/wcs2wms/exception/TaskExceptionRequest.java

@@ -4,19 +4,42 @@ import lombok.AllArgsConstructor;
 import lombok.Data;
 import lombok.NoArgsConstructor;
 
+/**
+ * 出入库异常信息上报
+ */
 @Data
 @AllArgsConstructor
 @NoArgsConstructor
 public class TaskExceptionRequest {
 
     /**
-     * 任务号
+     * 异常任务类型
      */
-    private String taskNo;
+    private String taskTypeCode;
 
     /**
-     * 异常类型
+     * 需要上报异常的任务编号（系统任务号）
      */
-    private int exceptionType;
+    private String taskCode;
+
+    /**
+     * 异常类别：1-入库，2-出库
+     */
+    private String taskClass;
+
+    /**
+     * 请求唯一编号，原样回传
+     */
+    private String reqCode;
+
+    /**
+     * 异常信息
+     */
+    private String adverseCauses;
+
+    /**
+     * 异常任务的类型 - 1052-入库有货，2-出库无货
+     */
+    private int type;
 
 }

ruoyi-admin/src/main/java/com/ruoyi/api/domain/wcs2wms/stockin/StockinReceive.java

@@ -1,29 +1,43 @@
 package com.ruoyi.api.domain.wcs2wms.stockin;
 
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * 入库请求返回
+ *
+ * 【常见错误】
+ * 任务类型不可为空	未传 taskTypeCode
+ * 该任务类型未配置	taskTypeCode 在系统中不存在
+ * 该任务类型无点位配置信息	任务类型缺少点位模板
+ * 该任务类型未开启	任务类型状态为禁用
+ */
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
 public class StockinReceive {
 
     /**
-     * wms下发任务号
+     * 系统生成的任务编号（唯一）
      */
-    private String taskNo;
+    private String taskCode;
 
     /**
-     * WMS分配的目标库位编号
+     * 请求时传入的 reqCode，原样回传
      */
-    private String cargoSpaceId;
+    private String reqCode;
 
     /**
-     * 巷道编号
+     * 容器编号（containerCode）
      */
-    private String roadwayId;
+    private String cntCode;
 
     /**
-     * 作业单ID
+     * 终点库位编号
      */
-    private String jobId;
+    private String siteCode;
+
 
-    /**
-     * 入出库标识
-     */
-    private String inOrOut;
 }

ruoyi-admin/src/main/java/com/ruoyi/api/domain/wcs2wms/stockin/StockinRequest.java

@@ -13,24 +13,34 @@ import lombok.NoArgsConstructor;
 @NoArgsConstructor
 public class StockinRequest {
 
+    /**
+     * 任务类型编号（必填），对应 WMS 任务配置中的类型 code
+     */
+    private String taskTypeCode;
+
+    /**
+     * 请求码 - 请求唯一编号，原样回传到响应中，便于追踪
+     */
+    private String reqCode;
+
     /**
      * 托盘号
      */
-    private String trayCode;
+    private String cntCode;
 
     /**
-     * 重量
+     * 货物高度 - 0-第一档高度，1-第二档高度，2-超高
      */
-    private int weight;
+    private String altimetry;
 
     /**
-     * 货物高度
+     * 重量 - 0-正常，1-超重。
      */
-    private int height;
+    private String weight;
 
     /**
      * 异常信息
      */
-    private String errorInfo;
+    private String adverseCauses;
 
 }

ruoyi-admin/src/main/java/com/ruoyi/api/domain/wcs2wms/taskFinish/TaskFinishRequest.java

@@ -1,22 +1,32 @@
 package com.ruoyi.api.domain.wcs2wms.taskFinish;
 
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * 任务完成回传请求
+ */
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
 public class TaskFinishRequest {
 
     /**
-     * 任务号
+     * 任务类型（必填）
      */
-    private String taskNo;
+    private String taskTypeCode;
 
     /**
-     * 作业单ID
+     * 请求唯一编号，原样回传到响应中，便于追踪
      */
-    private String jobId;
+    private String reqCode;
 
     /**
-     * 完成类型枚举值
-     * 1-入库完成 2-出库完成
+     * 任务编号
      */
-    private String type;
+    private String taskCode;
 
 
 

ruoyi-admin/src/main/java/com/ruoyi/api/domain/wcs2wms/taskFinish/taskFinishReceive.java

@@ -1,4 +1,36 @@
 package com.ruoyi.api.domain.wcs2wms.taskFinish;
 
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+
+/**
+ * 任务完成回传响应
+ *
+ * 【常见错误】
+ * 任务编号不可为空	未传 taskCode
+ * 未找到该任务信息xxxxx	taskCode 对应的任务在系统中不存在
+ */
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
 public class taskFinishReceive {
+
+    /**
+     * 任务类型（必填）
+     */
+    private String taskTypeCode;
+
+    /**
+     * 请求唯一编号，原样回传到响应中，便于追踪
+     */
+    private String reqCode;
+
+    /**
+     * 任务编号
+     */
+    private String taskCode;
+
 }