diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingOrderMapper.java b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingOrderMapper.java index bd8bba4..f9396f4 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingOrderMapper.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingOrderMapper.java @@ -3,24 +3,35 @@ package common.ecommerce.lingxing; import common.ecommerce.http.JacksonJsonCodec; import common.ecommerce.lingxing.dto.LingxingOrderDto; import common.ecommerce.lingxing.dto.LingxingOrderItemDto; +import common.ecommerce.lingxing.dto.LingxingPlatformInfoDto; +import common.ecommerce.lingxing.dto.LingxingTransactionInfoDto; import common.ecommerce.model.ChannelProvider; -import common.ecommerce.model.support.Money; import common.ecommerce.model.order.OrderLine; -import common.ecommerce.model.Platform; -import common.ecommerce.model.support.PlatformTime; import common.ecommerce.model.order.SalesOrder; +import common.ecommerce.model.support.Money; +import common.ecommerce.model.support.PlatformTime; import java.time.Instant; import java.time.ZoneId; import java.util.ArrayList; import java.util.Collections; -import java.util.Comparator; import java.util.List; /** * 领星订单 → 统一模型。 * *

领星订单是唯一的映射入口,平台差异全部收敛在这里。

+ * + *

字段来源({@code /pb/mp/order/v2/list}):

+ * */ public final class LingxingOrderMapper { @@ -31,35 +42,49 @@ public final class LingxingOrderMapper { } public SalesOrder toSalesOrder(LingxingOrderDto dto, String omsStoreId, ZoneId marketplaceZone) { - Platform platform = LingxingConstants.toPlatform(dto.getPlatformCode()); String channelOrderId = resolveChannelOrderId(dto); - String currency = dto.getCurrencyCode() == null ? "USD" : dto.getCurrencyCode(); + String currency = currencyOf(dto); List lines = new ArrayList(); - for (LingxingOrderItemDto item : safe(dto.getItemList())) { + List items = safe(dto.getItemInfo()); + for (int i = 0; i < items.size(); i++) { + LingxingOrderItemDto item = items.get(i); + // 平台侧 SKU 优先,缺失时回落领星本地 SKU;全空时用空串占位,避免 NPE 丢掉整行 + String sku = firstNonBlank(item.getMsku(), item.getLocalSku(), + item.getProductNo(), item.getOrderItemNo()); lines.add(OrderLine.builder() - .lineId(item.getOrderItemId()) - // 领星 MSKU 与平台 SKU 不总一致;优先 platform_sku,缺失时回落 sku - .platformSku(item.getPlatformSku() != null ? item.getPlatformSku() : item.getSku()) + .lineId(firstNonBlank(item.getGlobalItemNo(), item.getOrderItemNo(), + item.getId(), "line-" + i)) + .platformSku(sku == null ? "" : sku) .quantity(item.getQuantity() == null ? 0 : item.getQuantity()) - .unitPrice(moneyOrNull(item.getItemPrice(), currency)) - .tax(moneyOrNull(item.getTax(), currency)) - .discount(moneyOrNull(item.getDiscount(), currency)) + .unitPrice(moneyOrNull(item.getUnitPriceAmount(), currency)) + .tax(moneyOrNull(item.getTaxAmount(), currency)) + .discount(moneyOrNull(item.getDiscountAmount(), currency)) .build()); } - Instant occur = dto.getPurchaseTime() != null - ? Instant.ofEpochSecond(dto.getPurchaseTime()) - : Instant.EPOCH; + LingxingPlatformInfoDto platformInfo = first(dto.getPlatformInfo()); + LingxingTransactionInfoDto txn = first(dto.getTransactionInfo()); + + Instant occur = epochOrNull(dto.getGlobalPurchaseTime()); + if (occur == null && platformInfo != null) { + occur = epochOrNull(platformInfo.getPurchaseTime()); + } + if (occur == null) { + occur = Instant.EPOCH; + } return SalesOrder.builder() .omsStoreId(omsStoreId) .channelOrderId(channelOrderId) - .status(dto.getOrderStatus()) - .buyerName(dto.getBuyerName()) - .shipToCountryCode(dto.getCountryCode()) + // 领星系统订单状态原值(1 同步中 … 6 已发货 … 9 平台发货),由宿主解释 + .status(dto.getStatus() == null ? null : String.valueOf(dto.getStatus())) + // 该接口不返回买家姓名 + .buyerName(null) + .shipToCountryCode(platformInfo == null + ? null : trimToNull(platformInfo.getStoreCountryCode())) .lines(lines) - .totalAmount(moneyOrNull(dto.getOrderTotal(), currency)) + .totalAmount(txn == null ? null : moneyOrNull(txn.getOrderTotalAmount(), currency)) .occurredAt(PlatformTime.of(occur, marketplaceZone)) .sourceProvider(ChannelProvider.LINGXING) .sourceAccountId(dto.getStoreId()) @@ -69,44 +94,95 @@ public final class LingxingOrderMapper { /** * channelOrderId 是 canonicalKey 的一部分,必须稳定。 * - *

优先平台单号;缺失时退回领星 order_id(此时跨 provider 无法去重, - * 会由 DuplicateOrderGuard 记录差异)。

+ *

优先平台单号;合并单会有多个平台单号,排序后取第一个,保证多次同步得到同一个 key。 + * 都没有时退回领星系统单号(此时跨 provider 无法去重,由 DuplicateOrderGuard 记录差异)。

*/ static String resolveChannelOrderId(LingxingOrderDto dto) { - if (dto.getPlatformOrderNo() != null && !dto.getPlatformOrderNo().trim().isEmpty()) { - return dto.getPlatformOrderNo().trim(); + List platformOrderNos = new ArrayList(); + for (LingxingPlatformInfoDto info : safe(dto.getPlatformInfo())) { + String no = firstNonBlank(info.getPlatformOrderNo(), info.getPlatformOrderName()); + if (no != null) { + platformOrderNos.add(no); + } + } + if (!platformOrderNos.isEmpty()) { + Collections.sort(platformOrderNos); + return platformOrderNos.get(0); } - List names = dto.getPlatformOrderNames(); - if (names != null && !names.isEmpty()) { - List sorted = new ArrayList(names); - Collections.sort(sorted, new Comparator() { - @Override - public int compare(String a, String b) { - return a.compareTo(b); - } - }); - return sorted.get(0); + String globalOrderNo = trimToNull(dto.getGlobalOrderNo()); + if (globalOrderNo == null) { + throw new IllegalArgumentException( + "lingxing order has neither platform_order_no nor global_order_no"); } - return dto.getOrderId(); + return globalOrderNo; } public List parseList(String body) { return json.listAt(body, "data.list", LingxingOrderDto.class); } - public int parseTotal(String body) { - String total = json.stringAt(body, "data.total"); - return total == null ? 0 : Integer.parseInt(total); + // ---------------------------------------------------------------- internals + + private static String currencyOf(LingxingOrderDto dto) { + String currency = trimToNull(dto.getAmountCurrency()); + return currency == null ? "USD" : currency.toUpperCase(); + } + + /** + * 领星金额可能带币种符号或千分位({@code "¥49.16"}、{@code "-¥0.98"}、{@code "1,234.56"}), + * 只保留数字、小数点与符号位;没有数字时视为缺失。 + */ + static String cleanAmount(String raw) { + if (raw == null) { + return null; + } + StringBuilder sb = new StringBuilder(raw.length()); + boolean hasDigit = false; + for (int i = 0; i < raw.length(); i++) { + char c = raw.charAt(i); + if (c >= '0' && c <= '9') { + sb.append(c); + hasDigit = true; + } else if (c == '.' || c == '-' || c == '+') { + sb.append(c); + } + } + return hasDigit ? sb.toString() : null; + } + + private static Money moneyOrNull(String value, String currency) { + String cleaned = cleanAmount(value); + return cleaned == null ? null : Money.of(cleaned, currency); + } + + private static Instant epochOrNull(Long epochSeconds) { + return epochSeconds == null || epochSeconds <= 0 ? null : Instant.ofEpochSecond(epochSeconds); } private static List safe(List in) { return in == null ? Collections.emptyList() : in; } - private static Money moneyOrNull(String value, String currency) { - if (value == null || value.trim().isEmpty()) { + private static T first(List in) { + return in == null || in.isEmpty() ? null : in.get(0); + } + + /** 返回第一个非空白值;全为空时返回 {@code fallback}(可能为 null)。 */ + private static String firstNonBlank(String... values) { + for (String v : values) { + String trimmed = trimToNull(v); + if (trimmed != null) { + return trimmed; + } + } + return null; + } + + private static String trimToNull(String v) { + if (v == null) { return null; } - return Money.of(value.trim(), currency); + String trimmed = v.trim(); + return trimmed.isEmpty() ? null : trimmed; } } diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderDto.java index 01e00a9..a607ded 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderDto.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderDto.java @@ -9,74 +9,71 @@ import java.util.ArrayList; import java.util.List; /** - * 领星多平台订单列表条目。 + * 领星多平台订单列表条目({@code /pb/mp/order/v2/list} 的 {@code data.list[]})。 * - *

待核对:字段名依据领星 OpenAPI 文档摘录,联调时以官方最新文档 - * 与真实响应为准;调整集中在本 DTO 与 {@code LingxingOrderMapper}。

- * - *

纯数据容器,使用 Lombok 生成访问器;不承载任何业务不变量。

+ *

字段名以 2026-10 官方文档与真实响应为准。几个容易踩的点:

+ *
    + *
  • 平台单号不在顶层,在 {@code platform_info[]} 里;合并单可能有多条
  • + *
  • 币种是 {@code amount_currency},不是 {@code currency_code}
  • + *
  • 金额字段可能带币种符号(如 {@code "¥49.16"}),DTO 保持原样,由 mapper 清洗
  • + *
  • {@code update_time} 文档类型是 string,值是 epoch 秒字符串
  • + *
*/ @Getter @Setter @JsonIgnoreProperties(ignoreUnknown = true) public class LingxingOrderDto { - /** 领星内部订单 ID。 */ - @JsonProperty("order_id") - private String orderId; - - /** 平台订单号(Amazon / Walmart PO / eBay 等)。 */ - @JsonProperty("platform_order_no") - private String platformOrderNo; + /** 领星系统单号,系统内唯一。 */ + @JsonProperty("global_order_no") + private String globalOrderNo; - /** 部分接口返回平台单号数组,eBay 需用 platform_order_names 查询。 */ - @JsonProperty("platform_order_names") - private List platformOrderNames = new ArrayList(); + /** 补发/换货的原系统单号。 */ + @JsonProperty("original_global_order_no") + private String originalGlobalOrderNo; - /** 领星平台码,如 10008=Walmart。 */ - @JsonProperty("platform_code") - private Integer platformCode; + /** 平台参考号。 */ + @JsonProperty("reference_no") + private String referenceNo; /** 领星店铺 ID。 */ @JsonProperty("store_id") private String storeId; - /** 平台侧订单状态。 */ - @JsonProperty("order_status") - private String orderStatus; - - /** 买家名称。 */ - @JsonProperty("buyer_name") - private String buyerName; + /** 币种,ISO 4217,如 USD。 */ + @JsonProperty("amount_currency") + private String amountCurrency; - /** 收货国家二字码。 */ - @JsonProperty("country_code") - private String countryCode; + /** 系统订单状态:1 同步中 … 6 已发货 … 9 平台发货。 */ + @JsonProperty("status") + private Integer status; - /** 订单币种。 */ - @JsonProperty("currency_code") - private String currencyCode; + /** 发货方式:1 混合、2 自发货、3 平台发货(WFS 等平台仓)。 */ + @JsonProperty("delivery_type") + private Integer deliveryType; - /** 订单总额。 */ - @JsonProperty("order_total") - private String orderTotal; + /** 订单更新时间,值是 epoch 秒字符串。 */ + @JsonProperty("update_time") + private String updateTime; - /** 站点本地下单时间字符串。 */ - @JsonProperty("purchase_time_locale") - private String purchaseTimeLocale; + /** 订购时间,epoch 秒。 */ + @JsonProperty("global_purchase_time") + private Long globalPurchaseTime; - /** epoch 秒下单时间。 */ - @JsonProperty("purchase_time") - private Long purchaseTime; + /** 发货时间,epoch 秒;未发货为 0。 */ + @JsonProperty("global_delivery_time") + private Long globalDeliveryTime; - /** epoch 秒更新时间。 */ - @JsonProperty("update_time") - private Long updateTime; + /** 商品明细。 */ + @JsonProperty("item_info") + private List itemInfo = new ArrayList(); - /** 站点本地更新时间字符串。 */ - @JsonProperty("update_time_locale") - private String updateTimeLocale; + /** 平台单信息;合并单一个系统单号可能对应多条。 */ + @JsonProperty("platform_info") + private List platformInfo = new ArrayList(); - @JsonProperty("item_list") - private List itemList = new ArrayList(); + /** 交易信息。 */ + @JsonProperty("transaction_info") + private List transactionInfo = + new ArrayList(); } diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderItemDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderItemDto.java index 6f3f87b..bb343ed 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderItemDto.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderItemDto.java @@ -6,35 +6,64 @@ import lombok.Getter; import lombok.Setter; /** - * 领星订单明细行。字段名待官方文档核对。 + * 领星订单明细行({@code data.list[].item_info[]})。 * - *

纯数据容器,使用 Lombok 生成访问器。

+ *

SKU 语义:{@code msku} 是平台侧 SKU,{@code local_sku} 是领星本地 SKU。 + * 对齐直连渠道时应优先用 {@code msku}。

*/ @Getter @Setter @JsonIgnoreProperties(ignoreUnknown = true) public class LingxingOrderItemDto { - @JsonProperty("order_item_id") - private String orderItemId; + /** 系统商品唯一 ID。 */ + @JsonProperty("id") + private String id; - /** 领星 MSKU,需映射回平台 SKU 才能与直连对齐。 */ - @JsonProperty("sku") - private String sku; + /** 商品行系统唯一键。 */ + @JsonProperty("global_item_no") + private String globalItemNo; - /** 平台 SKU(部分接口返回)。 */ - @JsonProperty("platform_sku") - private String platformSku; + /** 订单明细单号。 */ + @JsonProperty("order_item_no") + private String orderItemNo; + + /** 平台 SKU。 */ + @JsonProperty("msku") + private String msku; + + /** 领星本地 SKU。 */ + @JsonProperty("local_sku") + private String localSku; + + /** 亚马逊 ASIN / 多平台商品 ID。 */ + @JsonProperty("product_no") + private String productNo; + + /** 品名。 */ + @JsonProperty("local_product_name") + private String localProductName; @JsonProperty("quantity") private Integer quantity; - @JsonProperty("item_price") - private String itemPrice; + /** 单价,币种取 {@code amount_currency},可能带币种符号。 */ + @JsonProperty("unit_price_amount") + private String unitPriceAmount; + + /** 商品金额(单价 × 数量)。 */ + @JsonProperty("item_price_amount") + private String itemPriceAmount; + + /** 折扣。 */ + @JsonProperty("discount_amount") + private String discountAmount; - @JsonProperty("tax") - private String tax; + /** 商品税费。 */ + @JsonProperty("tax_amount") + private String taxAmount; - @JsonProperty("discount") - private String discount; + /** 该行对应的平台单号。 */ + @JsonProperty("platform_order_no") + private String platformOrderNo; } diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingPlatformInfoDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingPlatformInfoDto.java new file mode 100644 index 0000000..dd4edec --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingPlatformInfoDto.java @@ -0,0 +1,54 @@ +package common.ecommerce.lingxing.dto; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; +import lombok.Setter; + +/** + * 领星订单的平台单信息({@code data.list[].platform_info[]})。 + * + *

注意 {@code platform_code} 在这里是字符串(如 {@code "10008"}), + * 而请求参数里是整数数组。

+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class LingxingPlatformInfoDto { + + /** 平台 CODE,字符串形态。 */ + @JsonProperty("platform_code") + private String platformCode; + + /** 平台订单唯一标识;Shopify 下与 platform_order_name 不同。 */ + @JsonProperty("platform_order_no") + private String platformOrderNo; + + /** 平台订单编号(核对平台单号用这个)。 */ + @JsonProperty("platform_order_name") + private String platformOrderName; + + /** 收货国家二字码。注意官方字段名里 C 是大写。 */ + @JsonProperty("store_Country_code") + private String storeCountryCode; + + /** 平台单状态。 */ + @JsonProperty("status") + private String status; + + /** 平台支付状态。 */ + @JsonProperty("payment_status") + private String paymentStatus; + + /** 平台发货状态。 */ + @JsonProperty("shipping_status") + private String shippingStatus; + + /** 平台订购时间,epoch 秒。 */ + @JsonProperty("purchase_time") + private Long purchaseTime; + + /** 平台发货时间,epoch 秒。 */ + @JsonProperty("delivery_time") + private Long deliveryTime; +} diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingTransactionInfoDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingTransactionInfoDto.java new file mode 100644 index 0000000..23ba9fb --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingTransactionInfoDto.java @@ -0,0 +1,30 @@ +package common.ecommerce.lingxing.dto; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; +import lombok.Setter; + +/** + * 领星订单的交易信息({@code data.list[].transaction_info[]})。 + * + *

金额是带币种符号的字符串(如 {@code "¥49.16"}),由 mapper 清洗后再转 + * {@link common.ecommerce.model.support.Money}。

+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class LingxingTransactionInfoDto { + + /** 订单总额。 */ + @JsonProperty("order_total_amount") + private String orderTotalAmount; + + /** 商品金额。 */ + @JsonProperty("order_item_amount") + private String orderItemAmount; + + /** 折扣金额。 */ + @JsonProperty("discount_amount") + private String discountAmount; +} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/LingxingOrderMapperTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/LingxingOrderMapperTest.java index 9c0c6b9..d2f33c4 100644 --- a/lingxing/src/test/java/common/ecommerce/lingxing/LingxingOrderMapperTest.java +++ b/lingxing/src/test/java/common/ecommerce/lingxing/LingxingOrderMapperTest.java @@ -1,9 +1,9 @@ package common.ecommerce.lingxing; -import common.ecommerce.model.Platform; import common.ecommerce.http.JacksonJsonCodec; import common.ecommerce.lingxing.dto.LingxingOrderDto; import common.ecommerce.model.ChannelProvider; +import common.ecommerce.model.Platform; import common.ecommerce.model.order.SalesOrder; import common.ecommerce.testkit.Fixtures; import org.junit.jupiter.api.Test; @@ -13,6 +13,7 @@ import java.util.List; import static org.junit.jupiter.api.Assertions.assertEquals; import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertThrows; class LingxingOrderMapperTest { @@ -30,7 +31,8 @@ class LingxingOrderMapperTest { assertEquals("oms-wm-001", o.omsStoreId()); assertEquals("PO-123456789", o.channelOrderId()); - assertEquals("Shipped", o.status()); + // 领星系统状态原值:6 已发货 + assertEquals("6", o.status()); assertEquals("US", o.shipToCountryCode()); assertEquals(2, o.lines().size()); assertEquals("SKU-RED-M", o.lines().get(0).platformSku()); @@ -43,23 +45,48 @@ class LingxingOrderMapperTest { } @Test - void fallsBackToSkuWhenPlatformSkuMissing() { - SalesOrder o = mapper.toSalesOrder(fixture().get(1), "oms-ebay-001", ZoneId.of("America/New_York")); - assertEquals("MSKU-GREEN-S", o.lines().get(0).platformSku()); - assertNull(o.lines().get(0).tax()); - } - - @Test - void platformOrderNamesSortedForStableCanonicalKey() { + void mergedOrderPicksSortedFirstPlatformOrderNo() { // 返回顺序是 EBAY-2222, EBAY-1111,取排序后第一个,保证多次同步 key 稳定 SalesOrder o = mapper.toSalesOrder(fixture().get(1), "oms-ebay-001", ZoneId.of("America/New_York")); assertEquals("EBAY-1111", o.channelOrderId()); } @Test - void fallsBackToLingxingOrderIdWhenNoPlatformNo() { + void fallsBackToLingxingGlobalOrderNoWhenNoPlatformInfo() { SalesOrder o = mapper.toSalesOrder(fixture().get(2), "oms-tts-001", ZoneId.of("Europe/London")); assertEquals("LX-1003", o.channelOrderId()); + assertEquals(0, o.lines().size()); + assertNull(o.shipToCountryCode()); + } + + @Test + void stripsCurrencySymbolFromAmounts() { + // 真实响应里 order_total_amount 可能是 "¥15.00" + SalesOrder o = mapper.toSalesOrder(fixture().get(1), "oms-ebay-001", ZoneId.of("America/New_York")); + assertEquals("15.00 USD", o.totalAmount().toString()); + } + + @Test + void blankAmountBecomesNull() { + SalesOrder o = mapper.toSalesOrder(fixture().get(1), "oms-ebay-001", ZoneId.of("America/New_York")); + // tax_amount 是空串,不能变成 0 或抛异常 + assertNull(o.lines().get(0).tax()); + } + + @Test + void cleanAmountHandlesSymbolsCommasAndSigns() { + assertEquals("49.16", LingxingOrderMapper.cleanAmount("¥49.16")); + assertEquals("-0.98", LingxingOrderMapper.cleanAmount("¥-0.98")); + assertEquals("1234.56", LingxingOrderMapper.cleanAmount("1,234.56")); + assertEquals("14.00", LingxingOrderMapper.cleanAmount("JP¥14.00")); + assertNull(LingxingOrderMapper.cleanAmount("")); + assertNull(LingxingOrderMapper.cleanAmount("¥")); + assertNull(LingxingOrderMapper.cleanAmount(null)); + } + @Test + void missingBothOrderNumbersFailsLoudly() { + LingxingOrderDto dto = new LingxingOrderDto(); + assertThrows(IllegalArgumentException.class, () -> LingxingOrderMapper.resolveChannelOrderId(dto)); } @Test diff --git a/lingxing/src/test/resources/fixtures/lingxing/orderList/success.json b/lingxing/src/test/resources/fixtures/lingxing/orderList/success.json index 33fb5bb..a0f9753 100644 --- a/lingxing/src/test/resources/fixtures/lingxing/orderList/success.json +++ b/lingxing/src/test/resources/fixtures/lingxing/orderList/success.json @@ -1,76 +1,149 @@ { "code": 0, - "msg": "success", + "message": "操作成功", + "request_id": "351a5dcef3da43ebaca27bfeec606a9b.1793586299739", + "response_time": "2026-11-02 10:24:59", "data": { - "total": 3, + "total": "3", "list": [ { - "order_id": "LX-1001", - "platform_order_no": "PO-123456789", - "platform_code": 10008, + "global_order_no": "103351413752115712", + "original_global_order_no": null, + "reference_no": "1", "store_id": "1108413237731", - "order_status": "Shipped", - "buyer_name": "John Doe", - "country_code": "US", - "currency_code": "USD", - "order_total": "59.97", - "purchase_time": 1793001600, - "update_time": 1793088000, - "purchase_time_locale": "2026-10-26 08:00:00", - "update_time_locale": "2026-10-27 08:00:00", - "item_list": [ + "amount_currency": "USD", + "status": 6, + "delivery_type": 2, + "update_time": "1793088000", + "global_purchase_time": 1793001600, + "global_delivery_time": 0, + "item_info": [ { - "order_item_id": "ITEM-1", - "sku": "MSKU-RED-M", - "platform_sku": "SKU-RED-M", + "id": "8745387", + "global_item_no": "ITEM-1", + "order_item_no": "ITEM-1", + "msku": "SKU-RED-M", + "local_sku": "", + "product_no": "", + "local_product_name": "Red Shirt", "quantity": 2, - "item_price": "19.99", - "tax": "1.60", - "discount": "0.00" + "unit_price_amount": "19.99", + "item_price_amount": "39.98", + "discount_amount": "0.00", + "tax_amount": "1.60", + "platform_order_no": "PO-123456789" }, { - "order_item_id": "ITEM-2", - "sku": "MSKU-BLUE-L", + "id": "8745388", + "global_item_no": "ITEM-2", + "order_item_no": "ITEM-2", + "msku": "SKU-BLUE-L", + "local_sku": "", + "product_no": "", + "local_product_name": "Blue Shirt", "quantity": 1, - "item_price": "19.99", - "tax": "0.80", - "discount": "0.00" + "unit_price_amount": "19.99", + "item_price_amount": "19.99", + "discount_amount": "0.00", + "tax_amount": "0.80", + "platform_order_no": "PO-123456789" + } + ], + "platform_info": [ + { + "order_from": "线上订单", + "platform_order_no": "PO-123456789", + "platform_order_name": "PO-123456789", + "platform_code": "10008", + "store_Country_code": "US", + "status": "Shipped", + "payment_status": "paid", + "shipping_status": "fulfilled", + "purchase_time": 1793001600, + "delivery_time": 0 + } + ], + "transaction_info": [ + { + "order_item_amount": "59.97", + "discount_amount": "0.00", + "order_total_amount": "59.97" } ] }, { - "order_id": "LX-1002", - "platform_order_names": ["EBAY-2222", "EBAY-1111"], - "platform_code": 10003, + "global_order_no": "103351413752115713", "store_id": "1108413237731", - "order_status": "Paid", - "buyer_name": "Jane Roe", - "country_code": "US", - "currency_code": "USD", - "order_total": "15.00", - "purchase_time": 1793002000, - "update_time": 1793088000, - "item_list": [ + "amount_currency": "USD", + "status": 4, + "delivery_type": 2, + "update_time": "1793088000", + "global_purchase_time": 1793002000, + "item_info": [ { - "order_item_id": "ITEM-3", - "sku": "MSKU-GREEN-S", + "id": "8745390", + "global_item_no": "ITEM-3", + "order_item_no": "ITEM-3", + "msku": "MSKU-GREEN-S", + "local_sku": "", + "product_no": "", "quantity": 1, - "item_price": "15.00" + "unit_price_amount": "15.00", + "item_price_amount": "15.00", + "discount_amount": "0.00", + "tax_amount": "", + "platform_order_no": "EBAY-2222" + } + ], + "platform_info": [ + { + "platform_order_no": "EBAY-2222", + "platform_order_name": "EBAY-2222", + "platform_code": "10003", + "store_Country_code": "US", + "status": "Paid", + "payment_status": "paid", + "shipping_status": "", + "purchase_time": 1793002000, + "delivery_time": 0 + }, + { + "platform_order_no": "EBAY-1111", + "platform_order_name": "EBAY-1111", + "platform_code": "10003", + "store_Country_code": "US", + "status": "Paid", + "payment_status": "paid", + "shipping_status": "", + "purchase_time": 1793002000, + "delivery_time": 0 + } + ], + "transaction_info": [ + { + "order_item_amount": "¥15.00", + "discount_amount": "¥0.00", + "order_total_amount": "¥15.00" } ] }, { - "order_id": "LX-1003", - "platform_code": 10011, + "global_order_no": "LX-1003", "store_id": "1108413237731", - "order_status": "Unpaid", - "buyer_name": "No Platform No", - "country_code": "GB", - "currency_code": "GBP", - "order_total": "10.00", - "purchase_time": 1793003000, - "update_time": 1793088000, - "item_list": [] + "amount_currency": "GBP", + "status": 3, + "delivery_type": 2, + "update_time": "1793088000", + "global_purchase_time": 1793003000, + "item_info": [], + "platform_info": [], + "transaction_info": [ + { + "order_item_amount": "10.00", + "discount_amount": "0.00", + "order_total_amount": "10.00" + } + ] } ] }