/*
 * Copyright ©2023 CJB-CNIT Team. All rights reserved
 */
package com.openhis.web.inventorymanage.appservice;

import com.core.common.core.domain.R;
import com.openhis.web.inventorymanage.dto.IssueDto;
import com.openhis.web.inventorymanage.dto.IssueSearchParam;

import javax.servlet.http.HttpServletRequest;
import java.util.List;

/**
 * 退货出库 appService
 *
 * @author CY
 * @date 2025-04-08
 */
public interface IReturnIssueAppService {

    /**
     * 出库退货单据页面初始化
     *
     * @return 初始化信息
     */
    R<?> returnIssueInit();

    /**
     * 单据号初始化
     *
     * @return 初始化信息
     */
    R<?> returnIssueNoInit();

    /**
     * 退货出库单据列表
     *
     * @param issueSearchParam 查询条件
     * @param pageNo 当前页码
     * @param pageSize 查询条数
     * @param searchKey 模糊查询关键字
     * @param request 请求数据
     * @return 退货出库单据分页列表
     */
    R<?> getPage(IssueSearchParam issueSearchParam, Integer pageNo, Integer pageSize, String searchKey,
                 HttpServletRequest request);

    /**
     * 退货出库单据详情
     *
     * @param busNo 单据号
     * @return 出库退货据详情
     */
    R<?> getDetail(String busNo);

    /**
     * 添加/编辑退货出库单据(批量)
     *
     * @param returnIssueDtoList 退货出库单据
     * @return 操作结果
     */
    R<?> addOrEditIssueReceipt(List<IssueDto> returnIssueDtoList);

    /**
     * 删除单据
     *
     * @param supplyRequestIds 供应请求id
     * @return 操作结果
     */
    R<?> deleteReceipt(List<Long> supplyRequestIds);

    /**
     * 提交审批
     *
     * @param busNo 单据号
     * @return 操作结果
     */
    R<?> submitApproval(String busNo);

    /**
     * 撤回审批
     *
     * @param busNo 单据号
     * @return 操作结果
     */
    R<?> withdrawApproval(String busNo);


    /**
     * 领用退库单据详情
     *
     * @param locationId 库房id
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @param pageNo 当前页码
     * @param pageSize 查询条数
     * @return 单据详情
     */
    R<?> getMonthlySettlementDetail(Long locationId, String startTime, String endTime,Integer pageNo, Integer pageSize);

}
