diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java index 90e05bd..4572f17 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java @@ -41,6 +41,9 @@ public enum LingxingApi { /** Shopify 在线商品(变体维度)。POST,offset/length(上限 1000),返回 data.list。 */ LISTING_SHOPIFY("/basicOpen/multiplatform/shopify/variantList", 1), + /** eBay 在线商品。POST,offset/length(上限 200),返回 data 数组。 */ + LISTING_EBAY("/basicOpen/multiplatform/ebay/list", 1), + /** 多平台订单列表;当前实现使用的跨平台接口。 */ ORDER_LIST("/pb/mp/order/v2/list", 10); diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSubPlatforms.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSubPlatforms.java index e6c028f..c4d681f 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSubPlatforms.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSubPlatforms.java @@ -38,7 +38,9 @@ public final class LingxingSubPlatforms { SHARED_TRANSPORT, SHARED_JSON)); register(map, new common.ecommerce.lingxing.platform.shopify.ShopifySubPlatform( SHARED_TRANSPORT, SHARED_JSON)); - // eBay、SHEIN… 落地后继续 register(...) + register(map, new common.ecommerce.lingxing.platform.ebay.EbaySubPlatform( + SHARED_TRANSPORT, SHARED_JSON)); + // SHEIN… 落地后继续 register(...) BY_PLATFORM = Collections.unmodifiableMap(map); } diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/EbaySubPlatform.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/EbaySubPlatform.java new file mode 100644 index 0000000..9a46c47 --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/EbaySubPlatform.java @@ -0,0 +1,30 @@ +package common.ecommerce.lingxing.platform.ebay; + +import common.ecommerce.http.HttpTransport; +import common.ecommerce.http.JacksonJsonCodec; +import common.ecommerce.lingxing.platform.LingxingSubPlatform; +import common.ecommerce.lingxing.platform.ebay.product.EbayProductSource; +import common.ecommerce.lingxing.platform.product.LingxingProductSource; +import common.ecommerce.model.Platform; + +/** + * 领星 · eBay 子平台:只做能力组合。 + */ +public final class EbaySubPlatform implements LingxingSubPlatform { + + private final LingxingProductSource products; + + public EbaySubPlatform(HttpTransport transport, JacksonJsonCodec json) { + this.products = new EbayProductSource(); + } + + @Override + public Platform platform() { + return Platform.EBAY; + } + + @Override + public LingxingProductSource productSource() { + return products; + } +} diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/dto/EbayAutoRestockDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/dto/EbayAutoRestockDto.java new file mode 100644 index 0000000..947d71a --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/dto/EbayAutoRestockDto.java @@ -0,0 +1,61 @@ +package common.ecommerce.lingxing.platform.ebay.dto; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; +import lombok.Setter; + +/** eBay 自动补货规则({@code product_auto_restock_response})。 */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class EbayAutoRestockDto { + + /** 商品变体唯一 ID(雪花 ID)。 */ + @JsonProperty("variantUniqueId") + private String variantUniqueId; + + /** 补货类型:1 固定值 / 2 指定仓库。 */ + @JsonProperty("type") + private Integer type; + + /** 补货类型名。 */ + @JsonProperty("typeName") + private String typeName; + + /** 同步间隔:1 每30分钟 / 2 每1小时 / 3 每6小时 / 4 每12小时 / 5 每24小时。 */ + @JsonProperty("syncIntervalTime") + private Integer syncIntervalTime; + + /** 同步间隔名。 */ + @JsonProperty("syncIntervalTimeName") + private String syncIntervalTimeName; + + /** 是否自动补货:0 未设置 / 1 启用 / 2 停用。 */ + @JsonProperty("autoRestock") + private Integer autoRestock; + + /** 是否自动补货名。 */ + @JsonProperty("autoRestockName") + private String autoRestockName; + + /** 停用原因:1 手动 / 2 自动。 */ + @JsonProperty("disableReason") + private Integer disableReason; + + /** 停用原因名。 */ + @JsonProperty("disableReasonName") + private String disableReasonName; + + /** 自动停用具体原因。 */ + @JsonProperty("autoDisableReason") + private String autoDisableReason; + + /** 补货数量。 */ + @JsonProperty("restockQuantity") + private String restockQuantity; + + /** 补货仓库 ID。 */ + @JsonProperty("restockWarehouseId") + private String restockWarehouseId; +} diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/dto/EbayListingDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/dto/EbayListingDto.java new file mode 100644 index 0000000..e91e35e --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/dto/EbayListingDto.java @@ -0,0 +1,123 @@ +package common.ecommerce.lingxing.platform.ebay.dto; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; +import lombok.Setter; + +/** + * 领星 · eBay 在线商品({@code /basicOpen/multiplatform/ebay/list} 的 {@code data[]})。 + * + *
注意:响应是 {@code data} 数组(不是 {@code data.list}),总数在顶层 {@code total}。
+ * + *{@code msku} 可能为空串;此时应回落到 {@code item_id} 作为商品标识。
+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class EbayListingDto { + + /** 商品跳转链接。 */ + @JsonProperty("item_url") + private String itemUrl; + + /** 图片链接。 */ + @JsonProperty("picture_url") + private String pictureUrl; + + /** 商品 ID。 */ + @JsonProperty("item_id") + private String itemId; + + /** 平台侧 MSKU,可能为空串。 */ + @JsonProperty("msku") + private String msku; + + /** 变体属性,如 Black/Regular/S。 */ + @JsonProperty("attribute") + private String attribute; + + /** 标题。 */ + @JsonProperty("title") + private String title; + + /** 本地品名。 */ + @JsonProperty("local_name") + private String localName; + + /** 本地 SKU。 */ + @JsonProperty("local_sku") + private String localSku; + + /** 销售状态值。 */ + @JsonProperty("listing_status") + private Integer listingStatus; + + /** 销售状态名,如「在售」。 */ + @JsonProperty("listing_status_name") + private String listingStatusName; + + /** 店铺 id。 */ + @JsonProperty("store_id") + private String storeId; + + /** 店铺名称。 */ + @JsonProperty("store_name") + private String storeName; + + /** 站点 code,如 10003-US。 */ + @JsonProperty("site_code") + private String siteCode; + + /** 站点名称,如「美国」。 */ + @JsonProperty("site_name") + private String siteName; + + /** 销售类型:1 拍卖 / 2 固价 / 3 多属性。 */ + @JsonProperty("listing_type") + private Integer listingType; + + /** 销售类型名称。 */ + @JsonProperty("listing_type_name") + private String listingTypeName; + + /** 价格,接口不返回币种。 */ + @JsonProperty("price") + private String price; + + /** 起拍价。 */ + @JsonProperty("start_price") + private String startPrice; + + /** 一口价。 */ + @JsonProperty("accept_price") + private String acceptPrice; + + /** 库存。 */ + @JsonProperty("quantity") + private Integer quantity; + + /** 是否自动补货。 */ + @JsonProperty("auto_restock") + private String autoRestock; + + /** 自动补货规则详情。 */ + @JsonProperty("product_auto_restock_response") + private EbayAutoRestockDto productAutoRestockResponse; + + /** 物品所在地。 */ + @JsonProperty("location") + private String location; + + /** 处理时间。 */ + @JsonProperty("dispatch_time_max") + private Integer dispatchTimeMax; + + /** 创建时间,格式 Y-m-d H:i:s。 */ + @JsonProperty("listing_start_time") + private String listingStartTime; + + /** 结束时间,格式 Y-m-d H:i:s。 */ + @JsonProperty("listing_end_time") + private String listingEndTime; +} diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSource.java new file mode 100644 index 0000000..4ee31fc --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSource.java @@ -0,0 +1,208 @@ +package common.ecommerce.lingxing.platform.ebay.product; + +import common.ecommerce.http.HttpRequest; +import common.ecommerce.http.HttpResponse; +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.lingxing.http.LingxingEnvelope; +import common.ecommerce.lingxing.platform.LingxingCall; +import common.ecommerce.lingxing.platform.ebay.dto.EbayListingDto; +import common.ecommerce.lingxing.platform.product.LingxingProductSource; +import common.ecommerce.model.ChannelProvider; +import common.ecommerce.model.product.ProductListing; +import common.ecommerce.model.product.ProductQuery; +import common.ecommerce.model.product.ProductStatus; +import common.ecommerce.model.support.Money; +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.util.ArrayList; +import java.util.Collections; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** + * 领星 · eBay 在线商品。 + * + *接口 {@code /basicOpen/multiplatform/ebay/list}:POST,{@code offset}/{@code length} + * (上限 200),返回 {@code data} 数组;令牌桶容量 1。
+ * + *时间过滤精度为 {@code Y-m-d}(站点时间),区间不超过 31 天。
+ */ +public final class EbayProductSource implements LingxingProductSource { + + private static final int MAX_PAGE_SIZE = 200; + + /** 查询时间类型:1 创建时间(默认)。 */ + private static final int TIME_FIELD_CREATE = 1; + + /** 接口要求时间区间不超过 31 天。 */ + private static final int MAX_QUERY_DAYS = 31; + + private static final DateTimeFormatter DATE = DateTimeFormatter.ofPattern("yyyy-MM-dd"); + private static final DateTimeFormatter DATE_TIME = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"); + + @Override + public Page统一字段来源:
+ *