package cn.iocoder.yudao.module.erp.api.purchase;
|
|
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
|
import cn.iocoder.yudao.module.erp.api.purchase.dto.ErpPurchaseOrderItemRespDTO;
|
import cn.iocoder.yudao.module.erp.api.purchase.dto.ErpPurchaseOrderRespDTO;
|
|
import java.math.BigDecimal;
|
import java.util.List;
|
|
/**
|
* ERP 采购订单 API 接口
|
*
|
* @author 芋道源码
|
*/
|
public interface ErpPurchaseOrderApi {
|
|
String PREFIX = "/rpc-api/erp/purchase-order";
|
|
/**
|
* 获取采购订单
|
*
|
* @param id 订单编号
|
* @return 采购订单
|
*/
|
CommonResult<ErpPurchaseOrderRespDTO> getPurchaseOrder(Long id);
|
|
/**
|
* 根据供应商编号获取采购订单列表（已审核状态）
|
*
|
* @param supplierId 供应商编号
|
* @return 采购订单列表
|
*/
|
CommonResult<List<ErpPurchaseOrderRespDTO>> getPurchaseOrderListBySupplierId(Long supplierId);
|
|
/**
|
* 根据编号列表获取采购订单列表
|
*
|
* @param ids 编号列表
|
* @return 采购订单列表
|
*/
|
CommonResult<List<ErpPurchaseOrderRespDTO>> getPurchaseOrderList(List<Long> ids);
|
|
/**
|
* 获取采购订单明细列表
|
*
|
* @param orderId 订单编号
|
* @return 明细列表
|
*/
|
CommonResult<List<ErpPurchaseOrderItemRespDTO>> getPurchaseOrderItemList(Long orderId);
|
|
/**
|
* 获取采购订单明细
|
*
|
* @param id 明细编号
|
* @return 明细
|
*/
|
CommonResult<ErpPurchaseOrderItemRespDTO> getPurchaseOrderItem(Long id);
|
|
/**
|
* 更新采购订单明细的入库数量
|
*
|
* @param orderItemId 明细编号
|
* @param inCount 入库数量增量
|
*/
|
CommonResult<Boolean> updateOrderItemInCount(Long orderItemId, BigDecimal inCount);
|
|
/**
|
* 更新采购订单的入库状态
|
*
|
* 根据明细入库数量自动计算订单状态：
|
* - 所有明细都完成入库 → 完成状态
|
* - 部分明细完成入库 → 部分入库状态
|
*
|
* @param orderId 订单编号
|
*/
|
CommonResult<Boolean> updateOrderInStatus(Long orderId);
|
|
}
|
