package cn.iocoder.yudao.module.mes.api.returnsales;

import cn.iocoder.yudao.module.mes.api.returnsales.dto.MesWmReturnSalesCreateReqDTO;
import cn.iocoder.yudao.module.mes.api.returnsales.dto.MesWmReturnSalesLineRespDTO;

import java.util.List;

/**
 * MES 销售退货单 API 接口
 *
 * @author 超级管理员
 */
public interface MesWmReturnSalesApi {

    /**
     * 创建销售退货单（由售后模块调用）
     *
     * @param reqDTO 创建请求参数
     * @return 创建的销售退货单编号
     */
    Long createReturnSales(MesWmReturnSalesCreateReqDTO reqDTO);

    /** 取消尚未完成入库的销售退货单。 */
    void cancelReturnSales(Long id);

    /**
     * 查询销售退货单行（用于获取 MES 解析后回填的批次）
     *
     * @param returnSalesId 销售退货单编号
     * @return 退货单行列表
     */
    List<MesWmReturnSalesLineRespDTO> getReturnSalesLineList(Long returnSalesId);

}