gaoluyang
2026-11-03 006020bc9a87dc40c2e73bc50f244b348b831de1
yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/purchase/ErpPurchaseReturnService.java
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,101 @@
package cn.iocoder.yudao.module.erp.service.purchase;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.erp.controller.admin.purchase.vo.returns.ErpPurchaseReturnPageReqVO;
import cn.iocoder.yudao.module.erp.controller.admin.purchase.vo.returns.ErpPurchaseReturnSaveReqVO;
import cn.iocoder.yudao.module.erp.dal.dataobject.purchase.ErpPurchaseReturnDO;
import cn.iocoder.yudao.module.erp.dal.dataobject.purchase.ErpPurchaseReturnItemDO;
import jakarta.validation.Valid;
import java.math.BigDecimal;
import java.util.Collection;
import java.util.List;
/**
 * ERP é‡‡è´­é€€è´§ Service æŽ¥å£
 *
 * @author èŠ‹é“æºç 
 */
public interface ErpPurchaseReturnService {
    /**
     * åˆ›å»ºé‡‡è´­é€€è´§
     *
     * @param createReqVO åˆ›å»ºä¿¡æ¯
     * @return ç¼–号
     */
    Long createPurchaseReturn(@Valid ErpPurchaseReturnSaveReqVO createReqVO);
    /**
     * æ›´æ–°é‡‡è´­é€€è´§
     *
     * @param updateReqVO æ›´æ–°ä¿¡æ¯
     */
    void updatePurchaseReturn(@Valid ErpPurchaseReturnSaveReqVO updateReqVO);
    /**
     * æ›´æ–°é‡‡è´­é€€è´§çš„状态
     *
     * @param id ç¼–号
     * @param status çŠ¶æ€
     */
    void updatePurchaseReturnStatus(Long id, Integer status);
    /**
     * æ›´æ–°é‡‡è´­é€€è´§çš„退款金额
     *
     * @param id ç¼–号
     * @param refundPrice é€€æ¬¾é‡‘额
     */
    void updatePurchaseReturnRefundPrice(Long id, BigDecimal refundPrice);
    /**
     * åˆ é™¤é‡‡è´­é€€è´§
     *
     * @param ids ç¼–号数组
     */
    void deletePurchaseReturn(List<Long> ids);
    /**
     * èŽ·å¾—é‡‡è´­é€€è´§
     *
     * @param id ç¼–号
     * @return é‡‡è´­é€€è´§
     */
    ErpPurchaseReturnDO getPurchaseReturn(Long id);
    /**
     * æ ¡éªŒé‡‡è´­é€€è´§ï¼Œå·²ç»å®¡æ ¸é€šè¿‡
     *
     * @param id ç¼–号
     * @return é‡‡è´­é€€è´§
     */
    ErpPurchaseReturnDO validatePurchaseReturn(Long id);
    /**
     * èŽ·å¾—é‡‡è´­é€€è´§åˆ†é¡µ
     *
     * @param pageReqVO åˆ†é¡µæŸ¥è¯¢
     * @return é‡‡è´­é€€è´§åˆ†é¡µ
     */
    PageResult<ErpPurchaseReturnDO> getPurchaseReturnPage(ErpPurchaseReturnPageReqVO pageReqVO);
    // ==================== é‡‡è´­é€€è´§é¡¹ ====================
    /**
     * èŽ·å¾—é‡‡è´­é€€è´§é¡¹åˆ—è¡¨
     *
     * @param returnId é‡‡è´­é€€è´§ç¼–号
     * @return é‡‡è´­é€€è´§é¡¹åˆ—表
     */
    List<ErpPurchaseReturnItemDO> getPurchaseReturnItemListByReturnId(Long returnId);
    /**
     * èŽ·å¾—é‡‡è´­é€€è´§é¡¹ List
     *
     * @param returnIds é‡‡è´­é€€è´§ç¼–号数组
     * @return é‡‡è´­é€€è´§é¡¹ List
     */
    List<ErpPurchaseReturnItemDO> getPurchaseReturnItemListByReturnIds(Collection<Long> returnIds);
}