[Important] CO and CL Category Tree Adjustment in Sep 2021

开发者您好：

为了提供更完善的商品上架功能以及优化商品搜索的精确度，同时为了保持不同站点商品上架的一致性，Shopee调整了商品类目（Category）以及对应的商品属性（Attribute）。Shopee将于2021年09月22日，在哥伦比亚和智利市场更新类目结构。

更新內容:

• 新的类目结构（Category Tree）将适用于所有站点。

• 更多必填的属性。

• 支持更多属性输入格式*

• dropdown多选

• combo box多选

*请注意，此更新适用于Open API 2.0，Open API 1.0的属性输入格式仅支持单选。Open API 2.0 将于近期上线，具体时间敬请留意平台相关信息。

更新上线后对上架商品的影响:

• 现有商品的类目将会自动更新成新的类目，无需开发者/卖家额外调整。

• 新上传的商品必须使用新的类目编号（category_id）才能上架成功，开发者/卖家将无法使用旧的类目编号。

• 新的类目结构与Open API 2.0更为适配，在Open API 2.0中：

• get_category API接口将会返回不同语言的类目名称。

• get_attributes API接口将会返回属性的编号（value_id）和名称（value_name），用以上架商品。

• 一次请求将支持单一属性ID（attribute_id）对应多个value_id或value_name

更新上线前的准备：

1. 熟悉新的类目结构（下载新的类目结构）

2. 若第三方系统有独立的类目对照关系，请准备后续的代码更新和文件调整。

3. 在沙盒环境中测试新的类目结构（请从09月01日后进行测试，届时我们会通过公告及邮件告知您）

请于2021年9月3日前填写此表单，如果此次更新会对您造成任何可能的影响，请告知我们，以便为您提供针对性的支持来帮助您适应此次更新，谢谢。

Hi Developer,

We would like to inform you that the new category tree will be launched for CO and CL markets on 22 September 2021. This was launched for SEA, TW and MX markets in June 2021.

The new category tree will be more stable and consistent across different markets, with new types of attributes introduced. This is to support sellers in filling in more comprehensive product information and optimising search results.

What’s new:

• The category tree structure will be adjusted to be consistent across markets.

• More mandatory attributes will be added.

• New attribute input types will be supported*

• Multi-select dropdown

• Multi-select combo box

*These can only be supported in Open API 2.0. For version 1.0, these attributes will be treated as single-select.

What to expect:

• For all existing listings, the categories will be automatically adjusted by our system to match the new structure. No action will be required.

• For new listings uploaded after the new category tree is launched, do note that the API will only accept the new category ID.

• Category and attribute API will be adjusted to better suit the new structure in Open API 2.0.

• Get_category API will provide the category name in different languages.

• Attribute value_id and value_name can be extracted from the get_attributes API to be used during the listing upload process.

• For newly supported multi-select attribute types, you can input multi value_id or value_name under a single attribute_id in one request.

How to prepare for the changes:

1. Familiarise with the new category tree (download it here)

2. Prepare for any code and document adjustments required, such as offline category mapping relationship

3. Test the new category tree for CO and CL shops in the Sandbox environment (kindly test from 1st Sep on, we will inform you via announcement and email)

Please fill in this form by 3rd Sep to acknowledge that you have understood the above and let us know of the impact you are likely to face, so that we can provide targeted support to ease your transition.