商品创建准备

创建商品前，您需要通过API拿到创建商品所需要的类目，属性，品牌，发货天数，类目是否支持尺寸表等信息，为创建商品做准备。

每个商品都有唯一的一个类目，您可以通过v2.product.get_category接口获取Shopee支持的所有类目数据。每一个节点的类目都有唯一的category_id。

1.1 全球类目数据

为了方便卖家销售多个市场，Shopee的类目树数据适用于所有的市场，但我们仍然会根据市场的地方政策，将部分类目设置为市场禁售，即会出现v2.product.get_category接口用马来西亚店铺请求，您可以获取到类目A，但是通过新加坡店铺，您获取不到类目A的情况。这是因为不同站点可用的类目不同。跨境和本土销售的政策也有所不同，所以类目数据也会有差异。对于不同类型的卖家，支持的类目数据也有细小的差异。

所以，为了您拿到最准确类目数据，建议根据不同店铺进行获取。

1.2 类目树

V2.product.get_category接口返回该店铺所有可用的类目。

parent_category_id=0时，表示这是第一级类目，否则，将返回这个类目的上一级类目，当​​​​has_children=false表示最后一级类目，否则，表示这个类目还有子类目。请注意，创建或者更新商品只能使用has_children=false的类目ID。

例如：类目树路径为Level 1 category→Level 2 category→Level 3 category，接口返回将会是

"category_list": [

{

"display_category_name": "Level 1 category",

"has_children":true,

"category_id": 105899,

"original_category_name": "Level 1 category",

"parent_category_id": 0

},

{

"display_category_name": "Level 2 category",

"has_children": true,

"category_id":109889,

"original_category_name": "Level 2 category",

"parent_category_id":105899

},

{

"display_category_name": "Level 3 category",

"has_children":false,

"category_id":107839,

"original_category_name": "Level 3 category",

"parent_category_id":109889

}

]

​​

1.3 推荐类目

为了帮助卖家快速找到商品类目，您也可以调用​​​​​​​​v2.product.category_recommend接口，接口将根据商品名称和商品图片，返回推荐的类目列表。

每个类目有不同的属性数据。v2.product.get_attribute_tree 接口将返回某个类目的属性数据，但是请注意只能查询最后一级类目的属性数据。

2.1 必填属性和可选属性

当您创建或者更新商品时，商品必须具有所有必填属性的值，但可以缺少可选属性。v2.product.get_attribute_tree 接口返回参数​​​​​​​​​​is_mandatory：true 表示必填属性，false为可选属性。

2.2 属性的类型

根据属性值是否支持多选、是否支持自定义填写、是否提供可选属性值，我们将属性区分了多种类型，您可以通过 v2.product.get_attribute_tree 接口返回参数​​input_type获取得到：

*下图表示COMBO_BOX 样式，卖家可以选择Shopee属性列表Elliptical Trainers的值，也可以选择自定义，点击Add a new item 按钮后自定义填写。

请注意：

• 对于支持多选的属性，您可以通过参数max_input_value_number获取到最多能填写多少个属性值。
• 您可以通过attribute_value_list参数获取到Shopee提供可填写的属性值列表。

2.3 属性值的数据类型

属性值有规定的数据类型，您需要按照要求的数据类型上传属性值。您可以通过v2.product.get_attribute_tree 接口返回参数input_validation_type参数获取属性值的数据类型。数据类型包括：

• INT_TYPE：整型
• STRING_TYPE：字符串类型
• ENUM_TYPE：枚举值类型
• FLOAT_TYPE：浮点类型
• TIMESTAMP_TYPE ：时间戳类型，例如1624007700
• DATE_TYPE：日期类型，包含两种，一种年月日，一种年月，例如06/2021 或者31/06/2021，您可以通过 v2.product.get_attribute_tree 接口返回参数date_format_type获取到日期类型。

请注意：实际创建/更新商品时的attribute value请输入时间戳，但是获取商品详情attribute value将会返回日期类型。

2.4 属性值单位

例如，长度这个属性，我们允许卖家选择“cm”、“m”等单位，所以您需要知道哪些属性的属性值可以填写单位以及属性值可用哪些单位。您可以调用v2.product.get_attribute_tree 接口获取这些信息。

返回参数format_type：QUANTITATIVE表示属性值要填写单位，NORMAL表示属性值不可以填写单位。

返回参数attribute_unit返回这个属性的属性值可用的单位。

*对于Shopee提供的属性值列表中，我们也会将属性值的数值和单位分开显示，即attribute_value_list中的original_value_name将返回属性值的数值，value_unit将返回属性值的单位。

2.5 父属性和父品牌

对于某些属性之间我们会设置关联。例如，Weight Type这个属性，卖家可选择的属性值包含Body Weights 、Barbells。另一个属性Body Weights Type我们设置了它与属性值Body Weights相关联，则当卖家选择了Body Weights的属性值时，则也可以填写Body Weights Type的属性值。

*选择Barbells并没有显示出Body Weights Type的属性。

*选择Body Weights后则显示了Body Weights Type的属性。

接口返回结果：

{

"attribute_id": 100643,

"original_attribute_name": "Weight Type",

"display_attribute_name": "Weight Type",

"is_mandatory": false,

"input_validation_type": "STRING_TYPE",

"format_type": "NORMAL",

"input_type": "COMBO_BOX",

"attribute_unit": [],

"attribute_value_list": [{

"value_id": 3300,

"original_value_name": "Barbells",

"display_value_name": "Barbells"

}, {

"value_id": 3341,

"original_value_name": "Body Weights",

"display_value_name": "Body Weights"

}],

"max_input_value_number": 1

}, {

"attribute_id": 100602,

"original_attribute_name": "Body Weights Type",

"display_attribute_name": "Body Weights Type",

"is_mandatory": false,

"input_validation_type": "STRING_TYPE",

"format_type": "NORMAL",

"input_type": "MULTIPLE_SELECT_COMBO_BOX",

"attribute_unit": [],

"attribute_value_list": [{

"value_id": 3164,

"original_value_name": "Ankle",

"display_value_name": "Ankle",

"parent_attribute_list": [{

"parent_attribute_id": 100643,

"parent_value_id": 3341

}]

}, {

"value_id": 3176,

"original_value_name": "Belt",

"display_value_name": "Belt",

"parent_attribute_list": [{

"parent_attribute_id": 100643,

"parent_value_id": 3341

}]

}],

"max_input_value_number": 5

}

在这个例子中，我们称Weight Type为父属性，Body Weights Type为子属性。如果您需要使用子属性，则必须上传关联的父属性的属性值。

parent_brand_list 也是一样的道理，您可以通过v2.product.get_brand_list接口获取可用的品牌列表值。

2.6 推荐属性

为了帮助卖家快速找到商品推荐填写的属性，您也可以调用​​​​​​​​v2.product.get_recommend_attribute接口，卖家可以上传商品名称和商品图片，接口将会返回推荐的属性列表。注意，这个接口可能不会返回必填的属性。

您可以为商品上传品牌信息，但我们会要求某些类目需要必须填写品牌信息，并且每个类目支持填写的品牌列表不同，所以您可以通过v2.product.get_brand_list接口将获取到某个类目（只能用最后一级类目请求）支持的品牌列表数据。

参数is_mandatory：true 表示这个类目必须填写品牌信息。

*如果Shopee提供的品牌列表不包含您所需要的品牌，您可以向Shopee提交注册品牌申请，请调用v2.product.register_brand API，审核详细流程请参考FAQ。

*如果您的商品没有品牌，Shopee提供的品牌列表中，包含No Brand（brand_id: 0)的选项，您可以选择此选项进行上传。

v2.product.get_brand_list 接口请求参数中，status：1为Shopee 提供的品牌列表，2为您提交申请后等待审核的品牌列表。

我们对不同的类目和不同类型的卖家，都有不同的发货天数要求，卖家需要在发货天数内履行订单，对于特定的类目，我们支持您设置商品为预售商品，发货天数将比较长。您可以通过 v2.product.get_item_limit 接口获取发货天数信息。

如果days_to_ship_limit里min_limit和max_limit同时返回的值是-1，则表示类目不支持预售，当返回大于0的值时，即为这个类目可以填写的预售天数范围。如果类目不支持预售，non_pre_order_days_to_ship参数将返回Shopee为这个类目设置的商品发货天数。

我们支持部分类目的商品上传尺寸表，您可以通过v2.product.support_size_chart接口查询到类目（最后一级类目）是否支持图片类型的尺寸表。

*请注意，我们正在推出表格类型的尺寸表格式，目前只有部分白名单卖家可以通过卖家中心使用，open api还不支持返回支持表格类型的类目以及上传表格类型的尺寸表，所以白名单卖家请忽略通过v2.product.support_size_chart接口获取的结果。

我们对商品信息有一定的限制，例如商品名称能填写的字符长度，商品价格填写范围等，我们针对不同的市场，不同类型的卖家都有不同的限制。您可以通过v2.product.get_item_limit 接口获取到我们设置的范围。

商品能选的物流渠道您可以通过v2.logistics.get_channel_list接口获取logistics_channel_id​​，您只能选择为商品选择enabled=true 且mask_channel_id=0的渠道。