BookingHeChuan/Myshipping.Application/Service/BookingOrder/IBookingMSKSPOTAPIService.cs

using Microsoft.AspNetCore.Mvc;
using Myshipping.Core;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace Myshipping.Application.Service.BookingOrder
{
    // <summary>
    /// 马士基API SPOT 订舱
    /// </summary>
    public interface IBookingMSKSPOTAPIService
    {
        /// <summary>
        /// 检索始发地、目的港口信息
        /// </summary>
        /// <param name="model">请求详情</param>
        /// <returns>返回检索结果</returns>
        Task<List<MSKAPISPOTSearchLocationResultDataDto>> SearchLocations(QuerySPOTLocationsDto model);


        /// <summary>
        /// 检索海运船期详情
        /// </summary>
        /// <param name="model">请求船期详情</param>
        /// <returns>返回船期结果</returns>
        Task<List<MSKAPISPOTSearchScheduleRateResultDataDto>> SearchShipSailingSchedule(QueryMSKSPOTShipSailingScheduleDto model);

        /// <summary>
        /// 发送马士基订舱请求
        /// </summary>
        /// <param name="model">请求订舱详情</param>
        /// <returns>返回检索结果</returns>
        Task<MSKBookingResultDto> SendMSKBooking(MSKBookingDto model);

        /// <summary>
        /// 检索商品名称
        /// </summary>
        /// <param name="model">请求详情</param>
        /// <returns>返回检索结果</returns>
        Task<List<SearchCommodityResultDto>> SearchCommodities(QueryCommoditiesDto model);

        /// <summary>
        /// 获取马士基API订舱详情
        /// </summary>
        /// <param name="id">马士基API订舱ID</param>
        /// <returns>返回详情</returns>
        Task<MSKBookingDto> GetInfo(long id);

        /// <summary>
        /// 保存
        /// </summary>
        /// <param name="model">请求订舱详情</param>
        /// <returns>返回ID</returns>
        Task<long> Save(MSKBookingDto model);

        /// <summary>
        /// 删除
        /// </summary>
        /// <param name="id">请求订舱ID</param>
        /// <returns></returns>
        Task Delete(long id);

        /// <summary>
        /// 批量发送API前调取校验预警
        /// </summary>
        /// <param name="ids">马士基API订舱ID组</param>
        /// <returns>返回提示信息</returns>
        Task<string> CheckWarningBatchSend(long[] ids);

        /// <summary>
        /// 批量发送
        /// </summary>
        /// <param name="ids">马士基API订舱ID组</param>
        /// <returns>返回执行结果消息</returns>
        Task<string> BatchSend(long[] ids);

        /// <summary>
        /// 批量复制前调取校验预警
        /// </summary>
        /// <param name="model">马士基API批量复制指定数据</param>
        /// <returns>返回提示信息</returns>
        Task<string> CheckWarningBatchCopy(MSKAPIBookingCopyDto model);

        /// <summary>
        /// 批量复制
        /// </summary>
        /// <param name="model">马士基API批量复制指定数据</param>
        /// <returns>返回执行结果消息</returns>
        Task<string> BatchCopy(MSKAPIBookingCopyDto model);

        /// <summary>
        /// 同步BC状态（BC,Cancellation）
        /// </summary>
        /// <param name="mblno">提单号</param>
        /// <param name="tenantId">租户ID</param>
        /// <param name="opTypeName">操作类型 BC-同步BC状态 Cancellation-同步取消状态</param>
        /// <returns>返回回执</returns>
        Task<MSKBookingResultDto> SyncBCInfo(string mblno, long tenantId, string opTypeName = "BookingConfirmation");
    }
}