From 57404c6fe8a3b66d5d7b49ae210f0b47b20aa8ff Mon Sep 17 00:00:00 2001 From: lml <1297555865@qq.com> Date: Fri, 6 Nov 2026 18:01:18 +0800 Subject: [PATCH] =?UTF-8?q?feat(lingxing):=20=E4=BF=AE=E6=AD=A3=20AWD=20?= =?UTF-8?q?=E5=85=A5=E5=BA=93=E6=97=B6=E9=97=B4=E8=A7=A3=E6=9E=90=E4=B8=8E?= =?UTF-8?q?=E5=A4=9A=E5=B9=B3=E5=8F=B0=E8=AE=A2=E5=8D=95=E5=88=86=E9=A1=B5?= =?UTF-8?q?=E4=B8=8B=E9=99=90=EF=BC=8C=E8=A1=A5=E9=BD=90=E5=BA=97=E9=93=BA?= =?UTF-8?q?/=E8=AE=A2=E5=8D=95/=E9=9D=A2=E5=8D=95/=E5=85=A5=E5=BA=93?= =?UTF-8?q?=E6=8E=A2=E9=92=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - fix(inbound): AWD 的 gmtCreate/gmtModified/shipBy 真实报文是 yyyy-MM-dd HH:mm:ss(无时区,按北京时间), 严格 ISO 解析会让整页货件映射失败;新增 InboundSupport.parseFlexible 做 ISO 优先 + 北京时间兜底 - fix(inbound): AWD 报文里 shipmentId(入库货件号)与 orderId(AWD 货件号)是两个字段, 前者落到 shipmentId、后者落到 shipmentNo,老报文缺 shipmentId 时回落 orderId - fix(order): 多平台订单 length 下限 20(真机 pageSize=5 返回 code=102 length最小值为20), 适配器统一收窄到 [LingxingConstants.MIN_PAGE_SIZE, MAX_PAGE_SIZE] - fix(order): FBM 列表确认只返回头部字段,注释写明金额与商品行必须调 getOrderDetail,DTO 同步说明 - test: 新增 FulfillmentProbeTest(probe 风格只读探针,覆盖店铺/订单/面单/入库) - test: LingxingLiveSmokeTest 凭据改为 -Dlingxing.probe.* 系统属性,不再写死类内常量与 sid - test: 新增 MultiPlatformOrderSourceTest、AmazonFbmOrderSourceTest,AwdCargoSourceTest 增加真实报文用例 - test: 新增 AWD 真实报文夹具 awdShipment/real-2026-11-06.json 验证:mvn -pl lingxing -am test(109 用例,0 失败,probe 默认跳过); 真实环境探针已跑通店铺/订单/面单/入库,AWD 与多平台订单报错均已消除。 --- .../ecommerce/lingxing/LingxingConstants.java | 6 + .../lingxing/platform/amazon/dto/FbmOrderDto.java | 21 + .../amazon/order/AmazonFbmOrderSource.java | 36 +- .../lingxing/platform/inbound/AwdCargoSource.java | 12 +- .../lingxing/platform/inbound/InboundSupport.java | 31 + .../platform/inbound/dto/AwdShipmentDto.java | 10 +- .../order/MultiPlatformOrderSource.java | 10 +- .../lingxing/adapter/LingxingLiveSmokeTest.java | 616 +++++++++--------- .../amazon/order/AmazonFbmOrderSourceTest.java | 107 +++ .../platform/inbound/AwdCargoSourceTest.java | 39 ++ .../order/MultiPlatformOrderSourceTest.java | 79 +++ .../lingxing/probe/FulfillmentProbeTest.java | 715 +++++++++++++++++++++ .../inbound/awdShipment/real-2026-11-06.json | 75 +++ 13 files changed, 1439 insertions(+), 318 deletions(-) create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSourceTest.java create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSourceTest.java create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/probe/FulfillmentProbeTest.java create mode 100644 lingxing/src/test/resources/fixtures/lingxing/inbound/awdShipment/real-2026-11-06.json diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java index 5c3420f..3de0143 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java @@ -41,6 +41,12 @@ public final class LingxingConstants { /** 多平台分页 length 上限(领星统一订单接口的限制)。 */ public static final int MAX_PAGE_SIZE = 500; + /** + * 多平台分页 length 下限:小于 20 领星直接返回 {@code code=102 length最小值为20}。 + * + *

2026-11 真机验证:{@code pageSize=5} 会被拒绝,适配器统一向上取到 20。

+ */ + public static final int MIN_PAGE_SIZE = 20; /** 亚马逊订单分页 length 上限。 */ public static final int AMAZON_MAX_PAGE_SIZE = 5000; /** 亚马逊 FBM 订单分页 length:文档默认 100,未给上限,按默认值取。 */ diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/FbmOrderDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/FbmOrderDto.java index 80aee1b..1002de9 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/FbmOrderDto.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/FbmOrderDto.java @@ -5,6 +5,9 @@ import com.fasterxml.jackson.annotation.JsonProperty; import lombok.Getter; import lombok.Setter; +import java.util.ArrayList; +import java.util.List; + /** * 领星 · 亚马逊 FBM 订单列表条目 * ({@code /erp/sc/routing/order/Order/getOrderList} 的 {@code data[]})。 @@ -34,6 +37,24 @@ public class FbmOrderDto { @JsonProperty("country_code") private String countryCode; + /** + * 订单金额。列表接口不会返回(2026-11 真实报文没有该字段), + * 这里保留字段只为兼容「列表与详情共用一个 DTO 解析」的场景,正常情况下为 null。 + */ + @JsonProperty("order_price_amount") + private String orderPriceAmount; + + /** + * 商品行。列表接口不会返回(2026-11 真实报文没有 {@code order_item}), + * 商品明细必须再调 {@code getOrderDetail}。 + */ + @JsonProperty("order_item") + private List orderItem = new ArrayList(); + + /** 平台订单号列表(元素类型不稳定,这里保留原样不解析)。 */ + @JsonProperty("platform_list") + private List platformList; + /** 订购时间。 */ @JsonProperty("purchase_time") private String purchaseTime; diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSource.java index 280b4ee..4aa12e8 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSource.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSource.java @@ -143,11 +143,40 @@ public final class AmazonFbmOrderSource implements LingxingOrderSource { // ---------------------------------------------------------------- mapping - /** 列表条目:没有商品行与金额,商品明细要再调详情。 */ + /** + * 列表条目。 + * + *

2026-11 真实报文确认 {@code getOrderList} 只返回头部字段(单号 / 状态 / 目的国 / + * 时间 / 物流 / 仓库),不含订单金额与 {@code order_item}; + * 金额与商品行必须再调 {@code getOrderDetail}。 + * 这里仍按「有就映射」处理,字段缺失时保持空值,不抛异常。

+ */ private SalesOrder toSalesOrder(FbmOrderDto dto, ChannelAccount account, ZoneId zone) { String orderNumber = requireOrderNumber(dto.getOrderNumber()); Instant occur = systemTime(dto.getPurchaseTime()); + List items = safe(dto.getOrderItem()); + List lines = new ArrayList(items.size()); + String firstCurrency = null; + for (int i = 0; i < items.size(); i++) { + FbmOrderItemDto item = items.get(i); + String currency = trimToNull(item.getCurrencyCode()); + if (firstCurrency == null) { + firstCurrency = currency; + } + String sku = firstNonBlank(item.getMsku(), item.getSku(), item.getPlatformOrderId()); + lines.add(OrderLine.builder() + .lineId(firstNonBlank(item.getOrderItemNo(), item.getPlatformOrderId(), + item.getSku(), "line-" + i)) + .platformSku(sku == null ? "" : sku) + .quantity(item.getQuality() == null ? 0 : item.getQuality()) + .unitPrice(moneyOrNull(item.getItemUnitPrice(), currency)) + .build()); + } + + // 订单金额没有独立币种:商品行币种优先,其次账户币种 + String totalCurrency = firstNonBlank(firstCurrency, account.currency()); + return SalesOrder.builder() .omsStoreId(account.omsStoreId()) .channelOrderId(orderNumber) @@ -155,9 +184,8 @@ public final class AmazonFbmOrderSource implements LingxingOrderSource { // FBM 列表不返回买家姓名;国家有 .buyerName(null) .shipToCountryCode(trimToNull(dto.getCountryCode())) - .lines(Collections.emptyList()) - // 列表接口不返回订单金额 - .totalAmount(null) + .lines(lines) + .totalAmount(moneyOrNull(dto.getOrderPriceAmount(), totalCurrency)) .occurredAt(requireOccurredAt(occur, orderNumber, zone)) .sourceProvider(ChannelProvider.LINGXING) .sourceAccountId(null) diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/AwdCargoSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/AwdCargoSource.java index f6f33ea..dad516f 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/AwdCargoSource.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/AwdCargoSource.java @@ -118,11 +118,14 @@ public final class AwdCargoSource implements LingxingInboundShipmentSource { private static InboundShipment toShipment(AwdShipmentDto dto, LingxingCall call, ZoneId zone) { String storeId = dto.getSid() == null ? null : String.valueOf(dto.getSid()); String orderId = InboundSupport.trimToNull(dto.getOrderId()); + // 真实报文里 shipmentId(入库货件号)与 orderId(AWD 货件单号)是两个字段; + // 老报文 / 夹具只有 orderId 时回落,保持向后兼容。 + String shipmentId = InboundSupport.trimToNull(dto.getShipmentId()); return InboundShipment.builder() .omsStoreId(call.ctx().omsStoreId()) .sourceProvider(ChannelProvider.LINGXING) .sourceAccountId(storeId) - .shipmentId(orderId) + .shipmentId(shipmentId != null ? shipmentId : orderId) .shipmentNo(orderId) .stockOrderNo(InboundSupport.trimToNull(dto.getStockOrderId())) .warehouseReferenceId(InboundSupport.trimToNull(dto.getWarehouseReferenceId())) @@ -200,8 +203,13 @@ public final class AwdCargoSource implements LingxingInboundShipmentSource { address.getPostalCode(), address.getCountryCode()); } + /** + * AWD 时间字段:文档写 ISO instant,真实报文是 {@code yyyy-MM-dd HH:mm:ss}(无时区,按北京时间)。 + * + * @see InboundSupport#parseFlexible(String, String) + */ private static PlatformTime platformTime(String value, ZoneId zone) { - Instant instant = InboundSupport.parseIso(value); + Instant instant = InboundSupport.parseFlexible(value, OP); return instant == null ? null : PlatformTime.of(instant, zone); } } diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/InboundSupport.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/InboundSupport.java index a993a1e..1b2e15d 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/InboundSupport.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/InboundSupport.java @@ -75,6 +75,37 @@ final class InboundSupport { return Instant.parse(text); } + /** + * 「ISO 优先、北京时间文本兜底」的宽松解析。 + * + *

AWD 文档写的是 ISO instant,但 2026-11 真实报文返回的是 + * {@code 2026-11-02 15:06:49} 这种没有时区后缀的文本({@code gmtCreate} / + * {@code gmtModified} / {@code shipBy}),严格按 ISO 解析会让整页货件映射失败。 + * 无时区文本按北京时间解释,与 FBT / WFS 的口径一致。

+ * + * @param operation 解析失败时的异常文案,可为 null(失败时退回严格解析的行为) + */ + static Instant parseFlexible(String value, String operation) { + String text = trimToNull(value); + if (text == null) { + return null; + } + try { + return parseIso(text); + } catch (RuntimeException ignored) { + // 继续尝试北京时间文本 + } + try { + return parseBeijingDateTime(text); + } catch (RuntimeException e) { + if (operation == null) { + throw e; + } + throw new IllegalArgumentException( + "unparseable inbound time " + text + " on " + operation, e); + } + } + /** 店铺 id 列表:调用方没传时用当前账户的店铺,避免跨店铺查询。 */ static List resolveStoreIds(LingxingCall call, InboundShipmentQuery query, String op) { if (!query.storeIds().isEmpty()) { diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/dto/AwdShipmentDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/dto/AwdShipmentDto.java index c59a539..fe1b9c9 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/dto/AwdShipmentDto.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/dto/AwdShipmentDto.java @@ -17,10 +17,18 @@ import java.util.List; @JsonIgnoreProperties(ignoreUnknown = true) public class AwdShipmentDto { - /** AWD 货件单号。 */ + /** AWD 货件单号(如 {@code STAR-W74AHX5UQHY3E})。 */ @JsonProperty("orderId") private String orderId; + /** + * 入库货件号(如 {@code STAR-RVKFDYRYN6DZC}),与 {@link #orderId} 是两个不同的字段。 + * + *

2026-11 真实报文确认存在;接口的货件号过滤参数 {@code shipmentId} 对应的就是它。

+ */ + @JsonProperty("shipmentId") + private String shipmentId; + /** 备货单号。 */ @JsonProperty("stockOrderId") private String stockOrderId; diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSource.java index a441a3e..e82ad0b 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSource.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSource.java @@ -39,7 +39,8 @@ import java.util.Map; * * * - * + * * @@ -113,8 +114,11 @@ public class MultiPlatformOrderSource implements LingxingOrderSource { from = to.minus(Duration.ofDays(LingxingConstants.MAX_QUERY_DAYS)); } - // 领星 length 上限 500;pageSize 未设置时给 100,与 SalesOrderQuery 的默认值一致 - int length = Math.min(query.pageSize() <= 0 ? 100 : query.pageSize(), LingxingConstants.MAX_PAGE_SIZE); + // 领星 length 上限 500、下限 20(传小于 20 会返回 code=102 length最小值为20); + // pageSize 未设置时给 100,与 SalesOrderQuery 的默认值一致 + int requested = query.pageSize() <= 0 ? 100 : query.pageSize(); + int length = Math.max(LingxingConstants.MIN_PAGE_SIZE, + Math.min(requested, LingxingConstants.MAX_PAGE_SIZE)); // 游标就是字符串化的 offset:领星只有 offset 分页,没有不透明游标 int offset = query.cursor() == null ? 0 : Integer.parseInt(query.cursor()); diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingLiveSmokeTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingLiveSmokeTest.java index 869af89..965e6d6 100644 --- a/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingLiveSmokeTest.java +++ b/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingLiveSmokeTest.java @@ -6,93 +6,102 @@ import common.ecommerce.http.HttpResponse; import common.ecommerce.http.HttpTransport; import common.ecommerce.http.JacksonJsonCodec; import common.ecommerce.http.OkHttpTransport; +import common.ecommerce.lingxing.LingxingApi; import common.ecommerce.lingxing.LingxingConstants; import common.ecommerce.lingxing.auth.LingxingTokenClient; +import common.ecommerce.lingxing.http.LingxingEnvelope; +import common.ecommerce.lingxing.http.LingxingRateLimiter; +import common.ecommerce.lingxing.http.LingxingRequestFactory; +import common.ecommerce.lingxing.platform.LingxingCall; +import common.ecommerce.lingxing.platform.multiplatform.order.LingxingOrderFilters; import common.ecommerce.model.ChannelProvider; -import common.ecommerce.model.Capability; import common.ecommerce.model.Platform; import common.ecommerce.model.account.AccountKey; import common.ecommerce.model.account.ChannelAccount; -import common.ecommerce.model.fulfillment.LabelQuery; -import common.ecommerce.model.fulfillment.OutboundOrder; -import common.ecommerce.model.fulfillment.OutboundOrderLine; -import common.ecommerce.model.fulfillment.OutboundOrderQuery; -import common.ecommerce.model.fulfillment.ShippingLabel; -import common.ecommerce.model.inbound.InboundReceipt; -import common.ecommerce.model.inbound.InboundReceiptQuery; -import common.ecommerce.model.inbound.InboundShipment; -import common.ecommerce.model.inbound.InboundShipmentQuery; import common.ecommerce.model.order.OrderLine; import common.ecommerce.model.order.SalesOrder; import common.ecommerce.model.order.SalesOrderQuery; import common.ecommerce.model.order.SalesOrderRef; -import common.ecommerce.model.product.ProductListing; -import common.ecommerce.model.product.ProductQuery; import common.ecommerce.model.settlement.SettlementQuery; import common.ecommerce.model.settlement.SettlementTransaction; import common.ecommerce.model.support.Page; -import common.ecommerce.model.support.PlatformTime; import common.ecommerce.sdk.ChannelConnection; import common.ecommerce.sdk.ChannelContext; import common.ecommerce.spi.AccessToken; import common.ecommerce.spi.ChannelSecret; import common.ecommerce.testkit.InMemoryLockProvider; import common.ecommerce.testkit.InMemoryTokenStore; +import org.junit.jupiter.api.Assumptions; import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfSystemProperty; import java.time.Clock; import java.time.Duration; import java.time.Instant; import java.time.LocalDate; import java.util.ArrayList; +import java.util.Collections; +import java.util.LinkedHashMap; import java.util.List; +import java.util.Map; +import java.util.TreeMap; import static org.junit.jupiter.api.Assertions.assertFalse; import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; /** - * 领星真实环境冒烟测试。 + * 领星真实环境冒烟测试:逐个只读查询接口打一页,打印请求与解析结果,人工核对字段映射。 + * + *

覆盖范围:认证 / 店铺 / 订单(多平台、亚马逊 SC、FBM、VC)/ 结算。 + * 面单与入库见 {@code FulfillmentProbeTest},商品 / 售后见 {@code probe} 包下各自的探针与契约测试。

+ * + *

默认跳过,用 {@code -Dlingxing.probe=true} 显式开启;凭据走系统属性, + * 与 {@code probe} 包下的探针一致,真实凭证不入库:

* - *

填上 APP_KEY / APP_SECRET 即可跑(STORE_ID 可留空),然后 IDE 里右键 Run 或执行:

*
- * mvn -pl lingxing -am test -Dtest=LingxingLiveSmokeTest
+ * mvn -pl lingxing -am -DfailIfNoTests=false \
+ *     -Dlingxing.probe=true \
+ *     -Dlingxing.probe.appKey=你的appId -Dlingxing.probe.appSecret=你的appSecret \
+ *     -Dtest=LingxingLiveSmokeTest test
  * 
* + *

可选系统属性(不填则走自动发现或跳过对应段落):

+ *
    + *
  • {@code -Dlingxing.probe.platformCode=10008}:多平台店铺 / 订单用哪个平台, + * 不填不带 {@code platform_code} 过滤,返回账号下全部店铺;
  • + *
  • {@code -Dlingxing.probe.storeId=...}:指定某一家店(store_id / sid),覆盖自动发现的店铺;
  • + *
  • {@code -Dlingxing.probe.vcStoreId=...}:亚马逊 VC 店铺,不填自动发现。
  • + *
+ * *

调用前确认出口 IP 已加入领星白名单,否则会直接 401/403。

* - *

本类只用于联调,不要把真实凭证提交到仓库。

+ *

只做查询,不调用任何写接口。整轮冒烟共用一个 token(同一个 app 下多店铺共用), + * 不要给每个测试单独换 token,否则会频繁触发领星限流。

*/ +@EnabledIfSystemProperty(named = "lingxing.probe", matches = "true") class LingxingLiveSmokeTest { - // ==================== 填写这里 ==================== - /** 领星 ERP 开放接口的 AppID。 */ - private static final String APP_KEY = "在这里填 AppID"; - /** 领星 ERP 开放接口的 AppSecret。 */ - private static final String APP_SECRET = "在这里填 AppSecret"; - /** 领星后台的 store_id。 */ - private static final String STORE_ID = "在这里填 store_id"; - // ================================================ + // ==================== 系统属性(不读环境变量,凭证不入库) ==================== + private static final String APP_KEY = System.getProperty("lingxing.probe.appKey", ""); + private static final String APP_SECRET = System.getProperty("lingxing.probe.appSecret", ""); - /** - * 领星平台码:10008 = Walmart;TikTok 10011、eBay 10003、Amazon SC 10001,按需改。 - * - *

Target / BestBuy / AEPH / Michaels / ECHO / LOS-DLI-US 等平台在领星侧 - * 没有独立平台码。这类平台把本常量置为 {@code null} 或 {@code 0} 即可: - * 请求体不带 {@code platform_code},店铺与订单都只按 {@code store_id} 过滤, - * 业务平台由 {@link #smokePlatform()} 兜底成 {@link Platform#CUSTOM}。

- */ - private static final Integer PLATFORM_CODE = 0; - private static final String BASE_URL = LingxingConstants.PRODUCTION_BASE_URL; + /** 多平台用的领星 platform_code;空 / 0 表示不带过滤,返回账号下全部店铺。 */ + private static final Integer PLATFORM_CODE = optInt("lingxing.probe.platformCode"); - /** - * 面单冒烟只取前几单,避免把大段 base64 刷到控制台。 - */ - private static final int LABEL_SMOKE_LIMIT = 5; + /** 指定某一家店(store_id / sid);空表示按店铺列表自动发现。 */ + private static final String STORE_ID = opt("lingxing.probe.storeId"); + /** 亚马逊 VC 的 vc_store_id;空表示自动发现。 */ + private static final String VC_STORE_ID = opt("lingxing.probe.vcStoreId"); + // ========================================================================= + + private static final String BASE_URL = LingxingConstants.PRODUCTION_BASE_URL; private final JacksonJsonCodec json = new JacksonJsonCodec(); private final LoggingTransport transport = new LoggingTransport(new OkHttpTransport("common-ecommerce-smoke")); private final InMemoryTokenStore tokenStore = new InMemoryTokenStore(); private final InMemoryLockProvider locks = new InMemoryLockProvider(); + private final LingxingAdapter adapter = new LingxingAdapter(transport, json, tokenStore, locks, Clock.systemUTC()); /** * 第 1 步:只验证认证。失败说明 AppID/AppSecret 不对,或 IP 不在白名单。 @@ -106,8 +115,10 @@ class LingxingLiveSmokeTest { assertNotNull(token.value()); } + // ================================================================ 店铺 + /** - * 第 2 步(多平台):先按 {@code PLATFORM_CODE} 列一次店铺,再拉一页订单, + * 第 2 步(店铺):先按 {@code PLATFORM_CODE} 列一次店铺,再拉一页订单, * 打印请求与解析结果,人工核对字段映射。 * *

订单接口按店铺 id 过滤,而各子平台的 id 口径不同(亚马逊 SC 是数字 {@code sid}, @@ -115,16 +126,15 @@ class LingxingLiveSmokeTest { * {@code STORE_ID} 填了则优先用它,仅作为「指定某一家店」的覆盖手段。

* *

没有平台码的平台(Target / BestBuy / AEPH / Michaels / ECHO / - * LOS-DLI-US 等):把 {@link #PLATFORM_CODE} 置为 {@code null} 或 {@code 0}。 + * LOS-DLI-US 等):不传 {@code -Dlingxing.probe.platformCode} 即可。 * 此时店铺列表不带 {@code platform_code} 过滤,会返回该领星账号下所有平台的店铺, * 每行都打印了真实的 {@code platform_code};订单查询只发 {@code store_id}, * 照样能拉到数据。想固定到某一家店时,从打印结果里挑一个 {@code store_id} - * 填到 {@link #STORE_ID} 即可。

+ * 填到 {@code -Dlingxing.probe.storeId} 即可。

*/ @Test void pullsOnePageOfOrders() { requireCredentials(); - LingxingAdapter adapter = adapter(); List shops = listShops(adapter); String storeId = resolveStoreId(shops); if (storeId == null) { @@ -151,22 +161,91 @@ class LingxingLiveSmokeTest { + " total=" + o.totalAmount() + " country=" + o.shipToCountryCode() + " lines=" + o.lines().size() - + " utc=" + o.occurredAt().utc()); + + " utc=" + (o.occurredAt() == null ? null : o.occurredAt().utc())); } assertFalse(page.size() > 20, "pageSize 未被平台遵守"); } /** - * 第 3 步(亚马逊 SC):先列店铺拿 sid,再拉订单列表,最后取一单详情核对金额。 + * 第 2 步补充(店铺):多平台店铺列表在没有任何过滤时到底返回什么。 + * + *

{@link LingxingAdapter#listSubChannels} 内部按上游店铺接口的协议写死了 + * {@code is_sync=1} + {@code status=1}(暂停同步 / 授权异常 / 删除的店看不到), + * 适配器没有对应的查询入口。这里用 {@link LingxingCall} 直接打同一个接口, + * 不过滤这三项,把未启用的店也打出来,用来判断「订单 / 入库里少的店铺」是不是被过滤掉了。

+ */ + @Test + void listsShopsIncludingDisabledOnes() { + requireCredentials(); + LingxingCall call = call(null); + + Map body = new LinkedHashMap(); + body.put("offset", 0); + body.put("length", LingxingConstants.MULTI_PLATFORM_MAX_PAGE_SIZE); + if (hasPlatformCode()) { + body.put("platform_code", Collections.singletonList(PLATFORM_CODE)); + } + + HttpRequest req = call.signed(LingxingApi.SHOP_LIST_MULTI_PLATFORM, body, "smoke.shops.all"); + HttpResponse resp = call.execute(req); + LingxingEnvelope env = call.envelope(resp, "smoke.shops.all"); + List> shops = toRows(json.listAt(env.body(), "data.list", LinkedHashMap.class)); + + System.out.println("[shops all] platform_code=" + platformCodeLabel() + + " 本地过滤=无(含暂停同步 / 授权异常)" + + " page=" + shops.size() + " total=" + env.total()); + + Map>> byCode = new TreeMap>>(); + for (Map shop : shops) { + String code = String.valueOf(shop.get("platform_code")); + List> group = byCode.get(code); + if (group == null) { + group = new ArrayList>(); + byCode.put(code, group); + } + group.add(shop); + } + System.out.println("[shops all] 按 platform_code 分组(每组代表一种子平台)"); + for (Map.Entry>> e : byCode.entrySet()) { + Platform mapped = LingxingConstants.toPlatform(toInt(e.getKey())); + System.out.println(" code=" + e.getKey() + + " → " + (mapped == null ? "未登记" : mapped.name()) + + " 共 " + e.getValue().size() + " 家"); + for (Map shop : e.getValue()) { + System.out.println(" store_id=" + shop.get("store_id") + + " is_sync=" + shop.get("is_sync") + + " status=" + shop.get("status") + + " name=" + shop.get("store_name") + + " platform_name=" + shop.get("platform_name")); + } + } + + // 适配器的子渠道列表(启用 + 正常授权)与这里的差集,就是被 is_sync/status 过滤掉的店铺 + List visible = adapter.listSubChannels(context(account("0"), "smoke-shops-visible-")); + List hidden = new ArrayList(); + for (Map shop : shops) { + String storeId = shop.get("store_id") == null ? null : String.valueOf(shop.get("store_id")); + if (storeId == null || !containsStore(visible, storeId)) { + hidden.add(storeId + "(" + shop.get("store_name") + ")"); + } + } + System.out.println("[shops all] 适配器可见=" + visible.size() + + ",被 is_sync/status 过滤掉=" + hidden.size() + " " + hidden); + assertFalse(shops.isEmpty(), "店铺列表接口返回 0 条,检查 appKey / 白名单 / platform_code 是否抄错"); + assertFalse(visible.size() > shops.size(), "不过滤的店铺列表不该比适配器可见的少"); + } + + // ================================================================ 订单 + + /** + * 第 4 步(亚马逊 SC):先列店铺拿 sid,再拉订单列表,最后取一单详情核对金额。 * *

不依赖 STORE_ID:sid 来自 {@code /erp/sc/data/seller/lists}。

*/ @Test void listsAmazonShopsAndPullsOrders() { requireCredentials(); - LingxingAdapter adapter = adapter(); - - String sid = firstAmazonShopSid(adapter); + String sid = firstAmazonShopSid(); if (sid == null) { return; } @@ -188,7 +267,7 @@ class LingxingLiveSmokeTest { + " status=" + o.status() + " total=" + o.totalAmount() + " lines=" + o.lines().size() - + " utc=" + o.occurredAt().utc()); + + " utc=" + (o.occurredAt() == null ? null : o.occurredAt().utc())); } if (page.items().isEmpty()) { @@ -200,7 +279,7 @@ class LingxingLiveSmokeTest { SalesOrder detail = adapter.get(ctx, SalesOrderRef.of(first.channelOrderId())); System.out.println("[amazon detail] " + detail.channelOrderId() + " total=" + detail.totalAmount() + " lines=" + detail.lines().size()); - for (common.ecommerce.model.order.OrderLine line : detail.lines()) { + for (OrderLine line : detail.lines()) { System.out.println(" sku=" + line.platformSku() + " qty=" + line.quantity() + " unit=" + line.unitPrice() @@ -210,16 +289,14 @@ class LingxingLiveSmokeTest { } /** - * 第 3 步补充(亚马逊 FBM):拉一页「订单管理」视角的自发货订单,再取一单详情。 + * 第 4 步补充(亚马逊 FBM):拉一页「订单管理」视角的自发货订单,再取一单详情。 * *

这条路由的主键是领星系统单号 {@code order_number},不是平台订单号。

*/ @Test void pullsAmazonFbmOrders() { requireCredentials(); - LingxingAdapter adapter = adapter(); - - String sid = firstAmazonShopSid(adapter); + String sid = firstAmazonShopSid(); if (sid == null) { return; } @@ -240,7 +317,7 @@ class LingxingLiveSmokeTest { System.out.println(" order_number=" + o.channelOrderId() + " status=" + o.status() + " country=" + o.shipToCountryCode() - + " utc=" + o.occurredAt().utc()); + + " utc=" + (o.occurredAt() == null ? null : o.occurredAt().utc())); } if (page.items().isEmpty()) { @@ -254,7 +331,7 @@ class LingxingLiveSmokeTest { + " status=" + detail.status() + " total=" + detail.totalAmount() + " lines=" + detail.lines().size()); - for (common.ecommerce.model.order.OrderLine line : detail.lines()) { + for (OrderLine line : detail.lines()) { System.out.println(" sku=" + line.platformSku() + " qty=" + line.quantity() + " unit=" + line.unitPrice()); @@ -262,51 +339,6 @@ class LingxingLiveSmokeTest { } /** - * 第 4 步(多平台):列 Walmart 店铺,再拉一页 Walmart 在线商品。 - * - *

店铺来自 {@code /pb/mp/shop/v2/getSellerList},商品来自 - * {@code /basicOpen/multiplatform/walmart/list}。

- */ - @Test - void listsWalmartShopsAndProducts() { - requireCredentials(); - LingxingAdapter adapter = adapter(); - - ChannelAccount discovery = walmartAccount("0"); - List shops = adapter.listSubChannels(context(discovery, "smoke-walmart-shops-")); - System.out.println("[walmart shops] count=" + shops.size()); - for (SubChannel shop : shops) { - System.out.println(" store_id=" + shop.externalStoreId() - + " name=" + shop.name() - + " platform=" + shop.platform()); - } - if (shops.isEmpty()) { - System.out.println("[walmart shops] 没有已授权店铺,跳过商品拉取"); - return; - } - - ChannelContext ctx = context(walmartAccount(shops.get(0).externalStoreId()), - "smoke-walmart-products-"); - Instant to = Instant.now(); - Instant from = to.minus(Duration.ofDays(7)); - Page page = adapter.pull(ctx, ProductQuery.builder() - .updatedAfter(from) - .updatedBefore(to) - .pageSize(20) - .build()); - - System.out.println("[walmart products] store_id=" + ctx.account().externalStoreId() - + " window=" + from + " .. " + to - + " items=" + page.size() + " nextCursor=" + page.nextCursor()); - for (ProductListing p : page.items()) { - System.out.println(" msku=" + p.platformSku() - + " status=" + p.status() - + " title=" + p.title() - + " images=" + p.imageUrls().size()); - } - } - - /** * 第 5 步(亚马逊 VC):先列 VC 店铺拿 vc_store_id,再拉订单列表,最后取一单详情。 * *

VC 详情分 DF / PO 两个接口,{@code get()} 会先按订单编号查出类型再分派。

@@ -314,9 +346,7 @@ class LingxingLiveSmokeTest { @Test void listsAmazonVcShopsAndPullsOrders() { requireCredentials(); - LingxingAdapter adapter = adapter(); - - String vcStoreId = firstVcShopId(adapter); + String vcStoreId = firstVcShopId(); if (vcStoreId == null) { return; } @@ -338,7 +368,7 @@ class LingxingLiveSmokeTest { + " status=" + o.status() + " total=" + o.totalAmount() + " lines=" + o.lines().size() - + " utc=" + o.occurredAt().utc()); + + " utc=" + (o.occurredAt() == null ? null : o.occurredAt().utc())); } if (page.items().isEmpty()) { @@ -361,249 +391,163 @@ class LingxingLiveSmokeTest { } /** - * 第 6 步(结算):拉一页亚马逊结算交易明细。 + * 第 5 步补充(订单 · 时间口径):默认时间窗按「更新时间」过滤, + * 这对增量同步是对的,但按「下单时间」回补历史订单时会一条都查不到。 + * 这里对同一店铺、同一段订购时间分别用两种口径各拉一页,对比条数。 + * + *

只有多平台订单接口({@code /pb/mp/order/v2/list})支持 {@code date_type}, + * 亚马逊 SC / VC 走各自接口,会忽略该条件。门面不暴露这个参数,直接用适配器。

*/ @Test - void pullsAmazonSettlements() { + void ordersByPurchaseTimeWindow() { requireCredentials(); - LingxingAdapter adapter = adapter(); - - String sid = firstAmazonShopSid(adapter); - if (sid == null) { + List shops = listShops(adapter); + String storeId = resolveStoreId(shops); + if (storeId == null) { return; } - ChannelContext ctx = context(amazonAccount(sid), "smoke-settlement-"); - LocalDate today = LocalDate.now(); - Page page = adapter.pull(ctx, SettlementQuery.builder() - // 文档:结算时间双闭区间,最长 7 天 - .settledAfter(today.minusDays(6)) - .settledBefore(today) + ChannelContext ctx = context(account(storeId), "smoke-orders-purchase-"); + Instant to = Instant.now(); + Instant from = to.minus(Duration.ofDays(2)); + SalesOrderQuery query = SalesOrderQuery.builder() + .updatedAfter(from) + .updatedBefore(to) .pageSize(20) + .build(); + + Page byUpdate = adapter.pull(ctx, query, LingxingOrderFilters.none()); + Page byPurchase = adapter.pull(ctx, query, LingxingOrderFilters.builder() + .dateType(LingxingOrderFilters.DATE_TYPE_PURCHASE_TIME) .build()); - System.out.println("[settlements] sid=" + sid - + " window=" + today.minusDays(6) + " .. " + today - + " items=" + page.size() + " nextCursor=" + page.nextCursor()); - for (SettlementTransaction t : page.items()) { - System.out.println(" key=" + t.transactionKey() - + " order=" + t.channelOrderId() - + " event=" + t.eventType() - + " type=" + t.transactionType() - + " amount=" + t.amount() - + " status=" + t.processingStatus() - + " postedAt=" + t.postedAt()); + System.out.println("[orders date_type] store_id=" + storeId + + " window=" + from + " .. " + to + + " update_time=" + byUpdate.size() + + " purchase_time=" + byPurchase.size()); + for (SalesOrder o : byPurchase.items()) { + System.out.println(" purchase " + o.channelOrderId() + + " status=" + o.status() + + " utc=" + (o.occurredAt() == null ? null : o.occurredAt().utc())); } - } - - /** - * 第 7 步(仓库):拉一页销售出库单,打印单据与商品行,人工核对字段映射。 - * - *

{@code /erp/sc/routing/wms/order/wmsOrderList} 按店铺数字 sid 过滤, - * 所以用亚马逊店铺列表返回的 {@code sid},而不是多平台的 {@code store_id} - * (后者不是数字,适配器会直接拒绝,避免跨店铺返回数据)。

- */ - @Test - void pullsOutboundOrders() { - requireCredentials(); - LingxingAdapter adapter = adapter(); - -// String sid = firstAmazonShopSid(adapter); -// if (sid == null) { -// System.out.println("[outbound orders] 没有亚马逊店铺(WMS 需要数字 sid),跳过"); -// return; -// } - String sid = "15898"; - - ChannelContext ctx = context(amazonAccount(sid), "smoke-outbound-orders-"); - Page page = pullOneOutboundPage(adapter, ctx); - - System.out.println("[outbound orders] sid=" + sid - + " window=最近 30 天 items=" + page.size() - + " nextCursor=" + page.nextCursor()); - for (OutboundOrder o : page.items()) { - System.out.println(" wo_number=" + o.woNumber() - + " order_number=" + o.orderNumber() - + " status=" + o.status() + "/" + o.statusName() - + " logistics=" + o.logisticsStatus() + "/" + o.logisticsStatusName() - + " warehouse=" + o.warehouseId() + "/" + o.warehouseName() - + " waybillNO=" + o.waybillNo() - + " amount=" + o.orderAmount() - + " lines=" + o.lines().size() - + " createdAt=" + (o.createdAt() == null ? null : o.createdAt().utc()) - + " surface=" + o.surfaceFileUrl()); - for (OutboundOrderLine line : o.lines()) { - System.out.println(" sku=" + line.sku() - + " msku=" + line.sellerSku() - + " qty=" + line.quantity() - + " unit=" + line.unitPrice()); - } + if (byUpdate.size() != byPurchase.size()) { + System.out.println("[orders date_type] 两种口径条数不同,说明 date_type 已生效;" + + "按订购时间回补历史订单时必须显式传 date_type"); } - assertFalse(page.size() > 20, "pageSize 未被平台遵守"); + assertFalse(byPurchase.size() > 20, "pageSize 未被平台遵守"); } /** - * 第 8 步(面单):用上一步的出库单号取面单,再按系统单号查一次。 + * 第 5 步补充(订单 · 回查):拿订单列表里的平台单号回查一次。 * - *

{@code wo_number_arr} 与 {@code order_number_arr} 二选一,两条路径都跑, - * 确认字段名与 base64 返回。文档提示面单可能尚未生成,此时 {@code file_b64} 为空串。

- */ - @Test - void pullsShippingLabels() { - requireCredentials(); - LingxingAdapter adapter = adapter(); - -// String sid = firstAmazonShopSid(adapter); -// if (sid == null) { -// System.out.println("[labels] 没有亚马逊店铺(WMS 需要数字 sid),跳过"); -// return; -// } - - String sid = "15898"; - ChannelContext ctx = context(amazonAccount(sid), "smoke-labels-"); - Page page = pullOneOutboundPage(adapter, ctx); - if (page.items().isEmpty()) { - System.out.println("[labels] 最近 30 天没有出库单,跳过"); - return; - } - - List woNumbers = new ArrayList<>(); - List orderNumbers = new ArrayList<>(); - for (OutboundOrder o : page.items()) { - if (woNumbers.size() >= LABEL_SMOKE_LIMIT) { - break; - } - woNumbers.add(o.woNumber()); - if (o.orderNumber() != null) { - orderNumbers.add(o.orderNumber()); - } - } - - printLabels("wo_number_arr", adapter.labels(ctx, - LabelQuery.builder().woNumbers(woNumbers).build())); - if (!orderNumbers.isEmpty()) { - printLabels("order_number_arr", adapter.labels(ctx, - LabelQuery.builder().orderNumbers(orderNumbers).build())); - } - } - - /** - * 第 9 步(入库):按当前店铺所属子平台拉一页入库货件;亚马逊 SC 再拉一页 FBA 接收明细。 + *

契约上「按平台单号查询时领星允许不传时间窗」,这里验证的是实现没有偷偷塞默认时间窗 + * 把老订单过滤掉:用平台单号回查,命中数至少 1。

* - *

只读。FBT / WFS / AWD 的时间字段与日期口径不同,这里统一用最近 7 天先看字段映射; - * 各接口的时间窗上限与「待核对」参数由 {@code InboundProbeTest} 另行核对。

+ *

只对多平台接口有效;没有样本时提示跳过。

*/ @Test - void pullsInboundShipmentsAndReceipts() { + void ordersBackfilledByPlatformOrderNo() { requireCredentials(); - LingxingAdapter adapter = adapter(); - List shops = listShops(adapter); String storeId = resolveStoreId(shops); if (storeId == null) { return; } - ChannelAccount account = account(storeId); - ChannelContext ctx = context(account, "smoke-inbound-"); - if (!adapter.supports(account, Capability.INBOUND_SHIPMENT)) { - System.out.println("[inbound] " + account.key().platform() + " 未装配入库货件查询,跳过"); - return; - } - + ChannelContext ctx = context(account(storeId), "smoke-orders-backfill-"); Instant to = Instant.now(); - Instant from = to.minus(Duration.ofDays(7)); - Page page = adapter.pull(ctx, InboundShipmentQuery.builder() - .storeIds(storeId) - .after(from) - .before(to) - .pageSize(20) + Instant from = to.minus(Duration.ofDays(2)); + Page sample = adapter.pull(ctx, SalesOrderQuery.builder() + .updatedAfter(from) + .updatedBefore(to) + .pageSize(1) .build()); - - System.out.println("[inbound shipments] platform=" + account.key().platform() - + " store=" + storeId + " items=" + page.size() - + " nextCursor=" + page.nextCursor()); - for (InboundShipment s : page.items()) { - System.out.println(" shipmentNo=" + s.shipmentNo() - + " shipmentId=" + s.shipmentId() - + " inboundOrderNo=" + s.inboundOrderNo() - + " status=" + s.status() + "/" + s.statusName() - + " storeIds=" + s.storeIds() - + " warehouse=" + s.warehouseName() - + " createdAt=" + (s.createdAt() == null ? null : s.createdAt().utc()) - + " lines=" + s.lines().size() - + " shippingRefs=" + s.shippingRefs().size()); - } - - if (!adapter.supports(account, Capability.INBOUND_RECEIPT)) { + if (sample.items().isEmpty()) { + System.out.println("[orders backfill] 最近 2 天没有订单,跳过平台单号回查"); return; } - // FBA 到货接收明细按签收日期取数,日期用平台口径(北京时间)。 - LocalDate eventDate = LocalDate.now(PlatformTime.BEIJING_ZONE).minusDays(1); - Page receipts = adapter.pull(context(account, "smoke-inbound-receipts-"), - InboundReceiptQuery.builder() - .sid(storeId) - .eventDate(eventDate) + String platformOrderNo = sample.items().get(0).channelOrderId(); + Page hit = adapter.pull(ctx, SalesOrderQuery.builder() + .updatedAfter(from) + .updatedBefore(to) .pageSize(20) + .build(), + LingxingOrderFilters.builder() + .platformOrderNos(Collections.singletonList(platformOrderNo)) .build()); - System.out.println("[inbound receipts] sid=" + storeId + " eventDate=" + eventDate - + " items=" + receipts.size() + " nextCursor=" + receipts.nextCursor()); - for (InboundReceipt r : receipts.items()) { - System.out.println(" shipmentId=" + r.shipmentId() - + " fnsku=" + r.fnsku() - + " sku=" + r.sku() - + " qty=" + r.quantity() - + " fc=" + r.fulfillmentCenterId() - + " receivedAt=" + (r.receivedAt() == null ? null : r.receivedAt().utc()) - + " uniqueIndex=" + r.uniqueIndex()); + + System.out.println("[orders backfill] platform_order_no=" + platformOrderNo + + " → items=" + hit.size()); + for (SalesOrder o : hit.items()) { + System.out.println(" " + o.channelOrderId() + + " status=" + o.status() + + " utc=" + (o.occurredAt() == null ? null : o.occurredAt().utc())); } + assertTrue(hit.size() >= 1, "按平台单号回查没命中,检查 platform_order_no 参数名或时间窗"); } - // ---------------------------------------------------------------- helpers + // ================================================================ 结算 / 售后 /** - * 拉一页销售出库单(最近 30 天,按创建时间),两个仓储用例共用。 + * 第 6 步(结算):拉一页亚马逊结算交易明细。 */ - private static Page pullOneOutboundPage(LingxingAdapter adapter, ChannelContext ctx) { - Instant to = Instant.now(); - Instant from = to.minus(Duration.ofDays(30)); - return adapter.pull(ctx, OutboundOrderQuery.builder() - .after(from) - .before(to) - .timeType(OutboundOrderQuery.TIME_CREATED) + @Test + void pullsAmazonSettlements() { + requireCredentials(); + String sid = firstAmazonShopSid(); + if (sid == null) { + return; + } + + ChannelContext ctx = context(amazonAccount(sid), "smoke-settlement-"); + LocalDate today = LocalDate.now(); + Page page = adapter.pull(ctx, SettlementQuery.builder() + // 文档:结算时间双闭区间,最长 7 天 + .settledAfter(today.minusDays(6)) + .settledBefore(today) .pageSize(20) .build()); + + System.out.println("[settlements] sid=" + sid + + " window=" + today.minusDays(6) + " .. " + today + + " items=" + page.size() + " nextCursor=" + page.nextCursor()); + for (SettlementTransaction t : page.items()) { + System.out.println(" key=" + t.transactionKey() + + " order=" + t.channelOrderId() + + " event=" + t.eventType() + + " type=" + t.transactionType() + + " amount=" + t.amount() + + " status=" + t.processingStatus() + + " postedAt=" + t.postedAt()); + } } + // ---------------------------------------------------------------- helpers + /** - * 只打 base64 长度,避免把整张面单刷到控制台。 + * 一次性组装的 {@link LingxingCall}:用于适配器没有暴露入口的接口 + * (目前只有「含未启用店铺」的店铺列表)。 */ - private static void printLabels(String queryKey, List labels) { - System.out.println("[labels] " + queryKey + " count=" + labels.size()); - for (ShippingLabel label : labels) { - String base64 = label.contentBase64(); - System.out.println(" wo_number=" + label.woNumber() - + " order_number=" + label.orderNumber() - + " provider=" + label.logisticsProviderId() - + " typeId=" + label.logisticsTypeId() - + " fileType=" + label.fileType() - + " fileSize=" + label.fileSize() - + " b64=" + (base64 == null ? "null" : base64.length() + " chars")); - } + private LingxingCall call(ChannelAccount account) { + if (account == null) { + // 店铺列表接口不带平台维度,账户只作占位 + account = account(smokePlatform(), platformCodeOrNull(), "0"); + } + Clock clock = Clock.systemUTC(); + ChannelContext ctx = ChannelContext.of(account, connection(), "smoke-" + System.currentTimeMillis(), clock); + AccessToken token = new LingxingTokenClient(transport, json, clock) + .fetch(BASE_URL, APP_KEY, APP_SECRET); + return new LingxingCall(ctx, token, new LingxingRequestFactory(json, clock), + new LingxingRateLimiter(), json, transport); } /** * 认证只需要 AppID/AppSecret。 */ private static void requireCredentials() { - org.junit.jupiter.api.Assumptions.assumeTrue( - !APP_KEY.startsWith("在这里填") && !APP_SECRET.startsWith("在这里填"), - "请先填写 LingxingLiveSmokeTest 顶部的 APP_KEY / APP_SECRET"); - } - - private LingxingAdapter adapter() { - return new LingxingAdapter(transport, json, tokenStore, locks, Clock.systemUTC()); + Assumptions.assumeTrue(!APP_KEY.trim().isEmpty() && !APP_SECRET.trim().isEmpty(), + "未提供 -Dlingxing.probe.appKey / -Dlingxing.probe.appSecret,跳过冒烟"); } /** @@ -638,7 +582,7 @@ class LingxingLiveSmokeTest { *

返回 null 表示没有可用店铺,调用方打印跳过。

*/ private static String resolveStoreId(List shops) { - if (!STORE_ID.startsWith("在这里填")) { + if (STORE_ID != null) { if (!shops.isEmpty() && !containsStore(shops, STORE_ID)) { System.out.println("[shops] STORE_ID=" + STORE_ID + " 不在该平台店铺列表里," + "查不到数据时改用它;列表第一条是 " + shops.get(0).externalStoreId()); @@ -646,7 +590,7 @@ class LingxingLiveSmokeTest { return STORE_ID; } if (shops.isEmpty()) { - System.out.println("[orders] 没有已授权店铺,跳过(也可在 STORE_ID 里直接填 store_id)"); + System.out.println("[orders] 没有已授权店铺,跳过(也可用 -Dlingxing.probe.storeId 直接指定)"); return null; } String storeId = shops.get(0).externalStoreId(); @@ -669,7 +613,12 @@ class LingxingLiveSmokeTest { /** * 列出亚马逊店铺并返回第一家 sid;没有授权店铺时返回 null。 */ - private String firstAmazonShopSid(LingxingAdapter adapter) { + private String firstAmazonShopSid() { + List shops = amazonShops(); + return shops.isEmpty() ? null : shops.get(0).externalStoreId(); + } + + private List amazonShops() { ChannelAccount discovery = amazonAccount("0"); List shops = adapter.listSubChannels(context(discovery, "smoke-amazon-shops-")); System.out.println("[amazon shops] count=" + shops.size()); @@ -678,13 +627,13 @@ class LingxingLiveSmokeTest { + " name=" + shop.name() + " platform=" + shop.platform()); } - return shops.isEmpty() ? null : shops.get(0).externalStoreId(); + return shops; } /** * 列出亚马逊 VC 店铺并返回第一家 vc_store_id;没有授权店铺时返回 null。 */ - private String firstVcShopId(LingxingAdapter adapter) { + private String firstVcShopId() { ChannelAccount discovery = vcAccount("0"); List shops = adapter.listSubChannels(context(discovery, "smoke-vc-shops-")); System.out.println("[vc shops] count=" + shops.size()); @@ -702,9 +651,13 @@ class LingxingLiveSmokeTest { } /** - * 端点与凭据由调用方传入;冒烟测试里来自常量。 + * 端点与凭据由调用方传入;冒烟测试里来自系统属性。 */ private ChannelConnection connection() { + if (APP_KEY.trim().isEmpty() || APP_SECRET.trim().isEmpty()) { + throw new IllegalStateException( + "未提供 -Dlingxing.probe.appKey / -Dlingxing.probe.appSecret"); + } return ChannelConnection.of(BASE_URL, ChannelSecret.builder() .appKey(APP_KEY).appSecret(APP_SECRET).build()); } @@ -755,10 +708,6 @@ class LingxingLiveSmokeTest { return account(Platform.AMAZON_VC, LingxingConstants.PLATFORM_CODE_AMAZON_VC, vcStoreId); } - private ChannelAccount walmartAccount(String storeId) { - return account(Platform.WALMART_SC, 10008, storeId); - } - /** * @param platformCode 领星 platform_code;null 表示不带该过滤条件 */ @@ -773,6 +722,57 @@ class LingxingLiveSmokeTest { .build(); } + // ---------------------------------------------------------------- 系统属性 + + /** 系统属性原样返回;空串按「未配置」处理。 */ + private static String opt(String name) { + String value = System.getProperty(name, ""); + if (value == null) { + return null; + } + String trimmed = value.trim(); + return trimmed.isEmpty() ? null : trimmed; + } + + /** 系统属性转 Integer;空串 / 非数字按「未配置」处理。 */ + private static Integer optInt(String name) { + String value = opt(name); + if (value == null) { + return null; + } + try { + return Integer.valueOf(value); + } catch (NumberFormatException e) { + return null; + } + } + + private static Integer toInt(Object v) { + if (v == null) { + return null; + } + try { + return Integer.valueOf(String.valueOf(v).trim()); + } catch (NumberFormatException e) { + return null; + } + } + + /** {@code List} → {@code List>},避开泛型擦除。 */ + private static List> toRows(List raw) { + List> out = new ArrayList>(raw.size()); + for (Object o : raw) { + if (o instanceof Map) { + Map row = new LinkedHashMap(); + for (Map.Entry e : ((Map) o).entrySet()) { + row.put(String.valueOf(e.getKey()), e.getValue()); + } + out.add(row); + } + } + return out; + } + /** * 打印真实请求与响应,签名/字段名不对时靠这个定位。Authorization 只打指纹。 */ diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSourceTest.java new file mode 100644 index 0000000..1f28faa --- /dev/null +++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSourceTest.java @@ -0,0 +1,107 @@ +package common.ecommerce.lingxing.platform.amazon.order; + +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.model.Platform; +import common.ecommerce.model.order.OrderLine; +import common.ecommerce.model.order.SalesOrder; +import common.ecommerce.model.order.SalesOrderQuery; +import common.ecommerce.model.support.Page; +import common.ecommerce.testkit.RecordingTransport; +import common.ecommerce.testkit.Responses; +import org.junit.jupiter.api.Test; + +import java.time.Instant; + +import static common.ecommerce.lingxing.support.LingxingTestSupport.account; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.call; +import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * 领星亚马逊 FBM(订单管理视角)。 + * + *

夹具取自 2026-11-06 真实报文:列表只回头部字段,详情才带金额与商品行。

+ */ +class AmazonFbmOrderSourceTest { + + /** 列表条目:真实报文没有 order_price_amount / order_item。 */ + private static final String LIST = "{\"code\":0,\"message\":\"success\",\"data\":[" + + "{\"order_number\":\"103762423931902241\",\"status\":\"待发货\",\"order_from\":\"线上订单\"," + + "\"country_code\":\"US\",\"purchase_time\":\"2026-11-05 09:10:41\"," + + "\"payment_time\":\"2026-11-05 09:39:50\",\"logistics_type_name\":\"FedEx\"," + + "\"logistics_provider_name\":\"仓库 - 已去仓 BLL_NJ\",\"wid\":26189," + + "\"warehouse_name\":\"仓库 - 已去仓 BLL_NJ\"," + + "\"platform_list\":[\"113-5407739-9977043\"],\"customer_comment\":\"\"}" + + "],\"total\":1}"; + + /** 详情:对象形态,带 order_price_amount 与 order_item。 */ + private static final String DETAIL = "{\"code\":0,\"message\":\"success\",\"data\":{" + + "\"order_number\":\"103762423931902241\",\"order_status\":\"待发货\"," + + "\"purchase_time\":\"2026-11-05 09:10:41\",\"order_price_amount\":\"189.89\"," + + "\"order_item\":[{\"platform_order_id\":\"113-5407739-9977043\",\"MSKU\":\"AZDG846\"," + + "\"order_item_no\":\"174238021943081\",\"sku\":\"140054791\",\"quality\":1," + + "\"item_unit_price\":\"189.99\",\"currency_code\":\"USD\"}]" + + "},\"total\":0}"; + + private final RecordingTransport transport = RecordingTransport.create() + .route(LingxingApi.ORDER_LIST_FBM_AMAZON_SC.path(), r -> Responses.ok(LIST)) + .route(LingxingApi.ORDER_DETAIL_FBM_AMAZON_SC.path(), r -> Responses.ok(DETAIL)); + + private SalesOrder pullOne() { + Page page = new AmazonFbmOrderSource().orders( + call(transport, account(Platform.AMAZON_SC, 10001, "12822")), + SalesOrderQuery.builder() + .updatedAfter(Instant.parse("2026-11-04T00:00:00Z")) + .updatedBefore(Instant.parse("2026-11-06T00:00:00Z")) + .pageSize(20) + .build()); + assertEquals(1, page.size()); + return page.items().get(0); + } + + @Test + void listRowHasHeaderFieldsOnly() { + SalesOrder order = pullOne(); + assertEquals("103762423931902241", order.channelOrderId()); + assertEquals("待发货", order.status()); + assertEquals("US", order.shipToCountryCode()); + // 列表接口确实不返回金额与商品行:保持空值,不报错 + assertNull(order.totalAmount()); + assertTrue(order.lines().isEmpty()); + } + + @Test + void listTimeIsBeijing() { + // 2026-11-05 09:10:41 北京时间 = 2026-11-05T01:10:41Z + assertEquals(Instant.parse("2026-11-05T01:10:41Z"), pullOne().occurredAt().utc()); + } + + @Test + void listRequestUsesSid() { + pullOne(); + assertBodyContains(lastBody(transport), "\"sid\":\"12822\""); + } + + @Test + void detailRowCarriesAmountAndItemLines() { + SalesOrder order = new AmazonFbmOrderSource().order( + call(transport, account(Platform.AMAZON_SC, 10001, "12822")), + "103762423931902241"); + + assertEquals("待发货", order.status()); + assertNotNull(order.totalAmount(), "详情应带订单金额"); + assertEquals("189.89", order.totalAmount().amount().toPlainString()); + assertEquals("USD", order.totalAmount().currencyCode()); + + assertEquals(1, order.lines().size()); + OrderLine line = order.lines().get(0); + assertEquals("AZDG846", line.platformSku()); + assertEquals(1, line.quantity()); + assertEquals("189.99", line.unitPrice().amount().toPlainString()); + assertEquals("USD", line.unitPrice().currencyCode()); + } +} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/inbound/AwdCargoSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/inbound/AwdCargoSourceTest.java index a2e2ae3..e2f7ade 100644 --- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/inbound/AwdCargoSourceTest.java +++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/inbound/AwdCargoSourceTest.java @@ -111,6 +111,45 @@ class AwdCargoSourceTest { baseQuery().timeType(InboundShipmentTimeType.COMPLETED).build())); } + /** + * 真实报文(2026-11-06 冒烟抓到):时间字段是 {@code yyyy-MM-dd HH:mm:ss} 而不是 ISO instant, + * 且 {@code shipmentId} 与 {@code orderId} 是两个字段。旧实现会把整页货件判成映射失败。 + */ + @Test + void mapsRealPayloadWithBeijingTextTimes() { + RecordingTransport real = RecordingTransport.create() + .route(LingxingApi.INBOUND_SHIPMENT_AWD.path(), + r -> Responses.ok(JsonFixture.load( + "fixtures/lingxing/inbound/awdShipment/real-2026-11-06.json"))); + + Page page = new AwdCargoSource().shipments( + call(real, account(Platform.AMAZON_SC, 10001, "12822")), baseQuery().build()); + + assertEquals(1, page.size()); + InboundShipment shipment = page.items().get(0); + // 入库货件号取 shipmentId,AWD 货件单号取 orderId,不再混用 + assertEquals("STAR-RVKFDYRYN6DZC", shipment.shipmentId()); + assertEquals("STAR-W74AHX5UQHY3E", shipment.shipmentNo()); + assertEquals("CREATED", shipment.status()); + assertEquals("12822", shipment.storeId()); + assertEquals("NCSL", shipment.carrierCode()); + assertEquals("1ZR22YBD", shipment.warehouseReferenceId()); + + // 无时区文本按北京时间解释:2026-11-02 15:06:49 +08:00 = 2026-11-02T07:06:49Z + assertEquals(Instant.parse("2026-11-02T07:06:49Z"), shipment.createdAt().utc()); + assertEquals(Instant.parse("2026-11-02T08:39:57Z"), shipment.updatedAt().utc()); + // shipBy 是 ship-by 日期口径,同样按北京时间当天 0 点 + assertEquals(Instant.parse("2026-11-09T16:00:00Z"), shipment.shippedAt().utc()); + + assertEquals("36900 West 4th Street, BEAUMONT, CA, 92223, US", shipment.destinationAddress()); + assertEquals(1, shipment.lines().size()); + assertEquals("140030845", shipment.lines().get(0).sku()); + assertEquals("AZ6042", shipment.lines().get(0).msku()); + assertEquals(7, shipment.lines().get(0).boxQuantity()); + assertEquals(72, shipment.lines().get(0).quantityInBox().intValue()); + assertEquals("CENTIMETERS", shipment.lines().get(0).lengthUnit()); + } + @Test void inboundOrderNoIsRejected() { assertThrows(ValidationException.class, () -> new AwdCargoSource().shipments( diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSourceTest.java new file mode 100644 index 0000000..fe10cf7 --- /dev/null +++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSourceTest.java @@ -0,0 +1,79 @@ +package common.ecommerce.lingxing.platform.multiplatform.order; + +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.model.Platform; +import common.ecommerce.model.order.SalesOrder; +import common.ecommerce.model.order.SalesOrderQuery; +import common.ecommerce.model.support.Page; +import common.ecommerce.testkit.RecordingTransport; +import common.ecommerce.testkit.Responses; +import org.junit.jupiter.api.Test; + +import java.time.Instant; + +import static common.ecommerce.lingxing.support.LingxingTestSupport.account; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.call; +import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody; +import static org.junit.jupiter.api.Assertions.assertEquals; + +/** + * 领星多平台订单:分页长度边界。 + * + *

2026-11 真机验证:{@code length} 小于 20 时领星返回 + * {@code code=102 msg=length最小值为20},适配器必须向上取到 20,不能把 5 直接发出去。

+ */ +class MultiPlatformOrderSourceTest { + + private static final String ONE_ORDER = "{\"code\":0,\"message\":\"success\",\"data\":{\"total\":1,\"list\":[" + + "{\"global_order_no\":\"103762401014419036\",\"platform_order_no\":\"111-2270470-8221007\"," + + "\"store_id\":\"110528861382225920\",\"platform_code\":\"10008\",\"order_status\":6}" + + "]}}"; + + private final RecordingTransport transport = RecordingTransport.create() + .route(LingxingApi.ORDER_LIST.path(), r -> Responses.ok(ONE_ORDER)); + + private Page pull(SalesOrderQuery query) { + return new MultiPlatformOrderSource(transport, new common.ecommerce.http.JacksonJsonCodec()) + .orders(call(transport, account(Platform.WALMART_SC, 10008, "110528861382225920")), query); + } + + @Test + void pageSizeBelowPlatformMinimumIsRaisedToTwenty() { + pull(SalesOrderQuery.builder() + .updatedAfter(Instant.parse("2026-11-04T00:00:00Z")) + .updatedBefore(Instant.parse("2026-11-05T00:00:00Z")) + .pageSize(5) + .build()); + assertBodyContains(lastBody(transport), "\"length\":20"); + } + + @Test + void pageSizeAboveMinimumIsKept() { + pull(SalesOrderQuery.builder() + .updatedAfter(Instant.parse("2026-11-04T00:00:00Z")) + .updatedBefore(Instant.parse("2026-11-05T00:00:00Z")) + .pageSize(50) + .build()); + assertBodyContains(lastBody(transport), "\"length\":50"); + } + + @Test + void pageSizeZeroFallsBackToDefault() { + pull(SalesOrderQuery.builder() + .updatedAfter(Instant.parse("2026-11-04T00:00:00Z")) + .updatedBefore(Instant.parse("2026-11-05T00:00:00Z")) + .build()); + assertBodyContains(lastBody(transport), "\"length\":100"); + } + + @Test + void mapsMinimalRow() { + Page page = pull(SalesOrderQuery.builder() + .updatedAfter(Instant.parse("2026-11-04T00:00:00Z")) + .updatedBefore(Instant.parse("2026-11-05T00:00:00Z")) + .pageSize(20) + .build()); + assertEquals(1, page.size()); + } +} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/probe/FulfillmentProbeTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/probe/FulfillmentProbeTest.java new file mode 100644 index 0000000..62636d7 --- /dev/null +++ b/lingxing/src/test/java/common/ecommerce/lingxing/probe/FulfillmentProbeTest.java @@ -0,0 +1,715 @@ +package common.ecommerce.lingxing.probe; + +import common.ecommerce.capability.AggregatorCapable.SubChannel; +import common.ecommerce.http.HttpRequest; +import common.ecommerce.http.HttpResponse; +import common.ecommerce.http.HttpTransport; +import common.ecommerce.http.JacksonJsonCodec; +import common.ecommerce.http.OkHttpTransport; +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.lingxing.LingxingConstants; +import common.ecommerce.lingxing.adapter.LingxingAdapter; +import common.ecommerce.lingxing.auth.LingxingTokenClient; +import common.ecommerce.lingxing.http.LingxingEnvelope; +import common.ecommerce.lingxing.http.LingxingRateLimiter; +import common.ecommerce.lingxing.http.LingxingRequestFactory; +import common.ecommerce.lingxing.platform.LingxingCall; +import common.ecommerce.lingxing.platform.multiplatform.order.LingxingOrderFilters; +import common.ecommerce.model.ChannelProvider; +import common.ecommerce.model.Capability; +import common.ecommerce.model.Platform; +import common.ecommerce.model.account.AccountKey; +import common.ecommerce.model.account.ChannelAccount; +import common.ecommerce.model.fulfillment.LabelQuery; +import common.ecommerce.model.fulfillment.OutboundOrder; +import common.ecommerce.model.fulfillment.OutboundOrderLine; +import common.ecommerce.model.fulfillment.OutboundOrderQuery; +import common.ecommerce.model.fulfillment.ShippingLabel; +import common.ecommerce.model.inbound.InboundReceipt; +import common.ecommerce.model.inbound.InboundReceiptQuery; +import common.ecommerce.model.inbound.InboundShipment; +import common.ecommerce.model.inbound.InboundShipmentQuery; +import common.ecommerce.model.inbound.InboundShipmentTimeType; +import common.ecommerce.model.order.SalesOrder; +import common.ecommerce.model.order.SalesOrderQuery; +import common.ecommerce.model.support.Page; +import common.ecommerce.model.support.PlatformTime; +import common.ecommerce.sdk.ChannelConnection; +import common.ecommerce.sdk.ChannelContext; +import common.ecommerce.spi.AccessToken; +import common.ecommerce.spi.ChannelSecret; +import common.ecommerce.testkit.InMemoryLockProvider; +import common.ecommerce.testkit.InMemoryTokenStore; +import org.junit.jupiter.api.Assumptions; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfSystemProperty; + +import java.time.Clock; +import java.time.Duration; +import java.time.Instant; +import java.time.LocalDate; +import java.util.ArrayList; +import java.util.Collections; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.TreeMap; + +/** + * 店铺 / 订单 / 面单 / 入库的只读探针:核对这些接口在真实环境下的出入参。 + * + *

与同目录其它探针一样:默认跳过,用 {@code -Dlingxing.probe=true} 显式开启, + * 凭据走系统属性、真实凭证不入库:

+ * + *
+ * mvn -pl lingxing -am -DfailIfNoTests=false \
+ *     -Dlingxing.probe=true \
+ *     -Dlingxing.probe.appKey=你的appId -Dlingxing.probe.appSecret=你的appSecret \
+ *     -Dtest=FulfillmentProbeTest test
+ * 
+ * + *

可选系统属性:{@code -Dlingxing.probe.storeId}(多平台店铺)、 + * {@code -Dlingxing.probe.amazonSid}(WMS 出库单 / 面单 / AWD,必须数字)、 + * {@code -Dlingxing.probe.walmartStoreId}(WFS)、{@code -Dlingxing.probe.tiktokStoreId}(FBT)、 + * {@code -Dlingxing.probe.vcStoreId}(亚马逊 VC)。不填则从店铺列表自动发现。

+ * + *

只做查询,不调用任何写接口。异常只打印不抛出,一次跑完全部段落, + * 方便逐条对照真实报文(尤其 {@code 待核对} 的字段名与格式)。

+ */ +@EnabledIfSystemProperty(named = "lingxing.probe", matches = "true") +class FulfillmentProbeTest { + + // 真实凭据不入库:本地跑探针时用 -Dlingxing.probe.appKey=... -Dlingxing.probe.appSecret=... + private static final String APP_KEY = System.getProperty("lingxing.probe.appKey", ""); + private static final String APP_SECRET = System.getProperty("lingxing.probe.appSecret", ""); + private static final String STORE_ID = opt("lingxing.probe.storeId"); + private static final String AMAZON_SID = opt("lingxing.probe.amazonSid"); + private static final String WALMART_STORE_ID = opt("lingxing.probe.walmartStoreId"); + private static final String TIKTOK_STORE_ID = opt("lingxing.probe.tiktokStoreId"); + private static final String VC_STORE_ID = opt("lingxing.probe.vcStoreId"); + private static final Integer PLATFORM_CODE = optInt("lingxing.probe.platformCode"); + + private static final String BASE_URL = LingxingConstants.PRODUCTION_BASE_URL; + private static final JacksonJsonCodec JSON = new JacksonJsonCodec(); + + /** 面单只取前几单,避免把大段 base64 刷到控制台。 */ + private static final int LABEL_LIMIT = 5; + + private final LoggingTransport transport = + new LoggingTransport(new OkHttpTransport("common-ecommerce-fulfillment-probe")); + private final InMemoryTokenStore tokens = new InMemoryTokenStore(); + private final LingxingAdapter adapter = new LingxingAdapter(transport, JSON, tokens, + new InMemoryLockProvider(), Clock.systemUTC()); + + /** 多平台店铺自动发现结果;{@link #discoveryAttempted} 保证只发现一次。 */ + private String discoveredStoreId; + private boolean discoveryAttempted; + + // ================================================================ 店铺 + + /** + * 普通店铺列表(适配器 {@code listSubChannels},内部按 {@code is_sync=1 + status=1} 过滤), + * 再直连同一个接口不过滤这两项,把暂停同步 / 授权异常的店铺也打出来。 + * + *

两者相减就是被过滤掉的店铺;「订单 / 入库里莫名少的店铺」多半在这里。

+ */ + @Test + void probeShops() { + requireCredentials(); + System.out.println("\n================ shops / 多平台店铺 ================"); + try { + ChannelContext ctx = context("probe-shops-"); + List visible = adapter.listSubChannels(ctx); + System.out.println("[shops] 适配器可见=" + visible.size() + + " platform_code=" + platformCodeLabel()); + for (SubChannel shop : visible) { + System.out.println(" store_id=" + shop.externalStoreId() + + " platform_code=" + shop.platformCode() + + " platform=" + shop.platform() + + " name=" + shop.name() + + " platform_name=" + shop.attributes().get("platform_name")); + } + + List> all = fetchAllShops(); + System.out.println("[shops all] 不过滤=" + all.size()); + Map>> byCode = new TreeMap>>(); + for (Map shop : all) { + String code = String.valueOf(shop.get("platform_code")); + List> group = byCode.get(code); + if (group == null) { + group = new ArrayList>(); + byCode.put(code, group); + } + group.add(shop); + } + for (Map.Entry>> e : byCode.entrySet()) { + Platform mapped = LingxingConstants.toPlatform(toInt(e.getKey())); + System.out.println(" code=" + e.getKey() + + " → " + (mapped == null ? "未登记" : mapped.name()) + + " 共 " + e.getValue().size() + " 家"); + for (Map shop : e.getValue()) { + System.out.println(" store_id=" + shop.get("store_id") + + " is_sync=" + shop.get("is_sync") + + " status=" + shop.get("status") + + " name=" + shop.get("store_name") + + " platform_name=" + shop.get("platform_name")); + } + } + + List hidden = new ArrayList(); + for (Map shop : all) { + String storeId = shop.get("store_id") == null ? null : String.valueOf(shop.get("store_id")); + if (storeId == null || !containsStore(visible, storeId)) { + hidden.add(storeId + "(" + shop.get("store_name") + ")"); + } + } + System.out.println("[shops all] 被 is_sync/status 过滤掉=" + hidden.size() + " " + hidden); + } catch (RuntimeException e) { + printError(e); + } + } + + // ================================================================ 订单 + + /** 多平台订单:默认更新时间口径与订购时间口径各拉一页,对比条数。 */ + @Test + void probeOrdersByDateType() { + requireCredentials(); + System.out.println("\n================ orders / date_type ================"); + try { + ChannelAccount account = multiPlatformAccount(); + if (account == null) { + return; + } + ChannelContext ctx = context(account, "probe-orders-"); + Instant to = Instant.now(); + Instant from = to.minus(Duration.ofDays(2)); + SalesOrderQuery query = SalesOrderQuery.builder() + .updatedAfter(from) + .updatedBefore(to) + .pageSize(5) + .build(); + + Page byUpdate = adapter.pull(ctx, query, LingxingOrderFilters.none()); + System.out.println("[orders] date_type=update_time items=" + byUpdate.size() + + " nextCursor=" + byUpdate.nextCursor()); + printOrders(byUpdate); + + Page byPurchase = adapter.pull(ctx, query, LingxingOrderFilters.builder() + .dateType(LingxingOrderFilters.DATE_TYPE_PURCHASE_TIME) + .build()); + System.out.println("[orders] date_type=global_purchase_time items=" + byPurchase.size() + + " nextCursor=" + byPurchase.nextCursor()); + printOrders(byPurchase); + + // 按平台单号回查:契约上允许不传时间窗,这里用上一页的样本验证是否被默认窗口滤掉 + if (byUpdate.items().isEmpty()) { + System.out.println("[orders] 窗口内没有样本,跳过 platform_order_no 回查"); + return; + } + String platformOrderNo = byUpdate.items().get(0).channelOrderId(); + Page hit = adapter.pull(ctx, query, LingxingOrderFilters.builder() + .platformOrderNos(Collections.singletonList(platformOrderNo)) + .build()); + System.out.println("[orders] platform_order_no=" + platformOrderNo + + " → items=" + hit.size()); + printOrders(hit); + } catch (RuntimeException e) { + printError(e); + } + } + + /** 亚马逊 SC 订单列表 + 详情;FBM 列表 + 详情(主键是领星系统单号)。 */ + @Test + void probeAmazonOrders() { + requireCredentials(); + System.out.println("\n================ orders / Amazon SC + FBM ================"); + String sid = firstShopId(Platform.AMAZON_SC, LingxingConstants.PLATFORM_CODE_AMAZON, AMAZON_SID); + if (sid == null) { + return; + } + Instant to = Instant.now(); + Instant from = to.minus(Duration.ofDays(2)); + SalesOrderQuery query = SalesOrderQuery.builder() + .updatedAfter(from) + .updatedBefore(to) + .pageSize(5) + .build(); + + try { + ChannelContext ctx = context(account(Platform.AMAZON_SC, + LingxingConstants.PLATFORM_CODE_AMAZON, sid), "probe-amazon-orders-"); + Page page = adapter.pull(ctx, query); + System.out.println("[amazon orders] sid=" + sid + " items=" + page.size() + + " nextCursor=" + page.nextCursor()); + printOrders(page); + if (!page.items().isEmpty()) { + System.out.println(" [detail] " + adapter.get(ctx, + common.ecommerce.model.order.SalesOrderRef.of( + page.items().get(0).channelOrderId()))); + } + } catch (RuntimeException e) { + printError(e); + } + + try { + ChannelContext ctx = context(account(Platform.AMAZON_SC, + LingxingConstants.PLATFORM_CODE_AMAZON, sid), "probe-fbm-"); + Page page = adapter.pullFbmOrders(ctx, query); + System.out.println("[fbm orders] sid=" + sid + " items=" + page.size() + + " nextCursor=" + page.nextCursor()); + printOrders(page); + if (!page.items().isEmpty()) { + System.out.println(" [detail] " + adapter.getFbmOrder(ctx, page.items().get(0).channelOrderId())); + } + } catch (RuntimeException e) { + printError(e); + } + } + + /** 亚马逊 VC 订单列表 + 详情(详情分 DF / PO 两个接口,由 {@code get()} 分派)。 */ + @Test + void probeAmazonVcOrders() { + requireCredentials(); + System.out.println("\n================ orders / Amazon VC ================"); + String vcStoreId = firstShopId(Platform.AMAZON_VC, + LingxingConstants.PLATFORM_CODE_AMAZON_VC, VC_STORE_ID); + if (vcStoreId == null) { + return; + } + try { + ChannelContext ctx = context(account(Platform.AMAZON_VC, + LingxingConstants.PLATFORM_CODE_AMAZON_VC, vcStoreId), "probe-vc-orders-"); + Instant to = Instant.now(); + Page page = adapter.pull(ctx, SalesOrderQuery.builder() + .updatedAfter(to.minus(Duration.ofDays(2))) + .updatedBefore(to) + .pageSize(5) + .build()); + System.out.println("[vc orders] vc_store_id=" + vcStoreId + " items=" + page.size() + + " nextCursor=" + page.nextCursor()); + printOrders(page); + if (!page.items().isEmpty()) { + System.out.println(" [detail] " + adapter.get(ctx, + common.ecommerce.model.order.SalesOrderRef.of( + page.items().get(0).channelOrderId()))); + } + } catch (RuntimeException e) { + printError(e); + } + } + + // ================================================================ 面单 / 出库单 + + /** 销售出库单 → 面单({@code wo_number_arr} 与 {@code order_number_arr} 两条路径)。 */ + @Test + void probeOutboundOrdersAndLabels() { + requireCredentials(); + System.out.println("\n================ labels / WMS 出库单 + 面单 ================"); + String sid = firstShopId(Platform.AMAZON_SC, LingxingConstants.PLATFORM_CODE_AMAZON, AMAZON_SID); + if (sid == null) { + System.out.println("[labels] 没有亚马逊店铺(WMS 需要数字 sid),跳过"); + return; + } + try { + ChannelContext ctx = context(account(Platform.AMAZON_SC, + LingxingConstants.PLATFORM_CODE_AMAZON, sid), "probe-labels-"); + Instant to = Instant.now(); + Page page = adapter.pull(ctx, OutboundOrderQuery.builder() + .after(to.minus(Duration.ofDays(30))) + .before(to) + .timeType(OutboundOrderQuery.TIME_CREATED) + .pageSize(5) + .build()); + System.out.println("[outbound orders] sid=" + sid + " items=" + page.size() + + " nextCursor=" + page.nextCursor()); + for (OutboundOrder o : page.items()) { + System.out.println(" wo_number=" + o.woNumber() + + " order_number=" + o.orderNumber() + + " status=" + o.status() + "/" + o.statusName() + + " warehouse=" + o.warehouseId() + "/" + o.warehouseName() + + " waybillNO=" + o.waybillNo() + + " amount=" + o.orderAmount() + + " surface=" + o.surfaceFileUrl()); + for (OutboundOrderLine line : o.lines()) { + System.out.println(" sku=" + line.sku() + + " msku=" + line.sellerSku() + + " qty=" + line.quantity() + + " unit=" + line.unitPrice()); + } + } + if (page.items().isEmpty()) { + System.out.println("[labels] 最近 30 天没有出库单,跳过面单"); + return; + } + + List woNumbers = new ArrayList(); + List orderNumbers = new ArrayList(); + for (OutboundOrder o : page.items()) { + if (woNumbers.size() >= LABEL_LIMIT) { + break; + } + woNumbers.add(o.woNumber()); + if (o.orderNumber() != null) { + orderNumbers.add(o.orderNumber()); + } + } + printLabels("wo_number_arr", adapter.labels(ctx, LabelQuery.builder().woNumbers(woNumbers).build())); + if (!orderNumbers.isEmpty()) { + printLabels("order_number_arr", + adapter.labels(ctx, LabelQuery.builder().orderNumbers(orderNumbers).build())); + } + } catch (RuntimeException e) { + printError(e); + } + } + + // ================================================================ 入库 + + /** FBT(TikTok)/ WFS(沃尔玛)/ AWD(亚马逊)各拉一页,三种时间口径逐个试。 */ + @Test + void probeInboundShipments() { + requireCredentials(); + System.out.println("\n================ inbound / FBT + WFS + AWD ================"); + probeInbound("FBT", Platform.TIKTOK, 10011, + firstShopId(Platform.TIKTOK, 10011, TIKTOK_STORE_ID), + InboundShipmentTimeType.CREATED, InboundShipmentTimeType.UPDATED, + InboundShipmentTimeType.COMPLETED); + probeInbound("WFS", Platform.WALMART_SC, 10008, + firstShopId(Platform.WALMART_SC, 10008, WALMART_STORE_ID), + InboundShipmentTimeType.CREATED, InboundShipmentTimeType.COMPLETED); + probeInbound("AWD", Platform.AMAZON_SC, LingxingConstants.PLATFORM_CODE_AMAZON, + firstShopId(Platform.AMAZON_SC, LingxingConstants.PLATFORM_CODE_AMAZON, AMAZON_SID), + InboundShipmentTimeType.CREATED, InboundShipmentTimeType.UPDATED, + // 完成时间不支持,预期被显式拒绝 + InboundShipmentTimeType.COMPLETED); + } + + /** FBA 到货接收明细:按签收日期(北京时间)取一页。 */ + @Test + void probeFbaReceivedInventory() { + requireCredentials(); + System.out.println("\n================ inbound / FBA 接收明细 ================"); + String sid = firstShopId(Platform.AMAZON_SC, LingxingConstants.PLATFORM_CODE_AMAZON, AMAZON_SID); + if (sid == null) { + return; + } + try { + ChannelAccount account = account(Platform.AMAZON_SC, + LingxingConstants.PLATFORM_CODE_AMAZON, sid); + if (!adapter.supports(account, Capability.INBOUND_RECEIPT)) { + System.out.println("[inbound receipts] Amazon SC 未装配 FBA 接收明细,跳过"); + return; + } + LocalDate eventDate = LocalDate.now(PlatformTime.BEIJING_ZONE).minusDays(1); + Page page = adapter.pull(context(account, "probe-inbound-receipts-"), + InboundReceiptQuery.builder().sid(sid).eventDate(eventDate).pageSize(5).build()); + System.out.println("[inbound receipts] sid=" + sid + " eventDate=" + eventDate + + " items=" + page.size() + " nextCursor=" + page.nextCursor()); + for (InboundReceipt r : page.items()) { + System.out.println(" shipmentId=" + r.shipmentId() + + " fnsku=" + r.fnsku() + + " sku=" + r.sku() + + " qty=" + r.quantity() + + " fc=" + r.fulfillmentCenterId() + + " receivedAt=" + (r.receivedAt() == null ? null : r.receivedAt().utc()) + + " uniqueIndex=" + r.uniqueIndex()); + } + } catch (RuntimeException e) { + printError(e); + } + } + + // ================================================================ helpers + + private void probeInbound(String label, Platform platform, Integer platformCode, String storeId, + InboundShipmentTimeType... timeTypes) { + if (storeId == null) { + System.out.println("[inbound " + label + "] 没有 " + platform + " 店铺,跳过"); + return; + } + ChannelAccount account = account(platform, platformCode, storeId); + if (!adapter.supports(account, Capability.INBOUND_SHIPMENT)) { + System.out.println("[inbound " + label + "] " + platform + " 未装配入库货件查询,跳过"); + return; + } + Instant to = Instant.now(); + Instant from = to.minus(Duration.ofDays(7)); + for (InboundShipmentTimeType timeType : timeTypes) { + try { + Page page = adapter.pull(context(account, "probe-inbound-"), + InboundShipmentQuery.builder() + .storeIds(storeId) + .timeType(timeType) + .after(from) + .before(to) + .pageSize(5) + .build()); + System.out.println("[inbound " + label + "] " + platform + " store=" + storeId + + " timeType=" + timeType + " items=" + page.size() + + " nextCursor=" + page.nextCursor()); + for (InboundShipment s : page.items()) { + System.out.println(" shipmentNo=" + s.shipmentNo() + + " shipmentId=" + s.shipmentId() + + " inboundOrderNo=" + s.inboundOrderNo() + + " status=" + s.status() + "/" + s.statusName() + + " storeIds=" + s.storeIds() + + " warehouse=" + s.warehouseName() + + " createdAt=" + (s.createdAt() == null ? null : s.createdAt().utc()) + + " lines=" + s.lines().size() + + " shippingRefs=" + s.shippingRefs().size()); + } + } catch (RuntimeException e) { + printError(e); + } + } + } + + /** 不过滤 {@code is_sync} / {@code status} 的店铺列表。 */ + private List> fetchAllShops() { + LingxingCall call = call(context("probe-shops-all-")); + Map body = new LinkedHashMap(); + body.put("offset", 0); + body.put("length", LingxingConstants.MULTI_PLATFORM_MAX_PAGE_SIZE); + if (PLATFORM_CODE != null && PLATFORM_CODE != 0) { + body.put("platform_code", Collections.singletonList(PLATFORM_CODE)); + } + HttpRequest req = call.signed(LingxingApi.SHOP_LIST_MULTI_PLATFORM, body, "probe.shops.all"); + HttpResponse resp = call.execute(req); + LingxingEnvelope env = call.envelope(resp, "probe.shops.all"); + return toRows(JSON.listAt(env.body(), "data.list", LinkedHashMap.class)); + } + + /** + * 平台店铺 id:系统属性优先,否则按平台从店铺列表自动发现第一家。 + * + * @return null 表示没有可用店铺,调用方打印跳过 + */ + private String firstShopId(Platform platform, Integer platformCode, String configured) { + if (configured != null) { + return configured; + } + ChannelAccount discovery = account(platform, platformCode, "0"); + List shops = adapter.listSubChannels(context(discovery, "probe-shops-" + platform + "-")); + System.out.println("[shops] " + platform + " 自动发现 " + shops.size() + " 家店"); + for (SubChannel shop : shops) { + System.out.println(" store_id=" + shop.externalStoreId() + + " platform_code=" + shop.platformCode() + + " name=" + shop.name()); + } + return shops.isEmpty() ? null : shops.get(0).externalStoreId(); + } + + private void requireCredentials() { + Assumptions.assumeTrue(!APP_KEY.trim().isEmpty() && !APP_SECRET.trim().isEmpty(), + "未提供 -Dlingxing.probe.appKey / -Dlingxing.probe.appSecret,跳过探针"); + } + + private ChannelContext context(String prefix) { + return context(account(smokePlatform(), platformCodeOrNull(), STORE_ID == null ? "0" : STORE_ID), + prefix); + } + + private ChannelContext context(ChannelAccount account, String prefix) { + return ChannelContext.of(account, connection(), prefix + System.currentTimeMillis(), Clock.systemUTC()); + } + + /** 给适配器没有暴露入口的接口(不过滤 is_sync / status 的店铺列表)用。 */ + private LingxingCall call(ChannelContext ctx) { + Clock clock = Clock.systemUTC(); + AccessToken token = new LingxingTokenClient(transport, JSON, clock) + .fetch(BASE_URL, APP_KEY, APP_SECRET); + return new LingxingCall(ctx, token, new LingxingRequestFactory(JSON, clock), + new LingxingRateLimiter(), JSON, transport); + } + + private static ChannelConnection connection() { + return ChannelConnection.of(BASE_URL, ChannelSecret.builder() + .appKey(APP_KEY).appSecret(APP_SECRET).build()); + } + + private static void printOrders(Page page) { + for (SalesOrder o : page.items()) { + System.out.println(" " + o.channelOrderId() + + " status=" + o.status() + + " total=" + o.totalAmount() + + " lines=" + o.lines().size() + + " utc=" + (o.occurredAt() == null ? null : o.occurredAt().utc())); + } + } + + /** 只打 base64 长度,避免把整张面单刷到控制台。 */ + private static void printLabels(String queryKey, List labels) { + System.out.println("[labels] " + queryKey + " count=" + labels.size()); + for (ShippingLabel label : labels) { + String base64 = label.contentBase64(); + System.out.println(" wo_number=" + label.woNumber() + + " order_number=" + label.orderNumber() + + " provider=" + label.logisticsProviderId() + + " fileType=" + label.fileType() + + " fileSize=" + label.fileSize() + + " b64=" + (base64 == null ? "null" : base64.length() + " chars")); + } + } + + private static boolean containsStore(List shops, String storeId) { + for (SubChannel shop : shops) { + if (storeId.equals(shop.externalStoreId())) { + return true; + } + } + return false; + } + + /** + * 多平台探针用的账户:显式传了 {@code -Dlingxing.probe.storeId} 就用它, + * 否则从店铺列表自动发现第一家;都没有时返回 null,调用方跳过。 + * + *

自动发现结果缓存在实例字段里,避免每个探针都重复列一遍店铺。

+ */ + private ChannelAccount multiPlatformAccount() { + ChannelContext discoveryCtx = context(account(smokePlatform(), platformCodeOrNull(), "0"), + "probe-discovery-"); + String storeId = discoveredStoreId; + if (storeId == null && !discoveryAttempted) { + discoveryAttempted = true; + storeId = discoverFirstStore(discoveryCtx); + if (storeId == null) { + System.out.println("[shops] 没有配置 -Dlingxing.probe.storeId," + + "自动发现的店铺列表也是空,多平台探针跳过"); + } else { + System.out.println("[shops] 未指定 storeId,自动发现使用 store_id=" + storeId); + } + discoveredStoreId = storeId; + } + return storeId == null ? null : account(smokePlatform(), platformCodeOrNull(), storeId); + } + + private String discoverFirstStore(ChannelContext ctx) { + List shops = adapter.listSubChannels(ctx); + return shops.isEmpty() ? null : shops.get(0).externalStoreId(); + } + + private static boolean hasPlatformCode() { + return PLATFORM_CODE != null && PLATFORM_CODE != 0; + } + + private static Integer platformCodeOrNull() { + return hasPlatformCode() ? PLATFORM_CODE : null; + } + + /** 没有平台码时兜底 CUSTOM:订单与店铺都走多平台接口,只按 store_id 过滤。 */ + private static Platform smokePlatform() { + return hasPlatformCode() ? LingxingConstants.toPlatform(PLATFORM_CODE) : Platform.CUSTOM; + } + + private static String platformCodeLabel() { + return hasPlatformCode() ? String.valueOf(PLATFORM_CODE) : "未指定(仅按 store_id 过滤)"; + } + + /** + * 账户构造取 {@code Integer}:{@code platformCode} 为 null 表示不带该过滤条件。 + * 注意不要写成 {@code int}——自动发现时平台码常为 null,拆箱会直接 NPE。 + */ + private static ChannelAccount account(Platform platform, Integer platformCode, String storeId) { + return ChannelAccount.builder() + .key(AccountKey.of(ChannelProvider.LINGXING, platform, + "oms-" + platform.name().toLowerCase())) + .externalStoreId(storeId == null || storeId.trim().isEmpty() ? "probe" : storeId) + .platformCode(platformCode == null || platformCode == 0 ? null : platformCode) + .credentialRef("probe") + .marketplaceZone("America/Los_Angeles") + .currency("USD") + .build(); + } + + private static String opt(String name) { + String value = System.getProperty(name, ""); + if (value == null) { + return null; + } + String trimmed = value.trim(); + return trimmed.isEmpty() ? null : trimmed; + } + + private static Integer optInt(String name) { + String value = opt(name); + if (value == null) { + return null; + } + try { + return Integer.valueOf(value); + } catch (NumberFormatException e) { + return null; + } + } + + private static Integer toInt(Object v) { + if (v == null) { + return null; + } + try { + return Integer.valueOf(String.valueOf(v).trim()); + } catch (NumberFormatException e) { + return null; + } + } + + private static List> toRows(List raw) { + List> out = new ArrayList>(raw.size()); + for (Object o : raw) { + if (o instanceof Map) { + Map row = new LinkedHashMap(); + for (Map.Entry e : ((Map) o).entrySet()) { + row.put(String.valueOf(e.getKey()), e.getValue()); + } + out.add(row); + } + } + return out; + } + + private static void printError(RuntimeException e) { + String msg = e.getMessage() == null ? e.getClass().getSimpleName() : e.getMessage(); + System.out.println("[ERROR] " + e.getClass().getSimpleName() + ": " + + (msg.length() <= 300 ? msg : msg.substring(0, 300) + "…")); + } + + /** 打印请求/响应(截断),只读排查用。token 打码。 */ + static final class LoggingTransport implements HttpTransport { + + private static final int MAX_BODY = 2000; + + private final HttpTransport delegate; + + LoggingTransport(HttpTransport delegate) { + this.delegate = delegate; + } + + @Override + public HttpResponse execute(HttpRequest request) { + System.out.println(" --> " + request.method() + " " + pathOf(request.url())); + System.out.println(" headers " + mask(request.headers().toString())); + System.out.println(" body " + truncate(request.body())); + HttpResponse response = delegate.execute(request); + System.out.println(" <-- " + response.statusCode() + " " + truncate(response.body())); + return response; + } + + private static String mask(String headers) { + return headers.replaceAll("(?i)(bearer\\s+)[^,\\]]+", "$1***"); + } + + private static String pathOf(String url) { + int i = url.indexOf('/', url.indexOf("://") + 3); + return i < 0 ? url : url.substring(i); + } + + private static String truncate(String body) { + if (body == null) { + return "null"; + } + return body.length() <= MAX_BODY ? body : body.substring(0, MAX_BODY) + "...(" + body.length() + " chars)"; + } + } +} diff --git a/lingxing/src/test/resources/fixtures/lingxing/inbound/awdShipment/real-2026-11-06.json b/lingxing/src/test/resources/fixtures/lingxing/inbound/awdShipment/real-2026-11-06.json new file mode 100644 index 0000000..1bfa30c --- /dev/null +++ b/lingxing/src/test/resources/fixtures/lingxing/inbound/awdShipment/real-2026-11-06.json @@ -0,0 +1,75 @@ +{ + "code": 0, + "message": "操作成功", + "error_details": null, + "request_id": "990ec5475d7445feb6c24139ff4b219f.1793957763968", + "response_time": "2026-11-06T17:36:04.071", + "data": { + "current": 1, + "pages": 1, + "size": 5, + "total": 1, + "records": [ + { + "createByName": null, + "gmtCreate": "2026-11-02 15:06:49", + "gmtModified": "2026-11-02 16:39:57", + "shipmentId": "STAR-RVKFDYRYN6DZC", + "stockOrderId": null, + "sid": 12822, + "remark": null, + "orderId": "STAR-W74AHX5UQHY3E", + "status": "CREATED", + "warehouseReferenceId": "1ZR22YBD", + "destinationShipperName": "IUSJ", + "carrierCode": "NCSL", + "trackingId": null, + "shipBy": "2026-11-10 00:00:00", + "awdShippingAddressBO": { + "addressLine1": "zonggaishifanqu taiyuanquyuanqu", + "addressLine2": null, + "city": "Taiyuan", + "countryCode": "CN", + "stateOrProvinceCode": "Shanxi", + "postalCode": "030032", + "shipperName": "TaiYuanDeLiWenJuShangMaoYouXianGongSi", + "phoneNumber": "19873062030", + "zone": null + }, + "awdDeliveredGoodsBO": { + "destinationAddressLine1": "36900 West 4th Street", + "destinationAddressLine2": "", + "destinationCity": "BEAUMONT", + "destinationCountryCode": "US", + "destinationStateOrRegion": "CA", + "destinationPostalCode": "92223" + }, + "awdDeliveredGoodsItemBOS": [ + { + "boxQuantity": "7", + "msku": "AZ6042", + "quantityInBox": "72", + "length": 24.89, + "width": 32.00, + "height": 25.91, + "lengthUnit": "CENTIMETERS", + "weight": 11.80, + "weightUnit": "KILOGRAMS", + "expiration": null, + "prepOwner": null, + "labelOwner": "SELF", + "prepCategory": "NO_PREP", + "fnsku": "X004RUQXDN", + "asin": "B0FH27SGKL", + "parentAsin": "B0FH27SGKL", + "title": "5PCS Mini Box Cutter Keychain", + "productName": "Steelite-AZ6042", + "sku": "140030845", + "url": "https://m.media-amazon.com/images/I/61NyDdsg+IL._SL75_.jpg", + "receivedQuantity": 0 + } + ] + } + ] + } +}
参数类型说明
{@code offset}int必填,分页偏移;本实现用字符串化的 offset 作游标。
{@code length}int必填,分页长度,上限 500,超过会被截断。
{@code length}int必填,分页长度,下限 20、上限 500; + * 超出范围会被适配器收窄到边界值(<20 时领星返回 {@code code=102})。
{@code date_type}string时间类型:{@code update_time}(默认)、 * {@code global_purchase_time}、{@code global_delivery_time}、 * {@code global_payment_time}、{@code delivery_time}(仅 Shopify)。