diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java index fe70aca..002d23a 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java @@ -26,6 +26,12 @@ public enum LingxingApi { /** 亚马逊 SC Listing 列表。POST,offset/length 分页,上限 1000。 */ LISTING_AMAZON_SC("/erp/sc/data/mws/listing", 1), + /** 亚马逊 VC 店铺列表。POST,offset/length 分页(上限 200)。 */ + SHOP_LIST_AMAZON_VC("/basicOpen/platformAuth/vcSeller/pageList", 1), + + /** 亚马逊 VC Listing 列表。POST,offset/length 分页(上限 200)。 */ + LISTING_AMAZON_VC("/basicOpen/listingManage/vcListing/pageList", 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 b31e11f..012bfea 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSubPlatforms.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSubPlatforms.java @@ -32,6 +32,8 @@ public final class LingxingSubPlatforms { register(map, new WalmartSubPlatform(SHARED_TRANSPORT, SHARED_JSON)); register(map, new common.ecommerce.lingxing.platform.amazon.AmazonScSubPlatform( SHARED_TRANSPORT, SHARED_JSON)); + register(map, new common.ecommerce.lingxing.platform.amazon.vc.AmazonVcSubPlatform( + SHARED_TRANSPORT, SHARED_JSON)); // eBay、SHEIN… 落地后继续 register(...) BY_PLATFORM = Collections.unmodifiableMap(map); } diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/AmazonVcProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/AmazonVcProductSource.java new file mode 100644 index 0000000..32607fc --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/AmazonVcProductSource.java @@ -0,0 +1,101 @@ +package common.ecommerce.lingxing.platform.amazon.vc; + +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.amazon.vc.dto.AmazonVcListingDto; +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.support.Page; +import common.ecommerce.model.support.PlatformTime; + +import java.time.Instant; +import java.time.LocalDate; +import java.time.ZoneId; +import java.time.format.DateTimeFormatter; +import java.time.format.DateTimeParseException; +import java.util.ArrayList; +import java.util.Collections; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +/** + * 领星 · 亚马逊 VC 商品 / Listing 列表。 + * + *
接口 {@code /basicOpen/listingManage/vcListing/pageList}:POST, + * {@code offset}/{@code length} 分页(上限 200),{@code vc_store_ids} 为数组; + * 令牌桶容量 1。
+ * + *注意:该接口不支持按时间窗过滤,只能全量翻页后由调用方比对。
+ */ +public final class AmazonVcProductSource implements LingxingProductSource { + + private static final int MAX_PAGE_SIZE = 200; + + /** on_sale_time 是 Y-m-d 日期。 */ + private static final DateTimeFormatter DATE = DateTimeFormatter.ofPattern("yyyy-MM-dd"); + + @Override + public Page接口 {@code /basicOpen/platformAuth/vcSeller/pageList}:POST,{@code offset}/{@code length} + * 分页,{@code length} 上限 200,令牌桶容量 1。
+ */ +public final class AmazonVcShopSource implements LingxingShopSource { + + /** 领星侧 Amazon VC 的 platform_code。 */ + private static final int AMAZON_VC_PLATFORM_CODE = 10035; + + /** 店铺授权服务状态:1 = 正常同步。 */ + private static final int STATUS_ACTIVE = 1; + + private static final int MAX_PAGE_SIZE = 200; + + @Override + public List只保留映射到统一模型所需的字段。VC 的 SKU 字段是 {@code msku}(平台侧), + * 本地 SKU 是 {@code local_sku},对齐直连时应优先用 {@code msku}。
+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class AmazonVcListingDto { + + /** VC 店铺 id。 */ + @JsonProperty("vc_store_id") + private String vcStoreId; + + /** 在线商品缩略图地址。 */ + @JsonProperty("small_min_image_url") + private String smallMinImageUrl; + + /** ASIN。 */ + @JsonProperty("asin") + private String asin; + + /** 平台 SKU(MSKU),参与 canonicalKey。 */ + @JsonProperty("msku") + private String msku; + + /** 标题。 */ + @JsonProperty("item_name") + private String itemName; + + /** 父 ASIN,可能为空串。 */ + @JsonProperty("parent_asin") + private String parentAsin; + + /** 本地 SKU。 */ + @JsonProperty("local_sku") + private String localSku; + + /** 本地品名。 */ + @JsonProperty("local_name") + private String localName; + + /** 在线商品状态:-1 已删除,0 停售,1 在售。 */ + @JsonProperty("status") + private Integer status; + + /** 优惠金额。 */ + @JsonProperty("price") + private String price; + + /** 优惠金额货币符号,如 $。 */ + @JsonProperty("price_currency_icon") + private String priceCurrencyIcon; + + /** 开售时间,格式 {@code Y-m-d}。 */ + @JsonProperty("on_sale_time") + private String onSaleTime; + + /** 备注。 */ + @JsonProperty("remark") + private String remark; +} diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/dto/AmazonVcShopDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/dto/AmazonVcShopDto.java new file mode 100644 index 0000000..7d64aaa --- /dev/null +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/dto/AmazonVcShopDto.java @@ -0,0 +1,53 @@ +package common.ecommerce.lingxing.platform.amazon.vc.dto; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; +import lombok.Setter; + +/** + * 领星 · 亚马逊 VC 店铺({@code /basicOpen/platformAuth/vcSeller/pageList} 的 {@code data[]})。 + * + *唯一键 {@code vc_store_id},后续查 VC Listing 时用它指定店铺。
+ */ +@Getter +@Setter +@JsonIgnoreProperties(ignoreUnknown = true) +public class AmazonVcShopDto { + + /** 账号 ID。 */ + @JsonProperty("account_id") + private Long accountId; + + /** SELLER_ID。 */ + @JsonProperty("seller_id") + private String sellerId; + + /** 账号名称。 */ + @JsonProperty("account_name") + private String accountName; + + /** 站点简称,如 na。 */ + @JsonProperty("region") + private String region; + + /** 站点名称,如 北美洲。 */ + @JsonProperty("region_name") + private String regionName; + + /** VC 店铺 id,后续接口的入参。 */ + @JsonProperty("vc_store_id") + private String vcStoreId; + + /** 店铺名称。 */ + @JsonProperty("name") + private String name; + + /** 店铺授权服务状态:-1 删除,0 暂停同步,1 正常同步,2 授权异常。 */ + @JsonProperty("status") + private Integer status; + + /** 站点 id。 */ + @JsonProperty("mid") + private Integer mid; +}