Browse Source

fix(lingxing): 按真实响应重写订单 DTO 与字段映射

真实 /pb/mp/order/v2/list 响应与文档摘录不一致,原 DTO 字段名全部落空,
channelOrderId 为 null,导致 SalesOrder 构造抛 NPE。

- 订单字段改为 global_order_no / amount_currency / status /
  item_info / platform_info / transaction_info
- 平台单号从 platform_info[] 取,合并单排序后取第一个,保证 canonicalKey 稳定
- 收货国家取 platform_info[].store_Country_code
- 下单时间取 global_purchase_time,缺失时回落 platform_info[].purchase_time
- 金额清洗币种符号与千分位(¥49.16 → 49.16)
- 夹具与映射测试按真实结构重写
feature/supplier-lingxing
lml 3 weeks ago
parent
commit
703694c3df
  1. 158
      lingxing/src/main/java/common/ecommerce/lingxing/LingxingOrderMapper.java
  2. 93
      lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderDto.java
  3. 61
      lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderItemDto.java
  4. 54
      lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingPlatformInfoDto.java
  5. 30
      lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingTransactionInfoDto.java
  6. 49
      lingxing/src/test/java/common/ecommerce/lingxing/LingxingOrderMapperTest.java
  7. 173
      lingxing/src/test/resources/fixtures/lingxing/orderList/success.json

158
lingxing/src/main/java/common/ecommerce/lingxing/LingxingOrderMapper.java

@ -3,24 +3,35 @@ package common.ecommerce.lingxing; @@ -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;
/**
* 领星订单 → 统一模型。
*
* <p>领星订单是唯一的映射入口,平台差异全部收敛在这里。</p>
*
* <p>字段来源({@code /pb/mp/order/v2/list}):</p>
* <ul>
* <li>平台单号:{@code platform_info[].platform_order_no},缺失时用
* {@code platform_order_name},再缺失用 {@code global_order_no}</li>
* <li>收货国家:{@code platform_info[].store_Country_code}</li>
* <li>订单总额:{@code transaction_info[].order_total_amount},币种取
* {@code amount_currency}</li>
* <li>下单时间:{@code global_purchase_time},缺失时回落
* {@code platform_info[].purchase_time}</li>
* </ul>
*/
public final class LingxingOrderMapper {
@ -31,35 +42,49 @@ 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<OrderLine> lines = new ArrayList<OrderLine>();
for (LingxingOrderItemDto item : safe(dto.getItemList())) {
List<LingxingOrderItemDto> 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 { @@ -69,44 +94,95 @@ public final class LingxingOrderMapper {
/**
* channelOrderId 是 canonicalKey 的一部分,必须稳定。
*
* <p>优先平台单号;缺失时退回领星 order_id(此时跨 provider 无法去重,
* 会由 DuplicateOrderGuard 记录差异)。</p>
* <p>优先平台单号;合并单会有多个平台单号,排序后取第一个,保证多次同步得到同一个 key。
* 都没有时退回领星系统单号(此时跨 provider 无法去重,由 DuplicateOrderGuard 记录差异)。</p>
*/
static String resolveChannelOrderId(LingxingOrderDto dto) {
if (dto.getPlatformOrderNo() != null && !dto.getPlatformOrderNo().trim().isEmpty()) {
return dto.getPlatformOrderNo().trim();
List<String> platformOrderNos = new ArrayList<String>();
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<String> names = dto.getPlatformOrderNames();
if (names != null && !names.isEmpty()) {
List<String> sorted = new ArrayList<String>(names);
Collections.sort(sorted, new Comparator<String>() {
@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<LingxingOrderDto> 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 <T> List<T> safe(List<T> in) {
return in == null ? Collections.<T>emptyList() : in;
}
private static Money moneyOrNull(String value, String currency) {
if (value == null || value.trim().isEmpty()) {
private static <T> T first(List<T> 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;
}
}

93
lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderDto.java

@ -9,74 +9,71 @@ import java.util.ArrayList; @@ -9,74 +9,71 @@ import java.util.ArrayList;
import java.util.List;
/**
* 领星多平台订单列表条目。
* 领星多平台订单列表条目({@code /pb/mp/order/v2/list} 的 {@code data.list[]})。
*
* <p><b>待核对</b>:字段名依据领星 OpenAPI 文档摘录,联调时以官方最新文档
* 与真实响应为准;调整集中在本 DTO 与 {@code LingxingOrderMapper}。</p>
*
* <p>纯数据容器,使用 Lombok 生成访问器;不承载任何业务不变量。</p>
* <p>字段名以 2026-10 官方文档与真实响应为准。几个容易踩的点:</p>
* <ul>
* <li>平台单号不在顶层,在 {@code platform_info[]} 里;合并单可能有多条</li>
* <li>币种是 {@code amount_currency},不是 {@code currency_code}</li>
* <li>金额字段可能带币种符号(如 {@code "¥49.16"}),DTO 保持原样,由 mapper 清洗</li>
* <li>{@code update_time} 文档类型是 string,值是 epoch 秒字符串</li>
* </ul>
*/
@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<String> platformOrderNames = new ArrayList<String>();
/** 补发/换货的原系统单号。 */
@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<LingxingOrderItemDto> itemInfo = new ArrayList<LingxingOrderItemDto>();
/** 站点本地更新时间字符串。 */
@JsonProperty("update_time_locale")
private String updateTimeLocale;
/** 平台单信息;合并单一个系统单号可能对应多条。 */
@JsonProperty("platform_info")
private List<LingxingPlatformInfoDto> platformInfo = new ArrayList<LingxingPlatformInfoDto>();
@JsonProperty("item_list")
private List<LingxingOrderItemDto> itemList = new ArrayList<LingxingOrderItemDto>();
/** 交易信息。 */
@JsonProperty("transaction_info")
private List<LingxingTransactionInfoDto> transactionInfo =
new ArrayList<LingxingTransactionInfoDto>();
}

61
lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderItemDto.java

@ -6,35 +6,64 @@ import lombok.Getter; @@ -6,35 +6,64 @@ import lombok.Getter;
import lombok.Setter;
/**
* 领星订单明细行。字段名待官方文档核对。
* 领星订单明细行({@code data.list[].item_info[]})。
*
* <p>纯数据容器,使用 Lombok 生成访问器。</p>
* <p>SKU 语义:{@code msku} 是平台侧 SKU,{@code local_sku} 是领星本地 SKU。
* 对齐直连渠道时应优先用 {@code msku}。</p>
*/
@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;
}

54
lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingPlatformInfoDto.java

@ -0,0 +1,54 @@ @@ -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[]})。
*
* <p>注意 {@code platform_code} 在这里是<b>字符串</b>(如 {@code "10008"}),
* 而请求参数里是整数数组。</p>
*/
@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;
}

30
lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingTransactionInfoDto.java

@ -0,0 +1,30 @@ @@ -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[]})。
*
* <p>金额是带币种符号的字符串(如 {@code "¥49.16"}),由 mapper 清洗后再转
* {@link common.ecommerce.model.support.Money}。</p>
*/
@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;
}

49
lingxing/src/test/java/common/ecommerce/lingxing/LingxingOrderMapperTest.java

@ -1,9 +1,9 @@ @@ -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; @@ -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 { @@ -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 { @@ -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

173
lingxing/src/test/resources/fixtures/lingxing/orderList/success.json

@ -1,76 +1,149 @@ @@ -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"
}
]
}
]
}

Loading…
Cancel
Save