Browse Source

refactor(xincang): 按接口拆分 DTO,XincangDtos 拆成 16 个文件

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 <noreply@anthropic.com>
master
lml 1 week ago
parent
commit
c5d9c768a9
  1. 9
      README.md
  2. 75
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangAdapter.java
  3. 25
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangChannelRecommendMapper.java
  4. 24
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangForecastMapper.java
  5. 13
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangInventoryMapper.java
  6. 12
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderDetailMapper.java
  7. 9
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderMapper.java
  8. 8
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangProductMapper.java
  9. 12
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferDetailMapper.java
  10. 25
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferMapper.java
  11. 6
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/auth/XincangTokenClient.java
  12. 144
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangChannelRecommendDtos.java
  13. 1601
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangDtos.java
  14. 104
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastCreateDtos.java
  15. 222
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastDetailDtos.java
  16. 150
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastImproveDtos.java
  17. 64
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangLoginDtos.java
  18. 49
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangLogisticsDtos.java
  19. 55
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangOrderCreateDtos.java
  20. 173
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangOrderDetailDtos.java
  21. 30
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangProductListDtos.java
  22. 138
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangProductSaveDtos.java
  23. 88
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangStockAgeListDtos.java
  24. 84
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangStockListDtos.java
  25. 160
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangTransferCreateDtos.java
  26. 198
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangTransferDetailDtos.java
  27. 85
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangUploadDtos.java
  28. 64
      warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangWarehouseDtos.java

9
README.md

@ -362,7 +362,14 @@ common.ecommerce @@ -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

75
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangAdapter.java

@ -49,7 +49,20 @@ import common.ecommerce.warehouse.model.TransferOrder; @@ -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 @@ -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 @@ -181,7 +194,7 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
* <p>{@code api.productlist} 的 {@code key} 是 SKU 过滤条件,但文档没说是否精确匹配,
* 这里再按 {@code product_no} 精确比对一次。</p>
*/
private XincangDtos.ProductListItem findTemporaryProduct(WarehouseContext ctx, AccessToken token,
private XincangProductListDtos.ProductListItem findTemporaryProduct(WarehouseContext ctx, AccessToken token,
String sku) {
Map<String, Object> params = new LinkedHashMap<>();
params.put("state", 0);
@ -190,9 +203,9 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa @@ -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<XincangDtos.ProductListItem> items =
json.listAt(raw, "rst.data", XincangDtos.ProductListItem.class);
for (XincangDtos.ProductListItem item : items) {
List<XincangProductListDtos.ProductListItem> 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 @@ -220,7 +233,7 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
Map<String, String> 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 @@ -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 @@ -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 @@ -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 @@ -447,15 +462,15 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
public List<WarehouseFacility> warehouses(WarehouseContext ctx) {
String raw = executeGet(ctx, XincangConstants.PATH_CUSTOMER_WAREHOUSES,
new LinkedHashMap<String, Object>(), 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<WarehouseFacility> out = new ArrayList<WarehouseFacility>();
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 @@ -482,15 +497,15 @@ public final class XincangAdapter implements WarehouseProductCapable, OutboundCa
public List<String> carriers(WarehouseContext ctx) {
String raw = executeGet(ctx, XincangConstants.PATH_CUSTOMER_LOGISTICS,
new LinkedHashMap<String, Object>(), 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<String> out = new ArrayList<String>();
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 @@ -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 @@ -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 @@ -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 @@ -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 @@ -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 @@ -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");

25
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangChannelRecommendMapper.java

@ -4,7 +4,7 @@ import common.ecommerce.shared.support.Money; @@ -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 { @@ -32,12 +32,13 @@ public final class XincangChannelRecommendMapper {
}
/** 统一询价条件 → 信仓请求体。 */
public static XincangDtos.CalculateV3Request toRequest(ChannelRecommendQuery query) {
XincangDtos.CalculateV3Request req = new XincangDtos.CalculateV3Request();
List<XincangDtos.CalculateV3Request.Product> products =
new ArrayList<XincangDtos.CalculateV3Request.Product>(query.products().size());
public static XincangChannelRecommendDtos.CalculateV3Request toRequest(ChannelRecommendQuery query) {
XincangChannelRecommendDtos.CalculateV3Request req = new XincangChannelRecommendDtos.CalculateV3Request();
List<XincangChannelRecommendDtos.CalculateV3Request.Product> products =
new ArrayList<XincangChannelRecommendDtos.CalculateV3Request.Product>(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 { @@ -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 { @@ -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 { @@ -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 { @@ -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;
}

24
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangForecastMapper.java

@ -11,7 +11,9 @@ import common.ecommerce.warehouse.model.InboundOrder; @@ -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 { @@ -40,9 +42,9 @@ public final class XincangForecastMapper {
* <p>信仓必填:目的仓、出运类型、柜型、柜号、参考发货 / 到港时间、发货需求、
* 参考 SKU 种类数。缺一项在下发前就拒绝,避免仓返回难懂的 err。</p>
*/
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 { @@ -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 { @@ -111,11 +113,11 @@ public final class XincangForecastMapper {
* 按「一箱一件」兜底({@code box_count = sku_count});装箱率不同的场景
* 需要调用方在 {@code InboundCarton} 里显式给出,本轮不做更细的拆分。</p>
*/
public static List<XincangDtos.ForecastProduct> products(InboundCommand cmd) {
List<XincangDtos.ForecastProduct> products =
new ArrayList<XincangDtos.ForecastProduct>(cmd.lines().size());
public static List<XincangForecastImproveDtos.ForecastProduct> products(InboundCommand cmd) {
List<XincangForecastImproveDtos.ForecastProduct> products =
new ArrayList<XincangForecastImproveDtos.ForecastProduct>(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 { @@ -130,11 +132,11 @@ public final class XincangForecastMapper {
* <p>双号:{@code forecast_no} 既作仓侧单号也作业务单号兜底——
* 信仓的 {@code ref_no} 可能为空。</p>
*/
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<InboundOrderLine> lines = new ArrayList<InboundOrderLine>();
if (detail.products != null) {
for (XincangDtos.ForecastDetailProduct product : detail.products) {
for (XincangForecastDetailDtos.ForecastDetailProduct product : detail.products) {
if (product == null || blank(product.productNo)) {
continue;
}

13
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangInventoryMapper.java

@ -7,7 +7,8 @@ import common.ecommerce.warehouse.model.InventoryAgeRecord; @@ -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; @@ -28,7 +29,7 @@ import java.util.Map;
* <li>库龄列表 {@code GET api.stockagelist}</li>
* </ul>
*
* <p>平台字段名只出现在本类与 {@link XincangDtos};时间按北京时间解析成 UTC。</p>
* <p>平台字段名只出现在本类与 {@code dto} 包下的各 {@code Xincang*Dtos};时间按北京时间解析成 UTC。</p>
*/
public final class XincangInventoryMapper {
@ -79,14 +80,14 @@ public final class XincangInventoryMapper { @@ -79,14 +80,14 @@ public final class XincangInventoryMapper {
}
/** 库存响应 → 快照分页。 */
public static Page<InventorySnapshot> toSnapshots(XincangDtos.StockListResult rst,
public static Page<InventorySnapshot> toSnapshots(XincangStockListDtos.StockListResult rst,
String fallbackWarehouseCode,
Instant asOf,
int currentPage,
int pageSize) {
List<InventorySnapshot> out = new ArrayList<InventorySnapshot>();
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 { @@ -128,13 +129,13 @@ public final class XincangInventoryMapper {
}
/** 库龄响应 → 记录分页。 */
public static Page<InventoryAgeRecord> toAgeRecords(XincangDtos.StockAgeListResult rst,
public static Page<InventoryAgeRecord> toAgeRecords(XincangStockAgeListDtos.StockAgeListResult rst,
String fallbackWarehouseCode,
int currentPage,
int pageSize) {
List<InventoryAgeRecord> out = new ArrayList<InventoryAgeRecord>();
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;
}

12
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderDetailMapper.java

@ -9,7 +9,7 @@ import common.ecommerce.warehouse.model.OutboundOrder; @@ -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; @@ -23,7 +23,7 @@ import java.util.List;
/**
* 信仓订单详情报文 → 统一模型({@code GET api.get_order})。
*
* <p>平台字段名只出现在本类与 {@link XincangDtos}。
* <p>平台字段名只出现在本类与 {@code XincangOrderDetailDtos}。
* 时间字段是北京时间 {@code yyyy-MM-dd HH:mm:ss},统一折算成 UTC。</p>
*/
public final class XincangOrderDetailMapper {
@ -42,7 +42,7 @@ 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 { @@ -108,11 +108,11 @@ public final class XincangOrderDetailMapper {
* 单值字段;前者非空时以它为准,为空才退回单值字段。数量缺失或非正的行直接跳过——
* {@link OutboundLine} 要求数量为正,保留会在构造期抛异常。</p>
*/
static List<OutboundLine> toLines(XincangDtos.OrderDetail detail) {
static List<OutboundLine> toLines(XincangOrderDetailDtos.OrderDetail detail) {
List<OutboundLine> lines = new ArrayList<OutboundLine>();
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 { @@ -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;
}

9
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangOrderMapper.java

@ -10,7 +10,7 @@ import common.ecommerce.warehouse.model.OutboundLine; @@ -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; @@ -25,7 +25,7 @@ import java.util.Map;
* 信仓出库下单报文映射({@code POST api.add_order_multiple})。
*
* <p>该接口是 {@code multipart/form-data},{@code products} 字段本身是一段 JSON 字符串。
* 平台字段名只出现在本类与 {@link XincangDtos}。</p>
* 平台字段名只出现在本类与 {@code XincangOrderCreateDtos}。</p>
*
* <p>文档没有对应字段的就不发:申报信息(HS / 原产国 / 申报价值)、包裹尺寸等
* 统一模型里有,但信仓这版接口不收,硬塞只会被忽略或报错。</p>
@ -120,9 +120,10 @@ public final class XincangOrderMapper { @@ -120,9 +120,10 @@ public final class XincangOrderMapper {
/** 商品明细:{@code [{"product_sku":"...","sku_count":"1"}, ...]}。 */
static String productsJson(List<OutboundLine> lines, JsonCodec json) {
List<XincangDtos.OrderProduct> products = new ArrayList<XincangDtos.OrderProduct>(lines.size());
List<XincangOrderCreateDtos.OrderProduct> products =
new ArrayList<XincangOrderCreateDtos.OrderProduct>(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);

8
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangProductMapper.java

@ -3,7 +3,7 @@ package common.ecommerce.xincang.adapter; @@ -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; @@ -11,7 +11,7 @@ import java.math.RoundingMode;
/**
* 信仓商品报文映射({@code POST api.add_product} / {@code api.update_product})。
*
* <p>平台字段名只出现在本类与 {@link XincangDtos}。单位换算也在这里:
* <p>平台字段名只出现在本类与 {@code XincangProductSaveDtos}。单位换算也在这里:
* 统一模型用 cm / g,信仓用 inch / lbs,按 {@link XincangConstants} 里的常量换算并保留 4 位小数
* (文档「最长四位小数」)。</p>
*
@ -40,8 +40,8 @@ public final class XincangProductMapper { @@ -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();

12
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferDetailMapper.java

@ -4,7 +4,7 @@ import common.ecommerce.warehouse.enums.TransferStatus; @@ -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 { @@ -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 { @@ -69,13 +69,13 @@ public final class XincangTransferDetailMapper {
}
/** 转运明细行 → 统一模型。 */
static java.util.List<TransferOrder.TransferLine> toLines(XincangDtos.TransferDetail detail) {
static java.util.List<TransferOrder.TransferLine> toLines(XincangTransferDetailDtos.TransferDetail detail) {
if (detail.products == null || detail.products.isEmpty()) {
return java.util.Collections.emptyList();
}
java.util.List<TransferOrder.TransferLine> out =
new java.util.ArrayList<TransferOrder.TransferLine>(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 { @@ -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);
}

25
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/adapter/XincangTransferMapper.java

@ -8,7 +8,8 @@ import common.ecommerce.warehouse.model.TransferCommand; @@ -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 { @@ -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 { @@ -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 { @@ -95,13 +96,13 @@ public final class XincangTransferMapper {
}
/** 附件列表;空列表返回 null(不发空数组)。 */
private static List<XincangDtos.Attachment> attachments(List<TransferAttachment> sources) {
private static List<XincangUploadDtos.Attachment> attachments(List<TransferAttachment> sources) {
if (sources == null || sources.isEmpty()) {
return null;
}
List<XincangDtos.Attachment> out = new ArrayList<XincangDtos.Attachment>(sources.size());
List<XincangUploadDtos.Attachment> out = new ArrayList<XincangUploadDtos.Attachment>(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 { @@ -126,11 +127,11 @@ public final class XincangTransferMapper {
}
/** 产品明细:{@code [{"product_no":"SKU","sku_count":"1"}]}。 */
public static List<XincangDtos.TransferProduct> products(TransferCommand cmd) {
List<XincangDtos.TransferProduct> products =
new ArrayList<XincangDtos.TransferProduct>(cmd.lines().size());
public static List<XincangTransferCreateDtos.TransferProduct> products(TransferCommand cmd) {
List<XincangTransferCreateDtos.TransferProduct> products =
new ArrayList<XincangTransferCreateDtos.TransferProduct>(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());

6
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/auth/XincangTokenClient.java

@ -8,7 +8,7 @@ import common.ecommerce.shared.error.ValidationException; @@ -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 { @@ -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()) {

144
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangChannelRecommendDtos.java

@ -0,0 +1,144 @@ @@ -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)。
*
* <p>文档写的是 GET + {@code application/json} body;信仓其它 GET 都是 query,
* 这里按文档原样用 JSON body。</p>
*/
@JsonInclude(JsonInclude.Include.NON_NULL)
public static final class CalculateV3Request {
/** 产品信息;必填。 */
@JsonProperty("products")
public List<Product> 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<WarehouseFee> 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> logisticsService;
}
/** 单个物流渠道的报价。 */
@JsonIgnoreProperties(ignoreUnknown = true)
public static final class LogisticsService {
@JsonProperty("service_code")
public String serviceCode;
/** 总费用。 */
@JsonProperty("sum")
public String sum;
/** 费用明细。 */
@JsonProperty("fees")
public List<Fee> 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;
}
}

1601
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangDtos.java

File diff suppressed because it is too large Load Diff

104
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastCreateDtos.java

@ -0,0 +1,104 @@ @@ -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})。
*
* <p>只建单,不带商品明细;明细走「完善资料」。</p>
*/
@JsonInclude(JsonInclude.Include.NON_NULL)
public static final class ForecastCreateRequest {
/**
* 客户 id。
*
* <p>文档标注<b>已舍弃</b>,SDK 不填;保留占位以与文档字段表对齐。</p>
*/
@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;
}
}

222
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastDetailDtos.java

@ -0,0 +1,222 @@ @@ -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}。
*
* <p>时间字段是北京时间。</p>
*/
@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<ForecastDetailProduct> 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;
}
}

150
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangForecastImproveDtos.java

@ -0,0 +1,150 @@ @@ -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})。
*
* <p>{@code products} 是一段 JSON 字符串,新数据直接覆盖旧数据。</p>
*/
@JsonInclude(JsonInclude.Include.NON_NULL)
public static final class ForecastImproveRequest {
/**
* 预报单 id。
*
* <p>文档标注<b>已舍弃</b>,SDK 不填;保留占位以与文档字段表对齐。</p>
*/
@JsonProperty("id")
@Deprecated
public String id;
/**
* 客户 id。
*
* <p>文档标注<b>已舍弃</b>,SDK 不填。</p>
*/
@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;
/**
* 新增预报柜号。
*
* <p>文档标注<b>已舍弃</b>,SDK 不填。</p>
*/
@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;
/**
* 最晚免费时间(提柜)。
*
* <p>文档标注<b>已舍弃</b>,SDK 不填。</p>
*/
@JsonProperty("lfd")
@Deprecated
public String lfd;
@JsonProperty("delivery_requirements")
public String deliveryRequirements;
@JsonProperty("remark")
public String remark;
/** 其他需求,如 内箱贴,外箱贴。 */
@JsonProperty("other_need")
public String otherNeed;
/**
* 总件数。
*
* <p>文档标注<b>已舍弃</b>(由 {@code products} 汇总),SDK 不填。</p>
*/
@JsonProperty("sku_count_sum")
@Deprecated
public String skuCountSum;
/**
* 总箱数。
*
* <p>文档标注<b>已舍弃</b>(由 {@code products} 汇总),SDK 不填。</p>
*/
@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;
}
}

64
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangLoginDtos.java

@ -0,0 +1,64 @@ @@ -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})。
*
* <p>注意与业务接口不同:登录的 {@code rst} <b>没有</b> {@code code/msg/data} 包裹,
* 而是直接给出客户与 token 字段。</p>
*/
@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;
}
}

49
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangLogisticsDtos.java

@ -0,0 +1,49 @@ @@ -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<LogisticsRow> 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;
}
}

55
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangOrderCreateDtos.java

@ -0,0 +1,55 @@ @@ -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() {
}
/**
* 新增订单(一单多件)请求中的一条商品。
*
* <p>信仓把整组商品 JSON 序列化后放进 multipart 的 {@code products} 字段。</p>
*/
@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;
}
}

173
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangOrderDetailDtos.java

@ -0,0 +1,173 @@ @@ -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}。
*
* <p>字段名以文档为准;时间均为北京时间 {@code yyyy-MM-dd HH:mm:ss}(日期字段为
* {@code yyyy-MM-dd})。空值可能是空串,适配器里统一转 null。</p>
*/
@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<OrderDetailProduct> 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;
}
}

30
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangProductListDtos.java

@ -0,0 +1,30 @@ @@ -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[]} 的元素。
*
* <p>只声明判断「是否已存在、处于什么状态」需要的字段。</p>
*/
@JsonIgnoreProperties(ignoreUnknown = true)
public static final class ProductListItem {
/** 产品 SKU。 */
@JsonProperty("product_no")
public String productNo;
/** 产品状态:0 临时产品 / 1 正式产品。 */
@JsonProperty("state")
public String state;
}
}

138
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangProductSaveDtos.java

@ -0,0 +1,138 @@ @@ -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})。
*
* <p>两个接口共用同一套请求 schema,所以放在同一个文件。</p>
*/
public final class XincangProductSaveDtos {
private XincangProductSaveDtos() {
}
/**
* 新增 / 更新产品请求({@code POST api.add_product} / {@code api.update_product})。
*
* <p>信仓这两个接口的 {@code token} 放在 <b>请求体</b>里(文档 required 列表含 {@code token});
* 新增接口的 query 里同时也收一份,见 {@code XincangRequestFactory}。</p>
*
* <p>单位:金额美元、尺寸英寸、重量磅;与统一模型(cm / g)的换算在
* {@code XincangProductMapper}。</p>
*/
@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 计费重量。
*
* <p>文档标注<b>已废弃</b>:具体值由各服务商参数自动计算。SDK 不填,
* 保留占位只为与文档字段表对齐。</p>
*/
@JsonProperty("ahs_weight")
@Deprecated
public String ahsWeight;
/**
* AHS 计费尺寸。
*
* <p>文档标注<b>已废弃</b>:具体值由各服务商参数自动计算。SDK 不填。</p>
*/
@JsonProperty("ahs_dimensions")
@Deprecated
public String ahsDimensions;
/**
* 是否超尺寸。
*
* <p>文档标注<b>已废弃</b>:具体值由各服务商参数自动计算。SDK 不填。</p>
*/
@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;
}
}

88
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangStockAgeListDtos.java

@ -0,0 +1,88 @@ @@ -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<AgeRow> 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;
}
}

84
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangStockListDtos.java

@ -0,0 +1,84 @@ @@ -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<StockRow> 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;
}
}

160
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangTransferCreateDtos.java

@ -0,0 +1,160 @@ @@ -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})。
*
* <p>附件字段(产品贴 / 外箱贴 / 托盘贴 / BOL)要求先用 {@code upload.files} 上传,
* 再把返回的 {@code data.data} 对象原样放进来;SDK 只做字段搬运。</p>
*/
@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<XincangUploadDtos.Attachment> otherAtt;
/** BOL 附件(数组)。 */
@JsonProperty("bol_att")
public List<XincangUploadDtos.Attachment> 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;
}
}

198
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangTransferDetailDtos.java

@ -0,0 +1,198 @@ @@ -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}。
*
* <p>只声明统一模型用得上的字段与排查必需的字段;附件同时给了对象和
* {@code *_url}(签名后可直接下载),这里两者都保留。</p>
*/
@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<XincangUploadDtos.Attachment> bolAtt;
@JsonProperty("signature_bol_att")
public List<XincangUploadDtos.Attachment> signatureBolAtt;
@JsonProperty("express_label_att")
public XincangUploadDtos.Attachment expressLabelAtt;
@JsonProperty("other_att")
public List<XincangUploadDtos.Attachment> 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<TransferDetailProduct> 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;
}
}

85
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangUploadDtos.java

@ -0,0 +1,85 @@ @@ -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})。
*
* <p>{@code Attachment} 是上传返回的 {@code data.data},原样回传给转运的
* {@code *_att} 字段,所以由本文件持有。</p>
*/
public final class XincangUploadDtos {
private XincangUploadDtos() {
}
/**
* 附件元数据({@code upload.files} 返回的 {@code data.data} 原样回传)。
*
* <p>字段名与上传接口返回保持一致,包括 {@code file_url} 与 {@code fileType} 的
* 大小写差异——信仓文档里就是这么写的。</p>
*/
@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;
}
}

64
warehouse-sdk-xincang/src/main/java/common/ecommerce/xincang/dto/XincangWarehouseDtos.java

@ -0,0 +1,64 @@ @@ -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<WarehouseRow> 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;
}
}
Loading…
Cancel
Save