[Action Required] BR Category Tree Adjustment in Jan 2022

Hi Developer,

The category tree will be adjusted to 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.

The new category tree has been launched in most sites in Jun 2021, and will be launched in Jan 2022 in Brazil. The exact launch dates for each market and more details will be shared nearer to the date.

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.

• 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.

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

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

c. 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. From now till early Dec:

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

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

2. In early Dec:

a. The sandbox environment will be ready for developers to retrieve the new category structure and conduct testing. We will send out the detailed testing instructions nearer to date.

b. We will share the detailed rollout date, so that you can adapt your system or interface swiftly to the new category and attribute structure on the launch day with minimal impact.

开发者您好:

为了提供更完善的商品上架功能以及优化商品搜索的精确度，同时为了保持不同站点商品上架的一致性，Shopee调整了商品类目（Category）以及对应的商品属性（Attribute）。

大部分市场已于今年6月和9月上线了新的类目结构，巴西市场将于2022年1月上线新类目结构。具体的上线时间请留意后续公告。

更新內容:

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

• 更多必填的属性

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

• dropdown多选

• combo box多选

*请注意，此更新适用于Open API 2.0，Open API 1.0的属性输入格式仅支持单选。

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

• 现有商品的类目将会自动更新成新的类目，无需开发者/卖家额外调整
• 新上传的商品必须使用新的类目编号（category_id）才能上架成功，开发者/卖家将无法使用旧的类目编号
• 新的类目结构与Open API 2.0更为适配，在Open API 2.0中

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

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

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

更新上线前的准备：

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

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

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