Browse Source

feat(lingxing): 修正 AWD 入库时间解析与多平台订单分页下限,补齐店铺/订单/面单/入库探针

- 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 与多平台订单报错均已消除。
feature/supplier-lingxing
lml 2 weeks ago
parent
commit
57404c6fe8
  1. 6
      lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java
  2. 21
      lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/FbmOrderDto.java
  3. 36
      lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSource.java
  4. 12
      lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/AwdCargoSource.java
  5. 31
      lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/InboundSupport.java
  6. 10
      lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/dto/AwdShipmentDto.java
  7. 10
      lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSource.java
  8. 616
      lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingLiveSmokeTest.java
  9. 107
      lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSourceTest.java
  10. 39
      lingxing/src/test/java/common/ecommerce/lingxing/platform/inbound/AwdCargoSourceTest.java
  11. 79
      lingxing/src/test/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSourceTest.java
  12. 715
      lingxing/src/test/java/common/ecommerce/lingxing/probe/FulfillmentProbeTest.java
  13. 75
      lingxing/src/test/resources/fixtures/lingxing/inbound/awdShipment/real-2026-11-06.json

6
lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java

@ -41,6 +41,12 @@ public final class LingxingConstants { @@ -41,6 +41,12 @@ public final class LingxingConstants {
/** 多平台分页 length 上限(领星统一订单接口的限制)。 */
public static final int MAX_PAGE_SIZE = 500;
/**
* 多平台分页 length 下限:小于 20 领星直接返回 {@code code=102 length最小值为20}。
*
* <p>2026-11 真机验证:{@code pageSize=5} 会被拒绝,适配器统一向上取到 20。</p>
*/
public static final int MIN_PAGE_SIZE = 20;
/** 亚马逊订单分页 length 上限。 */
public static final int AMAZON_MAX_PAGE_SIZE = 5000;
/** 亚马逊 FBM 订单分页 length:文档默认 100,未给上限,按默认值取。 */

21
lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/dto/FbmOrderDto.java

@ -5,6 +5,9 @@ import com.fasterxml.jackson.annotation.JsonProperty; @@ -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 { @@ -34,6 +37,24 @@ public class FbmOrderDto {
@JsonProperty("country_code")
private String countryCode;
/**
* 订单金额。列表接口<b>不会</b>返回(2026-11 真实报文没有该字段),
* 这里保留字段只为兼容「列表与详情共用一个 DTO 解析」的场景,正常情况下为 null。
*/
@JsonProperty("order_price_amount")
private String orderPriceAmount;
/**
* 商品行。列表接口<b>不会</b>返回(2026-11 真实报文没有 {@code order_item}),
* 商品明细必须再调 {@code getOrderDetail}。
*/
@JsonProperty("order_item")
private List<FbmOrderItemDto> orderItem = new ArrayList<FbmOrderItemDto>();
/** 平台订单号列表(元素类型不稳定,这里保留原样不解析)。 */
@JsonProperty("platform_list")
private List<String> platformList;
/** 订购时间。 */
@JsonProperty("purchase_time")
private String purchaseTime;

36
lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSource.java

@ -143,11 +143,40 @@ public final class AmazonFbmOrderSource implements LingxingOrderSource { @@ -143,11 +143,40 @@ public final class AmazonFbmOrderSource implements LingxingOrderSource {
// ---------------------------------------------------------------- mapping
/** 列表条目:没有商品行与金额,商品明细要再调详情。 */
/**
* 列表条目。
*
* <p>2026-11 真实报文确认 {@code getOrderList} 只返回头部字段(单号 / 状态 / 目的国 /
* 时间 / 物流 / 仓库),<b>不含</b>订单金额与 {@code order_item};
* 金额与商品行必须再调 {@code getOrderDetail}。
* 这里仍按「有就映射」处理,字段缺失时保持空值,不抛异常。</p>
*/
private SalesOrder toSalesOrder(FbmOrderDto dto, ChannelAccount account, ZoneId zone) {
String orderNumber = requireOrderNumber(dto.getOrderNumber());
Instant occur = systemTime(dto.getPurchaseTime());
List<FbmOrderItemDto> items = safe(dto.getOrderItem());
List<OrderLine> lines = new ArrayList<OrderLine>(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 { @@ -155,9 +184,8 @@ public final class AmazonFbmOrderSource implements LingxingOrderSource {
// FBM 列表不返回买家姓名;国家有
.buyerName(null)
.shipToCountryCode(trimToNull(dto.getCountryCode()))
.lines(Collections.<OrderLine>emptyList())
// 列表接口不返回订单金额
.totalAmount(null)
.lines(lines)
.totalAmount(moneyOrNull(dto.getOrderPriceAmount(), totalCurrency))
.occurredAt(requireOccurredAt(occur, orderNumber, zone))
.sourceProvider(ChannelProvider.LINGXING)
.sourceAccountId(null)

12
lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/AwdCargoSource.java

@ -118,11 +118,14 @@ public final class AwdCargoSource implements LingxingInboundShipmentSource { @@ -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 { @@ -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);
}
}

31
lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/InboundSupport.java

@ -75,6 +75,37 @@ final class InboundSupport { @@ -75,6 +75,37 @@ final class InboundSupport {
return Instant.parse(text);
}
/**
* 「ISO 优先、北京时间文本兜底」的宽松解析。
*
* <p>AWD 文档写的是 ISO instant,但 <b>2026-11 真实报文</b>返回的是
* {@code 2026-11-02 15:06:49} 这种没有时区后缀的文本({@code gmtCreate} /
* {@code gmtModified} / {@code shipBy}),严格按 ISO 解析会让整页货件映射失败。
* 无时区文本按北京时间解释,与 FBT / WFS 的口径一致。</p>
*
* @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<String> resolveStoreIds(LingxingCall call, InboundShipmentQuery query, String op) {
if (!query.storeIds().isEmpty()) {

10
lingxing/src/main/java/common/ecommerce/lingxing/platform/inbound/dto/AwdShipmentDto.java

@ -17,10 +17,18 @@ import java.util.List; @@ -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} 是两个不同的字段。
*
* <p>2026-11 真实报文确认存在;接口的货件号过滤参数 {@code shipmentId} 对应的就是它。</p>
*/
@JsonProperty("shipmentId")
private String shipmentId;
/** 备货单号。 */
@JsonProperty("stockOrderId")
private String stockOrderId;

10
lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSource.java

@ -39,7 +39,8 @@ import java.util.Map; @@ -39,7 +39,8 @@ import java.util.Map;
* <table border="1">
* <tr><th>参数</th><th>类型</th><th>说明</th></tr>
* <tr><td>{@code offset}</td><td>int</td><td>必填,分页偏移;本实现用字符串化的 offset 作游标。</td></tr>
* <tr><td>{@code length}</td><td>int</td><td>必填,分页长度,<b>上限 500</b>,超过会被截断。</td></tr>
* <tr><td>{@code length}</td><td>int</td><td>必填,分页长度,<b>下限 20、上限 500</b>;
* 超出范围会被适配器收窄到边界值(&lt;20 时领星返回 {@code code=102})。</td></tr>
* <tr><td>{@code date_type}</td><td>string</td><td>时间类型:{@code update_time}(默认)、
* {@code global_purchase_time}、{@code global_delivery_time}、
* {@code global_payment_time}、{@code delivery_time}(仅 Shopify)。</td></tr>
@ -113,8 +114,11 @@ public class MultiPlatformOrderSource implements LingxingOrderSource { @@ -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());

616
lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingLiveSmokeTest.java

@ -6,93 +6,102 @@ import common.ecommerce.http.HttpResponse; @@ -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;
/**
* 领星真实环境冒烟测试。
* 领星真实环境冒烟测试:逐个只读查询接口打一页,打印请求与解析结果,人工核对字段映射。
*
* <p>覆盖范围:认证 / 店铺 / 订单(多平台、亚马逊 SC、FBM、VC)/ 结算。
* 面单与入库见 {@code FulfillmentProbeTest},商品 / 售后见 {@code probe} 包下各自的探针与契约测试。</p>
*
* <p><b>默认跳过</b>,用 {@code -Dlingxing.probe=true} 显式开启;凭据走系统属性,
* 与 {@code probe} 包下的探针一致,<b>真实凭证不入库</b>:</p>
*
* <p><b>填上 APP_KEY / APP_SECRET 即可跑(STORE_ID 可留空),然后 IDE 里右键 Run 或执行:</b></p>
* <pre>
* 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
* </pre>
*
* <p>可选系统属性(不填则走自动发现或跳过对应段落):</p>
* <ul>
* <li>{@code -Dlingxing.probe.platformCode=10008}:多平台店铺 / 订单用哪个平台,
* 不填<b>不带 {@code platform_code} 过滤</b>,返回账号下全部店铺;</li>
* <li>{@code -Dlingxing.probe.storeId=...}:指定某一家店(store_id / sid),覆盖自动发现的店铺;</li>
* <li>{@code -Dlingxing.probe.vcStoreId=...}:亚马逊 VC 店铺,不填自动发现。</li>
* </ul>
*
* <p>调用前确认出口 IP 已加入领星白名单,否则会直接 401/403。</p>
*
* <p>本类只用于联调,不要把真实凭证提交到仓库。</p>
* <p><b>只做查询</b>,不调用任何写接口。整轮冒烟共用一个 token(同一个 app 下多店铺共用),
* 不要给每个测试单独换 token,否则会频繁触发领星限流。</p>
*/
@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,按需改。
*
* <p>Target / BestBuy / AEPH / Michaels / ECHO / LOS-DLI-US 等平台在领星侧
* <b>没有独立平台码</b>。这类平台把本常量置为 {@code null} 或 {@code 0} 即可:
* 请求体不带 {@code platform_code},店铺与订单都只按 {@code store_id} 过滤,
* 业务平台由 {@link #smokePlatform()} 兜底成 {@link Platform#CUSTOM}。</p>
*/
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 { @@ -106,8 +115,10 @@ class LingxingLiveSmokeTest {
assertNotNull(token.value());
}
// ================================================================ 店铺
/**
* 第 2 步(多平台):先按 {@code PLATFORM_CODE} 列一次店铺,再拉一页订单,
* 第 2 步(店铺):先按 {@code PLATFORM_CODE} 列一次店铺,再拉一页订单,
* 打印请求与解析结果,人工核对字段映射。
*
* <p>订单接口按店铺 id 过滤,而各子平台的 id 口径不同(亚马逊 SC 是数字 {@code sid},
@ -115,16 +126,15 @@ class LingxingLiveSmokeTest { @@ -115,16 +126,15 @@ class LingxingLiveSmokeTest {
* {@code STORE_ID} 填了则优先用它,仅作为「指定某一家店」的覆盖手段。</p>
*
* <p><b>没有平台码的平台</b>(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} 即可。</p>
* 填到 {@code -Dlingxing.probe.storeId} 即可。</p>
*/
@Test
void pullsOnePageOfOrders() {
requireCredentials();
LingxingAdapter adapter = adapter();
List<SubChannel> shops = listShops(adapter);
String storeId = resolveStoreId(shops);
if (storeId == null) {
@ -151,22 +161,91 @@ class LingxingLiveSmokeTest { @@ -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 步补充(店铺):多平台店铺列表在<b>没有任何过滤</b>时到底返回什么。
*
* <p>{@link LingxingAdapter#listSubChannels} 内部按上游店铺接口的协议写死了
* {@code is_sync=1} + {@code status=1}(暂停同步 / 授权异常 / 删除的店看不到),
* 适配器<b>没有</b>对应的查询入口。这里用 {@link LingxingCall} 直接打同一个接口,
* 不过滤这三项,把未启用的店也打出来,用来判断「订单 / 入库里少的店铺」是不是被过滤掉了。</p>
*/
@Test
void listsShopsIncludingDisabledOnes() {
requireCredentials();
LingxingCall call = call(null);
Map<String, Object> body = new LinkedHashMap<String, Object>();
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<Map<String, Object>> 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<String, List<Map<String, Object>>> byCode = new TreeMap<String, List<Map<String, Object>>>();
for (Map<String, Object> shop : shops) {
String code = String.valueOf(shop.get("platform_code"));
List<Map<String, Object>> group = byCode.get(code);
if (group == null) {
group = new ArrayList<Map<String, Object>>();
byCode.put(code, group);
}
group.add(shop);
}
System.out.println("[shops all] 按 platform_code 分组(每组代表一种子平台)");
for (Map.Entry<String, List<Map<String, Object>>> 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<String, Object> 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<SubChannel> visible = adapter.listSubChannels(context(account("0"), "smoke-shops-visible-"));
List<String> hidden = new ArrayList<String>();
for (Map<String, Object> 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,再拉订单列表,最后取一单详情核对金额。
*
* <p>不依赖 STORE_ID:sid 来自 {@code /erp/sc/data/seller/lists}。</p>
*/
@Test
void listsAmazonShopsAndPullsOrders() {
requireCredentials();
LingxingAdapter adapter = adapter();
String sid = firstAmazonShopSid(adapter);
String sid = firstAmazonShopSid();
if (sid == null) {
return;
}
@ -188,7 +267,7 @@ class LingxingLiveSmokeTest { @@ -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 { @@ -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 { @@ -210,16 +289,14 @@ class LingxingLiveSmokeTest {
}
/**
* 第 3 步补充(亚马逊 FBM):拉一页「订单管理」视角的自发货订单,再取一单详情。
* 第 4 步补充(亚马逊 FBM):拉一页「订单管理」视角的自发货订单,再取一单详情。
*
* <p>这条路由的主键是领星系统单号 {@code order_number},不是平台订单号。</p>
*/
@Test
void pullsAmazonFbmOrders() {
requireCredentials();
LingxingAdapter adapter = adapter();
String sid = firstAmazonShopSid(adapter);
String sid = firstAmazonShopSid();
if (sid == null) {
return;
}
@ -240,7 +317,7 @@ class LingxingLiveSmokeTest { @@ -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 { @@ -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 { @@ -262,51 +339,6 @@ class LingxingLiveSmokeTest {
}
/**
* 第 4 步(多平台):列 Walmart 店铺,再拉一页 Walmart 在线商品。
*
* <p>店铺来自 {@code /pb/mp/shop/v2/getSellerList},商品来自
* {@code /basicOpen/multiplatform/walmart/list}。</p>
*/
@Test
void listsWalmartShopsAndProducts() {
requireCredentials();
LingxingAdapter adapter = adapter();
ChannelAccount discovery = walmartAccount("0");
List<SubChannel> 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<ProductListing> 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,再拉订单列表,最后取一单详情。
*
* <p>VC 详情分 DF / PO 两个接口,{@code get()} 会先按订单编号查出类型再分派。</p>
@ -314,9 +346,7 @@ class LingxingLiveSmokeTest { @@ -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 { @@ -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 { @@ -361,249 +391,163 @@ class LingxingLiveSmokeTest {
}
/**
* 第 6 步(结算):拉一页亚马逊结算交易明细。
* 第 5 步补充(订单 · 时间口径):默认时间窗按「更新时间」过滤,
* 这对增量同步是对的,但按「下单时间」回补历史订单时会一条都查不到。
* 这里对同一店铺、同一段订购时间分别用两种口径各拉一页,对比条数。
*
* <p>只有多平台订单接口({@code /pb/mp/order/v2/list})支持 {@code date_type},
* 亚马逊 SC / VC 走各自接口,会忽略该条件。门面不暴露这个参数,直接用适配器。</p>
*/
@Test
void pullsAmazonSettlements() {
void ordersByPurchaseTimeWindow() {
requireCredentials();
LingxingAdapter adapter = adapter();
String sid = firstAmazonShopSid(adapter);
if (sid == null) {
List<SubChannel> shops = listShops(adapter);
String storeId = resolveStoreId(shops);
if (storeId == null) {
return;
}
ChannelContext ctx = context(amazonAccount(sid), "smoke-settlement-");
LocalDate today = LocalDate.now();
Page<SettlementTransaction> 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<SalesOrder> byUpdate = adapter.pull(ctx, query, LingxingOrderFilters.none());
Page<SalesOrder> 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 步(仓库):拉一页销售出库单,打印单据与商品行,人工核对字段映射。
*
* <p>{@code /erp/sc/routing/wms/order/wmsOrderList} 按店铺<b>数字 sid</b> 过滤,
* 所以用亚马逊店铺列表返回的 {@code sid},而不是多平台的 {@code store_id}
* (后者不是数字,适配器会直接拒绝,避免跨店铺返回数据)。</p>
*/
@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<OutboundOrder> 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 步补充(订单 · 回查):拿订单列表里的平台单号回查一次。
*
* <p>{@code wo_number_arr} 与 {@code order_number_arr} 二选一,两条路径都跑,
* 确认字段名与 base64 返回。文档提示面单可能尚未生成,此时 {@code file_b64} 为空串。</p>
*/
@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<OutboundOrder> page = pullOneOutboundPage(adapter, ctx);
if (page.items().isEmpty()) {
System.out.println("[labels] 最近 30 天没有出库单,跳过");
return;
}
List<String> woNumbers = new ArrayList<>();
List<String> 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 接收明细。
* <p>契约上「按平台单号查询时领星允许不传时间窗」,这里验证的是实现没有偷偷塞默认时间窗
* 把老订单过滤掉:用平台单号回查,命中数至少 1。</p>
*
* <p><b>只读</b>。FBT / WFS / AWD 的时间字段与日期口径不同,这里统一用最近 7 天先看字段映射;
* 各接口的时间窗上限与「待核对」参数由 {@code InboundProbeTest} 另行核对。</p>
* <p>只对多平台接口有效;没有样本时提示跳过。</p>
*/
@Test
void pullsInboundShipmentsAndReceipts() {
void ordersBackfilledByPlatformOrderNo() {
requireCredentials();
LingxingAdapter adapter = adapter();
List<SubChannel> 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<InboundShipment> page = adapter.pull(ctx, InboundShipmentQuery.builder()
.storeIds(storeId)
.after(from)
.before(to)
.pageSize(20)
Instant from = to.minus(Duration.ofDays(2));
Page<SalesOrder> 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<InboundReceipt> receipts = adapter.pull(context(account, "smoke-inbound-receipts-"),
InboundReceiptQuery.builder()
.sid(storeId)
.eventDate(eventDate)
String platformOrderNo = sample.items().get(0).channelOrderId();
Page<SalesOrder> 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<OutboundOrder> 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<SettlementTransaction> 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<ShippingLabel> 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 { @@ -638,7 +582,7 @@ class LingxingLiveSmokeTest {
* <p>返回 null 表示没有可用店铺,调用方打印跳过。</p>
*/
private static String resolveStoreId(List<SubChannel> 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 { @@ -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 { @@ -669,7 +613,12 @@ class LingxingLiveSmokeTest {
/**
* 列出亚马逊店铺并返回第一家 sid;没有授权店铺时返回 null。
*/
private String firstAmazonShopSid(LingxingAdapter adapter) {
private String firstAmazonShopSid() {
List<SubChannel> shops = amazonShops();
return shops.isEmpty() ? null : shops.get(0).externalStoreId();
}
private List<SubChannel> amazonShops() {
ChannelAccount discovery = amazonAccount("0");
List<SubChannel> shops = adapter.listSubChannels(context(discovery, "smoke-amazon-shops-"));
System.out.println("[amazon shops] count=" + shops.size());
@ -678,13 +627,13 @@ class LingxingLiveSmokeTest { @@ -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<SubChannel> shops = adapter.listSubChannels(context(discovery, "smoke-vc-shops-"));
System.out.println("[vc shops] count=" + shops.size());
@ -702,9 +651,13 @@ class LingxingLiveSmokeTest { @@ -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 { @@ -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 { @@ -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<LinkedHashMap>} → {@code List<Map<String,Object>>},避开泛型擦除。 */
private static List<Map<String, Object>> toRows(List<?> raw) {
List<Map<String, Object>> out = new ArrayList<Map<String, Object>>(raw.size());
for (Object o : raw) {
if (o instanceof Map) {
Map<String, Object> row = new LinkedHashMap<String, Object>();
for (Map.Entry<?, ?> e : ((Map<?, ?>) o).entrySet()) {
row.put(String.valueOf(e.getKey()), e.getValue());
}
out.add(row);
}
}
return out;
}
/**
* 打印真实请求与响应,签名/字段名不对时靠这个定位。Authorization 只打指纹。
*/

107
lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSourceTest.java

@ -0,0 +1,107 @@ @@ -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(订单管理视角)。
*
* <p>夹具取自 2026-11-06 真实报文:列表只回头部字段,详情才带金额与商品行。</p>
*/
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<SalesOrder> 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());
}
}

39
lingxing/src/test/java/common/ecommerce/lingxing/platform/inbound/AwdCargoSourceTest.java

@ -111,6 +111,45 @@ class AwdCargoSourceTest { @@ -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<InboundShipment> 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(

79
lingxing/src/test/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSourceTest.java

@ -0,0 +1,79 @@ @@ -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;
/**
* 领星多平台订单:分页长度边界。
*
* <p>2026-11 真机验证:{@code length} 小于 20 时领星返回
* {@code code=102 msg=length最小值为20},适配器必须向上取到 20,不能把 5 直接发出去。</p>
*/
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<SalesOrder> 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<SalesOrder> 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());
}
}

715
lingxing/src/test/java/common/ecommerce/lingxing/probe/FulfillmentProbeTest.java

@ -0,0 +1,715 @@ @@ -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;
/**
* 店铺 / 订单 / 面单 / 入库的只读探针:核对这些接口在真实环境下的出入参。
*
* <p>与同目录其它探针一样:<b>默认跳过</b>,用 {@code -Dlingxing.probe=true} 显式开启,
* 凭据走系统属性、<b>真实凭证不入库</b>:</p>
*
* <pre>
* mvn -pl lingxing -am -DfailIfNoTests=false \
* -Dlingxing.probe=true \
* -Dlingxing.probe.appKey=你的appId -Dlingxing.probe.appSecret=你的appSecret \
* -Dtest=FulfillmentProbeTest test
* </pre>
*
* <p>可选系统属性:{@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)。不填则从店铺列表自动发现。</p>
*
* <p><b>只做查询</b>,不调用任何写接口。异常只打印不抛出,一次跑完全部段落,
* 方便逐条对照真实报文(尤其 {@code 待核对} 的字段名与格式)。</p>
*/
@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} 过滤),
* 再直连同一个接口不过滤这两项,把暂停同步 / 授权异常的店铺也打出来。
*
* <p>两者相减就是被过滤掉的店铺;「订单 / 入库里莫名少的店铺」多半在这里。</p>
*/
@Test
void probeShops() {
requireCredentials();
System.out.println("\n================ shops / 多平台店铺 ================");
try {
ChannelContext ctx = context("probe-shops-");
List<SubChannel> 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<Map<String, Object>> all = fetchAllShops();
System.out.println("[shops all] 不过滤=" + all.size());
Map<String, List<Map<String, Object>>> byCode = new TreeMap<String, List<Map<String, Object>>>();
for (Map<String, Object> shop : all) {
String code = String.valueOf(shop.get("platform_code"));
List<Map<String, Object>> group = byCode.get(code);
if (group == null) {
group = new ArrayList<Map<String, Object>>();
byCode.put(code, group);
}
group.add(shop);
}
for (Map.Entry<String, List<Map<String, Object>>> 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<String, Object> 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<String> hidden = new ArrayList<String>();
for (Map<String, Object> 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<SalesOrder> byUpdate = adapter.pull(ctx, query, LingxingOrderFilters.none());
System.out.println("[orders] date_type=update_time items=" + byUpdate.size()
+ " nextCursor=" + byUpdate.nextCursor());
printOrders(byUpdate);
Page<SalesOrder> 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<SalesOrder> 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<SalesOrder> 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<SalesOrder> 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<SalesOrder> 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<OutboundOrder> 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<String> woNumbers = new ArrayList<String>();
List<String> orderNumbers = new ArrayList<String>();
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<InboundReceipt> 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<InboundShipment> 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<Map<String, Object>> fetchAllShops() {
LingxingCall call = call(context("probe-shops-all-"));
Map<String, Object> body = new LinkedHashMap<String, Object>();
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<SubChannel> 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<SalesOrder> 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<ShippingLabel> 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<SubChannel> shops, String storeId) {
for (SubChannel shop : shops) {
if (storeId.equals(shop.externalStoreId())) {
return true;
}
}
return false;
}
/**
* 多平台探针用的账户:显式传了 {@code -Dlingxing.probe.storeId} 就用它,
* 否则从店铺列表自动发现第一家;都没有时返回 null,调用方跳过。
*
* <p>自动发现结果缓存在实例字段里,避免每个探针都重复列一遍店铺。</p>
*/
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<SubChannel> 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<Map<String, Object>> toRows(List<?> raw) {
List<Map<String, Object>> out = new ArrayList<Map<String, Object>>(raw.size());
for (Object o : raw) {
if (o instanceof Map) {
Map<String, Object> row = new LinkedHashMap<String, Object>();
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)";
}
}
}

75
lingxing/src/test/resources/fixtures/lingxing/inbound/awdShipment/real-2026-11-06.json

@ -0,0 +1,75 @@ @@ -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
}
]
}
]
}
}
Loading…
Cancel
Save