diff --git a/core/src/main/java/common/ecommerce/model/product/ProductListing.java b/core/src/main/java/common/ecommerce/model/product/ProductListing.java
index af6e14d..1f445d1 100644
--- a/core/src/main/java/common/ecommerce/model/product/ProductListing.java
+++ b/core/src/main/java/common/ecommerce/model/product/ProductListing.java
@@ -1,6 +1,8 @@
package common.ecommerce.model.product;
import common.ecommerce.model.ChannelProvider;
+import common.ecommerce.model.Platform;
+import common.ecommerce.model.support.Money;
import common.ecommerce.model.support.PlatformTime;
import java.util.ArrayList;
@@ -10,31 +12,90 @@ import java.util.Objects;
/**
* 统一商品 / Listing。
+ *
+ *
各渠道字段名不同、含义相同的部分,全部在此收敛为标准字段;
+ * 平台原始值另存于 {@code raw*} 字段,便于排查与后续扩展。
+ *
+ * 字段分三组:
+ *
+ * - 标识:platform / omsStoreId / platformSku / listingId / asin …
+ * - 内容:title / description / imageUrls / attributes
+ * - 状态与价格:status / rawStatus / price / currency
+ *
*/
public final class ProductListing {
+ // ---------------------------------------------------------------- 标识
+
+ private final Platform platform;
private final String omsStoreId;
+ /** 平台侧 SKU,参与 canonicalKey。领星 SC 取 seller_sku,VC 取 msku。 */
private final String platformSku;
+ /** 平台自身的 Listing 标识;亚马逊 SC 是 listing_id,VC 无,可空。 */
+ private final String listingId;
+ /** 平台商品编码;亚马逊是 ASIN。 */
+ private final String asin;
+ /** 父商品编码;亚马逊是父 ASIN,变体商品才有。 */
+ private final String parentAsin;
+ /** 全球贸易项目代码,如 UPC / EAN / GTIN。 */
+ private final String gtin;
+
+ // ---------------------------------------------------------------- 内容
+
private final String title;
private final List imageUrls;
- private final String status;
+ /** 平台原始属性(尺寸、变体、排名等未标准化字段),键为渠道字段名。 */
+ private final java.util.Map attributes;
+
+ // ---------------------------------------------------------------- 状态与价格
+
+ /** 归一化状态。 */
+ private final ProductStatus status;
+ /** 平台原始状态值,如 "1"、"-1"、"Active"。 */
+ private final String rawStatus;
+ /** 平台价格;币种见 {@link #currency()}。 */
+ private final Money price;
+ /** 币种代码,如 USD;平台不给时为 null。 */
+ private final String currency;
+ /** 开售时间;平台不提供时为 null。 */
+ private final PlatformTime listedAt;
+ /** 内容最后更新时间;平台不提供时为 null。 */
private final PlatformTime updatedAt;
+
+ // ---------------------------------------------------------------- 来源
+
private final ChannelProvider sourceProvider;
private ProductListing(Builder b) {
+ this.platform = Objects.requireNonNull(b.platform, "platform");
this.omsStoreId = Objects.requireNonNull(b.omsStoreId, "omsStoreId");
this.platformSku = Objects.requireNonNull(b.platformSku, "platformSku");
+ this.listingId = b.listingId;
+ this.asin = b.asin;
+ this.parentAsin = b.parentAsin;
+ this.gtin = b.gtin;
this.title = b.title;
this.imageUrls = Collections.unmodifiableList(new ArrayList(b.imageUrls));
- this.status = b.status;
+ this.attributes = Collections.unmodifiableMap(new java.util.LinkedHashMap(b.attributes));
+ this.status = b.status == null ? ProductStatus.UNKNOWN : b.status;
+ this.rawStatus = b.rawStatus;
+ this.price = b.price;
+ this.currency = b.currency;
+ this.listedAt = b.listedAt;
this.updatedAt = b.updatedAt;
- this.sourceProvider = b.sourceProvider;
+ this.sourceProvider = Objects.requireNonNull(b.sourceProvider, "sourceProvider");
}
public static Builder builder() {
return new Builder();
}
+ // ---------------------------------------------------------------- getters
+
+ public Platform platform() {
+ return platform;
+ }
+
public String omsStoreId() {
return omsStoreId;
}
@@ -43,6 +104,22 @@ public final class ProductListing {
return platformSku;
}
+ public String listingId() {
+ return listingId;
+ }
+
+ public String asin() {
+ return asin;
+ }
+
+ public String parentAsin() {
+ return parentAsin;
+ }
+
+ public String gtin() {
+ return gtin;
+ }
+
public String title() {
return title;
}
@@ -51,10 +128,30 @@ public final class ProductListing {
return imageUrls;
}
- public String status() {
+ public java.util.Map attributes() {
+ return attributes;
+ }
+
+ public ProductStatus status() {
return status;
}
+ public String rawStatus() {
+ return rawStatus;
+ }
+
+ public Money price() {
+ return price;
+ }
+
+ public String currency() {
+ return currency;
+ }
+
+ public PlatformTime listedAt() {
+ return listedAt;
+ }
+
public PlatformTime updatedAt() {
return updatedAt;
}
@@ -63,16 +160,33 @@ public final class ProductListing {
return sourceProvider;
}
+ // ---------------------------------------------------------------- builder
+
public static final class Builder {
+ private Platform platform;
private String omsStoreId;
private String platformSku;
+ private String listingId;
+ private String asin;
+ private String parentAsin;
+ private String gtin;
private String title;
private List imageUrls = Collections.emptyList();
- private String status;
+ private java.util.Map attributes = Collections.emptyMap();
+ private ProductStatus status;
+ private String rawStatus;
+ private Money price;
+ private String currency;
+ private PlatformTime listedAt;
private PlatformTime updatedAt;
private ChannelProvider sourceProvider;
+ public Builder platform(Platform platform) {
+ this.platform = platform;
+ return this;
+ }
+
public Builder omsStoreId(String omsStoreId) {
this.omsStoreId = omsStoreId;
return this;
@@ -83,6 +197,26 @@ public final class ProductListing {
return this;
}
+ public Builder listingId(String listingId) {
+ this.listingId = listingId;
+ return this;
+ }
+
+ public Builder asin(String asin) {
+ this.asin = asin;
+ return this;
+ }
+
+ public Builder parentAsin(String parentAsin) {
+ this.parentAsin = parentAsin;
+ return this;
+ }
+
+ public Builder gtin(String gtin) {
+ this.gtin = gtin;
+ return this;
+ }
+
public Builder title(String title) {
this.title = title;
return this;
@@ -93,11 +227,37 @@ public final class ProductListing {
return this;
}
- public Builder status(String status) {
+ public Builder attributes(java.util.Map attributes) {
+ this.attributes = attributes == null
+ ? Collections.emptyMap() : attributes;
+ return this;
+ }
+
+ public Builder status(ProductStatus status) {
this.status = status;
return this;
}
+ public Builder rawStatus(String rawStatus) {
+ this.rawStatus = rawStatus;
+ return this;
+ }
+
+ public Builder price(Money price) {
+ this.price = price;
+ return this;
+ }
+
+ public Builder currency(String currency) {
+ this.currency = currency;
+ return this;
+ }
+
+ public Builder listedAt(PlatformTime listedAt) {
+ this.listedAt = listedAt;
+ return this;
+ }
+
public Builder updatedAt(PlatformTime updatedAt) {
this.updatedAt = updatedAt;
return this;
diff --git a/core/src/main/java/common/ecommerce/model/product/ProductStatus.java b/core/src/main/java/common/ecommerce/model/product/ProductStatus.java
new file mode 100644
index 0000000..94eea66
--- /dev/null
+++ b/core/src/main/java/common/ecommerce/model/product/ProductStatus.java
@@ -0,0 +1,20 @@
+package common.ecommerce.model.product;
+
+/**
+ * 统一商品状态。
+ *
+ * 各渠道原始状态值不同(领星亚马逊 SC 是 0/1,VC 是 -1/0/1,其它平台可能是字符串),
+ * 由各自的 Mapper 归一到这里;无法识别时用 {@link #UNKNOWN},并保留原值在
+ * {@link ProductListing#rawStatus()}。
+ */
+public enum ProductStatus {
+
+ /** 在售。 */
+ ACTIVE,
+ /** 停售。 */
+ INACTIVE,
+ /** 已删除。 */
+ DELETED,
+ /** 无法识别;原值见 {@code rawStatus}。 */
+ UNKNOWN
+}
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/sc/dto/AmazonScListingDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/sc/dto/AmazonScListingDto.java
index 8cbebff..1b5ac59 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/sc/dto/AmazonScListingDto.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/sc/dto/AmazonScListingDto.java
@@ -5,6 +5,9 @@ import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Getter;
import lombok.Setter;
+import java.util.ArrayList;
+import java.util.List;
+
/**
* 领星 · 亚马逊 SC Listing({@code /erp/sc/data/mws/listing} 的 {@code data[]})。
*
@@ -70,4 +73,184 @@ public class AmazonScListingDto {
/** 商城所在国家。 */
@JsonProperty("marketplace")
private String marketplace;
+
+ /** 亚马逊定义的 Listing id,可能为空。 */
+ @JsonProperty("listing_id")
+ private String listingId;
+
+ /** FNSKU。 */
+ @JsonProperty("fnsku")
+ private String fnsku;
+
+ /** 本地产品 SKU。 */
+ @JsonProperty("local_sku")
+ private String localSku;
+
+ /** 本地品名。 */
+ @JsonProperty("local_name")
+ private String localName;
+
+ /** 备注。 */
+ @JsonProperty("remark")
+ private String remark;
+
+ /** List Price。 */
+ @JsonProperty("list_price")
+ private String listPrice;
+
+ /** 含促销、运费、积分的总价。 */
+ @JsonProperty("landed_price")
+ private String landedPrice;
+
+ /** 优惠价。 */
+ @JsonProperty("listing_price")
+ private String listingPrice;
+
+ /** 运费。 */
+ @JsonProperty("shipping")
+ private String shipping;
+
+ /** 积分(日本站才有)。 */
+ @JsonProperty("points")
+ private String points;
+
+ /** FBM 库存。 */
+ @JsonProperty("quantity")
+ private Integer quantity;
+
+ /** FBA 可售。 */
+ @JsonProperty("afn_fulfillable_quantity")
+ private Integer afnFulfillableQuantity;
+
+ /** FBA 不可售。 */
+ @JsonProperty("afn_unsellable_quantity")
+ private Integer afnUnsellableQuantity;
+
+ /** 待调仓。 */
+ @JsonProperty("reserved_fc_transfers")
+ private Integer reservedFcTransfers;
+
+ /** 调仓中。 */
+ @JsonProperty("reserved_fc_processing")
+ private Integer reservedFcProcessing;
+
+ /** 待发货。 */
+ @JsonProperty("reserved_customerorders")
+ private Integer reservedCustomerorders;
+
+ /** 在途。 */
+ @JsonProperty("afn_inbound_shipped_quantity")
+ private Integer afnInboundShippedQuantity;
+
+ /** 计划入库。 */
+ @JsonProperty("afn_inbound_working_quantity")
+ private Integer afnInboundWorkingQuantity;
+
+ /** 入库中。 */
+ @JsonProperty("afn_inbound_receiving_quantity")
+ private Integer afnInboundReceivingQuantity;
+
+ /** 预计 FBA 费(API 口径)。 */
+ @JsonProperty("fba_fee")
+ private String fbaFee;
+
+ /** FBA 费更新时间(API 口径)。 */
+ @JsonProperty("fba_fee_update_time")
+ private String fbaFeeUpdateTime;
+
+ /** 预计 FBA 费(报表口径)。 */
+ @JsonProperty("report_fba_fee")
+ private String reportFbaFee;
+
+ /** FBA 费更新时间(报表口径)。 */
+ @JsonProperty("report_fba_fee_update_time")
+ private String reportFbaFeeUpdateTime;
+
+ /** 平台费(报表口径)。 */
+ @JsonProperty("estimated_referral_fee")
+ private String estimatedReferralFee;
+
+ /** 平台费率,形如 15.0%,无法计算时为空串。 */
+ @JsonProperty("estimated_referral_fee_rate")
+ private String estimatedReferralFeeRate;
+
+ /** 品牌。 */
+ @JsonProperty("seller_brand")
+ private String sellerBrand;
+
+ /** 排名类别(已废弃,用 seller_category_new)。 */
+ @JsonProperty("seller_category")
+ private String sellerCategory;
+
+ /** 排名类别(新)。 */
+ @JsonProperty("seller_category_new")
+ private List