Browse Source
沃尔玛商品(/basicOpen/multiplatform/walmart/list, POST, qps 1, 上限 200): - WalmartListingDto:34 个字段全覆盖(文档标注均为必填) - WalmartProductSource:store_ids 传数组;时间窗按 Y-m-d,字段类型取更新时间(2), 超 31 天截断;响应在 data.list - 映射:msku→platformSku、item_id→listingId、gtin/upc→gtin、picture_url→imageUrls、 status_name 按名称归一、price + currency_icon 反推币种、 offer_start_date→listedAt、listing_start_time→updatedAt - 其余字段全部进 attributes - WalmartSubPlatform 注册 productSource 店铺列表: - 移除 SC / VC 的 status != 1 过滤,SDK 只转发 - 调用方按 SubChannel.status() 自行决定可用性 Co-Authored-By: Claude <noreply@anthropic.com>feature/supplier-lingxing
6 changed files with 445 additions and 9 deletions
@ -0,0 +1,160 @@
@@ -0,0 +1,160 @@
|
||||
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; |
||||
|
||||
/** |
||||
* 领星 · 沃尔玛在线商品({@code /basicOpen/multiplatform/walmart/list} 的 {@code data.list[]})。 |
||||
* |
||||
* <p>字段名以官方文档为准。注意响应外层是 {@code data.list},不是 {@code data}。</p> |
||||
* |
||||
* <p>SKU 语义:{@code msku} 是平台侧 MSKU,{@code local_sku} 是领星本地 SKU, |
||||
* 对齐时应优先用 {@code msku}。</p> |
||||
*/ |
||||
@Getter |
||||
@Setter |
||||
@JsonIgnoreProperties(ignoreUnknown = true) |
||||
public class WalmartListingDto { |
||||
|
||||
/** 平台商品 ID。 */ |
||||
@JsonProperty("item_id") |
||||
private String itemId; |
||||
|
||||
/** 商品跳转链接。 */ |
||||
@JsonProperty("item_url") |
||||
private String itemUrl; |
||||
|
||||
/** 图片链接。 */ |
||||
@JsonProperty("picture_url") |
||||
private String pictureUrl; |
||||
|
||||
/** 平台 SKU(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 / STAGE / SYSTEM PROBLEM。 */ |
||||
@JsonProperty("status_name") |
||||
private String statusName; |
||||
|
||||
/** 店铺 ID。 */ |
||||
@JsonProperty("store_id") |
||||
private String storeId; |
||||
|
||||
/** 店铺名。 */ |
||||
@JsonProperty("store_name") |
||||
private String storeName; |
||||
|
||||
/** 货币符号,注意不是 ISO 代码。 */ |
||||
@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; |
||||
|
||||
/** Buy Box 价格。 */ |
||||
@JsonProperty("buy_box_price") |
||||
private String buyBoxPrice; |
||||
|
||||
/** Buy Box 运费。 */ |
||||
@JsonProperty("buy_box_shipping_price") |
||||
private String buyBoxShippingPrice; |
||||
|
||||
/** GTIN。 */ |
||||
@JsonProperty("gtin") |
||||
private String gtin; |
||||
|
||||
/** UPC。 */ |
||||
@JsonProperty("upc") |
||||
private String upc; |
||||
|
||||
/** 商品税号。 */ |
||||
@JsonProperty("product_tax_code") |
||||
private String productTaxCode; |
||||
|
||||
/** 销售开始时间,格式 Y-m-d H:i:s。 */ |
||||
@JsonProperty("offer_start_date") |
||||
private String offerStartDate; |
||||
|
||||
/** 销售结束时间,格式 Y-m-d H:i:s。 */ |
||||
@JsonProperty("offer_end_date") |
||||
private String offerEndDate; |
||||
|
||||
/** 评论数。 */ |
||||
@JsonProperty("review_count") |
||||
private String reviewCount; |
||||
|
||||
/** 评分。 */ |
||||
@JsonProperty("average_rating") |
||||
private String averageRating; |
||||
|
||||
/** 品牌。 */ |
||||
@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("competitor_price") |
||||
private String competitorPrice; |
||||
|
||||
/** 竞品运费。 */ |
||||
@JsonProperty("competitor_ship_price") |
||||
private String competitorShipPrice; |
||||
|
||||
/** 创建时间,格式 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; |
||||
|
||||
/** 变体唯一 ID。 */ |
||||
@JsonProperty("variant_unique_id") |
||||
private String variantUniqueId; |
||||
|
||||
/** 库存调整后的值。 */ |
||||
@JsonProperty("quantityAdjustAfter") |
||||
private String quantityAdjustAfter; |
||||
|
||||
/** 库存调整前的值。 */ |
||||
@JsonProperty("quantityAdjustBefore") |
||||
private String quantityAdjustBefore; |
||||
|
||||
/** 库存调整操作人 ID。 */ |
||||
@JsonProperty("quantityUserId") |
||||
private String quantityUserId; |
||||
|
||||
/** 库存调整操作人名称。 */ |
||||
@JsonProperty("quantityUserIdName") |
||||
private String quantityUserIdName; |
||||
} |
||||
@ -0,0 +1,267 @@
@@ -0,0 +1,267 @@
|
||||
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.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.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 java.time.Instant; |
||||
import java.time.LocalDate; |
||||
import java.time.LocalDateTime; |
||||
import java.time.ZoneId; |
||||
import java.util.ArrayList; |
||||
import java.util.Collections; |
||||
import java.util.LinkedHashMap; |
||||
import java.util.List; |
||||
import java.util.Locale; |
||||
import java.util.Map; |
||||
|
||||
/** |
||||
* 领星 · 沃尔玛在线商品。 |
||||
* |
||||
* <p>接口 {@code /basicOpen/multiplatform/walmart/list}:POST,{@code offset}/{@code length} |
||||
* 分页(上限 200),返回在 {@code data.list};令牌桶容量 1。</p> |
||||
* |
||||
* <p>时间过滤:{@code listing_time_field} 选创建(1)/更新(2),日期精度为 {@code Y-m-d}, |
||||
* 区间不超过 31 天。</p> |
||||
*/ |
||||
public final class WalmartProductSource implements LingxingProductSource { |
||||
|
||||
private static final int MAX_PAGE_SIZE = 200; |
||||
|
||||
/** 搜索时间类型:按更新时间。 */ |
||||
private static final int TIME_FIELD_UPDATE = 2; |
||||
|
||||
/** 接口要求时间区间不超过 31 天。 */ |
||||
private static final int MAX_QUERY_DAYS = 31; |
||||
|
||||
/** 创建/更新时间是 Y-m-d H:i:s。 */ |
||||
private static final java.time.format.DateTimeFormatter DATE_TIME = |
||||
java.time.format.DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"); |
||||
/** 销量开始/结束是 Y-m-d。 */ |
||||
private static final java.time.format.DateTimeFormatter DATE = |
||||
java.time.format.DateTimeFormatter.ofPattern("yyyy-MM-dd"); |
||||
|
||||
@Override |
||||
public Page<ProductListing> products(LingxingCall call, ProductQuery query) { |
||||
int length = Math.min(query.pageSize() <= 0 ? 20 : query.pageSize(), MAX_PAGE_SIZE); |
||||
int offset = query.cursor() == null ? 0 : Integer.parseInt(query.cursor()); |
||||
|
||||
Map<String, Object> body = new LinkedHashMap<String, Object>(); |
||||
body.put("offset", offset); |
||||
body.put("length", length); |
||||
body.put("store_ids", |
||||
Collections.singletonList(call.ctx().account().externalStoreId())); |
||||
applyTimeWindow(body, query); |
||||
|
||||
HttpRequest req = call.signed(LingxingApi.LISTING_WALMART, body, "products.pull"); |
||||
HttpResponse resp = call.execute(req); |
||||
LingxingEnvelope envelope = call.envelope(resp, "products.pull"); |
||||
|
||||
List<WalmartListingDto> dtos = call.json().listAt(envelope.body(), "data.list", WalmartListingDto.class); |
||||
List<ProductListing> out = new ArrayList<ProductListing>(dtos.size()); |
||||
for (WalmartListingDto dto : dtos) { |
||||
out.add(toProductListing(dto, call)); |
||||
} |
||||
|
||||
int nextOffset = offset + dtos.size(); |
||||
boolean hasMore = dtos.size() >= length |
||||
&& (envelope.total() < 0 || nextOffset < envelope.total()); |
||||
return Page.of(out, hasMore ? String.valueOf(nextOffset) : null); |
||||
} |
||||
|
||||
/** 日期精度为 Y-m-d;区间超过 31 天时截断到最近 31 天。 */ |
||||
private static void applyTimeWindow(Map<String, Object> body, ProductQuery query) { |
||||
Instant from = query.updatedAfter(); |
||||
Instant to = query.updatedBefore(); |
||||
if (from == null && to == null) { |
||||
return; |
||||
} |
||||
if (to == null) { |
||||
to = Instant.now(); |
||||
} |
||||
if (from == null) { |
||||
from = to.minus(java.time.Duration.ofDays(MAX_QUERY_DAYS)); |
||||
} else if (java.time.Duration.between(from, to).toDays() > MAX_QUERY_DAYS) { |
||||
from = to.minus(java.time.Duration.ofDays(MAX_QUERY_DAYS)); |
||||
} |
||||
body.put("listing_time_field", TIME_FIELD_UPDATE); |
||||
body.put("listing_start_time", DATE.format(from.atZone(ZoneId.of("UTC")).toLocalDate())); |
||||
body.put("listing_end_time", DATE.format(to.atZone(ZoneId.of("UTC")).toLocalDate())); |
||||
} |
||||
|
||||
/** |
||||
* 领星沃尔玛商品 → 统一模型。 |
||||
* |
||||
* <p>统一字段来源:</p> |
||||
* <ul> |
||||
* <li>platformSku ← {@code msku}</li> |
||||
* <li>listingId ← {@code item_id}</li> |
||||
* <li>gtin ← {@code gtin},缺失时用 {@code upc}</li> |
||||
* <li>title ← {@code title}</li> |
||||
* <li>imageUrls ← {@code picture_url}(单张)</li> |
||||
* <li>status ← {@code status_name}(PUBLISHED / ... 字符串)</li> |
||||
* <li>rawStatus ← {@code status_name} 原值</li> |
||||
* <li>price ← {@code price};currency 由 {@code currency_icon} 反推</li> |
||||
* <li>listedAt ← {@code offer_start_date}(销售开始时间)</li> |
||||
* <li>updatedAt ← {@code listing_start_time}(接口只给创建时间,没有内容更新时间)</li> |
||||
* <li>attributes ← 其余全部原始字段</li> |
||||
* </ul> |
||||
*/ |
||||
private ProductListing toProductListing(WalmartListingDto dto, LingxingCall call) { |
||||
ZoneId zone = ZoneId.of(call.ctx().account().marketplaceZone()); |
||||
String currency = currencyOf(dto.getCurrencyIcon()); |
||||
String gtin = firstNonBlank(dto.getGtin(), dto.getUpc()); |
||||
|
||||
return ProductListing.builder() |
||||
.platform(call.ctx().platform()) |
||||
.omsStoreId(call.ctx().omsStoreId()) |
||||
.platformSku(dto.getMsku()) |
||||
.listingId(trimToNull(dto.getItemId())) |
||||
.gtin(gtin) |
||||
.title(dto.getTitle()) |
||||
.imageUrls(dto.getPictureUrl() == null |
||||
? Collections.<String>emptyList() |
||||
: Collections.singletonList(dto.getPictureUrl())) |
||||
.status(statusOf(dto.getStatusName())) |
||||
.rawStatus(dto.getStatusName()) |
||||
.price(moneyOrNull(dto.getPrice(), currency)) |
||||
.currency(currency) |
||||
.listedAt(dateTime(dto.getOfferStartDate(), zone, false)) |
||||
.updatedAt(dateTime(dto.getListingStartTime(), zone, false)) |
||||
.attributes(attributesOf(dto)) |
||||
.sourceProvider(ChannelProvider.LINGXING) |
||||
.build(); |
||||
} |
||||
|
||||
/** 沃尔玛状态是字符串,按名称归一。 */ |
||||
private static ProductStatus statusOf(String statusName) { |
||||
if (statusName == null) { |
||||
return ProductStatus.UNKNOWN; |
||||
} |
||||
String s = statusName.trim().toUpperCase(Locale.ROOT); |
||||
if ("PUBLISHED".equals(s)) { |
||||
return ProductStatus.ACTIVE; |
||||
} |
||||
if ("UNPUBLISHED".equals(s) || "STAGE".equals(s) |
||||
|| "READY TO PUBLISH".equals(s) || "IN PROGRESS".equals(s)) { |
||||
return ProductStatus.INACTIVE; |
||||
} |
||||
if ("SYSTEM PROBLEM".equals(s)) { |
||||
return ProductStatus.UNKNOWN; |
||||
} |
||||
return ProductStatus.UNKNOWN; |
||||
} |
||||
|
||||
private static Map<String, Object> attributesOf(WalmartListingDto dto) { |
||||
Map<String, Object> attrs = new LinkedHashMap<String, Object>(); |
||||
attrs.put("item_url", dto.getItemUrl()); |
||||
attrs.put("local_sku", dto.getLocalSku()); |
||||
attrs.put("local_name", dto.getLocalName()); |
||||
attrs.put("store_id", dto.getStoreId()); |
||||
attrs.put("store_name", dto.getStoreName()); |
||||
attrs.put("currency_icon", dto.getCurrencyIcon()); |
||||
attrs.put("available_quantity", dto.getAvailableQuantity()); |
||||
attrs.put("wfs_available_quantity", dto.getWfsAvailableQuantity()); |
||||
attrs.put("buy_box_price", dto.getBuyBoxPrice()); |
||||
attrs.put("buy_box_shipping_price", dto.getBuyBoxShippingPrice()); |
||||
attrs.put("upc", dto.getUpc()); |
||||
attrs.put("product_tax_code", dto.getProductTaxCode()); |
||||
attrs.put("offer_end_date", dto.getOfferEndDate()); |
||||
attrs.put("review_count", dto.getReviewCount()); |
||||
attrs.put("average_rating", dto.getAverageRating()); |
||||
attrs.put("brand", dto.getBrand()); |
||||
attrs.put("fulfillment_type", dto.getFulfillmentType()); |
||||
attrs.put("fulfillment_type_name", dto.getFulfillmentTypeName()); |
||||
attrs.put("competitor_price", dto.getCompetitorPrice()); |
||||
attrs.put("competitor_ship_price", dto.getCompetitorShipPrice()); |
||||
attrs.put("listing_end_time", dto.getListingEndTime()); |
||||
attrs.put("variant_unique_id", dto.getVariantUniqueId()); |
||||
attrs.put("quantityAdjustAfter", dto.getQuantityAdjustAfter()); |
||||
attrs.put("quantityAdjustBefore", dto.getQuantityAdjustBefore()); |
||||
attrs.put("quantityUserId", dto.getQuantityUserId()); |
||||
attrs.put("quantityUserIdName", dto.getQuantityUserIdName()); |
||||
attrs.values().removeAll(Collections.singleton(null)); |
||||
return attrs; |
||||
} |
||||
|
||||
/** |
||||
* 货币符号 → ISO 代码。无法识别时返回 null,不猜。 |
||||
*/ |
||||
private static String currencyOf(String icon) { |
||||
if (icon == null) { |
||||
return null; |
||||
} |
||||
String s = icon.trim(); |
||||
if ("$".equals(s) || "US$".equals(s)) { |
||||
return "USD"; |
||||
} |
||||
if ("€".equals(s)) { |
||||
return "EUR"; |
||||
} |
||||
if ("£".equals(s)) { |
||||
return "GBP"; |
||||
} |
||||
if ("C$".equals(s) || "CA$".equals(s)) { |
||||
return "CAD"; |
||||
} |
||||
if ("MXN".equals(s) || "MX$".equals(s)) { |
||||
return "MXN"; |
||||
} |
||||
return null; |
||||
} |
||||
|
||||
private static common.ecommerce.model.support.PlatformTime dateTime(String raw, ZoneId zone, |
||||
boolean dateOnly) { |
||||
if (raw == null || raw.trim().isEmpty()) { |
||||
return null; |
||||
} |
||||
try { |
||||
String value = raw.trim(); |
||||
Instant utc = dateOnly |
||||
? LocalDate.parse(value, DATE).atStartOfDay(zone).toInstant() |
||||
: LocalDateTime.parse(value, DATE_TIME).atZone(zone).toInstant(); |
||||
return common.ecommerce.model.support.PlatformTime.of(utc, zone); |
||||
} catch (RuntimeException e) { |
||||
return null; |
||||
} |
||||
} |
||||
|
||||
private static Money moneyOrNull(String value, String currency) { |
||||
if (value == null || value.trim().isEmpty() || currency == null) { |
||||
return null; |
||||
} |
||||
try { |
||||
return Money.of(value.trim(), currency); |
||||
} catch (RuntimeException e) { |
||||
return 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; |
||||
} |
||||
String trimmed = v.trim(); |
||||
return trimmed.isEmpty() ? null : trimmed; |
||||
} |
||||
} |
||||
Loading…
Reference in new issue