云仓WMS接口

chen.lin

2 天以前 9140aee230de0ef41de9682a9353fbd372e2bcaa

 rsf-open-api/src/main/java/com/vincent/rsf/openApi/controller/WmsErpController.java

@@ -1,7 +1,4 @@
package com.vincent.rsf.openApi.controller;


import com.vincent.rsf.framework.common.R;
import com.vincent.rsf.framework.exception.CoolException;
import com.vincent.rsf.openApi.entity.dto.CommonResponse;
import com.vincent.rsf.openApi.entity.params.ErpMatnrParms;
@@ -20,7 +17,7 @@
import java.util.Objects;

@RestController
@RequestMapping("/erp")
@RequestMapping({"/erp","/cloudwms"})
@Api("ERP接口对接")
public class WmsErpController {

@@ -44,50 +41,37 @@


    /**
     * 订单修改
     * @param params
     * @return
     * 入/出库通知单下发（对接协议 8.3）：新增/修改/取消。operateType 1新增 2修改 3取消，不传或 1/2 时有则更新、无则新增；3 时按取消。
     * @param params 单据参数（含 orderNo、orderItems、operateType 等，见对接文档）
     * @return 操作结果
     */
    @ApiOperation("单据修改")
    @PostMapping("/order/upadte")
    public CommonResponse modifyOrderDtel(@RequestBody ErpOpParams params) {
        if (Objects.isNull(params)) {
            throw new CoolException("参数不能为空！！");
        }
        return wmsErpService.updateOrderDetl(params);
    }


    /**
     * 订单新增
     * @param params
     * @return
     */
    @ApiOperation("新增单据")
    @ApiOperation("新增单据（兼容修改、取消）")
    @PostMapping("/order/add")
    public CommonResponse orderAdd(@RequestBody ErpOpParams params) {
        if (Objects.isNull(params)) {
            throw new CoolException("参数不能为空！！");
        }
        return wmsErpService.updateOrderDetl(params);
        return wmsErpService.addOrUpdateOrder(params);
    }


    /**
     * 删除订单
     * @param params
     * @return
     * 取消订单/取消单据。与 /order/add 传 operateType=3 的取消逻辑一致，均转发立库 sync/orders/delete。
     * @param params 至少包含 orderNo，可选 orderItems
     */
    @ApiOperation("删除订单")
    @PostMapping("/order/del")
    public CommonResponse orderDel(@RequestBody ErpOpParams params) {
    @ApiOperation("取消订单")
    @PostMapping({"/order/cancel", "/order/del"})
    public CommonResponse orderCancel(@RequestBody ErpOpParams params) {
        if (Objects.isNull(params)) {
            throw new CoolException("参数不能为空！！");
        }
        return wmsErpService.orderDel(params);
        return wmsErpService.orderCancel(params);
    }

    @ApiOperation("基础物料信息更新")
    /**
     * 物料基础信息同步（对接协议 8.2）
     * 支持 operateType：1新增 2修改 3禁用 4启用；请求体支持协议字段 matNr/makTx 与 matnr/maktx。
     */
    @ApiOperation("基础物料信息同步（支持 operateType、matNr/makTx）")
    @PostMapping("/mat/sync/auth/v1")
    public CommonResponse syncMatnrs(@RequestBody ErpMatnrParms parms) {
        if (Objects.isNull(parms)) {
@@ -97,19 +81,37 @@
    }


    @ApiOperation("订单信息上报")
    @PostMapping("/report/order")
    public CommonResponse reportOrders(@RequestBody ReportParams params) {
        if (Objects.isNull(params)) {
            throw new CoolException("参数不能为空！！");
        }
        return wmsErpService.reportOrders(params);
//    @ApiOperation("订单信息上报")
//    @PostMapping("/report/order")
//    public CommonResponse reportOrders(@RequestBody ReportParams params) {
//        if (Objects.isNull(params)) {
//            throw new CoolException("参数不能为空！！");
//        }
//        return wmsErpService.reportOrders(params);
//    }
//
//    @ApiOperation("盘点差异修改")
//    @PostMapping("/check/locitem/update")
//    public CommonResponse reportCheck(@RequestBody ReportParams params) {
//        return wmsErpService.reportCheck(params);
//    }

    @ApiOperation("库位信息查询")
    @PostMapping("/query/locs/detls")
    public CommonResponse queryLocsDetls(@RequestBody Map<String, Object> params) {
        return wmsErpService.queryLocsDetls(params);
    }

    @ApiOperation("盘点差异修改")
    @PostMapping("/report/check")
    public CommonResponse reportCheck(@RequestBody Map<String, Object> params) {
        return wmsErpService.reportCheck(params);
    @ApiOperation("库存明细查询（对接协议8.4）")
    @PostMapping("/inventory/details")
    public CommonResponse inventoryDetails(@RequestBody(required = false) Map<String, Object> params) {
        return wmsErpService.inventoryDetails(params);
    }

    @ApiOperation("库存汇总查询（对接协议8.5）")
    @PostMapping("/inventory/summary")
    public CommonResponse inventorySummary(@RequestBody(required = false) Map<String, Object> params) {
        return wmsErpService.inventorySummary(params);
    }

}