[Important] Category Tree Adjustment in June 2021 - Quantitative Attribute

Dear Developer,

After global category is live, there will be a new format type of attribute - quantitative attribute which requires user to include unit in the attribute value when creating product and the applicable units are determined by Shopee. Currently v2 get_attributes API can accommodate this new format type but v1 GetAttributes API doesn’t have any field to indicate whether the attribute is quantitative or normal, users uisng v1 may not be able to include attribute unit properly and fail to create product.

Thus, there will be some minor changes in v1 to resolve this issue:

1. In GetAttribute API, add response parameter “format_type” to output value “quantitative” and “normal”.

2. In GetAttribute API, add response parameter “attribute_unit” to output the applicable units when the attribute input type is “COMBO_BOX” or “TEXT_FILED”.

3. In Item.Add and Item.Update APIs, there won’t be any change. If you fail to include the correct unit the error message will return the applicable units.

These new parameters will be released in Live environment on 8 June 2021 to facilitate global category rollout starting from 9 June 2021 for different regions. You can test it in Sandbox from 8 June 2021.

Thanks!

尊敬的开发者，

Global category上线后将会有一种新的属性格式类型：Quantitative Attribute，这种属性格式要求卖家上传属性值时必须包含单位，且有效可用单位由shopee定义。目前v2 get_attributes接口可以支持这种新属性格式，但v1 GetAttributes接口没有字段标示属性格式是Quantitative还是Normal，所以开发者无法得知需要上传单位以及有效可用单位了，导致创建商品或者更新商品时失败。

为了解决此问题，我们将对v1接口做以下微调：

1. 在GetAttributes返参增加字段format_type，输出Quantitative和Normal，以区分属性格式。

2. 在GetAttributes返参增加字段attribute_unit，当属性输入类型(Attribute Input Type)为COMBO_BOX或TEXT_FILED时，输出有效可用单位。

3. 在item.Add/UpdateItem接口不做任何改动, 如果属性值没有包含单位，报错信息会返回有效可用单位。

新返参字段将在6月8日晚发布至Live环境，支持从6月9日起各站点陆续上线的global category。6月8日起你可以在Sandbox环境测试该功能。

谢谢！