+ * 提供 WMS 与 QMS 集成的质检相关服务 + * + * @author zch + * @date 2026-1-14 + */ +public interface RemoteQmsInspectionService { + + /** + * 为 WMS 入库单创建质检任务 + *
+ * 业务场景： + * 1. WMS 入库时判断物料是否需要质检（inspectionRequest = "0"） + * 2. 调用此接口创建质检任务，触发 8 级模板匹配策略 + * 3. 返回质检单号，WMS 更新入库单状态为"质检中" + *
+ * 说明：租户ID和用户ID从当前调用上下文自动获取（通过 LoginHelper 和 TenantHelper） + * + * @param request 质检任务请求参数 + * @return 质检单号 + */ + String createInspectionTaskForWMS(WmsInspectionTaskRequest request); + + /** + * 通知 WMS 质检完成（预留接口，暂不实现） + *
+ * 说明：质检完成回调采用 REST API 方式实现（POST /wsmApi/notifyInspectionComplete） + * 此 Dubbo 接口作为备用方案，未来如需服务间直接调用可启用 + *
+ * 说明：租户ID和用户ID从当前调用上下文自动获取
+ *
+ * @param notification 质检完成通知参数
+ * @return 处理结果
+ */
+ R
+ * 用于 QMS 质检完成后通知 WMS 完成入库操作
+ *
+ * 传递方式：
+ * 1. REST API：POST /wsmApi/notifyInspectionComplete（主要方式）
+ * 2. Dubbo 接口：RemoteQmsInspectionService.notifyInspectionComplete()（备用方式）
+ *
+ * @author zch
+ * @date 2026-1-14
+ */
+@Data
+@NoArgsConstructor
+public class InspectionCompleteNotification implements Serializable {
+
+ @Serial
+ private static final long serialVersionUID = 1L;
+
+ /**
+ * 质检单号
+ *
+ * 必填，用于关联质检单
+ */
+ private String inspectionNo;
+
+ /**
+ * 入库单号
+ *
+ * 必填，用于 WMS 定位入库记录
+ */
+ private String instockCode;
+
+ /**
+ * 质检结果
+ *
+ * 必填，0=合格，1=不合格
+ * WMS 根据此结果决定是否完成入库
+ */
+ private String result;
+
+ /**
+ * 质检状态
+ *
+ * 必填，0=未处理，1=已完成
+ * 只有状态为"已完成"时才通知 WMS
+ */
+ private String status;
+
+ /**
+ * 合格数量
+ *
+ * 必填，用于 WMS 更新库存
+ */
+ private BigDecimal qualifiedQty;
+
+ /**
+ * 不合格数量
+ *
+ * 必填，用于 WMS 生成不合格品记录
+ */
+ private BigDecimal unqualifiedQty;
+
+ /**
+ * 物料编码
+ *
+ * 可选，用于 WMS 校验
+ */
+ private String materialCode;
+
+ /**
+ * 质检完成时间
+ *
+ * 可选，用于记录日志
+ */
+ private String inspectionEndTime;
+
+}
diff --git a/ruoyi-api/pom.xml b/ruoyi-api/pom.xml
index 2e6458b2..1f6c05c4 100644
--- a/ruoyi-api/pom.xml
+++ b/ruoyi-api/pom.xml
@@ -20,6 +20,7 @@