From c5d9c768a94d03423c059e235203165f55cf77b6 Mon Sep 17 00:00:00 2001
From: lml <1297555865@qq.com>
Date: Thu, 12 Nov 2026 16:57:26 +0800
Subject: [PATCH] =?UTF-8?q?refactor(xincang):=20=E6=8C=89=E6=8E=A5?=
=?UTF-8?q?=E5=8F=A3=E6=8B=86=E5=88=86=20DTO=EF=BC=8CXincangDtos=20?=
=?UTF-8?q?=E6=8B=86=E6=88=90=2016=20=E4=B8=AA=E6=96=87=E4=BB=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
XincangDtos 单文件 1601 行、40 个内嵌类、覆盖 14 个接口,超出
onboarding-checklist「一个接口一个文件」的约定。按接口切成 16 个文件,
最大的 XincangForecastDetailDtos 约 220 行。
- Attachment 归到 XincangUploadDtos(upload.files 返回的对象,转运 /
商品原样回传),跨文件引用用 XincangUploadDtos.Attachment 限定
- UploadResponse / UploadData 保留(此前无调用方,按约定留作已定义未接入)
- 字段、@JsonProperty、@JsonInclude / @JsonIgnoreProperties 原样搬移,
序列化行为不变
- 4 处 mapper 的 javadoc 引用改为新类名;README 的 dto 目录说明同步
验证:mvn test 全量通过(信仓 118 个用例 + 3 个探针跳过)。
Co-Authored-By: Claude Code
---
README.md | 9 +-
.../ecommerce/xincang/adapter/XincangAdapter.java | 75 +-
.../adapter/XincangChannelRecommendMapper.java | 25 +-
.../xincang/adapter/XincangForecastMapper.java | 24 +-
.../xincang/adapter/XincangInventoryMapper.java | 13 +-
.../xincang/adapter/XincangOrderDetailMapper.java | 12 +-
.../xincang/adapter/XincangOrderMapper.java | 9 +-
.../xincang/adapter/XincangProductMapper.java | 8 +-
.../adapter/XincangTransferDetailMapper.java | 12 +-
.../xincang/adapter/XincangTransferMapper.java | 25 +-
.../ecommerce/xincang/auth/XincangTokenClient.java | 6 +-
.../xincang/dto/XincangChannelRecommendDtos.java | 144 ++
.../common/ecommerce/xincang/dto/XincangDtos.java | 1601 --------------------
.../xincang/dto/XincangForecastCreateDtos.java | 104 ++
.../xincang/dto/XincangForecastDetailDtos.java | 222 +++
.../xincang/dto/XincangForecastImproveDtos.java | 150 ++
.../ecommerce/xincang/dto/XincangLoginDtos.java | 64 +
.../xincang/dto/XincangLogisticsDtos.java | 49 +
.../xincang/dto/XincangOrderCreateDtos.java | 55 +
.../xincang/dto/XincangOrderDetailDtos.java | 173 +++
.../xincang/dto/XincangProductListDtos.java | 30 +
.../xincang/dto/XincangProductSaveDtos.java | 138 ++
.../xincang/dto/XincangStockAgeListDtos.java | 88 ++
.../xincang/dto/XincangStockListDtos.java | 84 +
.../xincang/dto/XincangTransferCreateDtos.java | 160 ++
.../xincang/dto/XincangTransferDetailDtos.java | 198 +++
.../ecommerce/xincang/dto/XincangUploadDtos.java | 85 ++
.../xincang/dto/XincangWarehouseDtos.java | 64 +
28 files changed, 1931 insertions(+), 1696 deletions(-)
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangChannelRecommendDtos.java
delete mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastCreateDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastDetailDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastImproveDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangLoginDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangLogisticsDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangOrderCreateDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangOrderDetailDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangProductListDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangProductSaveDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangStockAgeListDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangStockListDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangTransferCreateDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangTransferDetailDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangUploadDtos.java
create mode 100644 warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangWarehouseDtos.java
diff --git a/README.md b/README.md
index 330f75b..54da08e 100644
--- a/README.md
+++ b/README.md
@@ -362,7 +362,14 @@ common.ecommerce
│ XincangTransferMapper / XincangTransferDetailMapper /
│ XincangChannelRecommendMapper / XincangInventoryMapper /
│ XincangForecastMapper
- ├── dto XincangDtos(登录 / 商品)
+ ├── dto 一个接口一个文件:XincangLoginDtos / XincangProductSaveDtos /
+ │ XincangProductListDtos / XincangOrderCreateDtos /
+ │ XincangOrderDetailDtos / XincangUploadDtos /
+ │ XincangTransferCreateDtos / XincangTransferDetailDtos /
+ │ XincangChannelRecommendDtos / XincangStockListDtos /
+ │ XincangStockAgeListDtos / XincangForecastCreateDtos /
+ │ XincangForecastImproveDtos / XincangForecastDetailDtos /
+ │ XincangWarehouseDtos / XincangLogisticsDtos
├── enums XincangOrderStatus / XincangTransferState /
│ XincangForecastStatus / XincangOrderType
└── http XincangRequestFactory / XincangMultipart / XincangEnvelope / XincangRateLimiter
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangAdapter.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangAdapter.java
index b016b7d..2edf1d1 100644
--- a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangAdapter.java
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangAdapter.java
@@ -49,7 +49,20 @@ import common.ecommerce.warehouse.model.TransferOrder;
import common.ecommerce.warehouse.sdk.WarehouseContext;
import common.ecommerce.xincang.XincangConstants;
import common.ecommerce.xincang.auth.XincangTokenClient;
-import common.ecommerce.xincang.dto.XincangDtos;
+import common.ecommerce.xincang.dto.XincangChannelRecommendDtos;
+import common.ecommerce.xincang.dto.XincangForecastCreateDtos;
+import common.ecommerce.xincang.dto.XincangForecastDetailDtos;
+import common.ecommerce.xincang.dto.XincangForecastImproveDtos;
+import common.ecommerce.xincang.dto.XincangLogisticsDtos;
+import common.ecommerce.xincang.dto.XincangOrderCreateDtos;
+import common.ecommerce.xincang.dto.XincangOrderDetailDtos;
+import common.ecommerce.xincang.dto.XincangProductListDtos;
+import common.ecommerce.xincang.dto.XincangProductSaveDtos;
+import common.ecommerce.xincang.dto.XincangStockAgeListDtos;
+import common.ecommerce.xincang.dto.XincangStockListDtos;
+import common.ecommerce.xincang.dto.XincangTransferCreateDtos;
+import common.ecommerce.xincang.dto.XincangTransferDetailDtos;
+import common.ecommerce.xincang.dto.XincangWarehouseDtos;
import common.ecommerce.xincang.http.XincangEnvelope;
import common.ecommerce.xincang.http.XincangMultipart;
import common.ecommerce.xincang.http.XincangRateLimiter;
@@ -164,7 +177,7 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
@Override
public ProductResult createOrUpdate(WarehouseContext ctx, WarehouseProduct product) {
AccessToken token = login(ctx);
- XincangDtos.ProductRequest body = XincangProductMapper.toRequest(product, token.value());
+ XincangProductSaveDtos.ProductRequest body = XincangProductMapper.toRequest(product, token.value());
boolean existsAsTemporary = findTemporaryProduct(ctx, token, body.productNo) != null;
if (existsAsTemporary) {
@@ -181,7 +194,7 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
* {@code api.productlist} 的 {@code key} 是 SKU 过滤条件,但文档没说是否精确匹配,
* 这里再按 {@code product_no} 精确比对一次。
*/
- private XincangDtos.ProductListItem findTemporaryProduct(WarehouseContext ctx, AccessToken token,
+ private XincangProductListDtos.ProductListItem findTemporaryProduct(WarehouseContext ctx, AccessToken token,
String sku) {
Map params = new LinkedHashMap<>();
params.put("state", 0);
@@ -190,9 +203,9 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
params.put("key", sku);
String raw = executeGet(ctx, XincangConstants.PATH_PRODUCT_LIST, params, token, OP_PRODUCT_QUERY);
- List items =
- json.listAt(raw, "rst.data", XincangDtos.ProductListItem.class);
- for (XincangDtos.ProductListItem item : items) {
+ List items =
+ json.listAt(raw, "rst.data", XincangProductListDtos.ProductListItem.class);
+ for (XincangProductListDtos.ProductListItem item : items) {
if (sku.equals(item.productNo)) {
return item;
}
@@ -220,7 +233,7 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
Map form = XincangOrderMapper.toForm(ctx, cmd, json);
String raw = executeMultipart(ctx, XincangConstants.PATH_ORDER_ADD_MULTIPLE, form,
"warehouse.outbound.create");
- XincangDtos.OrderResult result = json.fromJson(raw, XincangDtos.OrderResponse.class).rst;
+ XincangOrderCreateDtos.OrderResult result = json.fromJson(raw, XincangOrderCreateDtos.OrderResponse.class).rst;
if (result == null || blank(result.orderNo)) {
throw WarehouseException.builder()
.message("xincang create order returned no rst.order_no: " + safeRelay(raw))
@@ -256,7 +269,8 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
}
String raw = executeGet(ctx, XincangConstants.PATH_ORDER_DETAIL, params, login(ctx),
"warehouse.outbound.get");
- XincangDtos.OrderDetail detail = json.fromJson(raw, XincangDtos.OrderDetailResponse.class).rst;
+ XincangOrderDetailDtos.OrderDetail detail =
+ json.fromJson(raw, XincangOrderDetailDtos.OrderDetailResponse.class).rst;
if (detail == null) {
throw XincangUnsupportedOutbound.businessError(ctx, "warehouse.outbound.get",
"xincang get_order returned no rst");
@@ -361,10 +375,11 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
@Override
public TransferOrder create(WarehouseContext ctx, TransferCommand cmd) {
String productsJson = json.toJson(XincangTransferMapper.products(cmd));
- XincangDtos.TransferRequest body = XincangTransferMapper.toRequest(cmd, ctx, productsJson);
+ XincangTransferCreateDtos.TransferRequest body = XincangTransferMapper.toRequest(cmd, ctx, productsJson);
String raw = execute(ctx, XincangConstants.PATH_TRANSFER_CREATE, body, login(ctx),
"warehouse.transfer.create");
- XincangDtos.TransferResult result = json.fromJson(raw, XincangDtos.TransferResponse.class).rst;
+ XincangTransferCreateDtos.TransferResult result =
+ json.fromJson(raw, XincangTransferCreateDtos.TransferResponse.class).rst;
if (result == null || blank(result.orderNo)) {
throw WarehouseException.builder()
.message("xincang transfer returned no rst.order_no: " + safeRelay(raw))
@@ -409,8 +424,8 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
params.put("order_no", providerTransferNo);
String raw = executeGet(ctx, XincangConstants.PATH_TRANSFER_DETAIL, params, login(ctx),
"warehouse.transfer.get");
- XincangDtos.TransferDetail detail =
- json.fromJson(raw, XincangDtos.TransferDetailResponse.class).rst;
+ XincangTransferDetailDtos.TransferDetail detail =
+ json.fromJson(raw, XincangTransferDetailDtos.TransferDetailResponse.class).rst;
if (detail == null) {
throw XincangUnsupportedOutbound.businessError(ctx, "warehouse.transfer.get",
"xincang fba_detail returned no rst");
@@ -447,15 +462,15 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
public List warehouses(WarehouseContext ctx) {
String raw = executeGet(ctx, XincangConstants.PATH_CUSTOMER_WAREHOUSES,
new LinkedHashMap(), login(ctx), "warehouse.directory.warehouses");
- XincangDtos.WarehouseListResult rst =
- json.fromJson(raw, XincangDtos.WarehouseListResponse.class).rst;
+ XincangWarehouseDtos.WarehouseListResult rst =
+ json.fromJson(raw, XincangWarehouseDtos.WarehouseListResponse.class).rst;
if (rst == null) {
throw XincangUnsupportedOutbound.businessError(ctx, "warehouse.directory.warehouses",
"xincang get_customer_warehouses returned no rst");
}
List out = new ArrayList();
if (rst.data != null) {
- for (XincangDtos.WarehouseListResult.WarehouseRow row : rst.data) {
+ for (XincangWarehouseDtos.WarehouseListResult.WarehouseRow row : rst.data) {
if (row == null || XincangForecastMapper.blank(row.warehouseCode)) {
continue;
}
@@ -482,15 +497,15 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
public List carriers(WarehouseContext ctx) {
String raw = executeGet(ctx, XincangConstants.PATH_CUSTOMER_LOGISTICS,
new LinkedHashMap(), login(ctx), "warehouse.directory.carriers");
- XincangDtos.LogisticsListResult rst =
- json.fromJson(raw, XincangDtos.LogisticsListResponse.class).rst;
+ XincangLogisticsDtos.LogisticsListResult rst =
+ json.fromJson(raw, XincangLogisticsDtos.LogisticsListResponse.class).rst;
if (rst == null) {
throw XincangUnsupportedOutbound.businessError(ctx, "warehouse.directory.carriers",
"xincang get_customer_logistics returned no rst");
}
List out = new ArrayList();
if (rst.data != null) {
- for (XincangDtos.LogisticsListResult.LogisticsRow row : rst.data) {
+ for (XincangLogisticsDtos.LogisticsListResult.LogisticsRow row : rst.data) {
if (row != null && !XincangForecastMapper.blank(row.logisticsType)) {
out.add(row.logisticsType.trim());
}
@@ -509,11 +524,11 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
*/
@Override
public InboundReceipt create(WarehouseContext ctx, InboundCommand cmd) {
- XincangDtos.ForecastCreateRequest body = XincangForecastMapper.toCreateRequest(cmd, ctx);
+ XincangForecastCreateDtos.ForecastCreateRequest body = XincangForecastMapper.toCreateRequest(cmd, ctx);
String raw = execute(ctx, XincangConstants.PATH_FORECAST_CREATE, body, login(ctx),
"warehouse.inbound.create");
- XincangDtos.ForecastCreateResult result =
- json.fromJson(raw, XincangDtos.ForecastCreateResponse.class).rst;
+ XincangForecastCreateDtos.ForecastCreateResult result =
+ json.fromJson(raw, XincangForecastCreateDtos.ForecastCreateResponse.class).rst;
if (result == null || blank(result.orderNo)) {
throw WarehouseException.builder()
.message("xincang forecast returned no rst.order_no: " + safeRelay(raw))
@@ -536,7 +551,7 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
@Override
public void improve(WarehouseContext ctx, String inboundRef, InboundCommand cmd) {
String productsJson = json.toJson(XincangForecastMapper.products(cmd));
- XincangDtos.ForecastImproveRequest body =
+ XincangForecastImproveDtos.ForecastImproveRequest body =
XincangForecastMapper.toImproveRequest(cmd, inboundRef, productsJson, ctx);
execute(ctx, XincangConstants.PATH_FORECAST_IMPROVE, body, login(ctx),
"warehouse.inbound.improve");
@@ -576,8 +591,8 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
params.put("forecast_no", inboundRef);
String raw = executeGet(ctx, XincangConstants.PATH_FORECAST_DETAIL, params, login(ctx),
"warehouse.inbound.get");
- XincangDtos.ForecastDetail detail =
- json.fromJson(raw, XincangDtos.ForecastDetailResponse.class).rst;
+ XincangForecastDetailDtos.ForecastDetail detail =
+ json.fromJson(raw, XincangForecastDetailDtos.ForecastDetailResponse.class).rst;
if (detail == null) {
throw XincangUnsupportedOutbound.businessError(ctx, "warehouse.inbound.get",
"xincang forecast_detail returned no rst");
@@ -624,7 +639,7 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
ctx.providerWarehouseId());
String raw = executeGet(ctx, XincangConstants.PATH_STOCK_LIST, params, login(ctx),
"warehouse.inventory.query");
- XincangDtos.StockListResult rst = json.fromJson(raw, XincangDtos.StockListResponse.class).rst;
+ XincangStockListDtos.StockListResult rst = json.fromJson(raw, XincangStockListDtos.StockListResponse.class).rst;
if (rst == null) {
throw XincangUnsupportedOutbound.businessError(ctx, "warehouse.inventory.query",
"xincang stocklist returned no rst");
@@ -646,8 +661,8 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
ctx.providerWarehouseId());
String raw = executeGet(ctx, XincangConstants.PATH_STOCK_AGE_LIST, params, login(ctx),
"warehouse.inventory.ages");
- XincangDtos.StockAgeListResult rst =
- json.fromJson(raw, XincangDtos.StockAgeListResponse.class).rst;
+ XincangStockAgeListDtos.StockAgeListResult rst =
+ json.fromJson(raw, XincangStockAgeListDtos.StockAgeListResponse.class).rst;
if (rst == null) {
throw XincangUnsupportedOutbound.businessError(ctx, "warehouse.inventory.ages",
"xincang stockagelist returned no rst");
@@ -669,11 +684,11 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
*/
@Override
public ChannelRecommendResult recommend(WarehouseContext ctx, ChannelRecommendQuery query) {
- XincangDtos.CalculateV3Request body = XincangChannelRecommendMapper.toRequest(query);
+ XincangChannelRecommendDtos.CalculateV3Request body = XincangChannelRecommendMapper.toRequest(query);
String raw = execute(ctx, XincangConstants.PATH_CHANNEL_RECOMMEND, body, login(ctx),
"warehouse.channel.recommend");
- XincangDtos.CalculateV3Result rst =
- json.fromJson(raw, XincangDtos.CalculateV3Response.class).rst;
+ XincangChannelRecommendDtos.CalculateV3Result rst =
+ json.fromJson(raw, XincangChannelRecommendDtos.CalculateV3Response.class).rst;
if (rst == null) {
throw XincangUnsupportedOutbound.businessError(ctx, "warehouse.channel.recommend",
"xincang calculate_order_v3 returned no rst");
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangChannelRecommendMapper.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangChannelRecommendMapper.java
index 5cf1cea..01bee5b 100644
--- a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangChannelRecommendMapper.java
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangChannelRecommendMapper.java
@@ -4,7 +4,7 @@ import common.ecommerce.shared.support.Money;
import common.ecommerce.warehouse.enums.WarehouseProvider;
import common.ecommerce.warehouse.model.ChannelRecommendQuery;
import common.ecommerce.warehouse.model.ChannelRecommendResult;
-import common.ecommerce.xincang.dto.XincangDtos;
+import common.ecommerce.xincang.dto.XincangChannelRecommendDtos;
import java.math.BigDecimal;
import java.util.ArrayList;
@@ -32,12 +32,13 @@ public final class XincangChannelRecommendMapper {
}
/** 统一询价条件 → 信仓请求体。 */
- public static XincangDtos.CalculateV3Request toRequest(ChannelRecommendQuery query) {
- XincangDtos.CalculateV3Request req = new XincangDtos.CalculateV3Request();
- List products =
- new ArrayList(query.products().size());
+ public static XincangChannelRecommendDtos.CalculateV3Request toRequest(ChannelRecommendQuery query) {
+ XincangChannelRecommendDtos.CalculateV3Request req = new XincangChannelRecommendDtos.CalculateV3Request();
+ List products =
+ new ArrayList(query.products().size());
for (ChannelRecommendQuery.SkuQuantity item : query.products()) {
- XincangDtos.CalculateV3Request.Product product = new XincangDtos.CalculateV3Request.Product();
+ XincangChannelRecommendDtos.CalculateV3Request.Product product =
+ new XincangChannelRecommendDtos.CalculateV3Request.Product();
product.sku = item.sku();
product.qty = String.valueOf(item.quantity());
products.add(product);
@@ -52,7 +53,7 @@ public final class XincangChannelRecommendMapper {
}
/** 信仓响应 → 统一结果。 */
- public static ChannelRecommendResult toResult(XincangDtos.CalculateV3Result rst) {
+ public static ChannelRecommendResult toResult(XincangChannelRecommendDtos.CalculateV3Result rst) {
ChannelRecommendResult.Builder builder = ChannelRecommendResult.builder()
.sourceProvider(WarehouseProvider.XINCANG);
if (rst.optimalPlan != null) {
@@ -65,7 +66,7 @@ public final class XincangChannelRecommendMapper {
.build());
}
if (rst.warehouseFeeList != null) {
- for (XincangDtos.CalculateV3Result.WarehouseFee warehouse : rst.warehouseFeeList) {
+ for (XincangChannelRecommendDtos.CalculateV3Result.WarehouseFee warehouse : rst.warehouseFeeList) {
// 仓代码是必填主键,缺了这条报价无法归属,直接跳过而不是编一个 "-"
if (warehouse == null || blankToNull(warehouse.warehouse) == null) {
continue;
@@ -77,14 +78,14 @@ public final class XincangChannelRecommendMapper {
}
private static ChannelRecommendResult.WarehouseQuote toQuote(
- XincangDtos.CalculateV3Result.WarehouseFee warehouse) {
+ XincangChannelRecommendDtos.CalculateV3Result.WarehouseFee warehouse) {
ChannelRecommendResult.WarehouseQuote.Builder builder =
ChannelRecommendResult.WarehouseQuote.builder()
.warehouseCode(warehouse.warehouse.trim())
.inventoryEnough(parseFlag(warehouse.isInventoryEnough))
.insufficientStockError(blankToNull(warehouse.insufficientStockError));
if (warehouse.logisticsService != null) {
- for (XincangDtos.CalculateV3Result.LogisticsService service : warehouse.logisticsService) {
+ for (XincangChannelRecommendDtos.CalculateV3Result.LogisticsService service : warehouse.logisticsService) {
if (service == null || blankToNull(service.serviceCode) == null) {
continue;
}
@@ -95,13 +96,13 @@ public final class XincangChannelRecommendMapper {
}
private static ChannelRecommendResult.ServiceQuote toService(
- XincangDtos.CalculateV3Result.LogisticsService service) {
+ XincangChannelRecommendDtos.CalculateV3Result.LogisticsService service) {
ChannelRecommendResult.ServiceQuote.Builder builder =
ChannelRecommendResult.ServiceQuote.builder()
.serviceCode(service.serviceCode.trim())
.total(parseMoney(service.sum));
if (service.fees != null) {
- for (XincangDtos.CalculateV3Result.Fee fee : service.fees) {
+ for (XincangChannelRecommendDtos.CalculateV3Result.Fee fee : service.fees) {
if (fee == null) {
continue;
}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangForecastMapper.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangForecastMapper.java
index ff5f0d7..81841f7 100644
--- a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangForecastMapper.java
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangForecastMapper.java
@@ -11,7 +11,9 @@ import common.ecommerce.warehouse.model.InboundOrder;
import common.ecommerce.warehouse.model.InboundOrderLine;
import common.ecommerce.warehouse.sdk.WarehouseContext;
import common.ecommerce.xincang.XincangConstants;
-import common.ecommerce.xincang.dto.XincangDtos;
+import common.ecommerce.xincang.dto.XincangForecastCreateDtos;
+import common.ecommerce.xincang.dto.XincangForecastDetailDtos;
+import common.ecommerce.xincang.dto.XincangForecastImproveDtos;
import common.ecommerce.xincang.enums.XincangForecastStatus;
import java.time.Instant;
@@ -40,9 +42,9 @@ public final class XincangForecastMapper {
* 信仓必填:目的仓、出运类型、柜型、柜号、参考发货 / 到港时间、发货需求、
* 参考 SKU 种类数。缺一项在下发前就拒绝,避免仓返回难懂的 err。
*/
- public static XincangDtos.ForecastCreateRequest toCreateRequest(InboundCommand cmd,
+ public static XincangForecastCreateDtos.ForecastCreateRequest toCreateRequest(InboundCommand cmd,
WarehouseContext ctx) {
- XincangDtos.ForecastCreateRequest req = new XincangDtos.ForecastCreateRequest();
+ XincangForecastCreateDtos.ForecastCreateRequest req = new XincangForecastCreateDtos.ForecastCreateRequest();
req.destWarehouse = require(cmd.warehouseId(), "warehouseId (dest_warehouse)", ctx);
req.shipmentType = require(cmd.shipmentType(), "shipmentType", ctx);
req.cabinetType = require(cmd.cabinetType(), "cabinetType", ctx);
@@ -75,14 +77,14 @@ public final class XincangForecastMapper {
* @param forecastNo 新增预报返回的 {@code order_no}
* @param productsJson 商品明细 JSON 字符串
*/
- public static XincangDtos.ForecastImproveRequest toImproveRequest(InboundCommand cmd,
+ public static XincangForecastImproveDtos.ForecastImproveRequest toImproveRequest(InboundCommand cmd,
String forecastNo,
String productsJson,
WarehouseContext ctx) {
if (cmd.lines().isEmpty()) {
throw validation(ctx, "xincang improve_forecast requires at least one product line");
}
- XincangDtos.ForecastImproveRequest req = new XincangDtos.ForecastImproveRequest();
+ XincangForecastImproveDtos.ForecastImproveRequest req = new XincangForecastImproveDtos.ForecastImproveRequest();
req.forecastNo = require(forecastNo, "forecastNo", ctx);
req.destWarehouse = require(cmd.warehouseId(), "warehouseId (dest_warehouse)", ctx);
req.shipmentType = require(cmd.shipmentType(), "shipmentType", ctx);
@@ -111,11 +113,11 @@ public final class XincangForecastMapper {
* 按「一箱一件」兜底({@code box_count = sku_count});装箱率不同的场景
* 需要调用方在 {@code InboundCarton} 里显式给出,本轮不做更细的拆分。
*/
- public static List products(InboundCommand cmd) {
- List products =
- new ArrayList(cmd.lines().size());
+ public static List products(InboundCommand cmd) {
+ List products =
+ new ArrayList(cmd.lines().size());
for (InboundLine line : cmd.lines()) {
- XincangDtos.ForecastProduct product = new XincangDtos.ForecastProduct();
+ XincangForecastImproveDtos.ForecastProduct product = new XincangForecastImproveDtos.ForecastProduct();
product.productNo = line.providerSku() == null ? line.omsSku() : line.providerSku();
product.skuCount = String.valueOf(line.quantity());
product.boxCount = String.valueOf(line.quantity());
@@ -130,11 +132,11 @@ public final class XincangForecastMapper {
* 双号:{@code forecast_no} 既作仓侧单号也作业务单号兜底——
* 信仓的 {@code ref_no} 可能为空。
*/
- public static InboundOrder toOrder(XincangDtos.ForecastDetail detail, WarehouseContext ctx) {
+ public static InboundOrder toOrder(XincangForecastDetailDtos.ForecastDetail detail, WarehouseContext ctx) {
InboundStatus status = XincangForecastStatus.toCore(detail.state);
List lines = new ArrayList();
if (detail.products != null) {
- for (XincangDtos.ForecastDetailProduct product : detail.products) {
+ for (XincangForecastDetailDtos.ForecastDetailProduct product : detail.products) {
if (product == null || blank(product.productNo)) {
continue;
}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangInventoryMapper.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangInventoryMapper.java
index d6c54d7..b3fed89 100644
--- a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangInventoryMapper.java
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangInventoryMapper.java
@@ -7,7 +7,8 @@ import common.ecommerce.warehouse.model.InventoryAgeRecord;
import common.ecommerce.warehouse.model.InventoryQuery;
import common.ecommerce.warehouse.model.InventorySnapshot;
import common.ecommerce.xincang.XincangConstants;
-import common.ecommerce.xincang.dto.XincangDtos;
+import common.ecommerce.xincang.dto.XincangStockAgeListDtos;
+import common.ecommerce.xincang.dto.XincangStockListDtos;
import java.math.BigDecimal;
import java.time.Instant;
@@ -28,7 +29,7 @@ import java.util.Map;
* 库龄列表 {@code GET api.stockagelist}
*
*
- * 平台字段名只出现在本类与 {@link XincangDtos};时间按北京时间解析成 UTC。
+ * 平台字段名只出现在本类与 {@code dto} 包下的各 {@code Xincang*Dtos};时间按北京时间解析成 UTC。
*/
public final class XincangInventoryMapper {
@@ -79,14 +80,14 @@ public final class XincangInventoryMapper {
}
/** 库存响应 → 快照分页。 */
- public static Page toSnapshots(XincangDtos.StockListResult rst,
+ public static Page toSnapshots(XincangStockListDtos.StockListResult rst,
String fallbackWarehouseCode,
Instant asOf,
int currentPage,
int pageSize) {
List out = new ArrayList();
if (rst != null && rst.data != null) {
- for (XincangDtos.StockListResult.StockRow row : rst.data) {
+ for (XincangStockListDtos.StockListResult.StockRow row : rst.data) {
if (row == null || blank(row.productSku)) {
continue;
}
@@ -128,13 +129,13 @@ public final class XincangInventoryMapper {
}
/** 库龄响应 → 记录分页。 */
- public static Page toAgeRecords(XincangDtos.StockAgeListResult rst,
+ public static Page toAgeRecords(XincangStockAgeListDtos.StockAgeListResult rst,
String fallbackWarehouseCode,
int currentPage,
int pageSize) {
List out = new ArrayList();
if (rst != null && rst.data != null) {
- for (XincangDtos.StockAgeListResult.AgeRow row : rst.data) {
+ for (XincangStockAgeListDtos.StockAgeListResult.AgeRow row : rst.data) {
if (row == null || blank(row.productSku)) {
continue;
}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderDetailMapper.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderDetailMapper.java
index a48dd37..791f4d4 100644
--- a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderDetailMapper.java
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderDetailMapper.java
@@ -9,7 +9,7 @@ import common.ecommerce.warehouse.model.OutboundOrder;
import common.ecommerce.warehouse.model.ShipTo;
import common.ecommerce.warehouse.sdk.WarehouseContext;
import common.ecommerce.xincang.XincangConstants;
-import common.ecommerce.xincang.dto.XincangDtos;
+import common.ecommerce.xincang.dto.XincangOrderDetailDtos;
import common.ecommerce.xincang.enums.XincangOrderStatus;
import java.time.Instant;
@@ -23,7 +23,7 @@ import java.util.List;
/**
* 信仓订单详情报文 → 统一模型({@code GET api.get_order})。
*
- * 平台字段名只出现在本类与 {@link XincangDtos}。
+ *
平台字段名只出现在本类与 {@code XincangOrderDetailDtos}。
* 时间字段是北京时间 {@code yyyy-MM-dd HH:mm:ss},统一折算成 UTC。
*/
public final class XincangOrderDetailMapper {
@@ -42,7 +42,7 @@ public final class XincangOrderDetailMapper {
* @param detail 详情;调用方保证非 null
* @param ctx 本次调用上下文(仓编码兜底)
*/
- public static OutboundOrder toOrder(XincangDtos.OrderDetail detail, WarehouseContext ctx) {
+ public static OutboundOrder toOrder(XincangOrderDetailDtos.OrderDetail detail, WarehouseContext ctx) {
OutboundStatus status = XincangOrderStatus.toCore(detail.state);
return OutboundOrder.builder()
.warehouseCode(firstNonBlank(detail.warehouseCode, ctx.providerWarehouseId()))
@@ -108,11 +108,11 @@ public final class XincangOrderDetailMapper {
* 单值字段;前者非空时以它为准,为空才退回单值字段。数量缺失或非正的行直接跳过——
* {@link OutboundLine} 要求数量为正,保留会在构造期抛异常。
*/
- static List toLines(XincangDtos.OrderDetail detail) {
+ static List toLines(XincangOrderDetailDtos.OrderDetail detail) {
List lines = new ArrayList();
if (detail.products != null && !detail.products.isEmpty()) {
int index = 0;
- for (XincangDtos.OrderDetailProduct product : detail.products) {
+ for (XincangOrderDetailDtos.OrderDetailProduct product : detail.products) {
if (product == null || blank(product.sku)) {
continue;
}
@@ -144,7 +144,7 @@ public final class XincangOrderDetailMapper {
return lines;
}
- private static ShipTo toShipTo(XincangDtos.OrderDetail detail) {
+ private static ShipTo toShipTo(XincangOrderDetailDtos.OrderDetail detail) {
if (blank(detail.country) && blank(detail.address) && blank(detail.receiveUser)) {
return null;
}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderMapper.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderMapper.java
index fabc8b3..4d78cad 100644
--- a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderMapper.java
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderMapper.java
@@ -10,7 +10,7 @@ import common.ecommerce.warehouse.model.OutboundLine;
import common.ecommerce.warehouse.model.ShipTo;
import common.ecommerce.warehouse.sdk.WarehouseContext;
import common.ecommerce.xincang.XincangConstants;
-import common.ecommerce.xincang.dto.XincangDtos;
+import common.ecommerce.xincang.dto.XincangOrderCreateDtos;
import common.ecommerce.xincang.enums.XincangOrderType;
import java.time.Instant;
@@ -25,7 +25,7 @@ import java.util.Map;
* 信仓出库下单报文映射({@code POST api.add_order_multiple})。
*
* 该接口是 {@code multipart/form-data},{@code products} 字段本身是一段 JSON 字符串。
- * 平台字段名只出现在本类与 {@link XincangDtos}。
+ * 平台字段名只出现在本类与 {@code XincangOrderCreateDtos}。
*
* 文档没有对应字段的就不发:申报信息(HS / 原产国 / 申报价值)、包裹尺寸等
* 统一模型里有,但信仓这版接口不收,硬塞只会被忽略或报错。
@@ -120,9 +120,10 @@ public final class XincangOrderMapper {
/** 商品明细:{@code [{"product_sku":"...","sku_count":"1"}, ...]}。 */
static String productsJson(List lines, JsonCodec json) {
- List products = new ArrayList(lines.size());
+ List products =
+ new ArrayList(lines.size());
for (OutboundLine line : lines) {
- XincangDtos.OrderProduct product = new XincangDtos.OrderProduct();
+ XincangOrderCreateDtos.OrderProduct product = new XincangOrderCreateDtos.OrderProduct();
product.productSku = skuOf(line);
product.skuCount = String.valueOf(line.quantity());
products.add(product);
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangProductMapper.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangProductMapper.java
index 326ec70..751fa9d 100644
--- a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangProductMapper.java
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangProductMapper.java
@@ -3,7 +3,7 @@ package common.ecommerce.xincang.adapter;
import common.ecommerce.shared.support.Money;
import common.ecommerce.warehouse.capability.WarehouseProduct;
import common.ecommerce.xincang.XincangConstants;
-import common.ecommerce.xincang.dto.XincangDtos;
+import common.ecommerce.xincang.dto.XincangProductSaveDtos;
import java.math.BigDecimal;
import java.math.RoundingMode;
@@ -11,7 +11,7 @@ import java.math.RoundingMode;
/**
* 信仓商品报文映射({@code POST api.add_product} / {@code api.update_product})。
*
- * 平台字段名只出现在本类与 {@link XincangDtos}。单位换算也在这里:
+ *
平台字段名只出现在本类与 {@code XincangProductSaveDtos}。单位换算也在这里:
* 统一模型用 cm / g,信仓用 inch / lbs,按 {@link XincangConstants} 里的常量换算并保留 4 位小数
* (文档「最长四位小数」)。
*
@@ -40,8 +40,8 @@ public final class XincangProductMapper {
* @param token 业务令牌;两个接口的请求体都要求
* @throws IllegalArgumentException 申报价值不是美元(信仓 amount 固定 USD)
*/
- public static XincangDtos.ProductRequest toRequest(WarehouseProduct product, String token) {
- XincangDtos.ProductRequest req = new XincangDtos.ProductRequest();
+ public static XincangProductSaveDtos.ProductRequest toRequest(WarehouseProduct product, String token) {
+ XincangProductSaveDtos.ProductRequest req = new XincangProductSaveDtos.ProductRequest();
req.token = token;
req.productNo = skuOf(product);
req.chnName = product.name();
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferDetailMapper.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferDetailMapper.java
index bc67f3e..7245586 100644
--- a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferDetailMapper.java
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferDetailMapper.java
@@ -4,7 +4,7 @@ import common.ecommerce.warehouse.enums.TransferStatus;
import common.ecommerce.warehouse.enums.TransferType;
import common.ecommerce.warehouse.enums.WarehouseProvider;
import common.ecommerce.warehouse.model.TransferOrder;
-import common.ecommerce.xincang.dto.XincangDtos;
+import common.ecommerce.xincang.dto.XincangTransferDetailDtos;
import common.ecommerce.xincang.enums.XincangTransferState;
/**
@@ -22,7 +22,7 @@ public final class XincangTransferDetailMapper {
*
* @param detail 详情;调用方保证非 null
*/
- public static TransferOrder toOrder(XincangDtos.TransferDetail detail) {
+ public static TransferOrder toOrder(XincangTransferDetailDtos.TransferDetail detail) {
TransferStatus status = XincangTransferState.toCore(detail.state);
return TransferOrder.builder()
// 双号:fba_no 是业务侧单号,order_no 是仓侧单号
@@ -69,13 +69,13 @@ public final class XincangTransferDetailMapper {
}
/** 转运明细行 → 统一模型。 */
- static java.util.List toLines(XincangDtos.TransferDetail detail) {
+ static java.util.List toLines(XincangTransferDetailDtos.TransferDetail detail) {
if (detail.products == null || detail.products.isEmpty()) {
return java.util.Collections.emptyList();
}
java.util.List out =
new java.util.ArrayList(detail.products.size());
- for (XincangDtos.TransferDetailProduct product : detail.products) {
+ for (XincangTransferDetailDtos.TransferDetailProduct product : detail.products) {
if (product == null || XincangOrderDetailMapper.blank(product.productNo)) {
continue;
}
@@ -96,12 +96,12 @@ public final class XincangTransferDetailMapper {
}
/** 明细件数合计;明细缺失时返回 0(未知,不猜)。 */
- static int totalQuantityOf(XincangDtos.TransferDetail detail) {
+ static int totalQuantityOf(XincangTransferDetailDtos.TransferDetail detail) {
if (detail.products == null || detail.products.isEmpty()) {
return 0;
}
int total = 0;
- for (XincangDtos.TransferDetailProduct product : detail.products) {
+ for (XincangTransferDetailDtos.TransferDetailProduct product : detail.products) {
if (product != null) {
total += XincangOrderDetailMapper.parsePositiveInt(product.skuCount);
}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferMapper.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferMapper.java
index 18beb8f..3e1fa58 100644
--- a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferMapper.java
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferMapper.java
@@ -8,7 +8,8 @@ import common.ecommerce.warehouse.model.TransferCommand;
import common.ecommerce.warehouse.model.TransferOrder;
import common.ecommerce.warehouse.enums.TransferType;
import common.ecommerce.warehouse.sdk.WarehouseContext;
-import common.ecommerce.xincang.dto.XincangDtos;
+import common.ecommerce.xincang.dto.XincangTransferCreateDtos;
+import common.ecommerce.xincang.dto.XincangUploadDtos;
import common.ecommerce.xincang.enums.XincangTransferState;
import java.time.LocalDate;
@@ -38,13 +39,13 @@ public final class XincangTransferMapper {
}
/** 统一命令 → 信仓新增转运请求。 */
- public static XincangDtos.TransferRequest toRequest(TransferCommand cmd, WarehouseContext ctx,
+ public static XincangTransferCreateDtos.TransferRequest toRequest(TransferCommand cmd, WarehouseContext ctx,
String productsJson) {
if (cmd.type() != TransferType.OUTBOUND) {
throw validation(ctx, "xincang transfer only supports OUTBOUND (warehouse -> platform), got "
+ cmd.type());
}
- XincangDtos.TransferRequest req = new XincangDtos.TransferRequest();
+ XincangTransferCreateDtos.TransferRequest req = new XincangTransferCreateDtos.TransferRequest();
req.fbaNo = cmd.transferRequestNo();
req.po = firstNonBlank(cmd.po(), cmd.transferRequestNo());
req.fromWarehouseName = require(cmd.fromWarehouseCode(),
@@ -80,11 +81,11 @@ public final class XincangTransferMapper {
}
/** 统一附件 → 信仓附件报文;null 透传(不发)。 */
- private static XincangDtos.Attachment attachment(TransferAttachment source) {
+ private static XincangUploadDtos.Attachment attachment(TransferAttachment source) {
if (source == null) {
return null;
}
- XincangDtos.Attachment target = new XincangDtos.Attachment();
+ XincangUploadDtos.Attachment target = new XincangUploadDtos.Attachment();
target.type = source.type();
target.bucket = source.bucket();
target.fileName = source.fileName();
@@ -95,13 +96,13 @@ public final class XincangTransferMapper {
}
/** 附件列表;空列表返回 null(不发空数组)。 */
- private static List attachments(List sources) {
+ private static List attachments(List sources) {
if (sources == null || sources.isEmpty()) {
return null;
}
- List out = new ArrayList(sources.size());
+ List out = new ArrayList(sources.size());
for (TransferAttachment source : sources) {
- XincangDtos.Attachment target = attachment(source);
+ XincangUploadDtos.Attachment target = attachment(source);
if (target != null) {
out.add(target);
}
@@ -126,11 +127,11 @@ public final class XincangTransferMapper {
}
/** 产品明细:{@code [{"product_no":"SKU","sku_count":"1"}]}。 */
- public static List products(TransferCommand cmd) {
- List products =
- new ArrayList(cmd.lines().size());
+ public static List products(TransferCommand cmd) {
+ List products =
+ new ArrayList(cmd.lines().size());
for (TransferCommand.TransferLine line : cmd.lines()) {
- XincangDtos.TransferProduct product = new XincangDtos.TransferProduct();
+ XincangTransferCreateDtos.TransferProduct product = new XincangTransferCreateDtos.TransferProduct();
product.productNo = line.providerSku();
product.skuCount = String.valueOf(line.quantity());
product.fnSku = blankToNull(line.fulfillmentSku());
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/auth/XincangTokenClient.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/auth/XincangTokenClient.java
index 675d0a2..ec8effe 100644
--- a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/auth/XincangTokenClient.java
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/auth/XincangTokenClient.java
@@ -8,7 +8,7 @@ import common.ecommerce.shared.error.ValidationException;
import common.ecommerce.shared.spi.AccessToken;
import common.ecommerce.warehouse.error.WarehouseException;
import common.ecommerce.xincang.XincangConstants;
-import common.ecommerce.xincang.dto.XincangDtos;
+import common.ecommerce.xincang.dto.XincangLoginDtos;
import common.ecommerce.xincang.http.XincangEnvelope;
import common.ecommerce.xincang.http.XincangRateLimiter;
import common.ecommerce.xincang.http.XincangRequestFactory;
@@ -70,8 +70,8 @@ public final class XincangTokenClient {
HttpResponse resp = transport.execute(req);
XincangEnvelope envelope = XincangEnvelope.of(resp, json, OP_FETCH, null);
- XincangDtos.LoginResponse login = json.fromJson(envelope.body(), XincangDtos.LoginResponse.class);
- XincangDtos.LoginResult result = login == null ? null : login.rst;
+ XincangLoginDtos.LoginResponse login = json.fromJson(envelope.body(), XincangLoginDtos.LoginResponse.class);
+ XincangLoginDtos.LoginResult result = login == null ? null : login.rst;
String token = result == null ? null : result.token;
if (token == null || token.trim().isEmpty()) {
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangChannelRecommendDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangChannelRecommendDtos.java
new file mode 100644
index 0000000..e24a593
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangChannelRecommendDtos.java
@@ -0,0 +1,144 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+/**
+ * 信仓报文结构:最优渠道({@code POST api.calculate_order_v3})。
+ */
+public final class XincangChannelRecommendDtos {
+
+ private XincangChannelRecommendDtos() {
+ }
+
+ /**
+ * 最优渠道请求({@code GET api.calculate_order_v3} 的 JSON body)。
+ *
+ * 文档写的是 GET + {@code application/json} body;信仓其它 GET 都是 query,
+ * 这里按文档原样用 JSON body。
+ */
+ @JsonInclude(JsonInclude.Include.NON_NULL)
+ public static final class CalculateV3Request {
+
+ /** 产品信息;必填。 */
+ @JsonProperty("products")
+ public List products;
+
+ /** 邮编;必填。 */
+ @JsonProperty("postcode")
+ public String postcode;
+
+ /** 是否签名:是 / 否;必填。 */
+ @JsonProperty("is_sign")
+ public String isSign;
+
+ /** 仓库代码;不传由仓择优。 */
+ @JsonProperty("warehouse_code")
+ public String warehouseCode;
+
+ /** 一行商品。 */
+ @JsonInclude(JsonInclude.Include.NON_NULL)
+ public static final class Product {
+
+ /** 产品 SKU。 */
+ @JsonProperty("sku")
+ public String sku;
+
+ /** 件数(字符串)。 */
+ @JsonProperty("qty")
+ public String qty;
+ }
+ }
+
+ /** 最优渠道响应 {@code rst}。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class CalculateV3Result {
+
+ /** 最优方案;无可用渠道时为 null。 */
+ @JsonProperty("optimalPlan")
+ public OptimalPlan optimalPlan;
+
+ /** 所有仓库的报价。 */
+ @JsonProperty("warehouseFeeList")
+ public List warehouseFeeList;
+
+ /** 最优方案。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class OptimalPlan {
+
+ @JsonProperty("warehouse")
+ public String warehouse;
+
+ /** 物流方式(渠道码)。 */
+ @JsonProperty("service_code")
+ public String serviceCode;
+
+ /** 总费用。 */
+ @JsonProperty("sum")
+ public String sum;
+ }
+
+ /** 单个仓库的费用列表。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class WarehouseFee {
+
+ @JsonProperty("warehouse")
+ public String warehouse;
+
+ /** 库存是否足够:1 够 / 0 不够。 */
+ @JsonProperty("isInventoryEnough")
+ public String isInventoryEnough;
+
+ /** 库存不足原因。 */
+ @JsonProperty("insufficientStockError")
+ public String insufficientStockError;
+
+ /** 该仓下的渠道报价。 */
+ @JsonProperty("logisticsService")
+ public List logisticsService;
+ }
+
+ /** 单个物流渠道的报价。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class LogisticsService {
+
+ @JsonProperty("service_code")
+ public String serviceCode;
+
+ /** 总费用。 */
+ @JsonProperty("sum")
+ public String sum;
+
+ /** 费用明细。 */
+ @JsonProperty("fees")
+ public List fees;
+ }
+
+ /** 一条费用明细。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class Fee {
+
+ /** 一级分类,如「快递费」。 */
+ @JsonProperty("big_fee_type")
+ public String bigFeeType;
+
+ /** 费用项,如「燃油附加费」。 */
+ @JsonProperty("fee_type")
+ public String feeType;
+
+ /** 费用。 */
+ @JsonProperty("customer_fee")
+ public String customerFee;
+ }
+ }
+
+ /** 最优渠道响应外层。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class CalculateV3Response {
+
+ @JsonProperty("rst")
+ public CalculateV3Result rst;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangDtos.java
deleted file mode 100644
index 36850fc..0000000
--- a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangDtos.java
+++ /dev/null
@@ -1,1601 +0,0 @@
-package common.ecommerce.xincang.dto;
-
-import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
-import com.fasterxml.jackson.annotation.JsonInclude;
-import com.fasterxml.jackson.annotation.JsonProperty;
-
-import java.math.BigDecimal;
-import java.util.List;
-
-/**
- * 信仓报文结构。
- *
- * 字段名以 Apifox「OMS接口文档V2」为准。信仓全局响应外层统一为
- * {@code {"rst": ..., "errno": 0, "err": "", "trace_id": "..."}},这里只放登录接口用到的部分。
- * 字段差异只改本类,不动适配器与领域模型。
- */
-public final class XincangDtos {
-
- private XincangDtos() {
- }
-
- /**
- * 登录响应({@code GET /api.login})。
- *
- * 注意与业务接口不同:登录的 {@code rst} 没有 {@code code/msg/data} 包裹,
- * 而是直接给出客户与 token 字段。
- */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class LoginResponse {
-
- /** 登录结果;业务失败时可能为 null。 */
- @JsonProperty("rst")
- public LoginResult rst;
-
- /** 0 表示成功。 */
- @JsonProperty("errno")
- public Integer errno;
-
- /** 错误描述;成功时为空串。 */
- @JsonProperty("err")
- public String err;
-
- /** 信仓侧链路号。 */
- @JsonProperty("trace_id")
- public String traceId;
- }
-
- /** 登录结果的 {@code rst} 部分。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class LoginResult {
-
- /** 客户 id。 */
- @JsonProperty("id")
- public String customerId;
-
- /** 回显的 APIKEY,正常等于登录用的 appkey。 */
- @JsonProperty("api_client_id")
- public String apiClientId;
-
- /** 回显的 APISECRET;不需要也不应落盘,仅用于排障时核对身份。 */
- @JsonProperty("api_client_secret")
- public String apiClientSecret;
-
- /** 过期时间,北京时间 {@code yyyy-MM-dd HH:mm:ss}。 */
- @JsonProperty("token_expire_time")
- public String tokenExpireTime;
-
- /** 令牌本体(形如 {@code {D0A7A4FB-...}})。 */
- @JsonProperty("token")
- public String token;
- }
-
- /**
- * 新增 / 更新产品请求({@code POST api.add_product} / {@code api.update_product})。
- *
- * 信仓这两个接口的 {@code token} 放在 请求体里(文档 required 列表含 {@code token});
- * 新增接口的 query 里同时也收一份,见 {@code XincangRequestFactory}。
- *
- * 单位:金额美元、尺寸英寸、重量磅;与统一模型(cm / g)的换算在
- * {@code XincangProductMapper}。
- */
- @JsonInclude(JsonInclude.Include.NON_NULL)
- public static final class ProductRequest {
-
- /** 令牌。 */
- @JsonProperty("token")
- public String token;
-
- /** 产品 SKU。 */
- @JsonProperty("product_no")
- public String productNo;
-
- /** 中文名。 */
- @JsonProperty("chn_name")
- public String chnName;
-
- /** 金额,美元,最长两位小数。 */
- @JsonProperty("amount")
- public BigDecimal amount;
-
- /** 产品条码。 */
- @JsonProperty("bar_code")
- public String barCode;
-
- /** 毛重,磅,最长四位小数。 */
- @JsonProperty("weight_lbs")
- public BigDecimal weightLbs;
-
- /** 装箱率 / 箱率。 */
- @JsonProperty("packing_rate")
- public Integer packingRate;
-
- /** 长,英寸,最长四位小数。 */
- @JsonProperty("size_l_ln")
- public BigDecimal sizeLLn;
-
- /** 宽,英寸,最长四位小数。 */
- @JsonProperty("size_w_ln")
- public BigDecimal sizeWLn;
-
- /** 高,英寸,最长四位小数。 */
- @JsonProperty("size_h_ln")
- public BigDecimal sizeHLn;
-
- /** 备注。 */
- @JsonProperty("remark")
- public String remark;
-
- /** 仓库码(信仓 {@code ckm})。 */
- @JsonProperty("ckm")
- public String ckm;
-
- /** 产品类型:1 普货 / 2 配件 / 3 危险品;不传默认 1。 */
- @JsonProperty("product_type")
- public Integer productType;
-
- /** 产品品类:0 其它 / 1 家具 / 2 食品 / 3 汽配 / 4 服饰 / 5 化妆品 / 6 鞋类 / 7 玩具 / 8 电子 / 9 数码。 */
- @JsonProperty("product_category")
- public Integer productCategory;
-
- /** 产品图片;需先调 {@code upload.files}。统一模型暂不承载图片,通常为 null。 */
- @JsonProperty("product_image")
- public ProductImage productImage;
-
- /**
- * AHS 计费重量。
- *
- * 文档标注已废弃:具体值由各服务商参数自动计算。SDK 不填,
- * 保留占位只为与文档字段表对齐。
- */
- @JsonProperty("ahs_weight")
- @Deprecated
- public String ahsWeight;
-
- /**
- * AHS 计费尺寸。
- *
- * 文档标注已废弃:具体值由各服务商参数自动计算。SDK 不填。
- */
- @JsonProperty("ahs_dimensions")
- @Deprecated
- public String ahsDimensions;
-
- /**
- * 是否超尺寸。
- *
- * 文档标注已废弃:具体值由各服务商参数自动计算。SDK 不填。
- */
- @JsonProperty("oversize")
- @Deprecated
- public String oversize;
- }
-
- /** 产品图片(OSS 元数据)。 */
- @JsonInclude(JsonInclude.Include.NON_NULL)
- public static final class ProductImage {
-
- /** 存储类型,如 {@code aliyun_oss}。 */
- @JsonProperty("type")
- public String type;
-
- /** bucket 名。 */
- @JsonProperty("bucket")
- public String bucket;
-
- /** 对象键。 */
- @JsonProperty("file_name")
- public String fileName;
-
- /** 可访问 URL。 */
- @JsonProperty("file_url")
- public String fileUrl;
- }
-
- /**
- * 产品列表响应({@code GET api.productlist})中 {@code rst.data[]} 的元素。
- *
- * 只声明判断「是否已存在、处于什么状态」需要的字段。
- */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class ProductListItem {
-
- /** 产品 SKU。 */
- @JsonProperty("product_no")
- public String productNo;
-
- /** 产品状态:0 临时产品 / 1 正式产品。 */
- @JsonProperty("state")
- public String state;
- }
-
- /**
- * 新增订单(一单多件)请求中的一条商品。
- *
- * 信仓把整组商品 JSON 序列化后放进 multipart 的 {@code products} 字段。
- */
- @JsonInclude(JsonInclude.Include.NON_NULL)
- public static final class OrderProduct {
-
- /** 产品 SKU。 */
- @JsonProperty("product_sku")
- public String productSku;
-
- /** 数量(字符串)。 */
- @JsonProperty("sku_count")
- public String skuCount;
- }
-
- /**
- * 新增订单(一单多件)响应中的 {@code rst}。
- */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class OrderResult {
-
- /** 信仓系统单号(DS-...)。 */
- @JsonProperty("order_no")
- public String orderNo;
-
- /** 信仓内部订单 id。 */
- @JsonProperty("order_id")
- public String orderId;
- }
-
- /**
- * 新增转运请求({@code POST fba.do_fba})。
- *
- * 附件字段(产品贴 / 外箱贴 / 托盘贴 / BOL)要求先用 {@code upload.files} 上传,
- * 再把返回的 {@code data.data} 对象原样放进来;SDK 只做字段搬运。
- */
- @JsonInclude(JsonInclude.Include.NON_NULL)
- public static final class TransferRequest {
-
- /** 转运单号(业务侧),必填。 */
- @JsonProperty("fba_no")
- public String fbaNo;
-
- /** PO 号,必填。 */
- @JsonProperty("po")
- public String po;
-
- /** 发货仓(仓方字典名称),必填。 */
- @JsonProperty("from_warehouse_name")
- public String fromWarehouseName;
-
- /** 目的仓(仓方字典名称),必填。 */
- @JsonProperty("dest_warehouse_name")
- public String destWarehouseName;
-
- /** 其它仓库名;目的仓选「其他仓库」时填。 */
- @JsonProperty("other_warehouse")
- public String otherWarehouse;
-
- /** 转运类型(订单类型字典值),必填。 */
- @JsonProperty("order_type")
- public String orderType;
-
- /** 转运类型(转运类型字典值),必填。 */
- @JsonProperty("delivery_mode")
- public String deliveryMode;
-
- /** 转运方式 / 配送方式(字典值),必填。 */
- @JsonProperty("delivery_way")
- public String deliveryWay;
-
- /** 预约发货时间 {@code yyyy-MM-dd}。 */
- @JsonProperty("pre_send_time")
- public String preSendTime;
-
- /** 标签需求,多选用英文逗号分隔,如 {@code 产品贴,外箱标签}。 */
- @JsonProperty("label_requirement")
- public String labelRequirement;
-
- /** 备注。 */
- @JsonProperty("remark")
- public String remark;
-
- /** 是否需要打托:{@code 是} / {@code 否}。 */
- @JsonProperty("is_pallet")
- public String isPallet;
-
- /** 产品明细 JSON 字符串。 */
- @JsonProperty("products")
- public String products;
-
- /** 产品贴打印份数。 */
- @JsonProperty("product_print_copies")
- public String productPrintCopies;
-
- /** 外箱贴打印份数。 */
- @JsonProperty("ctn_print_copies")
- public String ctnPrintCopies;
-
- /** 快递面单打印份数。 */
- @JsonProperty("express_print_copies")
- public String expressPrintCopies;
-
- /** 托盘贴打印份数。 */
- @JsonProperty("pallet_print_copies")
- public String palletPrintCopies;
-
- /** 产品贴附件;{@code label_requirement} 含「产品贴」时必传。 */
- @JsonProperty("product_label_att")
- public Attachment productLabelAtt;
-
- /** 外箱贴附件;{@code label_requirement} 含「外箱标签」时必传。 */
- @JsonProperty("ctn_label_att")
- public Attachment ctnLabelAtt;
-
- /** 快递面单附件;{@code delivery_way} 为快递发货类型时必传。 */
- @JsonProperty("express_label_att")
- public Attachment expressLabelAtt;
-
- /** 托盘贴附件;卡车 + 打托 + 含「托盘标签」三条件同时满足时必传。 */
- @JsonProperty("pallet_label_att")
- public Attachment palletLabelAtt;
-
- /** 其他附件(数组)。 */
- @JsonProperty("other_att")
- public List otherAtt;
-
- /** BOL 附件(数组)。 */
- @JsonProperty("bol_att")
- public List bolAtt;
- }
-
- /** 转运请求里的产品明细(序列化进 {@code products} 字符串)。 */
- @JsonInclude(JsonInclude.Include.NON_NULL)
- public static final class TransferProduct {
-
- /** 产品 SKU,必填。 */
- @JsonProperty("product_no")
- public String productNo;
-
- /** 数量(字符串),必填。 */
- @JsonProperty("sku_count")
- public String skuCount;
-
- /** 三方 SKU(可选)。 */
- @JsonProperty("fn_sku")
- public String fnSku;
-
- /** 箱标 SKU(可选)。 */
- @JsonProperty("ctn_sku")
- public String ctnSku;
-
- /** 备注。 */
- @JsonProperty("remark")
- public String remark;
- }
-
- /**
- * 附件元数据({@code upload.files} 返回的 {@code data.data} 原样回传)。
- *
- * 字段名与上传接口返回保持一致,包括 {@code file_url} 与 {@code fileType} 的
- * 大小写差异——信仓文档里就是这么写的。
- */
- @JsonInclude(JsonInclude.Include.NON_NULL)
- public static final class Attachment {
-
- /** 存储类型,如 {@code aliyun_oss}。 */
- @JsonProperty("type")
- public String type;
-
- /** bucket 名。 */
- @JsonProperty("bucket")
- public String bucket;
-
- /** 对象键。 */
- @JsonProperty("file_name")
- public String fileName;
-
- /** 可访问 URL。 */
- @JsonProperty("file_url")
- public String fileUrl;
-
- /** 文件类型(信仓原文是 camelCase)。 */
- @JsonProperty("fileType")
- public String fileType;
-
- /** 原始文件名。 */
- @JsonProperty("name")
- public String name;
-
- /** 上传接口返回的 uid,通常为空串。 */
- @JsonProperty("uid")
- public String uid;
-
- /** 上传接口返回的 url(与 file_url 同值)。 */
- @JsonProperty("url")
- public String url;
- }
-
- /** 文件上传响应({@code POST upload.files}):{@code {code,msg,data:{data:{...}}}}。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class UploadResponse {
-
- /** 业务数据外层。 */
- @JsonProperty("data")
- public UploadData data;
-
- /** 200 表示成功。 */
- @JsonProperty("code")
- public Integer code;
-
- /** 描述。 */
- @JsonProperty("msg")
- public String msg;
- }
-
- /** 上传响应的 {@code data} 层。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class UploadData {
-
- /** 附件元数据;直接作为 {@code *_att} 传参。 */
- @JsonProperty("data")
- public Attachment data;
- }
-
- /**
- * 转运单详情({@code GET fba.fba_detail})的 {@code rst}。
- *
- * 只声明统一模型用得上的字段与排查必需的字段;附件同时给了对象和
- * {@code *_url}(签名后可直接下载),这里两者都保留。
- */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class TransferDetail {
-
- @JsonProperty("id")
- public String id;
- /** 转运单号(LTL...);审核与后续查询都用它。 */
- @JsonProperty("order_no")
- public String orderNo;
- /** 业务侧转运单号(我们下发的 {@code fba_no})。 */
- @JsonProperty("fba_no")
- public String fbaNo;
- @JsonProperty("po")
- public String po;
-
- /** 客户 id。 */
- @JsonProperty("customer_id")
- public String customerId;
-
- /** 客户代码。 */
- @JsonProperty("customer_no")
- public String customerNo;
-
- /** 发货仓 id / 代码。 */
- @JsonProperty("from_warehouse")
- public String fromWarehouseId;
- @JsonProperty("from_warehouse_name")
- public String fromWarehouseName;
- /** 目的仓 id / 代码。 */
- @JsonProperty("dest_warehouse")
- public String destWarehouseId;
- @JsonProperty("dest_warehouse_name")
- public String destWarehouseName;
-
- /** 预约发货时间 {@code yyyy-MM-dd}。 */
- @JsonProperty("pre_send_time")
- public String preSendTime;
- /** 状态码,见 {@code XincangTransferState}。 */
- @JsonProperty("state")
- public String state;
- @JsonProperty("state_name")
- public String stateName;
-
- /** 是否需要产品贴 / 外箱贴 / 托盘贴:0 否 / 1 是。 */
- @JsonProperty("is_product_label")
- public String isProductLabel;
- @JsonProperty("is_ctn_label")
- public String isCtnLabel;
- @JsonProperty("is_pallet_label")
- public String isPalletLabel;
- /** 是否打托:0 否 / 1 是。 */
- @JsonProperty("is_pallet")
- public String isPallet;
-
- @JsonProperty("remark")
- public String remark;
- @JsonProperty("picking_time")
- public String pickingTime;
- @JsonProperty("picked_time")
- public String pickedTime;
- @JsonProperty("palleted_time")
- public String palletedTime;
- /** 发货时间。 */
- @JsonProperty("send_time")
- public String sendTime;
- @JsonProperty("approve_time")
- public String approveTime;
- @JsonProperty("shipping_id")
- public String shippingId;
-
- /** 转运类型(字典值)。 */
- @JsonProperty("delivery_mode")
- public String deliveryMode;
- /** 转运方式(字典值)。 */
- @JsonProperty("delivery_way")
- public String deliveryWay;
- /** 订单类型(字典值)。 */
- @JsonProperty("order_type")
- public String orderType;
- @JsonProperty("other_warehouse")
- public String otherWarehouse;
- /** 标签需求,逗号分隔。 */
- @JsonProperty("label_requirement")
- public String labelRequirement;
-
- /** 附件对象。 */
- @JsonProperty("product_label_att")
- public Attachment productLabelAtt;
- @JsonProperty("ctn_label_att")
- public Attachment ctnLabelAtt;
- @JsonProperty("pallet_label_att")
- public Attachment palletLabelAtt;
- @JsonProperty("bol_att")
- public List bolAtt;
- @JsonProperty("signature_bol_att")
- public List signatureBolAtt;
- @JsonProperty("express_label_att")
- public Attachment expressLabelAtt;
- @JsonProperty("other_att")
- public List otherAtt;
-
- /** 附件签名 URL(可直接下载)。 */
- @JsonProperty("product_label_att_url")
- public String productLabelAttUrl;
- @JsonProperty("ctn_label_att_url")
- public String ctnLabelAttUrl;
- @JsonProperty("pallet_label_att_url")
- public String palletLabelAttUrl;
- @JsonProperty("bol_att_url")
- public String bolAttUrl;
- @JsonProperty("signature_bol_file")
- public String signatureBolFile;
- @JsonProperty("express_label_att_url")
- public String expressLabelAttUrl;
- @JsonProperty("other_att_url")
- public String otherAttUrl;
-
- /** 总费用。 */
- @JsonProperty("total_amount")
- public String totalAmount;
-
- @JsonProperty("gmt_create")
- public String gmtCreate;
- @JsonProperty("gmt_modify")
- public String gmtModify;
-
- /** 产品明细。 */
- @JsonProperty("products")
- public List products;
- }
-
- /** 转运详情里的产品行。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class TransferDetailProduct {
-
- @JsonProperty("product_no")
- public String productNo;
- /** 件数。 */
- @JsonProperty("sku_count")
- public String skuCount;
- /** 箱数。 */
- @JsonProperty("box_count")
- public String boxCount;
- @JsonProperty("chn_name")
- public String chnName;
- @JsonProperty("packing_rate")
- public String packingRate;
- @JsonProperty("remark")
- public String remark;
- @JsonProperty("weight_lbs")
- public String weightLbs;
- @JsonProperty("weight_kg")
- public String weightKg;
-
- /** 产品中文名(文档字段 {@code chn_name} 的语义;与 {@link #chnName} 同值来源)。 */
- @JsonProperty("product_name")
- public String productName;
-
- /** 清点箱数。 */
- @JsonProperty("check_box_qty")
- public String checkBoxQty;
-
- /** 打托件数。 */
- @JsonProperty("pallet_sku_count")
- public String palletSkuCount;
-
- /** 上架件数。 */
- @JsonProperty("put_on_sku_count")
- public String putOnSkuCount;
- }
-
- /** 转运详情响应外层。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class TransferDetailResponse {
-
- @JsonProperty("rst")
- public TransferDetail rst;
- }
-
- /** 转运单创建结果 {@code rst}。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class TransferResult {
-
- /** 信仓转运单号(LTL...),审核时传它。 */
- @JsonProperty("order_no")
- public String orderNo;
- }
-
- /**
- * 订单详情({@code GET api.get_order})的 {@code rst}。
- *
- * 字段名以文档为准;时间均为北京时间 {@code yyyy-MM-dd HH:mm:ss}(日期字段为
- * {@code yyyy-MM-dd})。空值可能是空串,适配器里统一转 null。
- */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class OrderDetail {
-
- /** 订单 id。 */
- @JsonProperty("id")
- public String id;
-
- /** 信仓系统单号(DS-...)。 */
- @JsonProperty("order_no")
- public String orderNo;
-
- /** 订单状态码,见 {@code XincangOrderStatus}。 */
- @JsonProperty("state")
- public String state;
-
- /** 状态名。 */
- @JsonProperty("state_name")
- public String stateName;
-
- /** 仓侧报错信息;正常为空。 */
- @JsonProperty("api_error")
- public String apiError;
-
- /** 跟踪号。 */
- @JsonProperty("gzh")
- public String trackingNumber;
-
- /** 面单 URL。 */
- @JsonProperty("face_url")
- public String faceUrl;
-
- /** 参考号,即我们下发的 {@code ckh}。 */
- @JsonProperty("ckh")
- public String ckh;
-
- /** 订单类型:common / wayfair。 */
- @JsonProperty("order_type")
- public String orderType;
-
- /** 产品明细(一票多件)。 */
- @JsonProperty("products")
- public List products;
-
- /** 件数。 */
- @JsonProperty("sku_count")
- public String skuCount;
-
- @JsonProperty("dim_length")
- public String dimLength;
- @JsonProperty("dim_width")
- public String dimWidth;
- @JsonProperty("dim_height")
- public String dimHeight;
- @JsonProperty("dim_divisor")
- public String dimDivisor;
-
- /** 实重(磅)。 */
- @JsonProperty("weight_lbs")
- public String weightLbs;
- /** 计费重(磅)。 */
- @JsonProperty("billing_weight_lbs")
- public String billingWeightLbs;
- /** 体积重(磅)。 */
- @JsonProperty("volume_weight_lbs")
- public String volumeWeightLbs;
-
- @JsonProperty("product_sku")
- public String productSku;
- @JsonProperty("product_name")
- public String productName;
- @JsonProperty("source_sku")
- public String sourceSku;
-
- @JsonProperty("warehouse_id")
- public String warehouseId;
- @JsonProperty("warehouse_code")
- public String warehouseCode;
-
- @JsonProperty("country")
- public String country;
- @JsonProperty("province")
- public String province;
- @JsonProperty("city")
- public String city;
- @JsonProperty("address")
- public String address;
- @JsonProperty("address2")
- public String address2;
- @JsonProperty("postcode")
- public String postcode;
- @JsonProperty("receive_user")
- public String receiveUser;
- @JsonProperty("phone")
- public String phone;
- @JsonProperty("email")
- public String email;
-
- /** 物流方式字典值。 */
- @JsonProperty("logistics_type")
- public String logisticsType;
- @JsonProperty("is_sign")
- public String isSign;
- @JsonProperty("zone")
- public String zone;
-
- /** 总费用。 */
- @JsonProperty("total_amount")
- public String totalAmount;
- @JsonProperty("repair_amount")
- public String repairAmount;
-
- @JsonProperty("approve_time")
- public String approveTime;
- /** 发货时间。 */
- @JsonProperty("delivered_time")
- public String deliveredTime;
- @JsonProperty("shop_name")
- public String shopName;
- @JsonProperty("gmt_create")
- public String gmtCreate;
- @JsonProperty("gmt_modify")
- public String gmtModify;
- @JsonProperty("gmt_cancel")
- public String gmtCancel;
- /** 截单时间。 */
- @JsonProperty("intercept_time")
- public String interceptTime;
- }
-
- /** 订单详情里的产品行。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class OrderDetailProduct {
-
- @JsonProperty("product_id")
- public String productId;
- /** 产品 SKU。 */
- @JsonProperty("sku")
- public String sku;
- /** 数量。 */
- @JsonProperty("qty")
- public String qty;
- @JsonProperty("name_zh_cn")
- public String nameZhCn;
- }
-
- /** 订单详情响应外层,用于取 {@code rst}。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class OrderDetailResponse {
-
- @JsonProperty("rst")
- public OrderDetail rst;
- }
-
- /**
- * 最优渠道请求({@code GET api.calculate_order_v3} 的 JSON body)。
- *
- * 文档写的是 GET + {@code application/json} body;信仓其它 GET 都是 query,
- * 这里按文档原样用 JSON body。
- */
- @JsonInclude(JsonInclude.Include.NON_NULL)
- public static final class CalculateV3Request {
-
- /** 产品信息;必填。 */
- @JsonProperty("products")
- public List products;
-
- /** 邮编;必填。 */
- @JsonProperty("postcode")
- public String postcode;
-
- /** 是否签名:是 / 否;必填。 */
- @JsonProperty("is_sign")
- public String isSign;
-
- /** 仓库代码;不传由仓择优。 */
- @JsonProperty("warehouse_code")
- public String warehouseCode;
-
- /** 一行商品。 */
- @JsonInclude(JsonInclude.Include.NON_NULL)
- public static final class Product {
-
- /** 产品 SKU。 */
- @JsonProperty("sku")
- public String sku;
-
- /** 件数(字符串)。 */
- @JsonProperty("qty")
- public String qty;
- }
- }
-
- /** 最优渠道响应 {@code rst}。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class CalculateV3Result {
-
- /** 最优方案;无可用渠道时为 null。 */
- @JsonProperty("optimalPlan")
- public OptimalPlan optimalPlan;
-
- /** 所有仓库的报价。 */
- @JsonProperty("warehouseFeeList")
- public List warehouseFeeList;
-
- /** 最优方案。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class OptimalPlan {
-
- @JsonProperty("warehouse")
- public String warehouse;
-
- /** 物流方式(渠道码)。 */
- @JsonProperty("service_code")
- public String serviceCode;
-
- /** 总费用。 */
- @JsonProperty("sum")
- public String sum;
- }
-
- /** 单个仓库的费用列表。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class WarehouseFee {
-
- @JsonProperty("warehouse")
- public String warehouse;
-
- /** 库存是否足够:1 够 / 0 不够。 */
- @JsonProperty("isInventoryEnough")
- public String isInventoryEnough;
-
- /** 库存不足原因。 */
- @JsonProperty("insufficientStockError")
- public String insufficientStockError;
-
- /** 该仓下的渠道报价。 */
- @JsonProperty("logisticsService")
- public List logisticsService;
- }
-
- /** 单个物流渠道的报价。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class LogisticsService {
-
- @JsonProperty("service_code")
- public String serviceCode;
-
- /** 总费用。 */
- @JsonProperty("sum")
- public String sum;
-
- /** 费用明细。 */
- @JsonProperty("fees")
- public List fees;
- }
-
- /** 一条费用明细。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class Fee {
-
- /** 一级分类,如「快递费」。 */
- @JsonProperty("big_fee_type")
- public String bigFeeType;
-
- /** 费用项,如「燃油附加费」。 */
- @JsonProperty("fee_type")
- public String feeType;
-
- /** 费用。 */
- @JsonProperty("customer_fee")
- public String customerFee;
- }
- }
-
- /** 最优渠道响应外层。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class CalculateV3Response {
-
- @JsonProperty("rst")
- public CalculateV3Result rst;
- }
-
- /** 实时库存响应 {@code rst}({@code GET api.stocklist})。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class StockListResult {
-
- @JsonProperty("code")
- public String code;
-
- @JsonProperty("msg")
- public String msg;
-
- @JsonProperty("data")
- public List data;
-
- /** 总条数(字符串)。 */
- @JsonProperty("count")
- public String count;
-
- /** 一行库存。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class StockRow {
-
- @JsonProperty("warehouse_code")
- public String warehouseCode;
-
- /** 产品 SKU。 */
- @JsonProperty("product_sku")
- public String productSku;
-
- /** 实时库存。 */
- @JsonProperty("real_stock")
- public String realStock;
-
- /** 可售数量。 */
- @JsonProperty("cansale_sku_count")
- public String canSaleSkuCount;
-
- /** 占用数量。 */
- @JsonProperty("use_sku_count")
- public String useSkuCount;
-
- /** 待出库数量。 */
- @JsonProperty("wait_sku_count")
- public String waitSkuCount;
-
- /** 在海上数量。 */
- @JsonProperty("ship_sku_count")
- public String shipSkuCount;
-
- /** 预警数量。 */
- @JsonProperty("alerm_count")
- public String alarmCount;
-
- /** 商品名。 */
- @JsonProperty("chn_name")
- public String chnName;
-
- /** 体积(立方厘米)。 */
- @JsonProperty("volume_cm")
- public String volumeCm;
- }
- }
-
- /** 实时库存响应外层。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class StockListResponse {
-
- @JsonProperty("rst")
- public StockListResult rst;
- }
-
- /** 库龄列表响应 {@code rst}({@code GET api.stockagelist})。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class StockAgeListResult {
-
- @JsonProperty("code")
- public String code;
-
- @JsonProperty("msg")
- public String msg;
-
- @JsonProperty("data")
- public List data;
-
- /** 总条数(字符串)。 */
- @JsonProperty("count")
- public String count;
-
- /** 一行库龄。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class AgeRow {
-
- /** 计费日期 {@code yyyy-MM-dd}。 */
- @JsonProperty("dt")
- public String dt;
-
- @JsonProperty("warehouse_code")
- public String warehouseCode;
-
- /** 产品 SKU。 */
- @JsonProperty("product_sku")
- public String productSku;
-
- /** 入库柜号。 */
- @JsonProperty("cabinet_no")
- public String cabinetNo;
-
- /** 当日费用。 */
- @JsonProperty("sum_fee")
- public String sumFee;
-
- /** 计费总体积(立方米)。 */
- @JsonProperty("total_volume_cbm")
- public String totalVolumeCbm;
-
- /** 库存数量。 */
- @JsonProperty("sku_count")
- public String skuCount;
-
- /** 入库时间 {@code yyyy-MM-dd HH:mm:ss}。 */
- @JsonProperty("in_stock_time")
- public String inStockTime;
-
- /** 库龄天数。 */
- @JsonProperty("fee_days")
- public String feeDays;
-
- /** 费率。 */
- @JsonProperty("config_price")
- public String configPrice;
-
- /** 计费数量。 */
- @JsonProperty("fee_count")
- public String feeCount;
- }
- }
-
- /** 库龄列表响应外层。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class StockAgeListResponse {
-
- @JsonProperty("rst")
- public StockAgeListResult rst;
- }
-
- /**
- * 新增预报请求({@code POST forecast.do_forecast})。
- *
- * 只建单,不带商品明细;明细走「完善资料」。
- */
- @JsonInclude(JsonInclude.Include.NON_NULL)
- public static final class ForecastCreateRequest {
-
- /**
- * 客户 id。
- *
- * 文档标注已舍弃,SDK 不填;保留占位以与文档字段表对齐。
- */
- @JsonProperty("customer_id")
- @Deprecated
- public String customerId;
-
- /** 目的地仓。 */
- @JsonProperty("dest_warehouse")
- public String destWarehouse;
-
- /** 出运类型:1 空运 / 2 海运。 */
- @JsonProperty("shipment_type")
- public String shipmentType;
-
- /** 柜型:0 20GP / 1 40GP / 2 40HQ / 3 45HQ / 4 纸箱入库 / 5 托盘入库。 */
- @JsonProperty("cabinet_type")
- public String cabinetType;
-
- /** 柜号。 */
- @JsonProperty("cabinet_no")
- public String cabinetNo;
-
- /** 参考发货时间。 */
- @JsonProperty("rfc_etd")
- public String rfcEtd;
-
- /** 参考到港时间。 */
- @JsonProperty("rfc_eta")
- public String rfcEta;
-
- /** 发货需求:1 一件代发 / 2 FBA 中转。 */
- @JsonProperty("delivery_requirements")
- public String deliveryRequirements;
-
- /** 参考 SKU 种类数量。 */
- @JsonProperty("rfc_sku_count")
- public String rfcSkuCount;
-
- /** 中文名称。 */
- @JsonProperty("chn_name")
- public String chnName;
-
- /** 是否超 120cm:1 是 / 0 否。 */
- @JsonProperty("is_oversize")
- public String isOversize;
-
- /** 超尺寸备注。 */
- @JsonProperty("oversize_val")
- public String oversizeVal;
-
- @JsonProperty("remark")
- public String remark;
-
- /** 船务公司 id。 */
- @JsonProperty("shipping_company_id")
- public String shippingCompanyId;
-
- /** 预报托盘数;柜型为托盘入库时填。 */
- @JsonProperty("forecast_pallet_qty")
- public String forecastPalletQty;
- }
-
- /**
- * 完善预报资料请求({@code POST forecast.do_improve_forecast})。
- *
- * {@code products} 是一段 JSON 字符串,新数据直接覆盖旧数据。
- */
- @JsonInclude(JsonInclude.Include.NON_NULL)
- public static final class ForecastImproveRequest {
-
- /**
- * 预报单 id。
- *
- * 文档标注已舍弃,SDK 不填;保留占位以与文档字段表对齐。
- */
- @JsonProperty("id")
- @Deprecated
- public String id;
-
- /**
- * 客户 id。
- *
- * 文档标注已舍弃,SDK 不填。
- */
- @JsonProperty("customer_id")
- @Deprecated
- public String customerId;
-
- @JsonProperty("forecast_no")
- public String forecastNo;
-
- @JsonProperty("dest_warehouse")
- public String destWarehouse;
-
- @JsonProperty("shipment_type")
- public String shipmentType;
-
- /** 参考编号,长度上限 32。 */
- @JsonProperty("ref_no")
- public String refNo;
-
- /**
- * 新增预报柜号。
- *
- * 文档标注已舍弃,SDK 不填。
- */
- @JsonProperty("old_cabinet_no")
- @Deprecated
- public String oldCabinetNo;
-
- /** 柜型:0 20GP / 1 40GP / 2 40HQ / 3 45HQ / 4 纸箱入库 / 5 托盘入库。 */
- @JsonProperty("cabinet_type")
- public String cabinetType;
-
- /** 柜号。 */
- @JsonProperty("cabinet_no")
- public String cabinetNo;
-
- /** 发货时间。 */
- @JsonProperty("etd")
- public String etd;
-
- /** 到港时间。 */
- @JsonProperty("eta")
- public String eta;
-
- /**
- * 最晚免费时间(提柜)。
- *
- * 文档标注已舍弃,SDK 不填。
- */
- @JsonProperty("lfd")
- @Deprecated
- public String lfd;
-
- @JsonProperty("delivery_requirements")
- public String deliveryRequirements;
-
- @JsonProperty("remark")
- public String remark;
-
- /** 其他需求,如 内箱贴,外箱贴。 */
- @JsonProperty("other_need")
- public String otherNeed;
-
- /**
- * 总件数。
- *
- * 文档标注已舍弃(由 {@code products} 汇总),SDK 不填。
- */
- @JsonProperty("sku_count_sum")
- @Deprecated
- public String skuCountSum;
-
- /**
- * 总箱数。
- *
- * 文档标注已舍弃(由 {@code products} 汇总),SDK 不填。
- */
- @JsonProperty("box_count_sum")
- @Deprecated
- public String boxCountSum;
-
- /** 产品明细 JSON 字符串。 */
- @JsonProperty("products")
- public String products;
-
- /** 船务公司 id;通过【获取船务公司】接口取得。 */
- @JsonProperty("shipping_company_id")
- public String shippingCompanyId;
-
- /** 预报托盘数;柜型为托盘入库时填写。 */
- @JsonProperty("forecast_pallet_qty")
- public String forecastPalletQty;
- }
-
- /** 完善资料里的产品行(序列化进 {@code products} 字符串)。 */
- @JsonInclude(JsonInclude.Include.NON_NULL)
- public static final class ForecastProduct {
-
- @JsonProperty("product_no")
- public String productNo;
-
- /** 件数。 */
- @JsonProperty("sku_count")
- public String skuCount;
-
- /** 箱数。 */
- @JsonProperty("box_count")
- public String boxCount;
-
- /** 批次号;可选。 */
- @JsonProperty("batch_no")
- public String batchNo;
-
- @JsonProperty("remark")
- public String remark;
- }
-
- /**
- * 预报详情({@code GET forecast.forecast_detail})的 {@code rst}。
- *
- * 时间字段是北京时间。
- */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class ForecastDetail {
-
- /** 预报单 id。 */
- @JsonProperty("id")
- public String id;
-
- @JsonProperty("forecast_no")
- public String forecastNo;
-
- /** 中文名称。 */
- @JsonProperty("chn_name")
- public String chnName;
-
- /** 客户 id。 */
- @JsonProperty("customer_id")
- public String customerId;
-
- /** 客户代码。 */
- @JsonProperty("customer_name")
- public String customerName;
-
- /** 目的仓 id / 代码。 */
- @JsonProperty("dest_warehouse")
- public String destWarehouseId;
- @JsonProperty("dest_warehouse_name")
- public String destWarehouseName;
-
- /** 出运类型。 */
- @JsonProperty("shipment_type")
- public String shipmentType;
-
- /** 参考编号。 */
- @JsonProperty("ref_no")
- public String refNo;
-
- /** 柜型 / 柜号。 */
- @JsonProperty("cabinet_type")
- public String cabinetType;
- @JsonProperty("cabinet_no")
- public String cabinetNo;
-
- /** 预计发货 / 到港时间。 */
- @JsonProperty("rfc_etd")
- public String rfcEtd;
- @JsonProperty("rfc_eta")
- public String rfcEta;
- /** 实际发货 / 到港时间。 */
- @JsonProperty("etd")
- public String etd;
- @JsonProperty("eta")
- public String eta;
-
- /** 是否超 120cm。 */
- @JsonProperty("is_oversize")
- public String isOversize;
- @JsonProperty("oversize_val")
- public String oversizeVal;
-
- /** 发货需求。 */
- @JsonProperty("delivery_requirements")
- public String deliveryRequirements;
-
- /** 预报时间。 */
- @JsonProperty("forecast_time")
- public String forecastTime;
-
- /** 参考 SKU 种类数。 */
- @JsonProperty("rfc_sku_count")
- public String rfcSkuCount;
-
- @JsonProperty("remark")
- public String remark;
-
- /** 托盘数:预报 / 实收 / 上架 / 计费。 */
- @JsonProperty("forecast_pallet_qty")
- public String forecastPalletQty;
- @JsonProperty("receive_pallet_qty")
- public String receivePalletQty;
- @JsonProperty("shelf_pallet_qty")
- public String shelfPalletQty;
- @JsonProperty("bill_pallet_qty")
- public String billPalletQty;
-
- /** 到仓 / 卸柜清点 / 清点完成 / 上架 / 还柜时间。 */
- @JsonProperty("receive_time")
- public String receiveTime;
- @JsonProperty("unlade_time")
- public String unladeTime;
- @JsonProperty("check_time")
- public String checkTime;
- @JsonProperty("putaway_time")
- public String putawayTime;
- @JsonProperty("leave_time")
- public String leaveTime;
-
- /** 是否需要内箱贴 / 外箱贴:1 是 / 0 否。 */
- @JsonProperty("is_inner_box_sticker")
- public String isInnerBoxSticker;
- @JsonProperty("is_outer_box_sticker")
- public String isOuterBoxSticker;
-
- @JsonProperty("other_need")
- public String otherNeed;
-
- @JsonProperty("gmt_create")
- public String gmtCreate;
- @JsonProperty("gmt_modify")
- public String gmtModify;
-
- /** 预报状态码,见 {@code XincangForecastStatus}。 */
- @JsonProperty("state")
- public String state;
- @JsonProperty("state_name")
- public String stateName;
-
- @JsonProperty("products")
- public List products;
- }
-
- /** 预报详情里的产品行。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class ForecastDetailProduct {
-
- @JsonProperty("product_no")
- public String productNo;
-
- @JsonProperty("product_name")
- public String productName;
-
- /** 件数。 */
- @JsonProperty("sku_count")
- public String skuCount;
-
- /** 箱数。 */
- @JsonProperty("box_count")
- public String boxCount;
-
- /** 清点箱数。 */
- @JsonProperty("check_box_qty")
- public String checkBoxQty;
-
- /** 打托件数 / 上架件数。 */
- @JsonProperty("pallet_sku_count")
- public String palletSkuCount;
- @JsonProperty("put_on_sku_count")
- public String putOnSkuCount;
-
- /** 装箱率。 */
- @JsonProperty("packing_rate")
- public String packingRate;
-
- /** 体积(立方厘米)。 */
- @JsonProperty("volume_cm")
- public String volumeCm;
-
- /** 中文名。 */
- @JsonProperty("chn_name")
- public String chnName;
-
- /** 英文名。 */
- @JsonProperty("en_name")
- public String enName;
-
- /** 体积(立方英寸)。 */
- @JsonProperty("volume_ln")
- public String volumeLn;
-
- /** 长(厘米)。 */
- @JsonProperty("size_l_cm")
- public String sizeLCm;
- /** 宽(厘米)。 */
- @JsonProperty("size_w_cm")
- public String sizeWCm;
- /** 高(厘米)。 */
- @JsonProperty("size_h_cm")
- public String sizeHCm;
- /** 长(英寸)。 */
- @JsonProperty("size_l_ln")
- public String sizeLLn;
- /** 宽(英寸)。 */
- @JsonProperty("size_w_ln")
- public String sizeWLn;
- /** 高(英寸)。 */
- @JsonProperty("size_h_ln")
- public String sizeHLn;
-
- /** 预报产品创建时间。 */
- @JsonProperty("gmt_create")
- public String gmtCreate;
- /** 预报产品最后修改时间。 */
- @JsonProperty("gmt_modify")
- public String gmtModify;
- }
-
- /** 预报详情响应外层。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class ForecastDetailResponse {
-
- @JsonProperty("rst")
- public ForecastDetail rst;
- }
-
- /** 新增预报响应 {@code rst}。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class ForecastCreateResult {
-
- /** 预报单号;完善资料与提交都用它。 */
- @JsonProperty("order_no")
- public String orderNo;
- }
-
- /** 新增预报响应外层。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class ForecastCreateResponse {
-
- @JsonProperty("rst")
- public ForecastCreateResult rst;
- }
-
- /** 客户仓库列表响应 {@code rst}({@code GET api.get_customer_warehouses})。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class WarehouseListResult {
-
- @JsonProperty("code")
- public String code;
-
- @JsonProperty("msg")
- public String msg;
-
- @JsonProperty("data")
- public List data;
-
- /** 总条数(字符串)。 */
- @JsonProperty("count")
- public String count;
-
- /** 一行仓库。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class WarehouseRow {
-
- /** 仓方内部 id。 */
- @JsonProperty("id")
- public String id;
-
- /** 仓代码。 */
- @JsonProperty("warehouse_code")
- public String warehouseCode;
-
- @JsonProperty("country")
- public String country;
- @JsonProperty("province")
- public String province;
- @JsonProperty("city")
- public String city;
- @JsonProperty("street")
- public String street;
- @JsonProperty("postcode")
- public String postcode;
- }
- }
-
- /** 客户仓库列表响应外层。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class WarehouseListResponse {
-
- @JsonProperty("rst")
- public WarehouseListResult rst;
- }
-
- /** 客户承运商列表响应 {@code rst}({@code GET api.get_customer_logistics})。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class LogisticsListResult {
-
- @JsonProperty("code")
- public String code;
-
- @JsonProperty("msg")
- public String msg;
-
- @JsonProperty("data")
- public List data;
-
- /** 总条数(字符串)。 */
- @JsonProperty("count")
- public String count;
-
- /** 一行承运商。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class LogisticsRow {
-
- /** 物流方式代码,如 {@code FEDEX-G}。 */
- @JsonProperty("logistics_type")
- public String logisticsType;
- }
- }
-
- /** 客户承运商列表响应外层。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class LogisticsListResponse {
-
- @JsonProperty("rst")
- public LogisticsListResult rst;
- }
-
- /** 新增订单响应外层,用于取 {@code rst}。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class OrderResponse {
-
- /** 下单结果;业务失败时为 null。 */
- @JsonProperty("rst")
- public OrderResult rst;
- }
-
- /** 新增转运响应外层,用于取 {@code rst}。 */
- @JsonIgnoreProperties(ignoreUnknown = true)
- public static final class TransferResponse {
-
- /** 转运结果;业务失败时为 null。 */
- @JsonProperty("rst")
- public TransferResult rst;
- }
-}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastCreateDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastCreateDtos.java
new file mode 100644
index 0000000..67272f8
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastCreateDtos.java
@@ -0,0 +1,104 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * 信仓报文结构:新增预报({@code POST forecast.do_forecast}):只建单,不带商品明细。
+ */
+public final class XincangForecastCreateDtos {
+
+ private XincangForecastCreateDtos() {
+ }
+
+ /**
+ * 新增预报请求({@code POST forecast.do_forecast})。
+ *
+ * 只建单,不带商品明细;明细走「完善资料」。
+ */
+ @JsonInclude(JsonInclude.Include.NON_NULL)
+ public static final class ForecastCreateRequest {
+
+ /**
+ * 客户 id。
+ *
+ * 文档标注已舍弃,SDK 不填;保留占位以与文档字段表对齐。
+ */
+ @JsonProperty("customer_id")
+ @Deprecated
+ public String customerId;
+
+ /** 目的地仓。 */
+ @JsonProperty("dest_warehouse")
+ public String destWarehouse;
+
+ /** 出运类型:1 空运 / 2 海运。 */
+ @JsonProperty("shipment_type")
+ public String shipmentType;
+
+ /** 柜型:0 20GP / 1 40GP / 2 40HQ / 3 45HQ / 4 纸箱入库 / 5 托盘入库。 */
+ @JsonProperty("cabinet_type")
+ public String cabinetType;
+
+ /** 柜号。 */
+ @JsonProperty("cabinet_no")
+ public String cabinetNo;
+
+ /** 参考发货时间。 */
+ @JsonProperty("rfc_etd")
+ public String rfcEtd;
+
+ /** 参考到港时间。 */
+ @JsonProperty("rfc_eta")
+ public String rfcEta;
+
+ /** 发货需求:1 一件代发 / 2 FBA 中转。 */
+ @JsonProperty("delivery_requirements")
+ public String deliveryRequirements;
+
+ /** 参考 SKU 种类数量。 */
+ @JsonProperty("rfc_sku_count")
+ public String rfcSkuCount;
+
+ /** 中文名称。 */
+ @JsonProperty("chn_name")
+ public String chnName;
+
+ /** 是否超 120cm:1 是 / 0 否。 */
+ @JsonProperty("is_oversize")
+ public String isOversize;
+
+ /** 超尺寸备注。 */
+ @JsonProperty("oversize_val")
+ public String oversizeVal;
+
+ @JsonProperty("remark")
+ public String remark;
+
+ /** 船务公司 id。 */
+ @JsonProperty("shipping_company_id")
+ public String shippingCompanyId;
+
+ /** 预报托盘数;柜型为托盘入库时填。 */
+ @JsonProperty("forecast_pallet_qty")
+ public String forecastPalletQty;
+ }
+
+ /** 新增预报响应 {@code rst}。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class ForecastCreateResult {
+
+ /** 预报单号;完善资料与提交都用它。 */
+ @JsonProperty("order_no")
+ public String orderNo;
+ }
+
+ /** 新增预报响应外层。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class ForecastCreateResponse {
+
+ @JsonProperty("rst")
+ public ForecastCreateResult rst;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastDetailDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastDetailDtos.java
new file mode 100644
index 0000000..292b11f
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastDetailDtos.java
@@ -0,0 +1,222 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+/**
+ * 信仓报文结构:预报详情({@code GET forecast.forecast_detail})。
+ */
+public final class XincangForecastDetailDtos {
+
+ private XincangForecastDetailDtos() {
+ }
+
+ /**
+ * 预报详情({@code GET forecast.forecast_detail})的 {@code rst}。
+ *
+ * 时间字段是北京时间。
+ */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class ForecastDetail {
+
+ /** 预报单 id。 */
+ @JsonProperty("id")
+ public String id;
+
+ @JsonProperty("forecast_no")
+ public String forecastNo;
+
+ /** 中文名称。 */
+ @JsonProperty("chn_name")
+ public String chnName;
+
+ /** 客户 id。 */
+ @JsonProperty("customer_id")
+ public String customerId;
+
+ /** 客户代码。 */
+ @JsonProperty("customer_name")
+ public String customerName;
+
+ /** 目的仓 id / 代码。 */
+ @JsonProperty("dest_warehouse")
+ public String destWarehouseId;
+ @JsonProperty("dest_warehouse_name")
+ public String destWarehouseName;
+
+ /** 出运类型。 */
+ @JsonProperty("shipment_type")
+ public String shipmentType;
+
+ /** 参考编号。 */
+ @JsonProperty("ref_no")
+ public String refNo;
+
+ /** 柜型 / 柜号。 */
+ @JsonProperty("cabinet_type")
+ public String cabinetType;
+ @JsonProperty("cabinet_no")
+ public String cabinetNo;
+
+ /** 预计发货 / 到港时间。 */
+ @JsonProperty("rfc_etd")
+ public String rfcEtd;
+ @JsonProperty("rfc_eta")
+ public String rfcEta;
+ /** 实际发货 / 到港时间。 */
+ @JsonProperty("etd")
+ public String etd;
+ @JsonProperty("eta")
+ public String eta;
+
+ /** 是否超 120cm。 */
+ @JsonProperty("is_oversize")
+ public String isOversize;
+ @JsonProperty("oversize_val")
+ public String oversizeVal;
+
+ /** 发货需求。 */
+ @JsonProperty("delivery_requirements")
+ public String deliveryRequirements;
+
+ /** 预报时间。 */
+ @JsonProperty("forecast_time")
+ public String forecastTime;
+
+ /** 参考 SKU 种类数。 */
+ @JsonProperty("rfc_sku_count")
+ public String rfcSkuCount;
+
+ @JsonProperty("remark")
+ public String remark;
+
+ /** 托盘数:预报 / 实收 / 上架 / 计费。 */
+ @JsonProperty("forecast_pallet_qty")
+ public String forecastPalletQty;
+ @JsonProperty("receive_pallet_qty")
+ public String receivePalletQty;
+ @JsonProperty("shelf_pallet_qty")
+ public String shelfPalletQty;
+ @JsonProperty("bill_pallet_qty")
+ public String billPalletQty;
+
+ /** 到仓 / 卸柜清点 / 清点完成 / 上架 / 还柜时间。 */
+ @JsonProperty("receive_time")
+ public String receiveTime;
+ @JsonProperty("unlade_time")
+ public String unladeTime;
+ @JsonProperty("check_time")
+ public String checkTime;
+ @JsonProperty("putaway_time")
+ public String putawayTime;
+ @JsonProperty("leave_time")
+ public String leaveTime;
+
+ /** 是否需要内箱贴 / 外箱贴:1 是 / 0 否。 */
+ @JsonProperty("is_inner_box_sticker")
+ public String isInnerBoxSticker;
+ @JsonProperty("is_outer_box_sticker")
+ public String isOuterBoxSticker;
+
+ @JsonProperty("other_need")
+ public String otherNeed;
+
+ @JsonProperty("gmt_create")
+ public String gmtCreate;
+ @JsonProperty("gmt_modify")
+ public String gmtModify;
+
+ /** 预报状态码,见 {@code XincangForecastStatus}。 */
+ @JsonProperty("state")
+ public String state;
+ @JsonProperty("state_name")
+ public String stateName;
+
+ @JsonProperty("products")
+ public List products;
+ }
+
+ /** 预报详情里的产品行。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class ForecastDetailProduct {
+
+ @JsonProperty("product_no")
+ public String productNo;
+
+ @JsonProperty("product_name")
+ public String productName;
+
+ /** 件数。 */
+ @JsonProperty("sku_count")
+ public String skuCount;
+
+ /** 箱数。 */
+ @JsonProperty("box_count")
+ public String boxCount;
+
+ /** 清点箱数。 */
+ @JsonProperty("check_box_qty")
+ public String checkBoxQty;
+
+ /** 打托件数 / 上架件数。 */
+ @JsonProperty("pallet_sku_count")
+ public String palletSkuCount;
+ @JsonProperty("put_on_sku_count")
+ public String putOnSkuCount;
+
+ /** 装箱率。 */
+ @JsonProperty("packing_rate")
+ public String packingRate;
+
+ /** 体积(立方厘米)。 */
+ @JsonProperty("volume_cm")
+ public String volumeCm;
+
+ /** 中文名。 */
+ @JsonProperty("chn_name")
+ public String chnName;
+
+ /** 英文名。 */
+ @JsonProperty("en_name")
+ public String enName;
+
+ /** 体积(立方英寸)。 */
+ @JsonProperty("volume_ln")
+ public String volumeLn;
+
+ /** 长(厘米)。 */
+ @JsonProperty("size_l_cm")
+ public String sizeLCm;
+ /** 宽(厘米)。 */
+ @JsonProperty("size_w_cm")
+ public String sizeWCm;
+ /** 高(厘米)。 */
+ @JsonProperty("size_h_cm")
+ public String sizeHCm;
+ /** 长(英寸)。 */
+ @JsonProperty("size_l_ln")
+ public String sizeLLn;
+ /** 宽(英寸)。 */
+ @JsonProperty("size_w_ln")
+ public String sizeWLn;
+ /** 高(英寸)。 */
+ @JsonProperty("size_h_ln")
+ public String sizeHLn;
+
+ /** 预报产品创建时间。 */
+ @JsonProperty("gmt_create")
+ public String gmtCreate;
+ /** 预报产品最后修改时间。 */
+ @JsonProperty("gmt_modify")
+ public String gmtModify;
+ }
+
+ /** 预报详情响应外层。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class ForecastDetailResponse {
+
+ @JsonProperty("rst")
+ public ForecastDetail rst;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastImproveDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastImproveDtos.java
new file mode 100644
index 0000000..36d6c80
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastImproveDtos.java
@@ -0,0 +1,150 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * 信仓报文结构:完善预报资料({@code POST forecast.do_improve_forecast}):商品明细整段覆盖。
+ */
+public final class XincangForecastImproveDtos {
+
+ private XincangForecastImproveDtos() {
+ }
+
+ /**
+ * 完善预报资料请求({@code POST forecast.do_improve_forecast})。
+ *
+ * {@code products} 是一段 JSON 字符串,新数据直接覆盖旧数据。
+ */
+ @JsonInclude(JsonInclude.Include.NON_NULL)
+ public static final class ForecastImproveRequest {
+
+ /**
+ * 预报单 id。
+ *
+ * 文档标注已舍弃,SDK 不填;保留占位以与文档字段表对齐。
+ */
+ @JsonProperty("id")
+ @Deprecated
+ public String id;
+
+ /**
+ * 客户 id。
+ *
+ * 文档标注已舍弃,SDK 不填。
+ */
+ @JsonProperty("customer_id")
+ @Deprecated
+ public String customerId;
+
+ @JsonProperty("forecast_no")
+ public String forecastNo;
+
+ @JsonProperty("dest_warehouse")
+ public String destWarehouse;
+
+ @JsonProperty("shipment_type")
+ public String shipmentType;
+
+ /** 参考编号,长度上限 32。 */
+ @JsonProperty("ref_no")
+ public String refNo;
+
+ /**
+ * 新增预报柜号。
+ *
+ * 文档标注已舍弃,SDK 不填。
+ */
+ @JsonProperty("old_cabinet_no")
+ @Deprecated
+ public String oldCabinetNo;
+
+ /** 柜型:0 20GP / 1 40GP / 2 40HQ / 3 45HQ / 4 纸箱入库 / 5 托盘入库。 */
+ @JsonProperty("cabinet_type")
+ public String cabinetType;
+
+ /** 柜号。 */
+ @JsonProperty("cabinet_no")
+ public String cabinetNo;
+
+ /** 发货时间。 */
+ @JsonProperty("etd")
+ public String etd;
+
+ /** 到港时间。 */
+ @JsonProperty("eta")
+ public String eta;
+
+ /**
+ * 最晚免费时间(提柜)。
+ *
+ * 文档标注已舍弃,SDK 不填。
+ */
+ @JsonProperty("lfd")
+ @Deprecated
+ public String lfd;
+
+ @JsonProperty("delivery_requirements")
+ public String deliveryRequirements;
+
+ @JsonProperty("remark")
+ public String remark;
+
+ /** 其他需求,如 内箱贴,外箱贴。 */
+ @JsonProperty("other_need")
+ public String otherNeed;
+
+ /**
+ * 总件数。
+ *
+ * 文档标注已舍弃(由 {@code products} 汇总),SDK 不填。
+ */
+ @JsonProperty("sku_count_sum")
+ @Deprecated
+ public String skuCountSum;
+
+ /**
+ * 总箱数。
+ *
+ * 文档标注已舍弃(由 {@code products} 汇总),SDK 不填。
+ */
+ @JsonProperty("box_count_sum")
+ @Deprecated
+ public String boxCountSum;
+
+ /** 产品明细 JSON 字符串。 */
+ @JsonProperty("products")
+ public String products;
+
+ /** 船务公司 id;通过【获取船务公司】接口取得。 */
+ @JsonProperty("shipping_company_id")
+ public String shippingCompanyId;
+
+ /** 预报托盘数;柜型为托盘入库时填写。 */
+ @JsonProperty("forecast_pallet_qty")
+ public String forecastPalletQty;
+ }
+
+ /** 完善资料里的产品行(序列化进 {@code products} 字符串)。 */
+ @JsonInclude(JsonInclude.Include.NON_NULL)
+ public static final class ForecastProduct {
+
+ @JsonProperty("product_no")
+ public String productNo;
+
+ /** 件数。 */
+ @JsonProperty("sku_count")
+ public String skuCount;
+
+ /** 箱数。 */
+ @JsonProperty("box_count")
+ public String boxCount;
+
+ /** 批次号;可选。 */
+ @JsonProperty("batch_no")
+ public String batchNo;
+
+ @JsonProperty("remark")
+ public String remark;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangLoginDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangLoginDtos.java
new file mode 100644
index 0000000..34c56e6
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangLoginDtos.java
@@ -0,0 +1,64 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * 信仓报文结构:登录({@code GET /api.login}):换取客户级 token。
+ */
+public final class XincangLoginDtos {
+
+ private XincangLoginDtos() {
+ }
+
+ /**
+ * 登录响应({@code GET /api.login})。
+ *
+ * 注意与业务接口不同:登录的 {@code rst} 没有 {@code code/msg/data} 包裹,
+ * 而是直接给出客户与 token 字段。
+ */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class LoginResponse {
+
+ /** 登录结果;业务失败时可能为 null。 */
+ @JsonProperty("rst")
+ public LoginResult rst;
+
+ /** 0 表示成功。 */
+ @JsonProperty("errno")
+ public Integer errno;
+
+ /** 错误描述;成功时为空串。 */
+ @JsonProperty("err")
+ public String err;
+
+ /** 信仓侧链路号。 */
+ @JsonProperty("trace_id")
+ public String traceId;
+ }
+
+ /** 登录结果的 {@code rst} 部分。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class LoginResult {
+
+ /** 客户 id。 */
+ @JsonProperty("id")
+ public String customerId;
+
+ /** 回显的 APIKEY,正常等于登录用的 appkey。 */
+ @JsonProperty("api_client_id")
+ public String apiClientId;
+
+ /** 回显的 APISECRET;不需要也不应落盘,仅用于排障时核对身份。 */
+ @JsonProperty("api_client_secret")
+ public String apiClientSecret;
+
+ /** 过期时间,北京时间 {@code yyyy-MM-dd HH:mm:ss}。 */
+ @JsonProperty("token_expire_time")
+ public String tokenExpireTime;
+
+ /** 令牌本体(形如 {@code {D0A7A4FB-...}})。 */
+ @JsonProperty("token")
+ public String token;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangLogisticsDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangLogisticsDtos.java
new file mode 100644
index 0000000..9990961
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangLogisticsDtos.java
@@ -0,0 +1,49 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+/**
+ * 信仓报文结构:客户承运商列表({@code GET api.get_customer_logistics})。
+ */
+public final class XincangLogisticsDtos {
+
+ private XincangLogisticsDtos() {
+ }
+
+ /** 客户承运商列表响应 {@code rst}({@code GET api.get_customer_logistics})。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class LogisticsListResult {
+
+ @JsonProperty("code")
+ public String code;
+
+ @JsonProperty("msg")
+ public String msg;
+
+ @JsonProperty("data")
+ public List data;
+
+ /** 总条数(字符串)。 */
+ @JsonProperty("count")
+ public String count;
+
+ /** 一行承运商。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class LogisticsRow {
+
+ /** 物流方式代码,如 {@code FEDEX-G}。 */
+ @JsonProperty("logistics_type")
+ public String logisticsType;
+ }
+ }
+
+ /** 客户承运商列表响应外层。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class LogisticsListResponse {
+
+ @JsonProperty("rst")
+ public LogisticsListResult rst;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangOrderCreateDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangOrderCreateDtos.java
new file mode 100644
index 0000000..cb9600a
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangOrderCreateDtos.java
@@ -0,0 +1,55 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * 信仓报文结构:新增订单 / 一单多件({@code POST api.add_order_multiple})。
+ */
+public final class XincangOrderCreateDtos {
+
+ private XincangOrderCreateDtos() {
+ }
+
+ /**
+ * 新增订单(一单多件)请求中的一条商品。
+ *
+ * 信仓把整组商品 JSON 序列化后放进 multipart 的 {@code products} 字段。
+ */
+ @JsonInclude(JsonInclude.Include.NON_NULL)
+ public static final class OrderProduct {
+
+ /** 产品 SKU。 */
+ @JsonProperty("product_sku")
+ public String productSku;
+
+ /** 数量(字符串)。 */
+ @JsonProperty("sku_count")
+ public String skuCount;
+ }
+
+ /**
+ * 新增订单(一单多件)响应中的 {@code rst}。
+ */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class OrderResult {
+
+ /** 信仓系统单号(DS-...)。 */
+ @JsonProperty("order_no")
+ public String orderNo;
+
+ /** 信仓内部订单 id。 */
+ @JsonProperty("order_id")
+ public String orderId;
+ }
+
+ /** 新增订单响应外层,用于取 {@code rst}。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class OrderResponse {
+
+ /** 下单结果;业务失败时为 null。 */
+ @JsonProperty("rst")
+ public OrderResult rst;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangOrderDetailDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangOrderDetailDtos.java
new file mode 100644
index 0000000..ea42ac5
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangOrderDetailDtos.java
@@ -0,0 +1,173 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+/**
+ * 信仓报文结构:订单详情({@code GET api.get_order})。
+ */
+public final class XincangOrderDetailDtos {
+
+ private XincangOrderDetailDtos() {
+ }
+
+ /**
+ * 订单详情({@code GET api.get_order})的 {@code rst}。
+ *
+ * 字段名以文档为准;时间均为北京时间 {@code yyyy-MM-dd HH:mm:ss}(日期字段为
+ * {@code yyyy-MM-dd})。空值可能是空串,适配器里统一转 null。
+ */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class OrderDetail {
+
+ /** 订单 id。 */
+ @JsonProperty("id")
+ public String id;
+
+ /** 信仓系统单号(DS-...)。 */
+ @JsonProperty("order_no")
+ public String orderNo;
+
+ /** 订单状态码,见 {@code XincangOrderStatus}。 */
+ @JsonProperty("state")
+ public String state;
+
+ /** 状态名。 */
+ @JsonProperty("state_name")
+ public String stateName;
+
+ /** 仓侧报错信息;正常为空。 */
+ @JsonProperty("api_error")
+ public String apiError;
+
+ /** 跟踪号。 */
+ @JsonProperty("gzh")
+ public String trackingNumber;
+
+ /** 面单 URL。 */
+ @JsonProperty("face_url")
+ public String faceUrl;
+
+ /** 参考号,即我们下发的 {@code ckh}。 */
+ @JsonProperty("ckh")
+ public String ckh;
+
+ /** 订单类型:common / wayfair。 */
+ @JsonProperty("order_type")
+ public String orderType;
+
+ /** 产品明细(一票多件)。 */
+ @JsonProperty("products")
+ public List products;
+
+ /** 件数。 */
+ @JsonProperty("sku_count")
+ public String skuCount;
+
+ @JsonProperty("dim_length")
+ public String dimLength;
+ @JsonProperty("dim_width")
+ public String dimWidth;
+ @JsonProperty("dim_height")
+ public String dimHeight;
+ @JsonProperty("dim_divisor")
+ public String dimDivisor;
+
+ /** 实重(磅)。 */
+ @JsonProperty("weight_lbs")
+ public String weightLbs;
+ /** 计费重(磅)。 */
+ @JsonProperty("billing_weight_lbs")
+ public String billingWeightLbs;
+ /** 体积重(磅)。 */
+ @JsonProperty("volume_weight_lbs")
+ public String volumeWeightLbs;
+
+ @JsonProperty("product_sku")
+ public String productSku;
+ @JsonProperty("product_name")
+ public String productName;
+ @JsonProperty("source_sku")
+ public String sourceSku;
+
+ @JsonProperty("warehouse_id")
+ public String warehouseId;
+ @JsonProperty("warehouse_code")
+ public String warehouseCode;
+
+ @JsonProperty("country")
+ public String country;
+ @JsonProperty("province")
+ public String province;
+ @JsonProperty("city")
+ public String city;
+ @JsonProperty("address")
+ public String address;
+ @JsonProperty("address2")
+ public String address2;
+ @JsonProperty("postcode")
+ public String postcode;
+ @JsonProperty("receive_user")
+ public String receiveUser;
+ @JsonProperty("phone")
+ public String phone;
+ @JsonProperty("email")
+ public String email;
+
+ /** 物流方式字典值。 */
+ @JsonProperty("logistics_type")
+ public String logisticsType;
+ @JsonProperty("is_sign")
+ public String isSign;
+ @JsonProperty("zone")
+ public String zone;
+
+ /** 总费用。 */
+ @JsonProperty("total_amount")
+ public String totalAmount;
+ @JsonProperty("repair_amount")
+ public String repairAmount;
+
+ @JsonProperty("approve_time")
+ public String approveTime;
+ /** 发货时间。 */
+ @JsonProperty("delivered_time")
+ public String deliveredTime;
+ @JsonProperty("shop_name")
+ public String shopName;
+ @JsonProperty("gmt_create")
+ public String gmtCreate;
+ @JsonProperty("gmt_modify")
+ public String gmtModify;
+ @JsonProperty("gmt_cancel")
+ public String gmtCancel;
+ /** 截单时间。 */
+ @JsonProperty("intercept_time")
+ public String interceptTime;
+ }
+
+ /** 订单详情里的产品行。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class OrderDetailProduct {
+
+ @JsonProperty("product_id")
+ public String productId;
+ /** 产品 SKU。 */
+ @JsonProperty("sku")
+ public String sku;
+ /** 数量。 */
+ @JsonProperty("qty")
+ public String qty;
+ @JsonProperty("name_zh_cn")
+ public String nameZhCn;
+ }
+
+ /** 订单详情响应外层,用于取 {@code rst}。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class OrderDetailResponse {
+
+ @JsonProperty("rst")
+ public OrderDetail rst;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangProductListDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangProductListDtos.java
new file mode 100644
index 0000000..6ab4a35
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangProductListDtos.java
@@ -0,0 +1,30 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * 信仓报文结构:产品列表({@code GET api.productlist})。
+ */
+public final class XincangProductListDtos {
+
+ private XincangProductListDtos() {
+ }
+
+ /**
+ * 产品列表响应({@code GET api.productlist})中 {@code rst.data[]} 的元素。
+ *
+ * 只声明判断「是否已存在、处于什么状态」需要的字段。
+ */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class ProductListItem {
+
+ /** 产品 SKU。 */
+ @JsonProperty("product_no")
+ public String productNo;
+
+ /** 产品状态:0 临时产品 / 1 正式产品。 */
+ @JsonProperty("state")
+ public String state;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangProductSaveDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangProductSaveDtos.java
new file mode 100644
index 0000000..939eb02
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangProductSaveDtos.java
@@ -0,0 +1,138 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.math.BigDecimal;
+
+/**
+ * 信仓报文结构:新增 / 更新产品({@code POST api.add_product} / {@code api.update_product})。
+ *
+ * 两个接口共用同一套请求 schema,所以放在同一个文件。
+ */
+public final class XincangProductSaveDtos {
+
+ private XincangProductSaveDtos() {
+ }
+
+ /**
+ * 新增 / 更新产品请求({@code POST api.add_product} / {@code api.update_product})。
+ *
+ * 信仓这两个接口的 {@code token} 放在 请求体里(文档 required 列表含 {@code token});
+ * 新增接口的 query 里同时也收一份,见 {@code XincangRequestFactory}。
+ *
+ * 单位:金额美元、尺寸英寸、重量磅;与统一模型(cm / g)的换算在
+ * {@code XincangProductMapper}。
+ */
+ @JsonInclude(JsonInclude.Include.NON_NULL)
+ public static final class ProductRequest {
+
+ /** 令牌。 */
+ @JsonProperty("token")
+ public String token;
+
+ /** 产品 SKU。 */
+ @JsonProperty("product_no")
+ public String productNo;
+
+ /** 中文名。 */
+ @JsonProperty("chn_name")
+ public String chnName;
+
+ /** 金额,美元,最长两位小数。 */
+ @JsonProperty("amount")
+ public BigDecimal amount;
+
+ /** 产品条码。 */
+ @JsonProperty("bar_code")
+ public String barCode;
+
+ /** 毛重,磅,最长四位小数。 */
+ @JsonProperty("weight_lbs")
+ public BigDecimal weightLbs;
+
+ /** 装箱率 / 箱率。 */
+ @JsonProperty("packing_rate")
+ public Integer packingRate;
+
+ /** 长,英寸,最长四位小数。 */
+ @JsonProperty("size_l_ln")
+ public BigDecimal sizeLLn;
+
+ /** 宽,英寸,最长四位小数。 */
+ @JsonProperty("size_w_ln")
+ public BigDecimal sizeWLn;
+
+ /** 高,英寸,最长四位小数。 */
+ @JsonProperty("size_h_ln")
+ public BigDecimal sizeHLn;
+
+ /** 备注。 */
+ @JsonProperty("remark")
+ public String remark;
+
+ /** 仓库码(信仓 {@code ckm})。 */
+ @JsonProperty("ckm")
+ public String ckm;
+
+ /** 产品类型:1 普货 / 2 配件 / 3 危险品;不传默认 1。 */
+ @JsonProperty("product_type")
+ public Integer productType;
+
+ /** 产品品类:0 其它 / 1 家具 / 2 食品 / 3 汽配 / 4 服饰 / 5 化妆品 / 6 鞋类 / 7 玩具 / 8 电子 / 9 数码。 */
+ @JsonProperty("product_category")
+ public Integer productCategory;
+
+ /** 产品图片;需先调 {@code upload.files}。统一模型暂不承载图片,通常为 null。 */
+ @JsonProperty("product_image")
+ public ProductImage productImage;
+
+ /**
+ * AHS 计费重量。
+ *
+ * 文档标注已废弃:具体值由各服务商参数自动计算。SDK 不填,
+ * 保留占位只为与文档字段表对齐。
+ */
+ @JsonProperty("ahs_weight")
+ @Deprecated
+ public String ahsWeight;
+
+ /**
+ * AHS 计费尺寸。
+ *
+ * 文档标注已废弃:具体值由各服务商参数自动计算。SDK 不填。
+ */
+ @JsonProperty("ahs_dimensions")
+ @Deprecated
+ public String ahsDimensions;
+
+ /**
+ * 是否超尺寸。
+ *
+ * 文档标注已废弃:具体值由各服务商参数自动计算。SDK 不填。
+ */
+ @JsonProperty("oversize")
+ @Deprecated
+ public String oversize;
+ }
+
+ /** 产品图片(OSS 元数据)。 */
+ @JsonInclude(JsonInclude.Include.NON_NULL)
+ public static final class ProductImage {
+
+ /** 存储类型,如 {@code aliyun_oss}。 */
+ @JsonProperty("type")
+ public String type;
+
+ /** bucket 名。 */
+ @JsonProperty("bucket")
+ public String bucket;
+
+ /** 对象键。 */
+ @JsonProperty("file_name")
+ public String fileName;
+
+ /** 可访问 URL。 */
+ @JsonProperty("file_url")
+ public String fileUrl;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangStockAgeListDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangStockAgeListDtos.java
new file mode 100644
index 0000000..3c8e4e1
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangStockAgeListDtos.java
@@ -0,0 +1,88 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+/**
+ * 信仓报文结构:库龄列表({@code GET api.stockagelist})。
+ */
+public final class XincangStockAgeListDtos {
+
+ private XincangStockAgeListDtos() {
+ }
+
+ /** 库龄列表响应 {@code rst}({@code GET api.stockagelist})。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class StockAgeListResult {
+
+ @JsonProperty("code")
+ public String code;
+
+ @JsonProperty("msg")
+ public String msg;
+
+ @JsonProperty("data")
+ public List data;
+
+ /** 总条数(字符串)。 */
+ @JsonProperty("count")
+ public String count;
+
+ /** 一行库龄。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class AgeRow {
+
+ /** 计费日期 {@code yyyy-MM-dd}。 */
+ @JsonProperty("dt")
+ public String dt;
+
+ @JsonProperty("warehouse_code")
+ public String warehouseCode;
+
+ /** 产品 SKU。 */
+ @JsonProperty("product_sku")
+ public String productSku;
+
+ /** 入库柜号。 */
+ @JsonProperty("cabinet_no")
+ public String cabinetNo;
+
+ /** 当日费用。 */
+ @JsonProperty("sum_fee")
+ public String sumFee;
+
+ /** 计费总体积(立方米)。 */
+ @JsonProperty("total_volume_cbm")
+ public String totalVolumeCbm;
+
+ /** 库存数量。 */
+ @JsonProperty("sku_count")
+ public String skuCount;
+
+ /** 入库时间 {@code yyyy-MM-dd HH:mm:ss}。 */
+ @JsonProperty("in_stock_time")
+ public String inStockTime;
+
+ /** 库龄天数。 */
+ @JsonProperty("fee_days")
+ public String feeDays;
+
+ /** 费率。 */
+ @JsonProperty("config_price")
+ public String configPrice;
+
+ /** 计费数量。 */
+ @JsonProperty("fee_count")
+ public String feeCount;
+ }
+ }
+
+ /** 库龄列表响应外层。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class StockAgeListResponse {
+
+ @JsonProperty("rst")
+ public StockAgeListResult rst;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangStockListDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangStockListDtos.java
new file mode 100644
index 0000000..58c6832
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangStockListDtos.java
@@ -0,0 +1,84 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+/**
+ * 信仓报文结构:实时库存({@code GET api.stocklist})。
+ */
+public final class XincangStockListDtos {
+
+ private XincangStockListDtos() {
+ }
+
+ /** 实时库存响应 {@code rst}({@code GET api.stocklist})。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class StockListResult {
+
+ @JsonProperty("code")
+ public String code;
+
+ @JsonProperty("msg")
+ public String msg;
+
+ @JsonProperty("data")
+ public List data;
+
+ /** 总条数(字符串)。 */
+ @JsonProperty("count")
+ public String count;
+
+ /** 一行库存。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class StockRow {
+
+ @JsonProperty("warehouse_code")
+ public String warehouseCode;
+
+ /** 产品 SKU。 */
+ @JsonProperty("product_sku")
+ public String productSku;
+
+ /** 实时库存。 */
+ @JsonProperty("real_stock")
+ public String realStock;
+
+ /** 可售数量。 */
+ @JsonProperty("cansale_sku_count")
+ public String canSaleSkuCount;
+
+ /** 占用数量。 */
+ @JsonProperty("use_sku_count")
+ public String useSkuCount;
+
+ /** 待出库数量。 */
+ @JsonProperty("wait_sku_count")
+ public String waitSkuCount;
+
+ /** 在海上数量。 */
+ @JsonProperty("ship_sku_count")
+ public String shipSkuCount;
+
+ /** 预警数量。 */
+ @JsonProperty("alerm_count")
+ public String alarmCount;
+
+ /** 商品名。 */
+ @JsonProperty("chn_name")
+ public String chnName;
+
+ /** 体积(立方厘米)。 */
+ @JsonProperty("volume_cm")
+ public String volumeCm;
+ }
+ }
+
+ /** 实时库存响应外层。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class StockListResponse {
+
+ @JsonProperty("rst")
+ public StockListResult rst;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangTransferCreateDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangTransferCreateDtos.java
new file mode 100644
index 0000000..3b9c5b2
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangTransferCreateDtos.java
@@ -0,0 +1,160 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+/**
+ * 信仓报文结构:新增转运({@code POST fba.do_fba})。
+ */
+public final class XincangTransferCreateDtos {
+
+ private XincangTransferCreateDtos() {
+ }
+
+ /**
+ * 新增转运请求({@code POST fba.do_fba})。
+ *
+ * 附件字段(产品贴 / 外箱贴 / 托盘贴 / BOL)要求先用 {@code upload.files} 上传,
+ * 再把返回的 {@code data.data} 对象原样放进来;SDK 只做字段搬运。
+ */
+ @JsonInclude(JsonInclude.Include.NON_NULL)
+ public static final class TransferRequest {
+
+ /** 转运单号(业务侧),必填。 */
+ @JsonProperty("fba_no")
+ public String fbaNo;
+
+ /** PO 号,必填。 */
+ @JsonProperty("po")
+ public String po;
+
+ /** 发货仓(仓方字典名称),必填。 */
+ @JsonProperty("from_warehouse_name")
+ public String fromWarehouseName;
+
+ /** 目的仓(仓方字典名称),必填。 */
+ @JsonProperty("dest_warehouse_name")
+ public String destWarehouseName;
+
+ /** 其它仓库名;目的仓选「其他仓库」时填。 */
+ @JsonProperty("other_warehouse")
+ public String otherWarehouse;
+
+ /** 转运类型(订单类型字典值),必填。 */
+ @JsonProperty("order_type")
+ public String orderType;
+
+ /** 转运类型(转运类型字典值),必填。 */
+ @JsonProperty("delivery_mode")
+ public String deliveryMode;
+
+ /** 转运方式 / 配送方式(字典值),必填。 */
+ @JsonProperty("delivery_way")
+ public String deliveryWay;
+
+ /** 预约发货时间 {@code yyyy-MM-dd}。 */
+ @JsonProperty("pre_send_time")
+ public String preSendTime;
+
+ /** 标签需求,多选用英文逗号分隔,如 {@code 产品贴,外箱标签}。 */
+ @JsonProperty("label_requirement")
+ public String labelRequirement;
+
+ /** 备注。 */
+ @JsonProperty("remark")
+ public String remark;
+
+ /** 是否需要打托:{@code 是} / {@code 否}。 */
+ @JsonProperty("is_pallet")
+ public String isPallet;
+
+ /** 产品明细 JSON 字符串。 */
+ @JsonProperty("products")
+ public String products;
+
+ /** 产品贴打印份数。 */
+ @JsonProperty("product_print_copies")
+ public String productPrintCopies;
+
+ /** 外箱贴打印份数。 */
+ @JsonProperty("ctn_print_copies")
+ public String ctnPrintCopies;
+
+ /** 快递面单打印份数。 */
+ @JsonProperty("express_print_copies")
+ public String expressPrintCopies;
+
+ /** 托盘贴打印份数。 */
+ @JsonProperty("pallet_print_copies")
+ public String palletPrintCopies;
+
+ /** 产品贴附件;{@code label_requirement} 含「产品贴」时必传。 */
+ @JsonProperty("product_label_att")
+ public XincangUploadDtos.Attachment productLabelAtt;
+
+ /** 外箱贴附件;{@code label_requirement} 含「外箱标签」时必传。 */
+ @JsonProperty("ctn_label_att")
+ public XincangUploadDtos.Attachment ctnLabelAtt;
+
+ /** 快递面单附件;{@code delivery_way} 为快递发货类型时必传。 */
+ @JsonProperty("express_label_att")
+ public XincangUploadDtos.Attachment expressLabelAtt;
+
+ /** 托盘贴附件;卡车 + 打托 + 含「托盘标签」三条件同时满足时必传。 */
+ @JsonProperty("pallet_label_att")
+ public XincangUploadDtos.Attachment palletLabelAtt;
+
+ /** 其他附件(数组)。 */
+ @JsonProperty("other_att")
+ public List otherAtt;
+
+ /** BOL 附件(数组)。 */
+ @JsonProperty("bol_att")
+ public List bolAtt;
+ }
+
+ /** 转运请求里的产品明细(序列化进 {@code products} 字符串)。 */
+ @JsonInclude(JsonInclude.Include.NON_NULL)
+ public static final class TransferProduct {
+
+ /** 产品 SKU,必填。 */
+ @JsonProperty("product_no")
+ public String productNo;
+
+ /** 数量(字符串),必填。 */
+ @JsonProperty("sku_count")
+ public String skuCount;
+
+ /** 三方 SKU(可选)。 */
+ @JsonProperty("fn_sku")
+ public String fnSku;
+
+ /** 箱标 SKU(可选)。 */
+ @JsonProperty("ctn_sku")
+ public String ctnSku;
+
+ /** 备注。 */
+ @JsonProperty("remark")
+ public String remark;
+ }
+
+ /** 转运单创建结果 {@code rst}。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class TransferResult {
+
+ /** 信仓转运单号(LTL...),审核时传它。 */
+ @JsonProperty("order_no")
+ public String orderNo;
+ }
+
+ /** 新增转运响应外层,用于取 {@code rst}。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class TransferResponse {
+
+ /** 转运结果;业务失败时为 null。 */
+ @JsonProperty("rst")
+ public TransferResult rst;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangTransferDetailDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangTransferDetailDtos.java
new file mode 100644
index 0000000..30fd4e8
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangTransferDetailDtos.java
@@ -0,0 +1,198 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+/**
+ * 信仓报文结构:转运详情({@code GET fba.fba_detail})。
+ */
+public final class XincangTransferDetailDtos {
+
+ private XincangTransferDetailDtos() {
+ }
+
+ /**
+ * 转运单详情({@code GET fba.fba_detail})的 {@code rst}。
+ *
+ * 只声明统一模型用得上的字段与排查必需的字段;附件同时给了对象和
+ * {@code *_url}(签名后可直接下载),这里两者都保留。
+ */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class TransferDetail {
+
+ @JsonProperty("id")
+ public String id;
+ /** 转运单号(LTL...);审核与后续查询都用它。 */
+ @JsonProperty("order_no")
+ public String orderNo;
+ /** 业务侧转运单号(我们下发的 {@code fba_no})。 */
+ @JsonProperty("fba_no")
+ public String fbaNo;
+ @JsonProperty("po")
+ public String po;
+
+ /** 客户 id。 */
+ @JsonProperty("customer_id")
+ public String customerId;
+
+ /** 客户代码。 */
+ @JsonProperty("customer_no")
+ public String customerNo;
+
+ /** 发货仓 id / 代码。 */
+ @JsonProperty("from_warehouse")
+ public String fromWarehouseId;
+ @JsonProperty("from_warehouse_name")
+ public String fromWarehouseName;
+ /** 目的仓 id / 代码。 */
+ @JsonProperty("dest_warehouse")
+ public String destWarehouseId;
+ @JsonProperty("dest_warehouse_name")
+ public String destWarehouseName;
+
+ /** 预约发货时间 {@code yyyy-MM-dd}。 */
+ @JsonProperty("pre_send_time")
+ public String preSendTime;
+ /** 状态码,见 {@code XincangTransferState}。 */
+ @JsonProperty("state")
+ public String state;
+ @JsonProperty("state_name")
+ public String stateName;
+
+ /** 是否需要产品贴 / 外箱贴 / 托盘贴:0 否 / 1 是。 */
+ @JsonProperty("is_product_label")
+ public String isProductLabel;
+ @JsonProperty("is_ctn_label")
+ public String isCtnLabel;
+ @JsonProperty("is_pallet_label")
+ public String isPalletLabel;
+ /** 是否打托:0 否 / 1 是。 */
+ @JsonProperty("is_pallet")
+ public String isPallet;
+
+ @JsonProperty("remark")
+ public String remark;
+ @JsonProperty("picking_time")
+ public String pickingTime;
+ @JsonProperty("picked_time")
+ public String pickedTime;
+ @JsonProperty("palleted_time")
+ public String palletedTime;
+ /** 发货时间。 */
+ @JsonProperty("send_time")
+ public String sendTime;
+ @JsonProperty("approve_time")
+ public String approveTime;
+ @JsonProperty("shipping_id")
+ public String shippingId;
+
+ /** 转运类型(字典值)。 */
+ @JsonProperty("delivery_mode")
+ public String deliveryMode;
+ /** 转运方式(字典值)。 */
+ @JsonProperty("delivery_way")
+ public String deliveryWay;
+ /** 订单类型(字典值)。 */
+ @JsonProperty("order_type")
+ public String orderType;
+ @JsonProperty("other_warehouse")
+ public String otherWarehouse;
+ /** 标签需求,逗号分隔。 */
+ @JsonProperty("label_requirement")
+ public String labelRequirement;
+
+ /** 附件对象。 */
+ @JsonProperty("product_label_att")
+ public XincangUploadDtos.Attachment productLabelAtt;
+ @JsonProperty("ctn_label_att")
+ public XincangUploadDtos.Attachment ctnLabelAtt;
+ @JsonProperty("pallet_label_att")
+ public XincangUploadDtos.Attachment palletLabelAtt;
+ @JsonProperty("bol_att")
+ public List bolAtt;
+ @JsonProperty("signature_bol_att")
+ public List signatureBolAtt;
+ @JsonProperty("express_label_att")
+ public XincangUploadDtos.Attachment expressLabelAtt;
+ @JsonProperty("other_att")
+ public List otherAtt;
+
+ /** 附件签名 URL(可直接下载)。 */
+ @JsonProperty("product_label_att_url")
+ public String productLabelAttUrl;
+ @JsonProperty("ctn_label_att_url")
+ public String ctnLabelAttUrl;
+ @JsonProperty("pallet_label_att_url")
+ public String palletLabelAttUrl;
+ @JsonProperty("bol_att_url")
+ public String bolAttUrl;
+ @JsonProperty("signature_bol_file")
+ public String signatureBolFile;
+ @JsonProperty("express_label_att_url")
+ public String expressLabelAttUrl;
+ @JsonProperty("other_att_url")
+ public String otherAttUrl;
+
+ /** 总费用。 */
+ @JsonProperty("total_amount")
+ public String totalAmount;
+
+ @JsonProperty("gmt_create")
+ public String gmtCreate;
+ @JsonProperty("gmt_modify")
+ public String gmtModify;
+
+ /** 产品明细。 */
+ @JsonProperty("products")
+ public List products;
+ }
+
+ /** 转运详情里的产品行。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class TransferDetailProduct {
+
+ @JsonProperty("product_no")
+ public String productNo;
+ /** 件数。 */
+ @JsonProperty("sku_count")
+ public String skuCount;
+ /** 箱数。 */
+ @JsonProperty("box_count")
+ public String boxCount;
+ @JsonProperty("chn_name")
+ public String chnName;
+ @JsonProperty("packing_rate")
+ public String packingRate;
+ @JsonProperty("remark")
+ public String remark;
+ @JsonProperty("weight_lbs")
+ public String weightLbs;
+ @JsonProperty("weight_kg")
+ public String weightKg;
+
+ /** 产品中文名(文档字段 {@code chn_name} 的语义;与 {@link #chnName} 同值来源)。 */
+ @JsonProperty("product_name")
+ public String productName;
+
+ /** 清点箱数。 */
+ @JsonProperty("check_box_qty")
+ public String checkBoxQty;
+
+ /** 打托件数。 */
+ @JsonProperty("pallet_sku_count")
+ public String palletSkuCount;
+
+ /** 上架件数。 */
+ @JsonProperty("put_on_sku_count")
+ public String putOnSkuCount;
+ }
+
+ /** 转运详情响应外层。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class TransferDetailResponse {
+
+ @JsonProperty("rst")
+ public TransferDetail rst;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangUploadDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangUploadDtos.java
new file mode 100644
index 0000000..83c2126
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangUploadDtos.java
@@ -0,0 +1,85 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * 信仓报文结构:文件上传({@code POST upload.files})。
+ *
+ * {@code Attachment} 是上传返回的 {@code data.data},原样回传给转运的
+ * {@code *_att} 字段,所以由本文件持有。
+ */
+public final class XincangUploadDtos {
+
+ private XincangUploadDtos() {
+ }
+
+ /**
+ * 附件元数据({@code upload.files} 返回的 {@code data.data} 原样回传)。
+ *
+ * 字段名与上传接口返回保持一致,包括 {@code file_url} 与 {@code fileType} 的
+ * 大小写差异——信仓文档里就是这么写的。
+ */
+ @JsonInclude(JsonInclude.Include.NON_NULL)
+ public static final class Attachment {
+
+ /** 存储类型,如 {@code aliyun_oss}。 */
+ @JsonProperty("type")
+ public String type;
+
+ /** bucket 名。 */
+ @JsonProperty("bucket")
+ public String bucket;
+
+ /** 对象键。 */
+ @JsonProperty("file_name")
+ public String fileName;
+
+ /** 可访问 URL。 */
+ @JsonProperty("file_url")
+ public String fileUrl;
+
+ /** 文件类型(信仓原文是 camelCase)。 */
+ @JsonProperty("fileType")
+ public String fileType;
+
+ /** 原始文件名。 */
+ @JsonProperty("name")
+ public String name;
+
+ /** 上传接口返回的 uid,通常为空串。 */
+ @JsonProperty("uid")
+ public String uid;
+
+ /** 上传接口返回的 url(与 file_url 同值)。 */
+ @JsonProperty("url")
+ public String url;
+ }
+
+ /** 文件上传响应({@code POST upload.files}):{@code {code,msg,data:{data:{...}}}}。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class UploadResponse {
+
+ /** 业务数据外层。 */
+ @JsonProperty("data")
+ public UploadData data;
+
+ /** 200 表示成功。 */
+ @JsonProperty("code")
+ public Integer code;
+
+ /** 描述。 */
+ @JsonProperty("msg")
+ public String msg;
+ }
+
+ /** 上传响应的 {@code data} 层。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class UploadData {
+
+ /** 附件元数据;直接作为 {@code *_att} 传参。 */
+ @JsonProperty("data")
+ public Attachment data;
+ }
+}
diff --git a/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangWarehouseDtos.java b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangWarehouseDtos.java
new file mode 100644
index 0000000..c97f8d5
--- /dev/null
+++ b/warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangWarehouseDtos.java
@@ -0,0 +1,64 @@
+package common.ecommerce.xincang.dto;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
+
+/**
+ * 信仓报文结构:客户仓库列表({@code GET api.get_customer_warehouses})。
+ */
+public final class XincangWarehouseDtos {
+
+ private XincangWarehouseDtos() {
+ }
+
+ /** 客户仓库列表响应 {@code rst}({@code GET api.get_customer_warehouses})。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class WarehouseListResult {
+
+ @JsonProperty("code")
+ public String code;
+
+ @JsonProperty("msg")
+ public String msg;
+
+ @JsonProperty("data")
+ public List data;
+
+ /** 总条数(字符串)。 */
+ @JsonProperty("count")
+ public String count;
+
+ /** 一行仓库。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class WarehouseRow {
+
+ /** 仓方内部 id。 */
+ @JsonProperty("id")
+ public String id;
+
+ /** 仓代码。 */
+ @JsonProperty("warehouse_code")
+ public String warehouseCode;
+
+ @JsonProperty("country")
+ public String country;
+ @JsonProperty("province")
+ public String province;
+ @JsonProperty("city")
+ public String city;
+ @JsonProperty("street")
+ public String street;
+ @JsonProperty("postcode")
+ public String postcode;
+ }
+ }
+
+ /** 客户仓库列表响应外层。 */
+ @JsonIgnoreProperties(ignoreUnknown = true)
+ public static final class WarehouseListResponse {
+
+ @JsonProperty("rst")
+ public WarehouseListResult rst;
+ }
+}