package cn.iocoder.yudao.module.erp.api.sale;
|
|
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
|
import cn.iocoder.yudao.module.erp.api.sale.dto.ErpSaleOrderCreateReqDTO;
|
import cn.iocoder.yudao.module.erp.api.sale.dto.ErpSaleOrderItemRespDTO;
|
import cn.iocoder.yudao.module.erp.api.sale.dto.ErpSaleOrderRespDTO;
|
|
import java.math.BigDecimal;
|
import java.util.List;
|
|
/**
|
* ERP 销售订单 API 接口
|
*
|
* @author 芋道源码
|
*/
|
public interface ErpSaleOrderApi {
|
|
String PREFIX = "/rpc-api/erp/sale-order";
|
|
/**
|
* 创建销售订单
|
*
|
* @param createReqDTO 创建信息
|
* @return 订单编号
|
*/
|
CommonResult<Long> createSaleOrder(ErpSaleOrderCreateReqDTO createReqDTO);
|
|
/**
|
* 获取销售订单
|
*
|
* @param id 订单编号
|
* @return 销售订单
|
*/
|
CommonResult<ErpSaleOrderRespDTO> getSaleOrder(Long id);
|
|
/**
|
* 根据合同编号获取销售订单
|
*
|
* @param contractId 合同编号
|
* @return 销售订单
|
*/
|
CommonResult<ErpSaleOrderRespDTO> getSaleOrderByContractId(Long contractId);
|
|
/**
|
* 获取销售订单明细列表
|
*
|
* @param orderId 订单编号
|
* @return 明细列表
|
*/
|
CommonResult<List<ErpSaleOrderItemRespDTO>> getSaleOrderItemList(Long orderId);
|
|
/**
|
* 获取销售订单明细
|
*
|
* @param id 明细编号
|
* @return 明细
|
*/
|
CommonResult<ErpSaleOrderItemRespDTO> getSaleOrderItem(Long id);
|
|
/**
|
* 更新销售订单明细的出库数量
|
*
|
* @param orderItemId 明细编号
|
* @param outCount 出库数量增量
|
*/
|
CommonResult<Boolean> updateOrderItemOutCount(Long orderItemId, BigDecimal outCount);
|
|
/**
|
* 更新销售订单的出库状态
|
*
|
* 根据明细出库数量自动计算订单状态：
|
* - 所有明细都完成出库 → 完成状态
|
* - 部分明细完成出库 → 部分出库状态
|
*
|
* @param orderId 订单编号
|
*/
|
CommonResult<Boolean> updateOrderOutStatus(Long orderId);
|
|
}
|
