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.ErpPurchaseRequestRespDTO;

/**
 * ERP 采购申请 API 接口
 *
 * 供 SRM 等模块在审批通过后发起询价、回写台账时调用。
 */
public interface ErpPurchaseRequestApi {

    String PREFIX = "/rpc-api/erp/purchase-request";

    /**
     * 获取采购申请（含明细）
     *
     * @param id 采购申请编号
     * @return 采购申请
     */
    CommonResult<ErpPurchaseRequestRespDTO> getPurchaseRequest(Long id);

    /**
     * 回写采购申请关联的询价单
     *
     * @param id        采购申请编号
     * @param inquiryId 询价单编号
     * @param inquiryNo 询价单号
     * @return 是否成功
     */
    CommonResult<Boolean> updatePurchaseRequestInquiry(Long id, Long inquiryId, String inquiryNo);

    /**
     * 清除采购申请关联的询价单（询价单被取消/删除后，采购员可重新选择发起询价或直接生成台账）
     *
     * @param id 采购申请编号
     * @return 是否成功
     */
    CommonResult<Boolean> clearPurchaseRequestInquiry(Long id);

    /**
     * 回写采购申请关联的采购台账
     *
     * @param id      采购申请编号
     * @param orderId 采购台账编号
     * @param orderNo 采购台账单号
     * @return 是否成功
     */
    CommonResult<Boolean> updatePurchaseRequestOrder(Long id, Long orderId, String orderNo);

}