添加产品时的必填和选填属性

我们整理出了使用 CSV 和 API 添加/编辑产品时可能用到的所有产品属性（不含品类特有属性，品类特有属性可前往产品 > 品类和属性页面查看），并列出了必填属性表格（哪些属性是必填取决于商户要做的 CSV 操作）。请注意，有些产品属性已被重命名，具体请参见下表。

必填属性

点击“属性”可跳转至相应的属性说明和可接受的值示例。

*注意：对于所有编辑 CSV 的操作，您可以将不需要修改的“选填”字段从下载的 CSV 模板中移除。如果不移除，所有保留下来的字段都被视为“必填”字段，且文件中所有行/产品都必须填写这些字段。举例而言，如果您使用的是“编辑价格/库存”CSV 模板，移除“Inventory”（库存）字段后仍可以成功提交该 CSV 文件。而如果保留“Inventory”（库存）字段，则文件中的所有产品都必须填写该字段，否则将无法提交该 CSV 文件。

属性列表

Brand ID

类型：字符串

提供所售产品的产品品牌 ID。

产品必须是正品，并由品牌所有者直接制造。例如，Apple 是 iPhone 或 iPad 的品牌名。但对于不是由 Apple 制造的 iPhone 手机壳，Apple 则不是其品牌名。

访问品牌目录，以查看可供选择的品牌列表或请求添加新品牌。

例如：

• 可接受：545d5e6a6fa88c38cdfe0735

California Proposition 65 Chemical Names

类型：字符串

为遵守《加州65号提案》的规定，请提供产品适用的化学品名称（如有）。如果您选择的警告类型为“Food”（食品）、“Furniture”（家具）或“Chemical”（化学品）（参见上文列出的属性），则必须提供至少一种化学品名称。 

如果使用 CSV 文件上传，多个化学品名称可用“|”分隔。您可以提供最多5种化学品名称。详细了解《加州65号提案》警告信息。

例如：

• 可接受：Benzyl Chloride
• 可接受：Lead
• 可接受：Nalidixic Acid
• 不可接受：Chemical 

California Proposition 65 Warning Type

类型：字符串

为遵守《加州65号提案》的规定，请为产品提供适用的警告类型（如果有），包括“Chemical”（化学品）、“Food”（食品）、“Furniture”（家具）、“On_Product_Cancer”（产品加贴癌症警告）、“On_Product_Combined_Cancer_Reproductive”（产品加贴癌症和生殖伤害警告）、“On_Product_Reproductive”（产品加贴生殖伤害警告）、“Raw_Wood”（原木）或“Diesel_Engines”（柴油发动机）”。详细了解《加州65号提案》合规信息。

例如：

• 可接受：Chemical
• 可接受：Food
• 可接受：On_Product_Cancer
• 不可接受：Other

Clean Image 

类型：字符串

产品干净图片的 URL。必须与主图 URL 或其中一张现有的辅图 URL 或新添加图片的 URL 相同。选择干净图片的产品可能会获得更多曝光量和销量。请参阅“如何选择干净图片”（包括图片指南）。 

例如：

• 可接受：http://www.yourwebsite.com/images/7324204/3.png
• 可接受：http://www.yourwebsite.com/images/dress.jpg
• 不可接受：https://www.your website.com/images/7324204/3
• 不可接受：http://www.yourwebsite.com/images/dresses.html

Color

注意：如果您的产品属于以下品类，我们建议您使用“Primary color”（主色）字段输入您的产品颜色：配饰、手机与通信、计算机与办公配件、消费类电子产品、娱乐、家居与园艺、家居装饰、珠宝与配饰、箱包、男装、鞋类、运动或玩具与兴趣爱好。其他品类的产品请使用本字段。

类型：字符串

产品的颜色。如果要写两个颜色，请使用“&”符号将颜色分开（例如：black & red）。注意：这与产品有两个不同颜色的变体的情况不同。每个颜色变体在 CSV 文件中必须独立成行，并具有唯一的 SKU 和单独的库存数量。此处输入的颜色名称必须是 Wish 接受的颜色列表中的颜色。

例如：

• 可接受：red
• 可接受：black & blue
• 不可接受：red, blue
• 不可接受：black & blue & green

Condition

注意：如果您的产品属于手机与通信、计算机与办公配件、消费类电子产品、电子组件与电子用品，我们建议您使用“Item condition”（产品状态）字段输入该产品的状态。其他品类的产品请使用本字段。

类型：字符串

提供产品的状态。您可以输入“New”（全新）、“Used”（二手）或“Refurbished”（翻新）。请务必提供此信息，以便该产品的欧盟路向订单能够顺利办理通关手续。

例如：

• 可接受：New
• 可接受：Used
• 可接受：Refurbished
• 不可接受：Old

Contains Battery

类型：布尔

含电池或可能内置电池的产品，且电池无法拆卸且可能可以充电。

例如：

• 可接受：Yes
• 可接受：No
• 不可接受：0

Contains Liquid

类型：布尔

含可自由流动但体积恒定且粘稠度与水或油相似的物质的产品，包括乳霜、凝胶、润滑剂等半液体。

例如：

• 可接受：Yes
• 可接受：No
• 不可接受：0

Contains Metal

类型：布尔

由金属制成或材料成分中含有金属的产品。金属是一种固体材料，通常比较坚硬、有光泽、可延展、可熔化、有韧性，以及导电和导热。

例如：

• 可接受：Yes
• 可接受：No
• 不可接受：0

Contains Powder

类型：布尔

完全由细小且干燥的颗粒组成的任何产品。

例如：

• 可接受：Yes
• 可接受：No

不可接受：0

Country of Origin

类型：字符串

制造、生产或培育产品的国家/地区。国家/地区编码需遵循 ISO 3166 Alpha-2 编码规则。

例如：

• 可接受：CN
• 可接受：US
• 不可接受：China

Currency Code

类型：字符串

您的货币代码，用于您的所有产品，必须和您的本地货币相匹配。 

例如：

• 可接受：USD
• 可接受：CNY
• 不可接受：中文

Customs Declared Name

类型：字符串

报关时使用的产品申报名称，通常显示在产品包装上。

例如：

• 可接受：Repair Tools Kit Set
• 可接受：Rings
• 不可接受：!Rings
• 不可接受：T
• 不可接受：Good 衬衫
• 不可接受：超过200个字符的名称

Customs Declared Value

类型：数字（小数）

向海关申报的产品货值（以美元为单位），通常显示在产品包装上。

例如：

• 可接受：$100.99
• 可接受：10.99
• 不可接受：$49.99 + S/H

Customs Harmonization System (HS) Code

类型：字符串

用于报关的 HS 编码分类，通常显示在产品包装上。

例如：

• 可接受：33021010.00
• 可接受：6403.20
• 不可接受：2
• 不可接受：a

Default Shipping Price

类型：数字（小数）

产品的默认运费，自动应用于您未设置运费的国家/地区。

例如：

• 可接受：100.99
• 可接受：10.99
• 不可接受：49.99 + S/H

Description 

类型：字符串 

产品的详细描述，长度不得超过4000个字符。不得包含任何 HTML 码、店铺政策细节或店铺特定的其他术语。 

例如：

• 可接受：This dress shirt is 100% cotton and fits true to size.
• 可接受：This <b>dress shirt</b> is 100% cotton and <i>fits true to size</i>.

Enabled

类型：字符串

输入“Yes”即可在 Wish 平台上启用此 SKU。用户可以查看并购买已启用的产品。同样，输入“No”可禁用此 SKU。

例如：

• 可接受：“yes”或“no”
• 不可接受：True
• 不可接受：Enable

Extra Images 

类型：字符串

产品图片的 URL 列表，以竖线“|”分隔。直接链接至图片，而非其所在页面。使用规则与主图 URL 属性相同。URL 的顺序决定了图片在产品页面上的显示顺序。若要修改现有图片或添加新图片，需要提供所有的辅图 URL，包括未作改动的图片 URL。如果没有提供辅图 URL，则不会进行更新。支持的图片格式包括 JPEG、PNG 或 GIF。图片尺寸应至少为500 x 500像素。 

例如：

• 可接受：http://www.yourwebsite.com/images/7324204/3| https://www.yourwebsite.com/images/dress.jpg
• 可接受：http://www.yourwebsite.com/images/dress.jpg
• 不可接受：http://www.yourwebsite.com/images/dresses.html

GTIN 

类型：字符串

应为12至14位 GTIN（UPC、EAN、ISBN），不含字母和其他字符。此数字用于跟踪店内产品，以及在销售时可供扫描。

例如：

• 可接受：716393133224
• 不可接受：asdf884445ds

Inventory 

类型：整数 

SKU 的库存量。请为 Wish 指定库存设置库存缓冲。最大值为500,000，超过此值的库存量会自动降低。

例如：

• 可接受：1200
• 可接受：0
• 可接受：4
• 不可接受：In stock
• 不可接受：Out of Stock

Main Image 

类型：字符串 

产品图片的 URL。直接链接到图片，而非其所在的页面。接受 JPEG 或 GIF 格式。请勿包含公司徽标、名称、促销或其他标识性文字。图片的像素至少为 500 x 500。请勿包含任何“image not found”（找不到）的图片。 

例如：

• 可接受：http://www.yourwebsite.com/images/7324204/3.png
• 可接受：http://www.yourwebsite.com/images/dress.jpg
• 不可接受：http://www.yourwebsite.com/images/dresses.html

Max Quantity

类型：整数

每个订单中产品的数量上限。此功能旨在让用户拆分大订单，以便于管理和跟踪。仅极少数情况下会用到。

例如：

• 可接受：100
• 可接受：10
• 可接受：1
• 不可接受：0

Name

类型：字符串 

使用以下模板编辑您的产品名称：主品牌 + 副品牌，系列或产品名称 + 至多三个关键属性 + 通用的产品品类。产品名称必须清晰、简洁，并且能够准确描述所售产品。此模板有助于用户识别您的产品。

例如：

• 可接受：Nikon D5100 DSLR Camera (Body Only) USA MODEL
• 可接受：Sony VAIO 15" Laptop
• 不可接受：Best Price!!! ***CHEAP*** Baby Stroller!!!

Package Height

类型：数字（小数）

发货给用户的产品包裹的高度（单位：厘米）。

例如：

• 可接受：13.40

Package Width

类型：数字（小数）

发货给用户的产品包裹的宽度（单位：厘米）。

例如：

• 可接受：13.40

Package Length

类型：数字（小数）

发货给用户的产品包裹的长度（单位：厘米）。

例如：

• 可接受：10

Package Weight

类型：数字（小数）

发货给用户的产品的重量（单位：克）。对于中国大陆商户创建的产品，这是必填字段。

例如：

• 可接受：151.5
• 可接受：10

Parent SKU 

类型：字符串

父 SKU 是产品的唯一标识符。使用 CSV 文件编辑或添加新产品时，必须提供父 SKU。 

例如：

• 可接受：HSC0424PP
• 可接受：112123343455432
• 不可接受：2
• 不可接受：a

Pieces Included

类型：整数

产品内含的件数。

例如：

• 可接受：2
• 可接受：1
• 不可接受：-1

Price

类型：数字（小数）

以“Currency Code”（货币代码）字段中指定的货币计算的产品价格。您也可以在货币设置下或通过 API 端口 GET /api/v3/merchant/currency_settings 进行查看。用户按照换算为您的本地货币之后的金额来支付。 

例如：

• 可接受：100.99
• 可接受：10.99
• 不可接受：49.99 + S/H

Quantity Value

类型：数字（小数）

产品变体的总数量（使用指定的单位），用于计算产品的单价（根据下文所给公式计算）。请注意，如果某件产品具有多个产品变体，则须为每个产品变体设置数量值。

（产品价格 * 参考值）/数量值 = 单价（显示每参考值的价格，采用商户设置的单位）

举例而言，您上架一款200毫升的瓶装香水，售价33.12美元，您希望显示产品的每100毫升价格：

• 计量方式 = 英制体积
• 单位 = ml（毫升）
• 数量值 = 200
• 参考值 = 100
• 单价 = ($33.12 * 100) /200 = 16.56美元/100毫升

了解如何设置单价和单价产品属性。

例如：

• 可接受：1
• 可接受：15
• 不可接受：ABCXYZ

Reference Price

类型：数字（小数）

产品详情页有一个参考价格字段。如果商户选择在此字段中填入数值，则该数值必须符合产品参考价格政策。 

例如：

• 可接受：716393133224
• 不可接受：asdf884445ds

Reference Value

类型：数字（小数）

参考值（使用指定的单位）用于计算产品的单价，旨在向用户展示产品的单位计数（根据下文所给公式计算）。

（产品价格 * 参考值）/数量值 = 单价（显示每参考值的价格，采用商户设置的单位）

例如，您上架一款200毫升的瓶装香水，售价33.12美元，您希望显示产品的每100毫升价格：

• 计量方式 = 英制体积
• 单位 = 毫升
• 数量值 = 200
• 参考值 = 100
• 单价 = ($33.12 * 100) / 200 = 16.56美元/100毫升

了解如何设置单价产品属性。

例如：

• 可接受：100
• 可接受：38
• 不可接受：ABCXYZ

Shipping Price US（原为 US）

注意：要更新不同国家/地区的本地货币运费，请使用配送国家/地区列表中对应的两个字母的国家代码（而非 US）。

类型：数字（小数）

适用于在美国购物的用户的本地货币运费。 

例如：

• 可接受：1.99
• 不可接受：1.99+
• 可接受：disabled
• 可接受：enabled

Shipping Price US_HI 

类型：数字（小数）

在美国夏威夷地区购物的用户支付的地区运费。您可以指定“disabled”（禁用）或“enabled”（启用）来决定这个地区的用户是否可以购买此产品。还可以指定“use country shipping price”（使用国家/地区运费）取消设置地区运费。若要更新其他地区的运费，请使用其对应的国家/地区代码 + 短下划线 + 地区代码来代替 US_HI。

例如：

• 可接受：1.99
• 可接受：disabled
• 可接受：enabled
• 可接受：use country shipping price
• 不可接受：1.99+

Size

类型：字符串

产品尺码，服装、鞋类或首饰类产品尤其需要提供尺码。每个尺码变体在 CSV 文件中必须有对应的行，并有其单独的 SKU 编号及库存数量。此处需填写数字或 Wish 可接受的尺码列表中提供的尺码。

例如：

• 可接受：S
• 可接受：XXL
• 可接受：6
• 可接受：6.5
• 不可接受：small
• 不可接受：S, M

SKU 

类型：字符串 

SKU 用于标识产品的唯一变体（父 SKU）。每个父 SKU 可以拥有多个唯一的 SKU。添加或编辑产品变体都需要提供此 SKU。 

例如：

• 可接受：HSC0424PP
• 可接受：112123343455432
• 不可接受：2
• 不可接受：a

Tags

类型：字符串

Feed 文件中分配给每个产品的无等级之分的关键字或关键词。这些关键字词有助于描述产品和进行分类，且方便于在 Wish 平台上浏览或搜索时再次找到。标签应使用逗号分隔，但标签中不能使用逗号。添加的标签越多，标签的准确性越高，用户找到您的产品的机率越高。每个产品最多可添加10个标签。如果添加的标签超过10个，多余的标签将被忽略。

例如：

• 可接受：Shirt, Men's Fashion, Navy, Blue, Casual, Apparel
• 可接受：Women's Fashion、Jewelry & Watches
• 可接受：Men's Fashion、Suits、Mafia、Silk Tie、Ties
• 不可接受：Clearance Items
• 不可接受：Cheap Cheap Cheap
• 不可接受（标签过多）：Fashion, Suits, Ties, Silk Ties, Men's Suits, Italian Made Suits, Italian, Men's Fashion, Hand Crafted, Silk, High Quality

US TTD（妥投用时）

注意：要更新不同国家/地区的 TTD，请使用配送国家/地区列表中对应的两个字母的国家代码（而非 US）。

类型：字符串

给定国家或地区的指定妥投用时。TTD 是指从下订单开始到确认妥投之间的这段时间。如果禁用了此国家/地区路向的配送服务，此列也必须设置为“unset”。 

例如：

• 可接受：4
• 不可接受：one
• 不可接受（超过15天）：20
• 不可接受（非正数）：-2
• 不可接受（非整数）：20.5

Unit

类型：字符串

产品总含量的计量单位，用于显示产品的单价（根据下文所给公式计算），并用作参考值和数量值的计量单位。 

（产品价格 * 参考值）/数量值 = 单价（显示每参考值的价格，采用商户设置的单位）

例如，您上架一款200毫升的瓶装香水，售价33.12美元，您希望显示产品的每100毫升价格：

• 计量方式 = 英制体积
• 单位 = 毫升
• 数量值 = 200
• 参考值 = 100
• 单价 = ($33.12 * 100) / 200 = 16.56美元/100毫升

了解如何设置产品的单价。

例如：

• 重量：ounce（盎司）、pound（磅）、gram（克）、milligram（毫克）、kilogram（千克）
• 美制体积：fluid_ounce（液量盎司）、pint（品脱）、quart（夸脱）、gallon（加仑）
• 公制体积：milliliter（毫升）、centiliter（厘升）、liter（升）、cubicmeter（立方米）
• 长度：inch（英寸）、foot（英尺）、yard（码）、centimeter（厘米）、meter（米）
• 面积：square_foot（平方英尺）、square_meter（平方米）
• 每单位：count（件）、load（缸）、wash（次）、roll（卷）、pod（包）

Variation Image 

类型：字符串

注意：只有在有变体时才需要提供。每个变体必须提供图片（并非必须是不同的图片）。

产品图片的 URL。直接链接到图片，而非其所在的页面。接受 JPEG、PNG 或 GIF 格式。请勿包含公司徽标、名称、促销或其他标识性文字。图片的像素至少为500 x 500。请勿包含任何“image not found”（找不到）的图片。不接受以 https:// 开头的图片 URL。

例如：

• 可接受：http://www.yourwebsite.com/images/7324204/3.png
• 可接受：http://www.yourwebsite.com/images/dress.jpg
• 可接受：REMOVE_ALL
• 不可接受：https://www.your website.com/images/7324204/3
• 不可接受：http://www.yourwebsite.com/images/dresses.html

Variation Option

类型：字符串

该字段用于定义创建变体时使用的参数。您可以使用传统的“Color”（颜色）和“Size”（尺码）字段来创建变体，也可以使用品类特有的属性。在相关产品行的“Variation Option”（变体选项）列（如果有多个，则用逗号分隔）下填写所需属性的名称，并确保每个变体 SKU 在该字段都定义了唯一值。 

要查找可用于创建变体的品类特有属性，请前往“品类和属性”页面，选择所需的品类，然后点击“查看属性”。“已为变体启用”列指明属性是否可以用作变体选项。 

例如：

• 可接受：使用品类特有属性作为参数来创建变体。下表展示了添加男士皮带的变体的情况：

• 可接受：使用传统参数来创建变体（在品类特有属性中缺少参数或该特有属性无法用作参数时使用)。下表展示了使用传统的颜色和尺码属性来表示妆前乳（彩妆 > 面部 > 妆前乳）的变体的情况，因为该品类没有品类特有属性。这里的“Size”（尺码）用来表示光泽度，而“Color”（颜色）用来表示颜色：

Video URL

类型：字符串

为此产品上传的演示视频的 URL；请参见如何上传产品视频。

例如：

• 可接受：http://www.yourwebsite.com/videos/demo.mp4
• 不可接受：https://www.youtube.com/watch?v=123465789
• 不可接受：http://www.yourwebsite.com/video/dresses.html

Warehouse 

类型：字符串

请提供您内部使用的唯一仓库名，以用于区分各仓库。运费和库存仅应用于指定仓库。若您未特别指定仓库，则这些数据将应用于您账户关联的默认仓库。

例如：

• 可接受：US_94132
• 可接受：SZ_CN
• 不可接受：2
• 不可接受：a