foodie-server/ruoyi-admin/src/main/java/com/ruoyi/app/flashdelivery/dto/FlashDeliveryV2QuoteRequest.java

package com.ruoyi.app.flashdelivery.dto;

import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import lombok.Data;

import java.util.Date;
import java.util.List;

/**
 * v2 多点取送报价请求：物品主体整单只设置一次，取货点与收货点统一放在 stops 数组。
 * 与旧报价结构互斥；旧接口过渡期保留，见 FR-122。
 */
@Data
public class FlashDeliveryV2QuoteRequest {
    /** 业务场景，必填：HELP_SEND 帮送、HELP_PICKUP 帮取。 */
    private String serviceType;

    /** 配送等级，必填：NORMAL 普通、URGENT 一对一加急。 */
    private String deliveryType;

    /** 配送车型，必填：1=机车，2=轿车。 */
    private Integer vehicleType;

    /** 物品类别，整单一次；可选值与旧契约一致。 */
    private String packageType;

    /** 物品数量，整单一次，必须为大于 0 的整数。 */
    @JsonDeserialize(using = FlashDeliveryQuantityDeserializer.class)
    private Integer quantity;

    /** 物品重量范围，整单一次，决定车型运价；可选值与旧契约一致。 */
    private String weightRange;

    /** 物品体积、尺寸或其他规格说明，选填，最长 255 个字符。 */
    private String specification;

    /** 骑手小费，必填，整数新台币，没有时传 0。 */
    private Long tipAmount;

    /** 取件方式，选填，默认 NOW；SCHEDULED 表示预约取件。 */
    private String deliveryMode;

    /** 预约取件开始时间；SCHEDULED 时必填，NOW 时不得传。 */
    private Date scheduledPickupStartAt;

    /** 预约取件结束时间；SCHEDULED 时必填且晚于开始 30 分钟，NOW 时不得传。 */
    private Date scheduledPickupEndAt;

    /** 支付方式选填，缺省现金；服务端按闪送支付闸门校验。 */
    private String payType;

    /**
     * 统一站点数组，必填，顺序即用户添加顺序与骑手路线顺序。
     * 至少 1 个取货站与 1 个收货站，取货站必须全部位于收货站之前。
     */
    private List<FlashDeliveryV2StopRequest> stops;
}