Significant OpenAPI Updates

Dear Developers,

Please note the following changes:

Currently, system has promotion lock logic, meaning if sellers set promotions for their items, there will be limitations on editing the items, such as sellers cannot delete or unlist the item if it’s under Seller Discount, which requires more effort from sellers in product management.

To save seller’s effort in product management, we have updated the promotion lock logic to allow sellers to delete or edit item while it’s in upcoming or ongoing promotions. The red color is the lock rule changed in this phase:

Promotion Type	Change to Pre-order	Estimated Days	Unlist Item	Delete Item	Delete Model	Add Model	Change model status to unavailable (same as "Delete Model")	Change model status to normal (same as "Add Model")
Seller Discount	✔	✔	✔	✔	✔	✔	✔	✔
Bundle Deal	✔	✔	✔	✔	✔	X	✔	X
Add-on Deal (main item)	✔	✔	✔	✔	✔	✔	✔	✔
Add-on Deal (sub item)	✔	✔	✔	✔	✔	✔	✔	✔
Gift with purchase (main item)	✔	✔	✔	✔	✔	✔	✔	✔
Gift with purchase (gift)	✔	✔	✔	✔	✔	✔	✔	✔

For more promotion lock logic, please refer to this FAQ.

Effective Date on Live:

Lived on 2023.07.14

The existing v2.product.get_attributes and v2.global_product.get_attributes are unable to express the relationship between parent and child attributes. To solve this problem, we have added v2.product.get_attribute_tree and v2. global_product.get_attribute_tree.

Take “Category ID 100485 - Batteries” as an example, when the parent attribute “Attribute ID 100551 - Battery Type” selects “Vaue ID 3105 - Lithium battery”, then the child attribute “Attribute ID 100969 - BSMI” will be displayed and is mandatory, when the parent attribute “Attribute ID 100551 - Battery Type” selects “Vaue ID 7512 - Non-lithium battery” or “Vaue ID 7525 - Disposable Lithium Battery”, then the child attribute “Attribute ID 100969 - BSMI” will not appear.

If using v2.product.get_attributes, the response is as shown below, which can’t express that the child attribute “Attribute ID 100969 - BSMI” is required if the parent attribute “Attribute ID 100551 - Battery Type” selects “Vaue ID 3105 - Lithium battery”.

If using v2.product.get_attribute_tree, the response is as shown below, which can express the relationship between the parent attribute “Attribute ID 100551 - Battery Type” and the child attribute “Attribute ID 100969 - BSMI”.

To better obtain the attribute tree, please migrate to use the new v2.product.get_attribute_tree and v2.global_product.get_attribute_tree as soon as possible. The old v2.product.get_attributes and v2.global_product.get_attributes will be offline in the future. Please pay attention to the platform announcement.

Related APIs:

v2.product.get_attribute_tree

v2.global_product.get_attribute_tree

Effective Date on Live:

Lived on 2023.07.20

For local shops in ID region, Shopee has provided non-integrated channel, "Including Shipping Fee" / "Termasuk Ongkos Kirim" (channel ID: 89999) channel. This channel might be applicable for whitelisted sellers with the following cases:

Sells virtual goods
Has own fleet delivery
Supports special handling / installation of electronic items/bulky items

This channel previously only allows seller to set the items to have free shipping fee. Starting on 3 Aug 2023, channel ID: 89999 will be changed into "Seller Logistics" / "Jasa Kirim Toko" channel that allows seller to:

Set serviceable area
Set shipping fee for each of serviceable area

For the channel ID: 89999, sellers are allowed to enable/disable the channel on shop level and item level using OpenAPI, but cannot configure the serviceable area and shipping fee (can only be done via Seller Center).

Related APIs:

v2.logistics.get_channel_list

v2.logistics.update_channel

v2.product.add_item

v2.product.update_item

v2.product.get_item_base_info

Effective Date on Live:

2023.08.03

尊敬的开发者，

请留意以下变动：

目前，系统有促销锁定逻辑，如果商品设置了促销，那么在编辑商品时将会受到限制，例如商品处于Seller Discount时，卖家无法删除或下架该商品，这需要卖家在商品管理上耗费更多精力。

为了节省卖家在商品管理上耗费的精力，我们更新了促销锁定逻辑，允许卖家删除或编辑位于Upcoming或Ongoing促销中的商品。下面红色标注的部分是本次更新后的新逻辑：

Promotion Type	Change to Pre-order	Estimated Days	Unlist Item	Delete Item	Delete Model	Add Model	Change model status to unavailable (same as "Delete Model")	Change model status to normal (same as "Add Model")
Seller Discount	✔	✔	✔	✔	✔	✔	✔	✔
Bundle Deal	✔	✔	✔	✔	✔	X	✔	X
Add-on Deal (main item)	✔	✔	✔	✔	✔	✔	✔	✔
Add-on Deal (sub item)	✔	✔	✔	✔	✔	✔	✔	✔
Gift with purchase (main item)	✔	✔	✔	✔	✔	✔	✔	✔
Gift with purchase (gift)	✔	✔	✔	✔	✔	✔	✔	✔

更多促销锁定逻辑，请参考此FAQ。

上线时间：

2023.07.14 已上线

现有的v2.product.get_attributes与v2.global_product.get_attributes接口，无法表达父属性与子属性的关系以及子属性的必填情况，为了解决这一问题，平台新增了v2.product.get_attribute_tree与v2.global_product.get_attribute_tree接口。

以Category ID 100485 - Batteries为例，当父属性Attribute ID 100551 - Battery Type选择Value ID 3105 - Lithium battery时，将会新增Attribute ID 100969 - BSMI子属性且为必填，当父属性Attribute ID 100551 - Battery Type选择Value ID 7512 - Non-lithium battery或Value ID 7525 - Disposable Lithium Battery时，不会出现Attribute ID 100969 - BSMI子属性。

如果使用v2.product.get_attributes接口，接口返回如下，无法表达只有当父属性Attribute ID 100551 - Battery Type选择Value ID 3105 - Lithium battery时，才需要填写Attribute ID 100969 - BSMI子属性。

如果使用v2.product.get_attribute_tree接口，接口返回如下图所示，可以很好地表达父属性Attribute ID 100551 - Battery Type与子属性Attribute ID 100969 - BSMI的关系与必填情况。

为了更好地获取属性树，请您尽快迁移使用新的v2.product.get_attribute_tree与v2.global_product.get_attribute_tree接口，后续平台将下线旧的v2.product.get_attributes与v2.global_product.get_attributes接口，请留意平台通知。

影响接口：

v2.product.get_attribute_tree

v2.global_product.get_attribute_tree

上线时间：

2023.07.20 已上线

针对ID地区的Local Shop，Shopee提供了“Including Shipping Fee” / “Termasuk Ongkos Kirim”渠道 (channel ID：89999)，该渠道为非集成渠道，适用于以下情况的白名单卖家：

1）销售虚拟商品

2）拥有自己的车队送货

3）支持电子产品/大件物品的特殊处理/安装

该渠道此前仅允许卖家为商品设置为免运费，从2023年8月3日起，channel ID：89999渠道将更名为“Seller Logistics” / “Jasa Kirim Toko”，允许卖家：

1）设置服务区域

2）为每个服务区域设置运费

针对channel ID：89999，卖家只能通过Open API在Shop与Item维度启用/禁用该渠道，但是无法设置服务区域与运费 (只能通过Seller Center完成)。

影响接口:

v2.logistics.get_channel_list

v2.logistics.update_channel

v2.product.add_item

v2.product.update_item

v2.product.get_item_base_info

上线时间：

2023.08.03

Significant OpenAPI Updates

资料正文

§1 Significant OpenAPI Updates