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; + } +}