Browse Source

feat(lingxing): 接入 AliExpress / SHEIN / TikTok 在线商品

接口(均为 POST、qps 1、返回 data.list):
- AliExpress /basicOpen/multiplatform/aliexpress/list/v2(托管模式,isParent=0 子体)
- SHEIN      /basicOpen/multiplatform/shein/list(上限 1000)
- TikTok     /basicOpen/multiplatform/tiktok/list(上限 1000)

映射要点:
- 三者 platformSku 均取 msku,listingId 取 productUniqueId
- AliExpress:price 取 effectiveSupplyPrice + currencyCode;
  createTime 是北京时间,按 Asia/Shanghai 解析;storeIds 尽量传数字
- SHEIN:salePrice + saleCurrency;图片依次回落 imgUrl/imgMediumUrl/imgSmallUrl;
  status 0 删除 / 1 在售 / 2 停售
- TikTok:salesPrice + currency;title 为空时回落 pname;
  platformStatus 字符串归一,兼容示例中的无下划线写法 SELLERDEACTIVATED

Platform 新增 ALIEXPRESS,适配器与工厂的 platforms() 同步;
LingxingSubPlatforms 注册三个子平台。
其余字段全部进 attributes。

Co-Authored-By: Claude <noreply@anthropic.com>
feature/supplier-lingxing
chenchuchuan 3 weeks ago
parent
commit
3dd0188d39
  1. 2
      core/src/main/java/common/ecommerce/model/Platform.java
  2. 9
      lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java
  3. 3
      lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapter.java
  4. 3
      lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapterFactory.java
  5. 8
      lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSubPlatforms.java
  6. 30
      lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/AliexpressSubPlatform.java
  7. 22
      lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/dto/AliExpressWarehouseDto.java
  8. 224
      lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/dto/AliexpressListingDto.java
  9. 31
      lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/dto/AliexpressSupplyPriceDto.java
  10. 289
      lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSource.java
  11. 32
      lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/SheinSubPlatform.java
  12. 188
      lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/dto/SheinListingDto.java
  13. 16
      lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/dto/SheinSiteDto.java
  14. 30
      lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/dto/SheinSupplyPriceDto.java
  15. 22
      lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/dto/SheinWarehouseDto.java
  16. 267
      lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSource.java
  17. 30
      lingxing/src/main/java/common/ecommerce/lingxing/platform/tiktok/TiktokSubPlatform.java
  18. 128
      lingxing/src/main/java/common/ecommerce/lingxing/platform/tiktok/dto/TiktokListingDto.java
  19. 25
      lingxing/src/main/java/common/ecommerce/lingxing/platform/tiktok/dto/TiktokWarehouseDto.java
  20. 232
      lingxing/src/main/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSource.java

2
core/src/main/java/common/ecommerce/model/Platform.java

@ -26,6 +26,8 @@ public enum Platform { @@ -26,6 +26,8 @@ public enum Platform {
SHEIN,
/** Shopify(首期经领星接入) */
SHOPIFY,
/** AliExpress(首期经领星接入) */
ALIEXPRESS,
/** Mirakl 市场 */
MIRAKL,
/** Target(领星平台码待确认) */

9
lingxing/src/main/java/common/ecommerce/lingxing/LingxingApi.java

@ -44,6 +44,15 @@ public enum LingxingApi { @@ -44,6 +44,15 @@ public enum LingxingApi {
/** eBay 在线商品。POST,offset/length(上限 200),返回 data 数组。 */
LISTING_EBAY("/basicOpen/multiplatform/ebay/list", 1),
/** AliExpress 在线商品(托管模式)。POST,offset/length,返回 data.list。 */
LISTING_ALIEXPRESS("/basicOpen/multiplatform/aliexpress/list/v2", 1),
/** SHEIN 在线商品。POST,offset/length(上限 1000),返回 data.list。 */
LISTING_SHEIN("/basicOpen/multiplatform/shein/list", 1),
/** TikTok 在线商品。POST,offset/length(上限 1000),返回 data.list。 */
LISTING_TIKTOK("/basicOpen/multiplatform/tiktok/list", 1),
/** 多平台订单列表;当前实现使用的跨平台接口。 */
ORDER_LIST("/pb/mp/order/v2/list", 10);

3
lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapter.java

@ -104,7 +104,8 @@ public final class LingxingAdapter implements SalesOrderCapable, ProductCapable, @@ -104,7 +104,8 @@ public final class LingxingAdapter implements SalesOrderCapable, ProductCapable,
@Override
public Set<Platform> platforms() {
return EnumSet.of(Platform.AMAZON_SC, Platform.AMAZON_VC, Platform.WALMART_SC, Platform.TIKTOK,
Platform.TEMU, Platform.EBAY, Platform.SHEIN, Platform.SHOPIFY, Platform.MIRAKL,
Platform.TEMU, Platform.EBAY, Platform.SHEIN, Platform.SHOPIFY,
Platform.ALIEXPRESS, Platform.MIRAKL,
Platform.CUSTOM);
}

3
lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapterFactory.java

@ -40,7 +40,8 @@ public final class LingxingAdapterFactory implements AdapterFactory { @@ -40,7 +40,8 @@ public final class LingxingAdapterFactory implements AdapterFactory {
@Override
public EnumSet<Platform> platforms() {
return EnumSet.of(Platform.AMAZON_SC, Platform.AMAZON_VC, Platform.WALMART_SC, Platform.TIKTOK,
Platform.TEMU, Platform.EBAY, Platform.SHEIN, Platform.SHOPIFY, Platform.MIRAKL,
Platform.TEMU, Platform.EBAY, Platform.SHEIN, Platform.SHOPIFY,
Platform.ALIEXPRESS, Platform.MIRAKL,
Platform.CUSTOM);
}

8
lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSubPlatforms.java

@ -40,7 +40,13 @@ public final class LingxingSubPlatforms { @@ -40,7 +40,13 @@ public final class LingxingSubPlatforms {
SHARED_TRANSPORT, SHARED_JSON));
register(map, new common.ecommerce.lingxing.platform.ebay.EbaySubPlatform(
SHARED_TRANSPORT, SHARED_JSON));
// SHEIN… 落地后继续 register(...)
register(map, new common.ecommerce.lingxing.platform.aliexpress.AliexpressSubPlatform(
SHARED_TRANSPORT, SHARED_JSON));
register(map, new common.ecommerce.lingxing.platform.shein.SheinSubPlatform(
SHARED_TRANSPORT, SHARED_JSON));
register(map, new common.ecommerce.lingxing.platform.tiktok.TiktokSubPlatform(
SHARED_TRANSPORT, SHARED_JSON));
// 其它平台落地后继续 register(...)
BY_PLATFORM = Collections.unmodifiableMap(map);
}

30
lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/AliexpressSubPlatform.java

@ -0,0 +1,30 @@ @@ -0,0 +1,30 @@
package common.ecommerce.lingxing.platform.aliexpress;
import common.ecommerce.http.HttpTransport;
import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.lingxing.platform.LingxingSubPlatform;
import common.ecommerce.lingxing.platform.aliexpress.product.AliexpressProductSource;
import common.ecommerce.lingxing.platform.product.LingxingProductSource;
import common.ecommerce.model.Platform;
/**
* 领星 · AliExpress 子平台:只做能力组合。
*/
public final class AliexpressSubPlatform implements LingxingSubPlatform {
private final LingxingProductSource products;
public AliexpressSubPlatform(HttpTransport transport, JacksonJsonCodec json) {
this.products = new AliexpressProductSource();
}
@Override
public Platform platform() {
return Platform.ALIEXPRESS;
}
@Override
public LingxingProductSource productSource() {
return products;
}
}

22
lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/dto/AliExpressWarehouseDto.java

@ -0,0 +1,22 @@ @@ -0,0 +1,22 @@
package common.ecommerce.lingxing.platform.aliexpress.dto;
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Getter;
import lombok.Setter;
/** AliExpress 仓库库存({@code wareHouseDataList[]})。 */
@Getter
@Setter
@JsonIgnoreProperties(ignoreUnknown = true)
public class AliExpressWarehouseDto {
@JsonProperty("quantity")
private Integer quantity;
@JsonProperty("warehouseId")
private String warehouseId;
@JsonProperty("warehouseName")
private String warehouseName;
}

224
lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/dto/AliexpressListingDto.java

@ -0,0 +1,224 @@ @@ -0,0 +1,224 @@
package common.ecommerce.lingxing.platform.aliexpress.dto;
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Getter;
import lombok.Setter;
import java.util.ArrayList;
import java.util.List;
/**
* 领星 · AliExpress 在线商品(托管模式,{@code /basicOpen/multiplatform/aliexpress/list/v2} 的
* {@code data.list[]})。
*
* <p>字段为 camelCase。响应结构:{@code data.count} + {@code data.list}。</p>
*
* <p>注意文档对 {@code price} 的说明是「单位分,需除以 100 万」,示例 99990000
* 对应 {@code effectiveSupplyPrice} 59.99——实际换算需联调确认,这里只保留原值。</p>
*/
@Getter
@Setter
@JsonIgnoreProperties(ignoreUnknown = true)
public class AliexpressListingDto {
/** 记录 ID。 */
@JsonProperty("id")
private Long id;
/** 商品全局唯一 ID。 */
@JsonProperty("productUniqueId")
private Long productUniqueId;
/** 平台商品 ID。 */
@JsonProperty("productId")
private String productId;
/** 货品 ID。 */
@JsonProperty("itemId")
private String itemId;
/** 变体 MSKU,参与 canonicalKey。 */
@JsonProperty("msku")
private String msku;
/** 变体 MSKU ID。 */
@JsonProperty("mskuId")
private String mskuId;
/** SKU 编码。 */
@JsonProperty("sku")
private String sku;
/** 品名。 */
@JsonProperty("pname")
private String pname;
/** 商品标题。 */
@JsonProperty("title")
private String title;
/** 本地产品 ID。 */
@JsonProperty("pid")
private Long pid;
/** 变体属性名,如 颜色;尺寸。 */
@JsonProperty("attributeName")
private String attributeName;
/** 变体属性值,如 红色;L码。 */
@JsonProperty("attributeValue")
private String attributeValue;
/** 变体属性 JSON 字符串。 */
@JsonProperty("attributes")
private String attributes;
/** 父体图片 URL。 */
@JsonProperty("imageUrls")
private String imageUrls;
/** 变体图片地址。 */
@JsonProperty("skuImage")
private String skuImage;
/** 状态值。 */
@JsonProperty("status")
private Integer status;
/** 状态名,如 可售。 */
@JsonProperty("statusName")
private String statusName;
/** 是否删除。文档示例为字符串 "value",按 Object 接收避免解析失败。 */
@JsonProperty("isDelete")
private Object isDelete;
/** 子体货币代码。 */
@JsonProperty("currencyCode")
private String currencyCode;
/** 子体有效供货价。 */
@JsonProperty("effectiveSupplyPrice")
private String effectiveSupplyPrice;
/** 价格原值(文档说明单位为分)。 */
@JsonProperty("price")
private Long price;
/** 供货价列表(按时间区间)。 */
@JsonProperty("supplyPriceList")
private List<AliexpressSupplyPriceDto> supplyPriceList = new ArrayList<AliexpressSupplyPriceDto>();
/** 店铺 ID。 */
@JsonProperty("storeId")
private Long storeId;
/** 店铺名称。 */
@JsonProperty("storeName")
private String storeName;
/** 平台编号,如 aliexpress。 */
@JsonProperty("platformCode")
private String platformCode;
/** 平台名称。 */
@JsonProperty("platformName")
private String platformName;
/** 发货模式,如 仓发。 */
@JsonProperty("mode")
private String mode;
/** 发货模式值:0 仓发 / 1 JIT / 2 海外备仓。 */
@JsonProperty("productType")
private Integer productType;
/** 发货模式名称。 */
@JsonProperty("productTypeName")
private String productTypeName;
/** 本地 SKU 型号。 */
@JsonProperty("model")
private String model;
/** 备注。 */
@JsonProperty("notes")
private String notes;
/** 品牌 ID。 */
@JsonProperty("bid")
private Long bid;
/** 品牌名称。 */
@JsonProperty("bname")
private String bname;
/** 分类 ID。 */
@JsonProperty("cid")
private Long cid;
/** 分类名称。 */
@JsonProperty("cname")
private String cname;
/** 企业 ID。 */
@JsonProperty("companyId")
private Long companyId;
/** listing 创建时间,北京时间。 */
@JsonProperty("createTime")
private String createTime;
/** 是否多子体:1 多子体 / 2 单子体。 */
@JsonProperty("hasList")
private Integer hasList;
/** 仓库总库存。 */
@JsonProperty("inventoryQuantity")
private Integer inventoryQuantity;
/** 仓库库存(字符串)。 */
@JsonProperty("warehouseStock")
private String warehouseStock;
/** 7 天销量。 */
@JsonProperty("day7SaleCnt")
private Integer day7SaleCnt;
/** 30 天销量。 */
@JsonProperty("day30SaleCnt")
private Integer day30SaleCnt;
/** 是否自动补货。 */
@JsonProperty("autoRestock")
private String autoRestock;
/** 负责人 UID 列表。 */
@JsonProperty("principalUids")
private Object principalUids;
/** 负责人名称。 */
@JsonProperty("principalName")
private String principalName;
/** 库存同步中信息,null 表示不在同步中。 */
@JsonProperty("quantitySyn")
private Object quantitySyn;
/** 仓库详情列表。 */
@JsonProperty("wareHouseDataList")
private List<AliExpressWarehouseDto> wareHouseDataList = new ArrayList<AliExpressWarehouseDto>();
/** 唯一 ID。 */
@JsonProperty("uniqueId")
private String uniqueId;
/** 变体唯一 ID。 */
@JsonProperty("variantUniqueId")
private String variantUniqueId;
/** 仓库详情 JSON 字符串。 */
@JsonProperty("extJson")
private String extJson;
}

31
lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/dto/AliexpressSupplyPriceDto.java

@ -0,0 +1,31 @@ @@ -0,0 +1,31 @@
package common.ecommerce.lingxing.platform.aliexpress.dto;
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Getter;
import lombok.Setter;
import java.math.BigDecimal;
/** AliExpress 供货价({@code supplyPriceList[]}),按时间区间分段。 */
@Getter
@Setter
@JsonIgnoreProperties(ignoreUnknown = true)
public class AliexpressSupplyPriceDto {
/** 开始时间,Y-m-d。 */
@JsonProperty("beginStr")
private String beginStr;
/** 结束时间;null 表示至今。 */
@JsonProperty("endStr")
private String endStr;
/** 币种,如 USD。 */
@JsonProperty("currency")
private String currency;
/** 金额。 */
@JsonProperty("price")
private BigDecimal price;
}

289
lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSource.java

@ -0,0 +1,289 @@ @@ -0,0 +1,289 @@
package common.ecommerce.lingxing.platform.aliexpress.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.aliexpress.dto.AliexpressListingDto;
import common.ecommerce.lingxing.platform.aliexpress.dto.AliexpressSupplyPriceDto;
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.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;
/**
* 领星 · AliExpress 在线商品(托管模式)。
*
* <p>接口 {@code /basicOpen/multiplatform/aliexpress/list/v2}:POST,{@code offset}/{@code length}
* 必填,返回 {@code data.list};令牌桶容量 1。</p>
*
* <p>{@code isParent} 必填:本实现固定查子体(0),与统一模型的「一条 = 一个可售 SKU」对齐。</p>
*/
public final class AliexpressProductSource implements LingxingProductSource {
/** 接口没有明确上限,取与其它多平台商品接口一致的 1000。 */
private static final int MAX_PAGE_SIZE = 1000;
/** 是否父体:0 子体。 */
private static final int IS_CHILD = 0;
/** createTime 是北京时间。 */
private static final ZoneId BEIJING = ZoneId.of("Asia/Shanghai");
private static final DateTimeFormatter DATE_TIME =
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
private static final DateTimeFormatter DATE = 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("isParent", IS_CHILD);
body.put("offset", offset);
body.put("length", length);
body.put("storeIds",
Collections.singletonList(parseStoreId(call.ctx().account().externalStoreId())));
applyTimeWindow(body, query);
HttpRequest req = call.signed(LingxingApi.LISTING_ALIEXPRESS, body, "products.pull");
HttpResponse resp = call.execute(req);
LingxingEnvelope envelope = call.envelope(resp, "products.pull");
List<AliexpressListingDto> dtos =
call.json().listAt(envelope.body(), "data.list", AliexpressListingDto.class);
List<ProductListing> out = new ArrayList<ProductListing>(dtos.size());
for (AliexpressListingDto dto : dtos) {
out.add(toProductListing(dto, call));
}
int total = totalOf(call, envelope.body());
int nextOffset = offset + dtos.size();
boolean hasMore = dtos.size() >= length && (total < 0 || nextOffset < total);
return Page.of(out, hasMore ? String.valueOf(nextOffset) : null);
}
/** storeIds 文档示例是数字数组;能解析成数字就传数字,否则原样传字符串。 */
private static Object parseStoreId(String externalStoreId) {
try {
return Long.valueOf(externalStoreId);
} catch (RuntimeException e) {
return externalStoreId;
}
}
/** 时间窗:start/end 为 yyyy-MM-dd(北京时间的日期)。 */
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 (from != null) {
body.put("start", DATE.format(from.atZone(BEIJING).toLocalDate()));
}
if (to != null) {
body.put("end", DATE.format(to.atZone(BEIJING).toLocalDate()));
}
}
private static int totalOf(LingxingCall call, String body) {
String raw = call.json().stringAt(body, "data.count");
if (raw == null) {
raw = call.json().stringAt(body, "total");
}
if (raw == null) {
return -1;
}
try {
return Integer.parseInt(raw.trim());
} catch (NumberFormatException e) {
return -1;
}
}
/**
* 领星 AliExpress 商品 → 统一模型。
*
* <p>统一字段来源:</p>
* <ul>
* <li>platformSku ← {@code msku}</li>
* <li>listingId ← {@code productUniqueId}</li>
* <li>title ← {@code title}</li>
* <li>imageUrls ← {@code skuImage},为空时用 {@code imageUrls}(父体图)</li>
* <li>status ← {@code status}(文档只给了「可售」=2,其余归 UNKNOWN)</li>
* <li>rawStatus ← {@code statusName} 原值(中文)</li>
* <li>price ← {@code effectiveSupplyPrice} + {@code currencyCode}</li>
* <li>listedAt ← {@code createTime}(北京时间,按 UTC 换算)</li>
* <li>updatedAt ← 无</li>
* <li>attributes ← 其余全部原始字段</li>
* </ul>
*/
private ProductListing toProductListing(AliexpressListingDto dto, LingxingCall call) {
ZoneId zone = ZoneId.of(call.ctx().account().marketplaceZone());
String image = firstNonBlank(dto.getSkuImage(), dto.getImageUrls());
String currency = trimToNull(dto.getCurrencyCode());
String price = firstNonBlank(dto.getEffectiveSupplyPrice(), currentSupplyPrice(dto.getSupplyPriceList()));
return ProductListing.builder()
.platform(call.ctx().platform())
.omsStoreId(call.ctx().omsStoreId())
.platformSku(dto.getMsku())
.listingId(dto.getProductUniqueId() == null ? null : String.valueOf(dto.getProductUniqueId()))
.title(dto.getTitle())
.imageUrls(image == null ? Collections.<String>emptyList() : Collections.singletonList(image))
.status(statusOf(dto.getStatus()))
.rawStatus(dto.getStatusName())
.price(moneyOrNull(price, currency))
.currency(currency)
.listedAt(beijingTime(dto.getCreateTime(), zone))
.attributes(attributesOf(dto))
.sourceProvider(ChannelProvider.LINGXING)
.build();
}
/** 当前生效供货价:优先 endStr 为空,否则取 beginStr 最大的一条。 */
private static String currentSupplyPrice(List<AliexpressSupplyPriceDto> prices) {
if (prices == null || prices.isEmpty()) {
return null;
}
AliexpressSupplyPriceDto best = null;
for (AliexpressSupplyPriceDto p : prices) {
if (p == null || p.getPrice() == null) {
continue;
}
if (p.getEndStr() == null || p.getEndStr().trim().isEmpty()) {
return p.getPrice().toPlainString();
}
if (best == null || compareBegin(p.getBeginStr(), best.getBeginStr()) > 0) {
best = p;
}
}
return best == null ? null : best.getPrice().toPlainString();
}
private static int compareBegin(String a, String b) {
if (a == null) {
return b == null ? 0 : -1;
}
if (b == null) {
return 1;
}
return a.compareTo(b);
}
/** 文档只给了「2 可售」,其余归 UNKNOWN,保留原值在 rawStatus。 */
private static ProductStatus statusOf(Integer status) {
if (status == null) {
return ProductStatus.UNKNOWN;
}
if (status == 2) {
return ProductStatus.ACTIVE;
}
return ProductStatus.UNKNOWN;
}
private static Map<String, Object> attributesOf(AliexpressListingDto dto) {
Map<String, Object> attrs = new LinkedHashMap<String, Object>();
attrs.put("id", dto.getId());
attrs.put("productId", dto.getProductId());
attrs.put("itemId", dto.getItemId());
attrs.put("mskuId", dto.getMskuId());
attrs.put("sku", dto.getSku());
attrs.put("pname", dto.getPname());
attrs.put("pid", dto.getPid());
attrs.put("attributeName", dto.getAttributeName());
attrs.put("attributeValue", dto.getAttributeValue());
attrs.put("attributes", dto.getAttributes());
attrs.put("isDelete", dto.getIsDelete());
attrs.put("currencyCode", dto.getCurrencyCode());
attrs.put("price", dto.getPrice());
attrs.put("supplyPriceList", dto.getSupplyPriceList());
attrs.put("storeId", dto.getStoreId());
attrs.put("storeName", dto.getStoreName());
attrs.put("platformCode", dto.getPlatformCode());
attrs.put("platformName", dto.getPlatformName());
attrs.put("mode", dto.getMode());
attrs.put("productType", dto.getProductType());
attrs.put("productTypeName", dto.getProductTypeName());
attrs.put("model", dto.getModel());
attrs.put("notes", dto.getNotes());
attrs.put("bid", dto.getBid());
attrs.put("bname", dto.getBname());
attrs.put("cid", dto.getCid());
attrs.put("cname", dto.getCname());
attrs.put("companyId", dto.getCompanyId());
attrs.put("hasList", dto.getHasList());
attrs.put("inventoryQuantity", dto.getInventoryQuantity());
attrs.put("warehouseStock", dto.getWarehouseStock());
attrs.put("day7SaleCnt", dto.getDay7SaleCnt());
attrs.put("day30SaleCnt", dto.getDay30SaleCnt());
attrs.put("autoRestock", dto.getAutoRestock());
attrs.put("principalUids", dto.getPrincipalUids());
attrs.put("principalName", dto.getPrincipalName());
attrs.put("quantitySyn", dto.getQuantitySyn());
attrs.put("wareHouseDataList", dto.getWareHouseDataList());
attrs.put("uniqueId", dto.getUniqueId());
attrs.put("variantUniqueId", dto.getVariantUniqueId());
attrs.put("extJson", dto.getExtJson());
attrs.values().removeAll(Collections.singleton(null));
return attrs;
}
/** createTime 是北京时间,转成 UTC Instant 后按市场时区展示。 */
private static PlatformTime beijingTime(String raw, ZoneId marketplaceZone) {
if (raw == null || raw.trim().isEmpty()) {
return null;
}
try {
Instant utc = LocalDateTime.parse(raw.trim(), DATE_TIME).atZone(BEIJING).toInstant();
return PlatformTime.of(utc, marketplaceZone);
} 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;
}
}

32
lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/SheinSubPlatform.java

@ -0,0 +1,32 @@ @@ -0,0 +1,32 @@
package common.ecommerce.lingxing.platform.shein;
import common.ecommerce.http.HttpTransport;
import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.lingxing.platform.LingxingSubPlatform;
import common.ecommerce.lingxing.platform.product.LingxingProductSource;
import common.ecommerce.lingxing.platform.shein.product.SheinProductSource;
import common.ecommerce.model.Platform;
/**
* 领星 · SHEIN 子平台:只做能力组合。
*
* <p>10021 / 10027 / 10028 都映射到 {@link Platform#SHEIN}。</p>
*/
public final class SheinSubPlatform implements LingxingSubPlatform {
private final LingxingProductSource products;
public SheinSubPlatform(HttpTransport transport, JacksonJsonCodec json) {
this.products = new SheinProductSource();
}
@Override
public Platform platform() {
return Platform.SHEIN;
}
@Override
public LingxingProductSource productSource() {
return products;
}
}

188
lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/dto/SheinListingDto.java

@ -0,0 +1,188 @@ @@ -0,0 +1,188 @@
package common.ecommerce.lingxing.platform.shein.dto;
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Getter;
import lombok.Setter;
import java.util.ArrayList;
import java.util.List;
/**
* 领星 · SHEIN 在线商品({@code /basicOpen/multiplatform/shein/list} 的 {@code data.list[]})。
*
* <p>字段为 camelCase,响应结构 {@code data.count} + {@code data.list}。</p>
*/
@Getter
@Setter
@JsonIgnoreProperties(ignoreUnknown = true)
public class SheinListingDto {
/** 领星内部 id。 */
@JsonProperty("id")
private String id;
/** 商品 uid。 */
@JsonProperty("productUniqueId")
private String productUniqueId;
/** 负责人 uid 列表。 */
@JsonProperty("principalUids")
private List<String> principalUids = new ArrayList<String>();
/** 负责人名称。 */
@JsonProperty("principalName")
private String principalName;
/** 企业 id。 */
@JsonProperty("companyId")
private String companyId;
/** 店铺 id。 */
@JsonProperty("storeId")
private String storeId;
/** 店铺名称。 */
@JsonProperty("storeName")
private String storeName;
/** 平台代码,如 10027。 */
@JsonProperty("platformCode")
private String platformCode;
/** MSKU ID。 */
@JsonProperty("mskuId")
private String mskuId;
/** 平台侧 MSKU,参与 canonicalKey。 */
@JsonProperty("msku")
private String msku;
/** 品名。 */
@JsonProperty("pname")
private String pname;
/** 本地 SKU。 */
@JsonProperty("sku")
private String sku;
/** 本地商品 id。 */
@JsonProperty("pid")
private String pid;
/** 标题。 */
@JsonProperty("title")
private String title;
/** 分类 id。 */
@JsonProperty("cid")
private String cid;
/** 品牌 id。 */
@JsonProperty("bid")
private String bid;
/** 7 天销量。 */
@JsonProperty("day7SaleCnt")
private Integer day7SaleCnt;
/** 30 天销量。 */
@JsonProperty("day30SaleCnt")
private Integer day30SaleCnt;
/** 各仓库存。 */
@JsonProperty("wareHouseDataList")
private List<SheinWarehouseDto> wareHouseDataList = new ArrayList<SheinWarehouseDto>();
/** 备注。 */
@JsonProperty("notes")
private String notes;
/** 低质量图片。 */
@JsonProperty("imgSmallUrl")
private String imgSmallUrl;
/** 中质量图片。 */
@JsonProperty("imgMediumUrl")
private String imgMediumUrl;
/** 原质量图片。 */
@JsonProperty("imgUrl")
private String imgUrl;
/** SKC ID。 */
@JsonProperty("skcId")
private String skcId;
/** SKC。 */
@JsonProperty("skc")
private String skc;
/** SPU ID。 */
@JsonProperty("spuId")
private String spuId;
/** SPU。 */
@JsonProperty("spu")
private String spu;
/** 状态:0 删除 / 1 在售 / 2 停售。 */
@JsonProperty("status")
private Integer status;
/** 站点,逗号分隔。 */
@JsonProperty("site")
private String site;
/** 站点列表。 */
@JsonProperty("siteList")
private List<SheinSiteDto> siteList;
/** 是否在售。 */
@JsonProperty("isOnSale")
private Boolean isOnSale;
/** 属性,如 test-白色-test-均码。 */
@JsonProperty("attribute")
private String attribute;
/** 大分类名称。 */
@JsonProperty("categoryName")
private String categoryName;
/** 售价。 */
@JsonProperty("salePrice")
private Object salePrice;
/** 售价货币,可能是符号。 */
@JsonProperty("saleCurrency")
private String saleCurrency;
/** 总库存。 */
@JsonProperty("inventoryQuantity")
private Integer inventoryQuantity;
/** 出库中库存。 */
@JsonProperty("lockedQuantity")
private Integer lockedQuantity;
/** 待支付库存。 */
@JsonProperty("tempLockQuantity")
private Integer tempLockQuantity;
/** 可用库存。 */
@JsonProperty("usableInventory")
private Integer usableInventory;
/** 品牌名称。 */
@JsonProperty("bname")
private String bname;
/** 细分类名称。 */
@JsonProperty("cname")
private String cname;
/** 供货价列表。 */
@JsonProperty("supplyPriceList")
private List<SheinSupplyPriceDto> supplyPriceList = new ArrayList<SheinSupplyPriceDto>();
}

16
lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/dto/SheinSiteDto.java

@ -0,0 +1,16 @@ @@ -0,0 +1,16 @@
package common.ecommerce.lingxing.platform.shein.dto;
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Getter;
import lombok.Setter;
/** SHEIN 站点信息({@code siteList[]})。 */
@Getter
@Setter
@JsonIgnoreProperties(ignoreUnknown = true)
public class SheinSiteDto {
@JsonProperty("site")
private String site;
}

30
lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/dto/SheinSupplyPriceDto.java

@ -0,0 +1,30 @@ @@ -0,0 +1,30 @@
package common.ecommerce.lingxing.platform.shein.dto;
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Getter;
import lombok.Setter;
import java.math.BigDecimal;
/** SHEIN 供货价({@code supplyPriceList[]}),按时间区间分段。 */
@Getter
@Setter
@JsonIgnoreProperties(ignoreUnknown = true)
public class SheinSupplyPriceDto {
@JsonProperty("price")
private BigDecimal price;
/** 货币,文档示例为符号「¥」。 */
@JsonProperty("currency")
private String currency;
/** 执行开始时间,Y-m-d。 */
@JsonProperty("beginStr")
private String beginStr;
/** 执行结束时间,Y-m-d。 */
@JsonProperty("endStr")
private String endStr;
}

22
lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/dto/SheinWarehouseDto.java

@ -0,0 +1,22 @@ @@ -0,0 +1,22 @@
package common.ecommerce.lingxing.platform.shein.dto;
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Getter;
import lombok.Setter;
/** SHEIN 仓库库存({@code wareHouseDataList[]})。 */
@Getter
@Setter
@JsonIgnoreProperties(ignoreUnknown = true)
public class SheinWarehouseDto {
@JsonProperty("warehouseId")
private String warehouseId;
@JsonProperty("warehouseName")
private String warehouseName;
@JsonProperty("quantity")
private Integer quantity;
}

267
lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSource.java

@ -0,0 +1,267 @@ @@ -0,0 +1,267 @@
package common.ecommerce.lingxing.platform.shein.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.shein.dto.SheinListingDto;
import common.ecommerce.lingxing.platform.shein.dto.SheinSupplyPriceDto;
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.util.ArrayList;
import java.util.Collections;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
/**
* 领星 · SHEIN 在线商品。
*
* <p>接口 {@code /basicOpen/multiplatform/shein/list}:POST,{@code offset}/{@code length}
* (上限 1000),返回 {@code data.list};令牌桶容量 1。</p>
*
* <p>接口不支持时间窗过滤。</p>
*/
public final class SheinProductSource implements LingxingProductSource {
private static final int MAX_PAGE_SIZE = 1000;
@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("storeIds",
Collections.singletonList(call.ctx().account().externalStoreId()));
HttpRequest req = call.signed(LingxingApi.LISTING_SHEIN, body, "products.pull");
HttpResponse resp = call.execute(req);
LingxingEnvelope envelope = call.envelope(resp, "products.pull");
List<SheinListingDto> dtos = call.json().listAt(envelope.body(), "data.list", SheinListingDto.class);
List<ProductListing> out = new ArrayList<ProductListing>(dtos.size());
for (SheinListingDto dto : dtos) {
out.add(toProductListing(dto, call));
}
int total = totalOf(call, envelope.body());
int nextOffset = offset + dtos.size();
boolean hasMore = dtos.size() >= length && (total < 0 || nextOffset < total);
return Page.of(out, hasMore ? String.valueOf(nextOffset) : null);
}
private static int totalOf(LingxingCall call, String body) {
String raw = call.json().stringAt(body, "data.count");
if (raw == null) {
raw = call.json().stringAt(body, "total");
}
if (raw == null) {
return -1;
}
try {
return Integer.parseInt(raw.trim());
} catch (NumberFormatException e) {
return -1;
}
}
/**
* 领星 SHEIN 商品 → 统一模型。
*
* <p>统一字段来源:</p>
* <ul>
* <li>platformSku ← {@code msku}</li>
* <li>listingId ← {@code productUniqueId}</li>
* <li>title ← {@code title}</li>
* <li>imageUrls ← {@code imgUrl},为空时依次回落 {@code imgMediumUrl} / {@code imgSmallUrl}</li>
* <li>status ← {@code status}(0 删除 / 1 在售 / 2 停售)</li>
* <li>rawStatus ← 原始 {@code status} 值</li>
* <li>price ← {@code salePrice} + {@code saleCurrency}(符号按约定映射)</li>
* <li>listedAt / updatedAt ← 无(接口不返回时间字段)</li>
* <li>attributes ← 其余全部原始字段</li>
* </ul>
*/
private ProductListing toProductListing(SheinListingDto dto, LingxingCall call) {
String image = firstNonBlank(dto.getImgUrl(), dto.getImgMediumUrl(), dto.getImgSmallUrl());
String currency = currencyOf(dto.getSaleCurrency());
String priceText = amountOf(dto.getSalePrice());
if (priceText == null) {
priceText = currentSupplyPrice(dto.getSupplyPriceList());
}
return ProductListing.builder()
.platform(call.ctx().platform())
.omsStoreId(call.ctx().omsStoreId())
.platformSku(dto.getMsku())
.listingId(trimToNull(dto.getProductUniqueId()))
.title(dto.getTitle())
.imageUrls(image == null ? Collections.<String>emptyList() : Collections.singletonList(image))
.status(statusOf(dto.getStatus()))
.rawStatus(dto.getStatus() == null ? null : String.valueOf(dto.getStatus()))
.price(moneyOrNull(priceText, currency))
.currency(currency)
.attributes(attributesOf(dto))
.sourceProvider(ChannelProvider.LINGXING)
.build();
}
/** SHEIN:0 删除 / 1 在售 / 2 停售。 */
private static ProductStatus statusOf(Integer status) {
if (status == null) {
return ProductStatus.UNKNOWN;
}
switch (status) {
case 1:
return ProductStatus.ACTIVE;
case 2:
return ProductStatus.INACTIVE;
case 0:
return ProductStatus.DELETED;
default:
return ProductStatus.UNKNOWN;
}
}
/** 供货价兜底:优先 endStr 为空,否则取 beginStr 最大的一条。 */
private static String currentSupplyPrice(List<SheinSupplyPriceDto> prices) {
if (prices == null || prices.isEmpty()) {
return null;
}
SheinSupplyPriceDto best = null;
for (SheinSupplyPriceDto p : prices) {
if (p == null || p.getPrice() == null) {
continue;
}
if (p.getEndStr() == null || p.getEndStr().trim().isEmpty()) {
return p.getPrice().toPlainString();
}
if (best == null || compareBegin(p.getBeginStr(), best.getBeginStr()) > 0) {
best = p;
}
}
return best == null ? null : best.getPrice().toPlainString();
}
private static int compareBegin(String a, String b) {
if (a == null) {
return b == null ? 0 : -1;
}
if (b == null) {
return 1;
}
return a.compareTo(b);
}
/** salePrice 文档为 number,但示例可能是字符串,统一转字符串。 */
private static String amountOf(Object value) {
if (value == null) {
return null;
}
String s = String.valueOf(value).trim();
return s.isEmpty() ? null : s;
}
private static Map<String, Object> attributesOf(SheinListingDto dto) {
Map<String, Object> attrs = new LinkedHashMap<String, Object>();
attrs.put("id", dto.getId());
attrs.put("storeId", dto.getStoreId());
attrs.put("storeName", dto.getStoreName());
attrs.put("platformCode", dto.getPlatformCode());
attrs.put("mskuId", dto.getMskuId());
attrs.put("sku", dto.getSku());
attrs.put("pid", dto.getPid());
attrs.put("pname", dto.getPname());
attrs.put("skcId", dto.getSkcId());
attrs.put("skc", dto.getSkc());
attrs.put("spuId", dto.getSpuId());
attrs.put("spu", dto.getSpu());
attrs.put("cid", dto.getCid());
attrs.put("cname", dto.getCname());
attrs.put("categoryName", dto.getCategoryName());
attrs.put("bid", dto.getBid());
attrs.put("bname", dto.getBname());
attrs.put("attribute", dto.getAttribute());
attrs.put("site", dto.getSite());
attrs.put("siteList", dto.getSiteList());
attrs.put("isOnSale", dto.getIsOnSale());
attrs.put("inventoryQuantity", dto.getInventoryQuantity());
attrs.put("lockedQuantity", dto.getLockedQuantity());
attrs.put("tempLockQuantity", dto.getTempLockQuantity());
attrs.put("usableInventory", dto.getUsableInventory());
attrs.put("wareHouseDataList", dto.getWareHouseDataList());
attrs.put("supplyPriceList", dto.getSupplyPriceList());
attrs.put("day7SaleCnt", dto.getDay7SaleCnt());
attrs.put("day30SaleCnt", dto.getDay30SaleCnt());
attrs.put("principalUids", dto.getPrincipalUids());
attrs.put("principalName", dto.getPrincipalName());
attrs.put("companyId", dto.getCompanyId());
attrs.put("notes", dto.getNotes());
attrs.put("imgSmallUrl", dto.getImgSmallUrl());
attrs.put("imgMediumUrl", dto.getImgMediumUrl());
attrs.values().removeAll(Collections.singleton(null));
return attrs;
}
/** 货币符号 → ISO。约定 ¥ 符号视为日元,人民币以 CNY 返回。 */
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 ("¥".equals(s) || "¥".equals(s)) {
return "JPY";
}
if ("CNY".equalsIgnoreCase(s) || "RMB".equalsIgnoreCase(s)) {
return "CNY";
}
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;
}
}

30
lingxing/src/main/java/common/ecommerce/lingxing/platform/tiktok/TiktokSubPlatform.java

@ -0,0 +1,30 @@ @@ -0,0 +1,30 @@
package common.ecommerce.lingxing.platform.tiktok;
import common.ecommerce.http.HttpTransport;
import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.lingxing.platform.LingxingSubPlatform;
import common.ecommerce.lingxing.platform.product.LingxingProductSource;
import common.ecommerce.lingxing.platform.tiktok.product.TiktokProductSource;
import common.ecommerce.model.Platform;
/**
* 领星 · TikTok 子平台:只做能力组合。
*/
public final class TiktokSubPlatform implements LingxingSubPlatform {
private final LingxingProductSource products;
public TiktokSubPlatform(HttpTransport transport, JacksonJsonCodec json) {
this.products = new TiktokProductSource();
}
@Override
public Platform platform() {
return Platform.TIKTOK;
}
@Override
public LingxingProductSource productSource() {
return products;
}
}

128
lingxing/src/main/java/common/ecommerce/lingxing/platform/tiktok/dto/TiktokListingDto.java

@ -0,0 +1,128 @@ @@ -0,0 +1,128 @@
package common.ecommerce.lingxing.platform.tiktok.dto;
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Getter;
import lombok.Setter;
import java.util.ArrayList;
import java.util.List;
/**
* 领星 · TikTok 在线商品({@code /basicOpen/multiplatform/tiktok/list} 的 {@code data.list[]})。
*
* <p>字段为 camelCase,响应结构 {@code data.count} + {@code data.list}。</p>
*/
@Getter
@Setter
@JsonIgnoreProperties(ignoreUnknown = true)
public class TiktokListingDto {
@JsonProperty("id")
private String id;
@JsonProperty("productUniqueId")
private String productUniqueId;
@JsonProperty("principalUids")
private List<String> principalUids = new ArrayList<String>();
@JsonProperty("principalName")
private String principalName;
@JsonProperty("companyId")
private String companyId;
@JsonProperty("storeId")
private String storeId;
@JsonProperty("storeName")
private String storeName;
@JsonProperty("platformCode")
private String platformCode;
@JsonProperty("mskuId")
private String mskuId;
/** 平台侧 MSKU,参与 canonicalKey。 */
@JsonProperty("msku")
private String msku;
@JsonProperty("pname")
private String pname;
@JsonProperty("sku")
private String sku;
@JsonProperty("pid")
private String pid;
/** FBT 货品 ID。 */
@JsonProperty("goodId")
private String goodId;
@JsonProperty("title")
private String title;
@JsonProperty("cid")
private String cid;
@JsonProperty("bid")
private String bid;
@JsonProperty("notes")
private String notes;
@JsonProperty("imgUrl")
private String imgUrl;
@JsonProperty("spu")
private String spu;
@JsonProperty("spuId")
private String spuId;
/**
* 平台状态:DRAFT / PENDING / FAILED / ACTIVATE / SELLER_DEACTIVATED /
* PLATFORM_DEACTIVATED / FREEZE / DELETED。
*
* <p>注意示例里出现过 {@code SELLERDEACTIVATED}(无下划线),做容错处理。</p>
*/
@JsonProperty("platformStatus")
private String platformStatus;
@JsonProperty("categoryName")
private String categoryName;
@JsonProperty("usableInventory")
private Integer usableInventory;
@JsonProperty("waitOutboundQuantity")
private Integer waitOutboundQuantity;
/** 站点代码,逗号分隔,如 US,UK。 */
@JsonProperty("siteCode")
private String siteCode;
/** 税前价格。 */
@JsonProperty("taxExclusivePrice")
private Object taxExclusivePrice;
/** 售价。 */
@JsonProperty("salesPrice")
private String salesPrice;
/** 货币单位,文档示例为符号 $。 */
@JsonProperty("currency")
private String currency;
@JsonProperty("bname")
private String bname;
@JsonProperty("cname")
private String cname;
@JsonProperty("wareHouseDataList")
private List<TiktokWarehouseDto> wareHouseDataList = new ArrayList<TiktokWarehouseDto>();
}

25
lingxing/src/main/java/common/ecommerce/lingxing/platform/tiktok/dto/TiktokWarehouseDto.java

@ -0,0 +1,25 @@ @@ -0,0 +1,25 @@
package common.ecommerce.lingxing.platform.tiktok.dto;
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Getter;
import lombok.Setter;
/** TikTok 仓库库存({@code wareHouseDataList[]})。 */
@Getter
@Setter
@JsonIgnoreProperties(ignoreUnknown = true)
public class TiktokWarehouseDto {
@JsonProperty("quantity")
private Integer quantity;
@JsonProperty("warehouseId")
private String warehouseId;
@JsonProperty("warehouseName")
private String warehouseName;
@JsonProperty("waitOutboundQuantity")
private Integer waitOutboundQuantity;
}

232
lingxing/src/main/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSource.java

@ -0,0 +1,232 @@ @@ -0,0 +1,232 @@
package common.ecommerce.lingxing.platform.tiktok.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.tiktok.dto.TiktokListingDto;
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.util.ArrayList;
import java.util.Collections;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Locale;
import java.util.Map;
/**
* 领星 · TikTok 在线商品。
*
* <p>接口 {@code /basicOpen/multiplatform/tiktok/list}:POST,{@code offset}/{@code length}
* (上限 1000),返回 {@code data.list};令牌桶容量 1。接口不支持时间窗过滤。</p>
*/
public final class TiktokProductSource implements LingxingProductSource {
private static final int MAX_PAGE_SIZE = 1000;
@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("storeIds",
Collections.singletonList(call.ctx().account().externalStoreId()));
HttpRequest req = call.signed(LingxingApi.LISTING_TIKTOK, body, "products.pull");
HttpResponse resp = call.execute(req);
LingxingEnvelope envelope = call.envelope(resp, "products.pull");
List<TiktokListingDto> dtos = call.json().listAt(envelope.body(), "data.list", TiktokListingDto.class);
List<ProductListing> out = new ArrayList<ProductListing>(dtos.size());
for (TiktokListingDto dto : dtos) {
out.add(toProductListing(dto, call));
}
int total = totalOf(call, envelope.body());
int nextOffset = offset + dtos.size();
boolean hasMore = dtos.size() >= length && (total < 0 || nextOffset < total);
return Page.of(out, hasMore ? String.valueOf(nextOffset) : null);
}
private static int totalOf(LingxingCall call, String body) {
String raw = call.json().stringAt(body, "data.count");
if (raw == null) {
raw = call.json().stringAt(body, "total");
}
if (raw == null) {
return -1;
}
try {
return Integer.parseInt(raw.trim());
} catch (NumberFormatException e) {
return -1;
}
}
/**
* 领星 TikTok 商品 → 统一模型。
*
* <p>统一字段来源:</p>
* <ul>
* <li>platformSku ← {@code msku}</li>
* <li>listingId ← {@code productUniqueId}</li>
* <li>title ← {@code title};为空时回落 {@code pname}(示例中 title 可能为 "")</li>
* <li>imageUrls ← {@code imgUrl}</li>
* <li>status ← {@code platformStatus} 字符串归一</li>
* <li>rawStatus ← {@code platformStatus} 原值</li>
* <li>price ← {@code salesPrice} + {@code currency}</li>
* <li>listedAt / updatedAt ← 无(接口不返回时间字段)</li>
* <li>attributes ← 其余全部原始字段</li>
* </ul>
*/
private ProductListing toProductListing(TiktokListingDto dto, LingxingCall call) {
String currency = currencyOf(dto.getCurrency());
String title = firstNonBlank(dto.getTitle(), dto.getPname());
return ProductListing.builder()
.platform(call.ctx().platform())
.omsStoreId(call.ctx().omsStoreId())
.platformSku(dto.getMsku())
.listingId(trimToNull(dto.getProductUniqueId()))
.title(title)
.imageUrls(isBlank(dto.getImgUrl())
? Collections.<String>emptyList()
: Collections.singletonList(dto.getImgUrl().trim()))
.status(statusOf(dto.getPlatformStatus()))
.rawStatus(dto.getPlatformStatus())
.price(moneyOrNull(dto.getSalesPrice(), currency))
.currency(currency)
.attributes(attributesOf(dto))
.sourceProvider(ChannelProvider.LINGXING)
.build();
}
/**
* TikTok 平台状态字符串归一。
*
* <p>文档枚举:DRAFT / PENDING / FAILED / ACTIVATE / SELLER_DEACTIVATED /
* PLATFORM_DEACTIVATED / FREEZE / DELETED。示例中出现过无下划线写法
* {@code SELLERDEACTIVATED},先去掉下划线再匹配。</p>
*/
private static ProductStatus statusOf(String raw) {
if (raw == null) {
return ProductStatus.UNKNOWN;
}
String s = raw.trim().toUpperCase(Locale.ROOT).replace("_", "").replace(" ", "");
if ("ACTIVATE".equals(s) || "ACTIVE".equals(s)) {
return ProductStatus.ACTIVE;
}
if ("SELLERDEACTIVATED".equals(s)
|| "PLATFORMDEACTIVATED".equals(s)
|| "FREEZE".equals(s)
|| "DRAFT".equals(s)
|| "PENDING".equals(s)
|| "FAILED".equals(s)) {
return ProductStatus.INACTIVE;
}
if ("DELETED".equals(s)) {
return ProductStatus.DELETED;
}
return ProductStatus.UNKNOWN;
}
private static Map<String, Object> attributesOf(TiktokListingDto dto) {
Map<String, Object> attrs = new LinkedHashMap<String, Object>();
attrs.put("id", dto.getId());
attrs.put("storeId", dto.getStoreId());
attrs.put("storeName", dto.getStoreName());
attrs.put("platformCode", dto.getPlatformCode());
attrs.put("mskuId", dto.getMskuId());
attrs.put("sku", dto.getSku());
attrs.put("pid", dto.getPid());
attrs.put("pname", dto.getPname());
attrs.put("goodId", dto.getGoodId());
attrs.put("spu", dto.getSpu());
attrs.put("spuId", dto.getSpuId());
attrs.put("cid", dto.getCid());
attrs.put("cname", dto.getCname());
attrs.put("categoryName", dto.getCategoryName());
attrs.put("bid", dto.getBid());
attrs.put("bname", dto.getBname());
attrs.put("siteCode", dto.getSiteCode());
attrs.put("usableInventory", dto.getUsableInventory());
attrs.put("waitOutboundQuantity", dto.getWaitOutboundQuantity());
attrs.put("wareHouseDataList", dto.getWareHouseDataList());
attrs.put("taxExclusivePrice", dto.getTaxExclusivePrice());
attrs.put("salesPrice", dto.getSalesPrice());
attrs.put("currency", dto.getCurrency());
attrs.put("principalUids", dto.getPrincipalUids());
attrs.put("principalName", dto.getPrincipalName());
attrs.put("companyId", dto.getCompanyId());
attrs.put("notes", dto.getNotes());
attrs.values().removeAll(Collections.singleton(null));
return attrs;
}
/** 货币符号 → ISO。约定 ¥ 符号视为日元,人民币以 CNY 返回。 */
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 ("¥".equals(s) || "¥".equals(s)) {
return "JPY";
}
if ("CNY".equalsIgnoreCase(s) || "RMB".equalsIgnoreCase(s)) {
return "CNY";
}
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 boolean isBlank(String v) {
return v == null || v.trim().isEmpty();
}
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…
Cancel
Save