Browse Source
原来 1174 行的单个 YqnDtos 装了 63 个内部类,18 个接口的报文混在一起, 改一个接口要在上千行里翻找,共用结构(BatchAttr 之类)也会被误当成 「跨接口共享类型」。 拆成 18 个文件,一个接口一个: YqnCreateOrderDtos / YqnOrderDetailDtos / YqnCancelOrderDtos / YqnProductDtos / YqnFeeDetailDtos / YqnInventoryDtos / YqnCreateInboundDtos / YqnInboundPlanDtos / YqnTransferDtos / YqnCreateSaleReturnDtos / YqnReturnProcessDtos / YqnFeeEstimateDtos / YqnTrackingDtos / YqnDestroyPlanDtos / YqnBoxLabelDtos / YqnSkuLabelDtos / YqnLogisticsProductDtos / YqnWarehouseDtos 拆分原则: - 每个文件只放该接口的请求 / 响应与内嵌子结构 - 跨接口重复的结构**各自复制一份**(如 BatchAttr 在入库与调拨里各有一份), 避免因共用而被迫一起改 - 保留每个类的 @JsonInclude(NON_NULL):它决定空字段是否出现在报文里, 拆分时漏掉会让请求多出 null 字段(测试已验证并修复) 顺带修一处:TransferMapper 引用的是入库的 BatchAttr,拆分后类型不兼容, 改为使用调拨自己的 BatchAttr。 Co-Authored-By: Claude <noreply@anthropic.com>feature/supplier-lingxing
35 changed files with 1617 additions and 1372 deletions
@ -0,0 +1,44 @@
@@ -0,0 +1,44 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:打印入库计划单箱标(API 99,/v1/inbound/generateBoxLabel)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnBoxLabelDtos { |
||||
|
||||
private YqnBoxLabelDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class BoxLabelRequest { |
||||
|
||||
/** 入库计划单号(仓侧 ip 单号)。 */ |
||||
public String orderNo; |
||||
/** 来源单号(OMS 推单时的外部单号)。 */ |
||||
public String sourceNo; |
||||
/** 1 合成压缩包 / 2 合成一个 pdf。 */ |
||||
public Integer downloadMode; |
||||
/** 1 100*100 / 2 100*150 / 3 104*98(美国信纸)。 */ |
||||
public Integer labelSizeType; |
||||
/** 每页打印数量 1 / 6。 */ |
||||
public Integer numPerPage; |
||||
/** 是否一式两份。 */ |
||||
public Boolean twoCopies; |
||||
/** 是否展示客户唯一标识符。 */ |
||||
public Boolean showOrgUniqueCode; |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class BoxLabelResponse { |
||||
/** 任务编号;文件生成后靠它去任务中心查下载地址。 */ |
||||
public String taskNo; |
||||
public String orderNo; |
||||
public String sourceNo; |
||||
} |
||||
} |
||||
@ -0,0 +1,27 @@
@@ -0,0 +1,27 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:取消销售订单(API 122,/v1/saleOrder/cancel)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnCancelOrderDtos { |
||||
|
||||
private YqnCancelOrderDtos() { |
||||
} |
||||
|
||||
/** |
||||
* 取消销售订单请求(API 122):只有 {@code orderNo}。 |
||||
*/ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CancelOrderRequest { |
||||
|
||||
/** 订单号,即下单时的来源单号。 */ |
||||
public String orderNo; |
||||
} |
||||
} |
||||
@ -0,0 +1,141 @@
@@ -0,0 +1,141 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:创建入库计划单(API 97,/v1/inbound/createInboundPlan)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
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<InboundProductItem> productItems; |
||||
/** 附件。 */ |
||||
public List<InboundAttachItem> attachInfoItems; |
||||
/** 装箱信息。 */ |
||||
public List<InboundCartonItem> cartonItems; |
||||
/** 批次明细。 */ |
||||
public List<InboundBatchItem> 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<BatchAttr> 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; |
||||
} |
||||
} |
||||
@ -0,0 +1,177 @@
@@ -0,0 +1,177 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:创建销售订单(API 123,/v1/saleOrder/create)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnCreateOrderDtos { |
||||
|
||||
private YqnCreateOrderDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CreateOrderRequest { |
||||
|
||||
/** 来源单号;用 OMS 的出库单号,仓侧回查与幂等锚点。 */ |
||||
public String orderNo; |
||||
/** 承运商,如 FedEx / UPS。 */ |
||||
public String carrier; |
||||
/** 物流商服务 Code;不传走仓的分物流渠道规则。 */ |
||||
public String carrierCode; |
||||
/** 仓 code;不传走分仓规则。 */ |
||||
public String warehouseCode; |
||||
/** 币种,不填默认 USD。 */ |
||||
public String currency; |
||||
/** 支付时间 {@code yyyy-MM-dd HH:mm:ss};不填默认当前时间。 */ |
||||
public String paidAt; |
||||
|
||||
/** 目的国家,2 位字符。必填。 */ |
||||
public String shipToCountry; |
||||
/** 目的州;美加为 2 位编码。必填。 */ |
||||
public String shipToState; |
||||
/** 目的城市。必填。 */ |
||||
public String shipToCity; |
||||
/** 发运邮编。必填。 */ |
||||
public String shipToPostal; |
||||
/** 发运地址1。必填。 */ |
||||
public String shipToAddress1; |
||||
public String shipToAddress2; |
||||
public String shipToAddress3; |
||||
/** 发运联系人。必填。 */ |
||||
public String shipToContact; |
||||
/** 发运联系电话。必填。 */ |
||||
public String shipToTelephone; |
||||
/** 客户姓名。 */ |
||||
public String buyerName; |
||||
/** 客户邮箱。 */ |
||||
public String buyerEmail; |
||||
/** third party 账号。 */ |
||||
public String thirdPartyAccount; |
||||
|
||||
/** 发货时效:Standard-48 Hours / Same Day Ship Out / Outbound First Class;不填为标准。 */ |
||||
public String shipServiceLevel; |
||||
/** 平台订单号。 */ |
||||
public String poNumber; |
||||
/** Amazon 店铺 Seller ID。 */ |
||||
public String sellerCode; |
||||
/** 店铺名称;传入时会校验系统内是否存在。 */ |
||||
public String channelAccount; |
||||
/** 订单特殊标签 0 无 / 1 SFP / 2 VC;不填默认无。 */ |
||||
public Integer isPrime; |
||||
/** 最晚发货时间 {@code yyyy-MM-dd HH:mm:ss}。 */ |
||||
public String latestShipDate; |
||||
/** 最晚送达时间 {@code yyyy-MM-dd HH:mm:ss}。 */ |
||||
public String estimatedDeliveryTime; |
||||
/** 销售平台类型,码值见 API 123;必填。 */ |
||||
public Integer salesPlatform; |
||||
/** ERP 来源类型;领星为 1。 */ |
||||
public Integer erpPlatform; |
||||
public String remark; |
||||
|
||||
/** 产品行,必填。 */ |
||||
public List<ProductItem> productItems; |
||||
/** 附件(面单 / 装箱单 / BOL 等);非必填,传了就要给全必填子字段。 */ |
||||
public List<AttachInfoItem> attachInfoItems; |
||||
/** 发货包裹;不传则由仓按默认规则打包。 */ |
||||
public List<PackageItem> packageItems; |
||||
/** 业务标签 100 售后卡 / 110 贴发票 / 20 不使用耗材 / 21 纸箱打包 / 22 快递袋打包 / 150 采集 SN。 */ |
||||
public List<Integer> tags; |
||||
|
||||
/** 产品行。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class ProductItem { |
||||
/** 发货产品 SKU。 */ |
||||
public String sku; |
||||
/** 父商品 ERP SKU;箱产品必填。 */ |
||||
public String parentErpsku; |
||||
/** 批次属性,JSON 字符串。 */ |
||||
public String batchItems; |
||||
/** 商品形态 0 单一产品 / 2 箱产品;箱产品必填。 */ |
||||
public Integer saleType; |
||||
/** 标准件数;箱产品必填。 */ |
||||
public Integer standardQuantity; |
||||
/** 发货数量。 */ |
||||
public Integer quantity; |
||||
/** 是否保价 0 否 / 1 是;不填从产品中心取。 */ |
||||
public Integer isInsure; |
||||
/** 签收类型 0 不签收 / 1 直接 / 2 成人 / 3 间接;不填从产品中心取。 */ |
||||
public Integer isSignature; |
||||
/** 当前 SKU 总金额(美元)。 */ |
||||
public Double skuAmount; |
||||
/** 投保金额;保价时必填。 */ |
||||
public Double insureAmount; |
||||
/** 商品货号。 */ |
||||
public String articleNo; |
||||
/** EAN 条码。 */ |
||||
public String ean; |
||||
/** 供应商货号。 */ |
||||
public String supplierArticleNo; |
||||
/** 行号,当前订单内唯一。 */ |
||||
public String lineNo; |
||||
/** 产品订单序列号;各平台语义不同。 */ |
||||
public String skuOrderSn; |
||||
/** 产品交易序列号;各平台语义不同。 */ |
||||
public String skuTransactionSn; |
||||
/** 危险品标签。 */ |
||||
public String dangerousLabel; |
||||
/** 危险品标签数量。 */ |
||||
public Integer dangerousLabelQty; |
||||
} |
||||
|
||||
/** 附件。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class AttachInfoItem { |
||||
/** 附件名称,建议用 TrackingNo 且不带后缀。 */ |
||||
public String name; |
||||
/** 附件 URL;与 {@link #file} 至少给一个。 */ |
||||
public String url; |
||||
/** base64 内容;给了就忽略 url。 */ |
||||
public String file; |
||||
/** 0 面单 / 1 装箱单 / 2 BOL / 3 其他 / 4 箱标 / 5 托盘标 / 6 商品标 / 7 发票 / 8 发货计划。 */ |
||||
public Integer type; |
||||
/** base64 时的格式:png / pdf,默认 pdf。 */ |
||||
public String fileType; |
||||
public String remark; |
||||
/** 包裹号,与包裹的 refNo 一致。 */ |
||||
public String packageNo; |
||||
} |
||||
|
||||
/** 包裹。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class PackageItem { |
||||
public String refNo; |
||||
/** 长(cm),必填。 */ |
||||
public Double length; |
||||
/** 宽(cm),必填。 */ |
||||
public Double width; |
||||
/** 高(cm),必填。 */ |
||||
public Double height; |
||||
/** 重量(g),必填。 */ |
||||
public Double weight; |
||||
/** 包裹内 SKU;只有一个包裹时可省略,表示全部 SKU 同箱。 */ |
||||
public List<PackageSku> skuInfos; |
||||
/** 打包耗材 20 / 21 / 22,必填。 */ |
||||
public List<Integer> materialType; |
||||
} |
||||
|
||||
/** 包裹内 SKU 数量。 */ |
||||
public static final class PackageSku { |
||||
public String sku; |
||||
public Integer qty; |
||||
} |
||||
} |
||||
|
||||
/** 创建销售订单响应的 {@code data}。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CreateOrderResponse { |
||||
|
||||
/** 仓侧订单 id,列表查询时可用。 */ |
||||
public Long orderId; |
||||
} |
||||
} |
||||
@ -0,0 +1,49 @@
@@ -0,0 +1,49 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:创建销售退货(API 81,/v3/saleReturn/createSaleReturnPlan)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnCreateSaleReturnDtos { |
||||
|
||||
private YqnCreateSaleReturnDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CreateSaleReturnRequest { |
||||
|
||||
/** 仓库 code,必填。 */ |
||||
public String warehouseCode; |
||||
/** 来源单号,必填。 */ |
||||
public String orderNo; |
||||
public String lineName; |
||||
/** 关联销售订单号,必填。 */ |
||||
public String saleOrderNo; |
||||
/** 退货运单号,必填。 */ |
||||
public String returnTrackingNo; |
||||
/** 退货承运商,必填。 */ |
||||
public String carrierCode; |
||||
/** 预计到仓日期 yyyy-MM-dd。 */ |
||||
public String estimateReceiveDate; |
||||
public String returnReason; |
||||
public String remark; |
||||
/** 退货产品明细,必填。 */ |
||||
public List<SaleReturnItem> productItemRequests; |
||||
|
||||
/** 退货商品行。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class SaleReturnItem { |
||||
public String sku; |
||||
/** 数量;文档标为 string。 */ |
||||
public String qty; |
||||
/** 0 客户自提 / 1 拍照确认 / 2 销毁 / 5 仓库确认。 */ |
||||
public Integer returnDealMethod; |
||||
} |
||||
} |
||||
} |
||||
@ -0,0 +1,56 @@
@@ -0,0 +1,56 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:创建销毁计划单(API 88,/v1/destroyPlan/createDestroyPlan)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnDestroyPlanDtos { |
||||
|
||||
private YqnDestroyPlanDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CreateDestroyPlanRequest { |
||||
|
||||
/** 销毁的仓库 code。 */ |
||||
public String warehouseCode; |
||||
/** 来源单号(OMS 销毁单号)。 */ |
||||
public String sourceNo; |
||||
/** 0 可售库存 / 1 不可售库存。 */ |
||||
public Integer inventoryType; |
||||
/** 期望销毁日期 {@code yyyy-MM-dd}(字段名是仓方的 {@code Data},不是笔误)。 */ |
||||
public String hopeDestroyData; |
||||
public String remark; |
||||
public List<DestroyPlanItem> destroyPlanOrderItems; |
||||
public List<DestroyPlanAttach> orderAttaches; |
||||
|
||||
/** 待销毁商品行。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class DestroyPlanItem { |
||||
public String sku; |
||||
public Integer planQty; |
||||
} |
||||
|
||||
/** 附件。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class DestroyPlanAttach { |
||||
public String name; |
||||
public String remark; |
||||
/** 0 面单 / 1 装箱单 / 2 提单 / 3 其他。 */ |
||||
public Integer attachType; |
||||
public String url; |
||||
} |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CreateDestroyPlanResponse { |
||||
/** 仓侧销毁计划单号。 */ |
||||
public String destroyPlanOrderNo; |
||||
} |
||||
} |
||||
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,48 @@
@@ -0,0 +1,48 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:结算明细(API 133,/v1/warehouse/operation/costs/detail)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnFeeDetailDtos { |
||||
|
||||
private YqnFeeDetailDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CostDetailRequest { |
||||
|
||||
/** 销售订单号(数字);作业费 / 尾程费按它查。 */ |
||||
public Long saleOrderNo; |
||||
/** 结算单编号;仓储费 / 增值服务费按它查。 */ |
||||
public String billingTransNo; |
||||
/** 1 作业费 / 2 仓储费 / 3 增值服务费 / 4 尾程费。 */ |
||||
public Integer costType; |
||||
public String sku; |
||||
public String externalOrderNo; |
||||
/** 快照开始日期 yyyy-MM-dd;仅仓储费支持,区间不超过 30 天。 */ |
||||
public String snapshotStartDate; |
||||
/** 快照结束日期 yyyy-MM-dd。 */ |
||||
public String snapshotEndDate; |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CostDetail { |
||||
|
||||
/** 销售订单号(数字)。 */ |
||||
public Long saleOrderNo; |
||||
public String warehouseCode; |
||||
/** 费用金额,币种 USD。 */ |
||||
public Double costAmount; |
||||
public String costName; |
||||
public String settlementTime; |
||||
/** 1 实际结算 / 2 预估结算。 */ |
||||
public Integer settlementType; |
||||
} |
||||
} |
||||
@ -0,0 +1,77 @@
@@ -0,0 +1,77 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:订单测算 / 运费试算(API 121,/v1/saleOrder/calculate)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnFeeEstimateDtos { |
||||
|
||||
private YqnFeeEstimateDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CalculateRequest { |
||||
|
||||
/** 尺寸单位:0 英寸 / 1 厘米。 */ |
||||
public Integer sizeUnit; |
||||
public Double length; |
||||
public Double width; |
||||
public Double height; |
||||
/** 重量单位:0 磅 / 1 盎司 / 2 克。 */ |
||||
public Integer weightUnit; |
||||
public Double weight; |
||||
/** 保价货值。 */ |
||||
public Double insuredValue; |
||||
public List<CalculateSkuItem> warehouseSkuItem; |
||||
public String receiveCountry; |
||||
public String receiveState; |
||||
public String receiveCity; |
||||
public String receivePostal; |
||||
public String receiveAddress; |
||||
/** 1 住宅地址 / 0 商业地址。 */ |
||||
public Integer isResidential; |
||||
/** 物流产品服务,如 FedEx_FEDEX_GROUND。 */ |
||||
public String logisticsServiceCode; |
||||
public String logisticsProductCode; |
||||
/** 签名服务:NO_SIGNATURE / ADULT_SIGNATURE / SIGNATURE / INDIRECT_SIGNATURE。 */ |
||||
public String signService; |
||||
|
||||
/** 发货仓库。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CalculateSkuItem { |
||||
/** 发货仓库 code,必填。 */ |
||||
public String shipOrgWarehouseCode; |
||||
} |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CalculateResult { |
||||
|
||||
public String shipOrgWarehouseCode; |
||||
public List<CalculateCarrierItem> calculationCarrierItems; |
||||
|
||||
/** 一个渠道的报价。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CalculateCarrierItem { |
||||
public String carrier; |
||||
public String logisticsServiceCode; |
||||
public String currency; |
||||
public Double totalRate; |
||||
public List<CalculateCostItem> calculationCostItems; |
||||
} |
||||
|
||||
/** 细分成本项。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CalculateCostItem { |
||||
public String costName; |
||||
public Double estimatedCost; |
||||
public String currency; |
||||
} |
||||
} |
||||
} |
||||
@ -0,0 +1,87 @@
@@ -0,0 +1,87 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:查询入库计划(API 101,/v1/inbound/getInboundPlanInfo)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnInboundPlanDtos { |
||||
|
||||
private YqnInboundPlanDtos() { |
||||
} |
||||
|
||||
/** 查询入库计划请求(API 101):入库单号或来源单号都能传。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class GetInboundPlanRequest { |
||||
|
||||
public String orderNo; |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class InboundPlanInfo { |
||||
|
||||
public String orgWarehouseCode; |
||||
public String lineName; |
||||
/** 库存类型;文档标为 string。 */ |
||||
public String inventoryType; |
||||
public String inboundPlanOrderNo; |
||||
/** 0 草稿 / 5 待审核 / 6 审核拒回 / 8 待装箱 / 10 待发货 / 16 收货中 / |
||||
* 17 已收货 / 20 待入库 / 25 入库中 / 70 已完成 / 100 已取消。 */ |
||||
public String inboundPlanOrderStatus; |
||||
public String sourceNo; |
||||
public String shipmentId; |
||||
public String referenceId; |
||||
public String shipmentNo; |
||||
public String estimateArriveTime; |
||||
public String actualArriveTime; |
||||
public String firstReceptionDate; |
||||
public String shipperName; |
||||
public String shipperAddress; |
||||
public String shipperContact; |
||||
public String shipperPhone; |
||||
/** 货物形态。 */ |
||||
public String goodsType; |
||||
public String gpQuantity20; |
||||
public String gpCartonNo20; |
||||
public String gpQuantity40; |
||||
public String gpCartonNo40; |
||||
public String hqQuantity40; |
||||
public String hqCartonNo40; |
||||
public String hqQuantity45; |
||||
public String hqCartonNo45; |
||||
/** 纸箱数;文档标为 string。 */ |
||||
public String cartonQty; |
||||
public Integer planQty; |
||||
public Integer packedQty; |
||||
public Integer receivedQty; |
||||
/** 总重量(kg)。 */ |
||||
public Double totalWeight; |
||||
/** 总体积(CBM)。 */ |
||||
public Double totalVolume; |
||||
public String actualShipDate; |
||||
public Double cartonTotalWeight; |
||||
public Double cartonTotalVolume; |
||||
public String remark; |
||||
/** 产品详情(计划 / 装箱 / 实收)。 */ |
||||
public List<PlanProductDetail> planProductDetailParamList; |
||||
|
||||
/** 产品行。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class PlanProductDetail { |
||||
public String sku; |
||||
public Integer qty; |
||||
public Integer qtyPacked; |
||||
/** 上架数量。 */ |
||||
public Integer qtyReceived; |
||||
public Integer qtyReceivedSaleable; |
||||
public Integer qtyReceivedUnsaleable; |
||||
/** 最近上架时间。 */ |
||||
public String receivedTime; |
||||
} |
||||
} |
||||
} |
||||
@ -0,0 +1,91 @@
@@ -0,0 +1,91 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:库存查询(API 107,/v2/inventory/get_inventory_by_page)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnInventoryDtos { |
||||
|
||||
private YqnInventoryDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class InventoryQueryParam { |
||||
|
||||
/** 仓库 CODE 列表,必填。 */ |
||||
public List<String> warehouseCodes; |
||||
/** 0 可售 / 1 不可售。 */ |
||||
public Integer inventoryType; |
||||
/** 页码,字符串。 */ |
||||
public String page; |
||||
/** 页面大小,默认最高 500。 */ |
||||
public Integer rows; |
||||
public String sidx; |
||||
/** asc / desc。 */ |
||||
public String sort; |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class InventoryPage { |
||||
|
||||
public InventoryPageData data; |
||||
|
||||
/** 分页载荷。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class InventoryPageData { |
||||
public List<InventoryRow> content; |
||||
public Integer totalElements; |
||||
public Integer totalPages; |
||||
public Boolean last; |
||||
public Integer size; |
||||
public Integer number; |
||||
} |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class InventoryRow { |
||||
|
||||
@com.fasterxml.jackson.annotation.JsonProperty("warehouse_code") |
||||
public String warehouseCode; |
||||
@com.fasterxml.jackson.annotation.JsonProperty("line_name") |
||||
public String lineName; |
||||
public String sku; |
||||
/** 0 可售 / 1 不可售。 */ |
||||
@com.fasterxml.jackson.annotation.JsonProperty("inventory_type") |
||||
public Integer inventoryType; |
||||
@com.fasterxml.jackson.annotation.JsonProperty("inventory_available") |
||||
public Integer inventoryAvailable; |
||||
@com.fasterxml.jackson.annotation.JsonProperty("inventory_reserved") |
||||
public Integer inventoryReserved; |
||||
@com.fasterxml.jackson.annotation.JsonProperty("inventory_transport") |
||||
public Integer inventoryTransport; |
||||
/** 当前总库存;文档标为 string。 */ |
||||
@com.fasterxml.jackson.annotation.JsonProperty("inventory_current") |
||||
public String inventoryCurrent; |
||||
@com.fasterxml.jackson.annotation.JsonProperty("updated_at") |
||||
public String updatedAt; |
||||
@com.fasterxml.jackson.annotation.JsonProperty("is_over_warehouse") |
||||
public Integer isOverWarehouse; |
||||
@com.fasterxml.jackson.annotation.JsonProperty("parent_sku") |
||||
public String parentSku; |
||||
/** 0 单一产品 / 1 套装 / 2 箱产品。 */ |
||||
@com.fasterxml.jackson.annotation.JsonProperty("sale_type") |
||||
public Integer saleType; |
||||
@com.fasterxml.jackson.annotation.JsonProperty("standard_quantity") |
||||
public Integer standardQuantity; |
||||
@com.fasterxml.jackson.annotation.JsonProperty("inventory_pcs_available") |
||||
public Integer inventoryPcsAvailable; |
||||
@com.fasterxml.jackson.annotation.JsonProperty("inventory_pcs_reserved") |
||||
public Integer inventoryPcsReserved; |
||||
@com.fasterxml.jackson.annotation.JsonProperty("inventory_pcs_transport") |
||||
public Integer inventoryPcsTransport; |
||||
@com.fasterxml.jackson.annotation.JsonProperty("inventory_pcs_current") |
||||
public Integer inventoryPcsCurrent; |
||||
} |
||||
} |
||||
@ -0,0 +1,27 @@
@@ -0,0 +1,27 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:物流产品服务清单(API 135,/v2/sysCarrierGroup/getCarrierGroupList)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnLogisticsProductDtos { |
||||
|
||||
private YqnLogisticsProductDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CarrierGroup { |
||||
|
||||
/** 产品 code;出库下单与运费试算的入参。 */ |
||||
public String logisticsProductCode; |
||||
public String logisticsProductName; |
||||
/** 是否跨国运输。 */ |
||||
public Boolean crossCountry; |
||||
} |
||||
} |
||||
@ -0,0 +1,148 @@
@@ -0,0 +1,148 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:订单详情(API 128,/v1/saleOrder/findOne)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnOrderDetailDtos { |
||||
|
||||
private YqnOrderDetailDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class FindOneOrderRequest { |
||||
|
||||
/** 订单号;运去哪指我们下发时的 {@code orderNo}(来源单号)。 */ |
||||
public String orderNo; |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class OrderDetail { |
||||
|
||||
public String orderNo; |
||||
/** 支付时间 {@code yyyy-MM-dd HH:mm:ss}。 */ |
||||
public String paidAt; |
||||
public String shipToContact; |
||||
public String shipToAddress1; |
||||
public String shipToAddress2; |
||||
public String shipToAddress3; |
||||
public String shipToCity; |
||||
public String shipToState; |
||||
public String shipToCountry; |
||||
public String shipToPostal; |
||||
public String shipToTelephone; |
||||
/** 仓 code,可能因分仓规则与下单时不同。 */ |
||||
public String warehouseCode; |
||||
/** 承运商 code。 */ |
||||
public String carrierCode; |
||||
public String thirdPartyAccount; |
||||
public String currency; |
||||
/** 是否签收 0 否 / 1 是。 */ |
||||
public Integer isSignature; |
||||
/** 是否保价 0 否 / 1 是。 */ |
||||
public Integer isInsure; |
||||
/** pending / unshipped / approved / assigned / picked / shipped / canceled / refunded。 */ |
||||
public String orderStatusEnum; |
||||
/** 异常码;无异常为 {@code unexception}。 */ |
||||
public String errorCode; |
||||
/** 预估运费,默认币种 USD。 */ |
||||
public Double estimatedShippingFee; |
||||
public List<DetailProductItem> productItems; |
||||
public List<Enclosure> enclosure; |
||||
/** 发货信息;未发货时为 null 或空。 */ |
||||
public List<ShipmentPackage> shipmentPackages; |
||||
/** SKU ORD 列表。 */ |
||||
public List<OrdItem> ordList; |
||||
/** 采集 SN 信息。 */ |
||||
public List<SnInfo> orderSnInfo; |
||||
|
||||
/** 商品行。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class DetailProductItem { |
||||
public String sku; |
||||
public Integer quantity; |
||||
public String parentErpsku; |
||||
/** 0 单一产品 / 2 箱产品。 */ |
||||
public Integer saleType; |
||||
public Integer standardQuantity; |
||||
public Double skuAmount; |
||||
public Double insureAmount; |
||||
public String lineNo; |
||||
public BatchInfo batchInfo; |
||||
} |
||||
|
||||
/** 批次信息。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class BatchInfo { |
||||
public List<BatchItem> planBatchItems; |
||||
public List<BatchItem> outboundBatchItems; |
||||
} |
||||
|
||||
/** 一条批次。 */ |
||||
public static final class BatchItem { |
||||
public Integer qty; |
||||
public List<BatchParam> batchParam; |
||||
} |
||||
|
||||
/** 批次属性键值。 */ |
||||
public static final class BatchParam { |
||||
public String batchAttriKey; |
||||
public String batchAttriValue; |
||||
} |
||||
|
||||
/** 附件。 */ |
||||
public static final class Enclosure { |
||||
public String type; |
||||
public String name; |
||||
public String url; |
||||
} |
||||
|
||||
/** |
||||
* 发货包裹。 |
||||
* |
||||
* <p>{@code packageFlag} 0 实际包裹 / 1 面单信息; |
||||
* 面单信息行也有 trackingNo,拼包裹时不要重复计数。</p> |
||||
*/ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class ShipmentPackage { |
||||
public String trackingNo; |
||||
public String carrier; |
||||
public String erpSku; |
||||
public Double cost; |
||||
public Integer shipedQuantity; |
||||
public String shipmentDate; |
||||
public Integer packageFlag; |
||||
public String carrierCode; |
||||
public String carrierServiceCode; |
||||
} |
||||
|
||||
/** SKU 的 ORD 列表。 */ |
||||
public static final class OrdItem { |
||||
public String sku; |
||||
public List<String> skuOrdList; |
||||
} |
||||
|
||||
/** 采集的 SN 信息。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class SnInfo { |
||||
public String sku; |
||||
public String productId; |
||||
public List<SnItem> snList; |
||||
} |
||||
|
||||
/** 单条 SN。 */ |
||||
public static final class SnItem { |
||||
public String sku; |
||||
public String snCode; |
||||
public String lineNo; |
||||
public Integer productId; |
||||
public Integer deliverOrderItemId; |
||||
} |
||||
} |
||||
} |
||||
@ -0,0 +1,120 @@
@@ -0,0 +1,120 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:商品创建 / 编辑(API 115,/v1/product/save)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnProductDtos { |
||||
|
||||
private YqnProductDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class SaveProductRequest { |
||||
|
||||
/** 产品 SKU。 */ |
||||
public String sku; |
||||
/** 自定义产品编码。 */ |
||||
public String customItemNo; |
||||
/** UPC 编码。 */ |
||||
public String upc; |
||||
/** 1 成品 / 2 配件 / 3 耗材;不传默认成品。 */ |
||||
public Integer productType; |
||||
/** 中文名称。 */ |
||||
public String name; |
||||
/** 英文名称。 */ |
||||
public String nameEn; |
||||
/** 产品描述;不填默认取 {@link #nameEn}。 */ |
||||
public String description; |
||||
/** 0 原包装发货 / 1 重新打包。 */ |
||||
public Integer packingType; |
||||
/** 产品长(cm),一箱多件的尺寸。 */ |
||||
public Double length; |
||||
/** 产品宽(cm)。 */ |
||||
public Double width; |
||||
/** 产品高(cm)。 */ |
||||
public Double height; |
||||
/** 产品重量(g)。 */ |
||||
public Double weight; |
||||
/** 单品长(cm)。 */ |
||||
public Double itemLength; |
||||
/** 单品宽(cm)。 */ |
||||
public Double itemWidth; |
||||
/** 单品高(cm)。 */ |
||||
public Double itemHeight; |
||||
/** 保质期管理 0 否 / 1 是。 */ |
||||
public Integer expirationControl; |
||||
/** 保质期天数。 */ |
||||
public Integer expirationDate; |
||||
/** 装箱数量。 */ |
||||
public Integer packedQty; |
||||
/** 外箱长(cm)。 */ |
||||
public Double packedLength; |
||||
/** 外箱宽(cm)。 */ |
||||
public Double packedWidth; |
||||
/** 外箱高(cm)。 */ |
||||
public Double packedHeight; |
||||
/** 外箱重量(g)。 */ |
||||
public Double packedWeight; |
||||
/** 成本。 */ |
||||
public Double cost; |
||||
/** 币种。 */ |
||||
public String currency; |
||||
/** 是否保价 Y / N。 */ |
||||
public String isInsuranceFlag; |
||||
/** 保价费用。 */ |
||||
public Double isInsuranceRate; |
||||
/** 备注。 */ |
||||
public String remark; |
||||
/** 报关中文名。 */ |
||||
public String customName; |
||||
/** 报关英文名。 */ |
||||
public String customNameEn; |
||||
/** 是否需要 SN 0 否 / 1 是。 */ |
||||
public Integer isRequireSn; |
||||
/** 外包装样式 0 裸包装 / 1 销售包装 / 2 物流包装。 */ |
||||
public Integer packageStyle; |
||||
/** 序列号管理方式 1 全链路 SN / 2 SN 出库采集。 */ |
||||
public Integer snMgmtMode; |
||||
/** 客退处理方式 0 客户自提 / 1 拍照确认 / 2 销毁 / 5 仓库确认。 */ |
||||
public Integer returnDealMethod; |
||||
/** 批次管理。 */ |
||||
public LotControl lotControl; |
||||
/** 商品链接。 */ |
||||
public String link; |
||||
/** 清关信息;各国一条。 */ |
||||
public List<Customs> customs; |
||||
|
||||
/** 批次管理。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class LotControl { |
||||
/** 是否开启批次管理 0 否 / 1 是。 */ |
||||
public Integer lotEnabled; |
||||
/** 开启后必填:本商品需要开启的批次属性编码。 */ |
||||
public List<String> lotAttrCodeList; |
||||
} |
||||
|
||||
/** 一条进口海关信息;四项同进同退。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class Customs { |
||||
/** 国家编码,如 US。 */ |
||||
public String countryCode; |
||||
/** HS Code。 */ |
||||
public String customCode; |
||||
/** 进口申报价值。 */ |
||||
public Double importDeclaredValue; |
||||
/** 进口申报价值币种,枚举仅 USD。 */ |
||||
public String importDeclaredCurrency; |
||||
/** 出口申报价值。 */ |
||||
public Double exportDeclaredValue; |
||||
/** 出口申报价值币种,枚举仅 USD。 */ |
||||
public String exportDeclaredCurrency; |
||||
} |
||||
} |
||||
} |
||||
@ -0,0 +1,31 @@
@@ -0,0 +1,31 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:退货条目处理(API 77,/v3/saleReturn/addProcessMode)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnReturnProcessDtos { |
||||
|
||||
private YqnReturnProcessDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class SaleReturnProcessRequest { |
||||
|
||||
/** 退货计划单号,必填。 */ |
||||
public String saleReturnPlanNo; |
||||
/** 明细行 id(来自退货查询的 saleReturnOrderItems[].id),必填。 */ |
||||
public Long id; |
||||
/** 0 客户自提 / 2 销毁 / 3 上架(良品) / 4 换标上架(良品)。 */ |
||||
public Integer goodsReturnType; |
||||
/** 仅 4 换标上架时使用。 */ |
||||
public String newSku; |
||||
public String remark; |
||||
} |
||||
} |
||||
@ -0,0 +1,40 @@
@@ -0,0 +1,40 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:打印入库计划单 SKU 标(API 100,/v1/inbound/generateItemLabel)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnSkuLabelDtos { |
||||
|
||||
private YqnSkuLabelDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class SkuLabelRequest { |
||||
|
||||
/** 入库计划单号(仓侧 ip 单号)。 */ |
||||
public String orderNo; |
||||
/** 来源单号。 */ |
||||
public String sourceNo; |
||||
/** 1 合成压缩包 / 2 合成一个 pdf。 */ |
||||
public Integer downloadMode; |
||||
/** 纸张大小,1..14(40*30 … 100*100)。 */ |
||||
public Integer labelSizeType; |
||||
/** 原产地国家二字码;不打印时传 null。 */ |
||||
public String originCountry; |
||||
/** 是否显示英文名称。 */ |
||||
public Boolean isShowEn; |
||||
/** 是否展示中文名称;默认否。 */ |
||||
public Boolean isShowCn; |
||||
/** 是否展示二维码;默认是。 */ |
||||
public Boolean isShowQrCode; |
||||
/** 是否展示 ERP_SKU;默认是。 */ |
||||
public Boolean isShowErpSku; |
||||
} |
||||
} |
||||
@ -0,0 +1,85 @@
@@ -0,0 +1,85 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:获取运单物流状态(API 189,/api/v2/orderShipment/track/{trackingNo})。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnTrackingDtos { |
||||
|
||||
private YqnTrackingDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class ShipmentTrack { |
||||
|
||||
/** 运单 id。 */ |
||||
public Long id; |
||||
public String carrier; |
||||
public String trackingCode; |
||||
/** 最新状态;取值同 {@code trackingDetails[].status}。 */ |
||||
public String status; |
||||
/** 状态详情。 */ |
||||
public String statusDetail; |
||||
/** 预计妥投时间。 */ |
||||
public String estDeliveryDate; |
||||
/** 签收人。 */ |
||||
public String signedBy; |
||||
/** 承运商公开查询地址。 */ |
||||
public String publicUrl; |
||||
public Double weight; |
||||
public List<TrackDetail> trackingDetails; |
||||
public Parcel parcel; |
||||
public CarrierDetail carrierDetail; |
||||
|
||||
/** 一个轨迹节点。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class TrackDetail { |
||||
public String status; |
||||
public String message; |
||||
/** 时间点(格式未在文档中给出,按多种格式尝试解析)。 */ |
||||
public String datetime; |
||||
public String statusDetail; |
||||
public String timeZone; |
||||
public TrackingLocation trackingLocation; |
||||
} |
||||
|
||||
/** 节点地理位置。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class TrackingLocation { |
||||
public String city; |
||||
public String state; |
||||
public String country; |
||||
public String zip; |
||||
} |
||||
|
||||
/** 包裹信息;重量单位 oz、尺寸单位 inch(仓方固定口径)。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class Parcel { |
||||
public Double weight; |
||||
public Double length; |
||||
public Double width; |
||||
public Double height; |
||||
public String weightUnits; |
||||
public String packageDimensionsUnits; |
||||
} |
||||
|
||||
/** 承运商明细。 */ |
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CarrierDetail { |
||||
/** 物流服务。 */ |
||||
public String service; |
||||
public String containerType; |
||||
public String originLocation; |
||||
public String destinationLocation; |
||||
public String guaranteedDeliveryDate; |
||||
public String alternateIdentifier; |
||||
public String initialDeliveryAttempt; |
||||
} |
||||
} |
||||
} |
||||
@ -0,0 +1,108 @@
@@ -0,0 +1,108 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:创建调拨单(API 139,/v2/transferOutboundPlan/create)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnTransferDtos { |
||||
|
||||
private YqnTransferDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CreateTransferPlanRequest { |
||||
|
||||
/** 0 亚马逊移出 / 1 亚马逊移入 / 2 仓-仓调拨 / 3 调拨出库。 */ |
||||
public Integer type; |
||||
/** 出库仓 code;没有填 Other。 */ |
||||
public String orgWarehouseCode; |
||||
/** 入库仓 code;没有填 Other。 */ |
||||
public String inOrgWarehouseCode; |
||||
/** 0 可售 / 1 不可售。 */ |
||||
public Integer inventoryType; |
||||
/** 运送类型 1 卡车派送 / 2 快递派送。 */ |
||||
public Integer transportationCarrierType; |
||||
/** 运输方式 1 客户自提 / 2 仓库预约卡车 / 3 仓库物流 / 4 客户物流面单。 */ |
||||
public Integer transportationType; |
||||
/** 来源单号;唯一约束,查询与取消都靠它。 */ |
||||
public String sourceNo; |
||||
/** 期望出库日期 yyyy-MM-dd。 */ |
||||
public String estimateOutboundAt; |
||||
/** 期望入库日期 yyyy-MM-dd。 */ |
||||
public String estimateInboundAt; |
||||
public String shipmentId; |
||||
public String removeOrderId; |
||||
/** 目的地地址 code。 */ |
||||
public String receiveStore; |
||||
public String shipToCountry; |
||||
public String shipToState; |
||||
public String shipToCity; |
||||
public String shipToPostal; |
||||
public String shipToAddress1; |
||||
public String shipToContact; |
||||
public String shipToTelephone; |
||||
public String remark; |
||||
/** 增值服务 1 贴产品标 / 2 贴箱标 / 3 贴托盘标。 */ |
||||
public List<Integer> serviceType; |
||||
public String truckCompany; |
||||
/** 提货时间 yyyy-MM-dd。 */ |
||||
public String pickupTime; |
||||
/** 产品明细,必填。 */ |
||||
public List<TransferItem> transferOutboundPlanItems; |
||||
/** 标签 150 采集 SN / 160 后置提供 BOL。 */ |
||||
public List<Integer> tags; |
||||
public List<TransferBatchItem> batchItems; |
||||
|
||||
/** 产品行。 */ |
||||
public static final class TransferItem { |
||||
public String sku; |
||||
public Integer qty; |
||||
} |
||||
|
||||
/** 批次明细。 */ |
||||
public static final class TransferBatchItem { |
||||
public String sku; |
||||
public Integer qty; |
||||
public List<BatchAttr> batchParam; |
||||
} |
||||
|
||||
/** 批次属性键值;运去哪调拨与入库用的是同一套 key(如 ProductionDateNumber)。 */ |
||||
public static final class BatchAttr { |
||||
public String batchAttriKey; |
||||
public String batchAttriValue; |
||||
} |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class CreateTransferPlanResponse { |
||||
|
||||
public String transferOutboundPlanNo; |
||||
public Integer transferOutboundPlanStatus; |
||||
public String sourceNo; |
||||
public String orgWarehouseCode; |
||||
public String inOrgWarehouseCode; |
||||
public Integer totalQuantity; |
||||
public String estimateOutboundAt; |
||||
public String estimateInboundAt; |
||||
public String trackingNo; |
||||
public String remark; |
||||
/** 调出仓名称。 */ |
||||
public String orgWarehouseTitle; |
||||
/** 调入仓名称。 */ |
||||
public String inOrgWarehouseTitle; |
||||
public String carrierCode; |
||||
/** 总重量;运去哪未标单位。 */ |
||||
public Double totalWeight; |
||||
/** 总体积;运去哪未标单位。 */ |
||||
public Double totalVolume; |
||||
/** 异常 code;调拨失败时定位原因用。 */ |
||||
public String errorCode; |
||||
public String errorReason; |
||||
} |
||||
} |
||||
@ -0,0 +1,33 @@
@@ -0,0 +1,33 @@
|
||||
package common.ecommerce.yqn.dto; |
||||
|
||||
import com.fasterxml.jackson.annotation.JsonInclude; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 运去哪报文结构:查询仓库(API 134,/v1/warehouse/findAll)。 |
||||
* |
||||
* <p>一个文件对应一个接口,只放该接口的请求 / 响应与内嵌子结构; |
||||
* 与其它接口共用的结构各自复制一份,避免跨接口耦合。</p> |
||||
*/ |
||||
public final class YqnWarehouseDtos { |
||||
|
||||
private YqnWarehouseDtos() { |
||||
} |
||||
|
||||
@JsonInclude(JsonInclude.Include.NON_NULL) |
||||
public static final class WarehouseRow { |
||||
public String warehouseCode; |
||||
public String name; |
||||
public String country; |
||||
public String state; |
||||
public String city; |
||||
public String address1; |
||||
public String address2; |
||||
public String postal; |
||||
/** 联系人。 */ |
||||
public String linkman; |
||||
public String mobilePhone; |
||||
public String email; |
||||
} |
||||
} |
||||
Loading…
Reference in new issue