diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java index ee149f2..8cd38e4 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java @@ -26,6 +26,9 @@ public enum LingxingApi { /** 亚马逊 VC 店铺列表。POST,offset/length 分页,上限 200。 */ SHOP_LIST_AMAZON_VC("/basicOpen/platformAuth/vcSeller/pageList", 1), + /** 多平台店铺信息。POST,offset/length 分页,上限 200;可按 platform_code 过滤。 */ + SHOP_LIST_MULTI_PLATFORM("/pb/mp/shop/v2/getSellerList", 10), + /** 亚马逊 VC 订单列表(DF / PO / DI)。POST,offset/length 分页,上限 200。 */ ORDER_LIST_AMAZON_VC("/basicOpen/platformOrder/vcOrder/pageList", 1), @@ -38,6 +41,9 @@ public enum LingxingApi { /** 亚马逊 SC Listing 列表。POST,offset/length 分页,上限 1000。 */ LISTING_AMAZON_SC("/erp/sc/data/mws/listing", 1), + /** Walmart 在线商品。POST,offset/length 分页,上限 200,时间窗 ≤31 天。 */ + LISTING_WALMART("/basicOpen/multiplatform/walmart/list", 1), + /** * 亚马逊 SC 订单列表。POST,offset/length 分页,length 上限 5000; * 查询时间窗不超过 1 年。 diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java index f7fde15..d12cfed 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java @@ -51,6 +51,14 @@ public final class LingxingConstants { /** 亚马逊 VC 订单查询时间跨度上限:90 天。 */ public static final int VC_MAX_QUERY_DAYS = 90; + /** 多平台店铺列表分页 length 上限。 */ + public static final int MULTI_PLATFORM_MAX_PAGE_SIZE = 200; + + /** Walmart 在线商品分页 length 上限。 */ + public static final int WALMART_MAX_PAGE_SIZE = 200; + /** Walmart 在线商品查询时间跨度上限:31 天。 */ + public static final int WALMART_MAX_QUERY_DAYS = 31; + /** 结算交易明细分页 length 上限。 */ public static final int SETTLEMENT_MAX_PAGE_SIZE = 10000; /** 结算时间查询跨度上限:7 天(双闭区间)。 */ diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/dto/MultiPlatformShopDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/dto/MultiPlatformShopDto.java new file mode 100644 index 0000000..66d6c05 --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/dto/MultiPlatformShopDto.java @@ -0,0 +1,49 @@ +package common.ecommerce.lingxing.platform.multiplatform.dto; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; +import lombok.Setter; + +/** + * 领星 · 多平台店铺({@code /pb/mp/shop/v2/getSellerList} 的 {@code data.list[]})。 + * + *
{@code store_id} 是多平台店铺唯一键;{@code sid} 只有亚马逊店铺才有意义。
+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class MultiPlatformShopDto { + + /** 店铺 ID,多平台唯一键。 */ + @JsonProperty("store_id") + private String storeId; + + /** 亚马逊店铺 sid,非亚马逊平台为空。 */ + @JsonProperty("sid") + private String sid; + + /** 店铺名称。 */ + @JsonProperty("store_name") + private String storeName; + + /** 平台 code;响应里可能是字符串,用 Integer 接收。 */ + @JsonProperty("platform_code") + private Integer platformCode; + + /** 平台名称,如 Walmart。 */ + @JsonProperty("platform_name") + private String platformName; + + /** 店铺币种。 */ + @JsonProperty("currency") + private String currency; + + /** 店铺同步状态:1 启用、0 停用。 */ + @JsonProperty("is_sync") + private Integer isSync; + + /** 店铺授权状态:1 正常授权、0 授权失败。 */ + @JsonProperty("status") + private Integer status; +} diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/shop/MultiPlatformShopSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/shop/MultiPlatformShopSource.java new file mode 100644 index 0000000..5eb3d2d --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/shop/MultiPlatformShopSource.java @@ -0,0 +1,83 @@ +package common.ecommerce.lingxing.platform.multiplatform.shop; + +import common.ecommerce.capability.AggregatorCapable.SubChannel; +import common.ecommerce.http.HttpRequest; +import common.ecommerce.http.HttpResponse; +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.lingxing.LingxingConstants; +import common.ecommerce.lingxing.http.LingxingEnvelope; +import common.ecommerce.lingxing.platform.LingxingCall; +import common.ecommerce.lingxing.platform.multiplatform.dto.MultiPlatformShopDto; +import common.ecommerce.lingxing.platform.shop.LingxingShopSource; +import common.ecommerce.model.Platform; +import common.ecommerce.model.account.ChannelAccount; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** + * 领星 · 多平台店铺列表。 + * + *接口 {@code /pb/mp/shop/v2/getSellerList}:POST,{@code offset}/{@code length} + * 分页(上限 200),令牌桶 10 req/s。
+ * + *只返回当前账户 {@code platformCode} 对应的店铺,并过滤为「启用 + 正常授权」。 + * 响应结构是 {@code data.list[]} + {@code data.total}。
+ */ +public final class MultiPlatformShopSource implements LingxingShopSource { + + private static final int SYNC_ENABLED = 1; + private static final int STATUS_AUTHORIZED = 1; + + private static final String OP = "shops.list.multi"; + + @Override + public List订单复用领星多平台统一接口;店铺用多平台店铺接口(按 platform_code=10008 过滤); + * 商品用 Walmart 在线商品接口。
*/ public final class WalmartSubPlatform implements LingxingSubPlatform { private final LingxingOrderSource orders; + private final LingxingProductSource products; + private final LingxingShopSource shops; public WalmartSubPlatform(HttpTransport transport, JacksonJsonCodec json) { this.orders = new WalmartOrderSource(transport, json); + this.products = new WalmartProductSource(); + this.shops = new MultiPlatformShopSource(); } @Override @@ -27,4 +38,14 @@ public final class WalmartSubPlatform implements LingxingSubPlatform { public LingxingOrderSource orderSource() { return orders; } + + @Override + public LingxingProductSource productSource() { + return products; + } + + @Override + public LingxingShopSource shopSource() { + return shops; + } } diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/walmart/dto/WalmartListingDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/walmart/dto/WalmartListingDto.java new file mode 100644 index 0000000..5d2aa28 --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/walmart/dto/WalmartListingDto.java @@ -0,0 +1,99 @@ +package common.ecommerce.lingxing.platform.walmart.dto; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; +import lombok.Setter; + +/** + * 领星 · Walmart 在线商品 + * ({@code /basicOpen/multiplatform/walmart/list} 的 {@code data[]} / {@code data.list[]})。 + * + *平台 SKU 是 {@code msku};{@code item_id} 是 Walmart 商品 ID。
+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class WalmartListingDto { + + /** 产品跳转链接。 */ + @JsonProperty("item_url") + private String itemUrl; + + /** Walmart 商品 ID。 */ + @JsonProperty("item_id") + private String itemId; + + /** 图片链接。 */ + @JsonProperty("picture_url") + private String pictureUrl; + + /** 平台 MSKU,参与 canonicalKey。 */ + @JsonProperty("msku") + private String msku; + + @JsonProperty("title") + private String title; + + /** 领星本地品名。 */ + @JsonProperty("local_name") + private String localName; + + /** 领星本地 SKU。 */ + @JsonProperty("local_sku") + private String localSku; + + /** 状态名:PUBLISHED / READY TO PUBLISH / IN PROGRESS / UNPUBLISHED 等。 */ + @JsonProperty("status_name") + private String statusName; + + @JsonProperty("store_id") + private String storeId; + + @JsonProperty("store_name") + private String storeName; + + @JsonProperty("currency_icon") + private String currencyIcon; + + @JsonProperty("price") + private String price; + + /** 非 WFS 可售数量。 */ + @JsonProperty("available_quantity") + private Integer availableQuantity; + + /** WFS 可售数量。 */ + @JsonProperty("wfs_available_quantity") + private Integer wfsAvailableQuantity; + + @JsonProperty("buy_box_price") + private String buyBoxPrice; + + @JsonProperty("gtin") + private String gtin; + + @JsonProperty("upc") + private String upc; + + @JsonProperty("brand") + private String brand; + + /** 发货方式:0 WFS Eligible、1 Walmart Fulfilled、2 Seller Fulfilled。 */ + @JsonProperty("fulfillment_type") + private Integer fulfillmentType; + + @JsonProperty("fulfillment_type_name") + private String fulfillmentTypeName; + + /** 创建时间。 */ + @JsonProperty("listing_start_time") + private String listingStartTime; + + /** 销售结束时间。 */ + @JsonProperty("listing_end_time") + private String listingEndTime; + + @JsonProperty("variant_unique_id") + private String variantUniqueId; +} diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSource.java new file mode 100644 index 0000000..705093b --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSource.java @@ -0,0 +1,146 @@ +package common.ecommerce.lingxing.platform.walmart.product; + +import common.ecommerce.http.HttpRequest; +import common.ecommerce.http.HttpResponse; +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.lingxing.LingxingConstants; +import common.ecommerce.lingxing.http.LingxingEnvelope; +import common.ecommerce.lingxing.platform.LingxingCall; +import common.ecommerce.lingxing.platform.product.LingxingProductSource; +import common.ecommerce.lingxing.platform.walmart.dto.WalmartListingDto; +import common.ecommerce.model.ChannelProvider; +import common.ecommerce.model.account.ChannelAccount; +import common.ecommerce.model.product.ProductListing; +import common.ecommerce.model.product.ProductQuery; +import common.ecommerce.model.support.Page; +import common.ecommerce.model.support.PlatformTime; + +import java.time.Instant; +import java.time.LocalDate; +import java.time.LocalDateTime; +import java.time.ZoneId; +import java.time.format.DateTimeFormatter; +import java.time.temporal.ChronoUnit; +import java.util.ArrayList; +import java.util.Collections; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** + * 领星 · Walmart 在线商品。 + * + *接口 {@code /basicOpen/multiplatform/walmart/list}:POST,{@code offset}/{@code length} + * 分页(上限 200),令牌桶 1 req/s;时间窗按「创建时间 / 更新时间」过滤,最多 31 天。
+ * + *响应有两种形态:文档字段树写 {@code data.list[]},示例又给 {@code data[]}, + * 这里先按 {@code data.list} 解析,为空再回退 {@code data},两种都能吃。
+ * + *时区待核对:{@code listing_start_time}/{@code listing_end_time} 只到日期且未标时区, + * 这里按领星系统时间(北京时间)换算。
+ */ +public final class WalmartProductSource implements LingxingProductSource { + + private static final DateTimeFormatter DATE = DateTimeFormatter.ofPattern("yyyy-MM-dd"); + + /** 文档未注明时区,按 ERP 系统时间(北京时间)解释,待真实报文核对。 */ + private static final ZoneId SYSTEM_ZONE = PlatformTime.BEIJING_ZONE; + + /** listing_time_field:2 = 更新时间。 */ + private static final int TIME_FIELD_UPDATE = 2; + + private static final String OP = "products.pull.walmart"; + + @Override + public Page店铺来自 {@code /pb/mp/shop/v2/getSellerList},商品来自 + * {@code /basicOpen/multiplatform/walmart/list}。
+ */ + @Test + void listsWalmartShopsAndProducts() { + requireCredentials(); + LingxingAdapter adapter = adapter(); + + ChannelAccount discovery = walmartAccount("0"); + ListVC 详情分 DF / PO 两个接口,{@code get()} 会先按订单编号查出类型再分派。
@@ -369,6 +416,10 @@ 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); + } + private ChannelAccount account(Platform platform, int platformCode, String storeId) { return ChannelAccount.builder() .key(AccountKey.of(ChannelProvider.LINGXING, platform, "oms-smoke-001"))