ds8-solution-pro/ds-wms-service/DS.WMS.Core/Fee/Interface/IFeeAuditService.cs

using DS.Module.Core;
using DS.WMS.Core.Fee.Dtos;
using DS.WMS.Core.Flow.Dtos;
using DS.WMS.Core.Op.Entity;
using DS.WMS.Core.TaskInteraction.Dtos;

namespace DS.WMS.Core.Fee.Interface
{
    /// <summary>
    /// 费用审核
    /// </summary>
    public interface IFeeAuditService
    {
        /// <summary>
        /// 获取列表分页数据
        /// </summary>
        /// <param name="request"></param>
        /// <returns></returns>
        Task<DataResult<List<FeeAuditBusiness>>> GetListAsync(PageRequest<bool> request);

        /// <summary>
        /// 获取整票审核列表
        /// </summary>
        /// <param name="request"></param>
        /// <returns></returns>
        Task<DataResult<List<FeeAuditBusiness>>> GetBizListAsync(PageRequest<bool> request);

        /// <summary>
        /// 根据查询条件获取费用明细
        /// </summary>
        /// <param name="request">请求参数</param>
        /// <returns></returns>
        Task<DataResult<PendingAuditFee>> GetFeesAsync(AuditDetailRequest request);

        /// <summary>
        /// 获取业务相关联的费用统计
        /// </summary>
        /// <param name="id">业务ID</param>
        /// <param name="businessType">业务类型</param>
        /// <param name="feeId">费用ID（可空）</param>
        /// <returns></returns>
        Task<DataResult<FeeAuditStatistics>> GetStatAsync(long id, BusinessType businessType, long? feeId);

        /// <summary>
        /// 按费用批量审批
        /// </summary>
        /// <param name="yesOrNo">审批结果</param>
        /// <param name="remark">备注</param>
        /// <param name="idArray">待审批的费用ID</param>
        /// <returns></returns>
        Task<DataResult> AuditAsync(int yesOrNo, string remark, params long[] idArray);

        /// <summary>
        /// 按业务批量审核
        /// </summary>
        /// <param name="request"></param>
        /// <returns></returns>
        Task<DataResult> AuditAsync(BizAuditRequest request);

        /// <summary>
        /// 一键审核当前登录用户的所有待审核项
        /// </summary>
        /// <param name="request"></param>
        /// <returns></returns>
        Task<DataResult> AuditAsync(AuditConditionRequest request);

        /// <summary>
        /// 整票审核
        /// </summary>
        /// <param name="request">审核请求</param>
        /// <returns></returns>
        Task<DataResult> AuditBillAsync(TaskAuditRequest request);

        /// <summary>
        /// 设置业务费用锁定状态
        /// </summary>
        /// <param name="items">业务信息</param>
        /// <returns></returns>
        Task<DataResult> SetFeeLockingAsync(IEnumerable<BusinessFeeStatus> items);

        /// <summary>
        /// 设置费用状态
        /// </summary>
        /// <param name="status">费用状态</param>
        /// <param name="ids">费用ID</param>
        /// <returns></returns>
        Task<DataResult> SetFeeStatusAsync(FeeStatus status, params long[] ids);

        /// <summary>
        /// 根据审批结果更新审批状态
        /// </summary>
        ///<param name="callback">回调信息</param>
        /// <returns></returns>
        Task<DataResult> UpdateStatusAsync(FlowCallback callback);
    }
}