admin/src/Oms.Application/Dtos/Orders/OrderParcelCreateInput.cs

namespace Oms.Application.Dtos.Orders;

/// <summary>
/// 订单包裹入参。
/// </summary>
public class OrderParcelCreateInput
{
    /// <summary>
    /// 请求标识。
    /// </summary>
    public string? RequestId { get; set; }

    /// <summary>
    /// 客户单号。
    /// </summary>
    public string? ClientNo { get; set; }

    /// <summary>
    /// 跟踪号（可选）。
    /// </summary>
    public string? TrackNo { get; set; }

    /// <summary>
    /// 服务单号（可选，不传时系统自动生成）。
    /// </summary>
    public string? ServiceNo { get; set; }

    /// <summary>
    /// 产品编码。
    /// </summary>
    public string? ProductCode { get; set; }

    /// <summary>
    /// 渠道编码。
    /// </summary>
    public string? ChannelCode { get; set; }

    /// <summary>
    /// 货物属性。
    /// </summary>
    public string? CargoAttribute { get; set; }

    /// <summary>
    /// 出口报关方式。
    /// </summary>
    public string? ExportCustomsMode { get; set; }

    /// <summary>
    /// 仓库主键。
    /// </summary>
    public int? WarehouseId { get; set; }

    /// <summary>
    /// 客户主键。
    /// </summary>
    public int? CustomerId { get; set; }

    /// <summary>
    /// 长度。
    /// </summary>
    public decimal? Length { get; set; }

    /// <summary>
    /// 宽度。
    /// </summary>
    public decimal? Width { get; set; }

    /// <summary>
    /// 高度。
    /// </summary>
    public decimal? Height { get; set; }

    /// <summary>
    /// 实际重量。
    /// </summary>
    public decimal? ActualWeight { get; set; }

    /// <summary>
    /// 体积重量。
    /// </summary>
    public decimal? VolumetricWeight { get; set; }

    /// <summary>
    /// 计费重量。
    /// </summary>
    public decimal? ChargeableWeight { get; set; }

    /// <summary>
    /// 体积。
    /// </summary>
    public decimal? Cubic { get; set; }

    /// <summary>
    /// 是否 COD。
    /// </summary>
    public bool IsCod { get; set; }

    /// <summary>
    /// COD 币种。
    /// </summary>
    public string? CodCurrency { get; set; }

    /// <summary>
    /// COD 金额。
    /// </summary>
    public decimal? CodSum { get; set; }

    /// <summary>
    /// 申报币种。
    /// </summary>
    public string? DeclaredCurrency { get; set; }

    /// <summary>
    /// 申报金额。
    /// </summary>
    public decimal? DeclaredSum { get; set; }

    /// <summary>
    /// 客户勾选附加服务字典 code 列表（落库序列化为 JSON 数组）。
    /// </summary>
    public List<string>? AdditionalServices { get; set; }

    /// <summary>
    /// 是否偏远（预计算后可写入，供下单前公式/计费条件求值）。
    /// </summary>
    public byte? IsRemote { get; set; }

    /// <summary>
    /// 数量。
    /// </summary>
    public int? Quantity { get; set; }

    /// <summary>
    /// 收件人信息。
    /// </summary>
    public OrderParcelReceiverInput? Receiver { get; set; }

    /// <summary>
    /// 寄件人信息。
    /// </summary>
    public OrderParcelSenderInput? Sender { get; set; }

    /// <summary>
    /// 包裹内件集合。
    /// </summary>
    public List<OrderParcelItemInput> Items { get; set; } = [];

    /// <summary>
    /// 选用的优惠券实例 Id。
    /// </summary>
    public int? CouponInstanceId { get; set; }

    /// <summary>
    /// 仅保存为草稿，不执行预报计费与状态推进。
    /// </summary>
    public bool SaveAsDraft { get; set; }

    /// <summary>
    /// 到仓方式：selfShip / doorPickup。
    /// </summary>
    public string? InboundMethod { get; set; }

    /// <summary>
    /// 上门揽收时发件地址簿 Id。
    /// </summary>
    public int? SenderAddressId { get; set; }

    /// <summary>
    /// 期望揽收时间（上门揽收）。
    /// </summary>
    public DateTime? ExpectPickupTime { get; set; }

    /// <summary>
    /// 承运商编码（可后补）。
    /// </summary>
    public string? CarrierCode { get; set; }

    /// <summary>
    /// 承运服务（可后补）。
    /// </summary>
    public string? CarrierService { get; set; }
}