Merge branch 'dev-ty1.2' into dev-bms-260826

2026-09-07 10:19:22 +08:00
parent ba3a540a94 627f63cbd3
commit 0c95470300
7 changed files with 272 additions and 22 deletions
@@ -92,11 +92,11 @@ public interface WmsServiceFeign {


    /**
-     * oms下发单保存
+     * oms下发单保存（返回执行结果，失败时OMS据此回滚下发标记，避免"OMS已下发/WMS无数据"的阻断）
     */
    @ApiOperation("oms下发单保存")
    @PostMapping(value = "/stockInOrderApi/omsInOrderAdd")
-    public void omsInOrderAdd(@RequestBody StockInOrder stockInOrder);
+    public AjaxResult omsInOrderAdd(@RequestBody StockInOrder stockInOrder);

    @ApiOperation("oms取消下发单保存")
    @PostMapping(value = "/stockOutOrderApi/cancelExecutionOrder")
@@ -119,11 +119,19 @@ public interface WmsServiceFeign {
    public AjaxResult checkOmsAssignInventory(@RequestBody List<OutMaterialDetail> outMaterialDetails);

    /**
-     * oms下发单明细保存
+     * oms下发单明细保存（返回执行结果，明细保存含自动审核链路，失败时OMS据此回滚）
     */
    @ApiOperation("oms下发单明细保存")
    @PostMapping(value = "/stockInOrderApi/omsInOrderAddDetail")
-    public void omsInOrderAddDetail(@RequestBody List<InMaterialDetail> inMaterialDetails);
+    public AjaxResult omsInOrderAddDetail(@RequestBody List<InMaterialDetail> inMaterialDetails);
+
+    /**
+     * oms取消下发入库执行单：WMS侧一个事务内逻辑删除下发链路产生的全部数据
+     * （入库单/明细、收货单/明细、收货任务、收货作业单/明细、质检单），已开始收货则报错拦截
+     */
+    @ApiOperation("oms取消下发入库单清理")
+    @PostMapping(value = "/stockInOrderApi/omsCancelInOrder")
+    public AjaxResult omsCancelInOrder(@RequestBody StockInOrder stockInOrder);

    @ApiOperation("oms查询物料列表")
    @GetMapping("/materialBaseInfoApi/queryList")
@@ -70,7 +70,10 @@ public class RemoteWmsFallbackFactory implements FallbackFactory<WmsServiceFeign
            }

            @Override
-            public void omsInOrderAdd(StockInOrder stockInOrder) {
+            public AjaxResult omsInOrderAdd(StockInOrder stockInOrder) {
+                //返回错误而非静默成功：下发主单保存失败必须让OMS感知并回滚下发标记，
+                //否则OMS显示已下发、WMS无数据，下游收货流程无从进行（流程阻断）
+                return AjaxResult.error("WMS入库单保存失败（服务降级）：" + cause.getMessage());
            }

            @Override
@@ -96,7 +99,15 @@ public class RemoteWmsFallbackFactory implements FallbackFactory<WmsServiceFeign
            }

            @Override
-            public void omsInOrderAddDetail(List<InMaterialDetail> inMaterialDetails) {
+            public AjaxResult omsInOrderAddDetail(List<InMaterialDetail> inMaterialDetails) {
+                //返回错误而非静默成功：明细保存（含自动审核）失败必须让OMS感知并回滚下发标记
+                return AjaxResult.error("WMS入库单明细保存失败（服务降级）：" + cause.getMessage());
+            }
+
+            @Override
+            public AjaxResult omsCancelInOrder(StockInOrder stockInOrder) {
+                //返回错误而非静默成功，让OMS侧取消下发能感知清理失败并整体回滚（取消下发可重试，WMS清理幂等）
+                return AjaxResult.error("WMS取消下发清理失败：" + cause.getMessage());
            }

            @Override