package common.ecommerce.yqn.dto; import com.fasterxml.jackson.annotation.JsonInclude; import java.util.List; /** * 运去哪报文结构:创建入库计划单(API 97,/v1/inbound/createInboundPlan)。 * *

一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; * 与其它接口共用的结构各自复制一份,避免跨接口耦合。

*/ public final class YqnCreateInboundDtos { private YqnCreateInboundDtos() { } @JsonInclude(JsonInclude.Include.NON_NULL) public static final class CreateInboundPlanRequest { /** 入库仓库 CODE,必填。 */ public String warehouseCode; /** 项目名称。 */ public String lineCode; /** 0 正常库存 / 1 不可售库存,必填。 */ public Integer inventoryType; /** 工厂批次号。 */ public String batchNumber; /** 入库单号(外部来源单号),必填。 */ public String orderNo; /** Amazon 订单 ShipmentId。 */ public String shipmentId; /** Amazon 订单 referenceId。 */ public String referenceId; /** 单据币种,默认 USD;影响库存成本计算。 */ public String currency; /** 预计到仓 yyyy-MM-dd。 */ public String estimateArriveTime; public String originCountry; /** 期望到仓 yyyy-MM-dd。 */ public String expectArriveDate; /** 预计发运 yyyy-MM-dd。 */ public String predictionShipDate; public String shipperName; public String shipperAddress; public String shipperContact; public String shipperPhone; /** 集装箱号:4 位大写字母 + 7 位数字。 */ public String containerNo; public String remark; /** 产品明细,必填。 */ public List productItems; /** 附件。 */ public List attachInfoItems; /** 装箱信息。 */ public List cartonItems; /** 批次明细。 */ public List batchItems; /** 头程类型 0 自发 / 1 运去哪头程(openapi 只支持 0)。 */ public Integer logisticsType; /** 国际运输方式 0 海运整柜 / 1 海运散货 / 2 国际快递 / 3 空运。 */ public Integer transportType; /** 送仓方式 1 集装箱 / 2 卡车 / 3 快递。 */ public Integer deliveryType; /** 集装箱尺寸 0 无 / 1 GP20 / 2 GP40 / 3 HQ40 / 4 HQ45。 */ public Integer goodsSize; /** 物流单号集合,逗号分割。 */ public String tmsNos; /** 承运商 0 FEDEX / 1 USPS / 2 UPS / 3 DHL / 4 OTHER。 */ public Integer carrier; /** 是否 SOC 箱 0 否 / 1 是。 */ public Integer socFlag; /** 是否打托 0 否 / 1 是。 */ public Integer palletFlag; /** 入库商品行。 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static final class InboundProductItem { public String sku; public Integer qty; /** 采购成本,影响库存成本。 */ public Double cost; } /** 附件。 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static final class InboundAttachItem { public String name; /** 与 file 至少给一个。 */ public String url; /** base64;给了就忽略 url。 */ public String file; /** ShippingLabel / PackingList / BOL / Other。 */ public String type; public String remark; } /** 装箱信息。 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static final class InboundCartonItem { public String sku; public Integer qty; /** 装箱入数。 */ public Integer cartonQty; /** 箱码,必填。 */ public String cartonNo; /** 外箱重量(g)。 */ public Double cartonWeight; /** 外箱尺寸(cm)。 */ public Double cartonLength; public Double cartonWidth; public Double cartonHeight; /** 箱序标识;一箱多 SKU 时归并同一物理箱。 */ public String sid; } /** 批次明细。 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static final class InboundBatchItem { public String sku; /** 箱唛号;正式箱唛最少 7 位且末四位为数字。 */ public String cartonNo; public Integer qty; public List batchParam; } /** 批次属性键值。 */ public static final class BatchAttr { public String batchAttriKey; public String batchAttriValue; } } /** 创建入库计划响应 {@code data}。 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static final class CreateInboundPlanResponse { /** 入库计划单号。 */ public String inboundPlanOrderNo; } }