package com.vincent.rsf.openApi.service;

import com.vincent.rsf.openApi.entity.dto.CommonResponse;
import com.vincent.rsf.openApi.entity.params.ErpMatnrParms;
import com.vincent.rsf.openApi.entity.params.ErpOpParams;
import com.vincent.rsf.openApi.entity.params.ReportParams;

import java.util.Map;

public interface WmsErpService {

    CommonResponse getOrderInfo(ErpOpParams params);

    /** 新增单据（兼容修改）：入/出库通知单下发，有则更新、无则新增 */
    CommonResponse addOrUpdateOrder(ErpOpParams params);

    /** 取消订单/取消单据：符合取消条件时执行取消逻辑 */
    CommonResponse orderCancel(ErpOpParams params);

    CommonResponse syncMatnrs(ErpMatnrParms parms);

    CommonResponse reportOrders(ReportParams params);

    CommonResponse reportCheck(ReportParams params);

    /** 库位信息查询（转发立库） */
    CommonResponse queryLocsDetls(Map<String, Object> params);

    /**
     * 通用转发：将云仓请求原样转发至立库 WMS（接口提供方：立库）
     * @param wmsPath 立库路径常量，见 WmsConstant
     * @param body 请求体，可为 List 或 Map/对象，null 时按空 body 转发
     */
    CommonResponse forwardToWms(String wmsPath, Object body);

    /** 对接协议 8.4 库存明细查询 */
    CommonResponse inventoryDetails(Map<String, Object> params);

    /** 对接协议 8.5 库存汇总查询 */
    CommonResponse inventorySummary(Map<String, Object> params);
}