Significant OpenAPI Updates

Dear Developer:

Please find the below updates:

1. Updates related to the Shopcategory:

Changes of data_type field for some request data:

shopid —> from ‘uint64’ to ‘uint32’

Shop_category_id —> from ‘uint64’ to ‘uint32’

Optimized APIs:

shopee.shopcategory.AddShopCategory

shopee.shopcategory.DeleteShopCategory

shopee.shopcategory.UpdateShopCategory

shopee.shopcategory.GetShopCategory

shopee.shopcategory.AddItems

shopee.shopcategory.GetItems

shopee.shopcategory.DeleteItems

Maximum amount of active categories is increased

Self-defined categories upper limit will be increased from 50 to 100

For Shopee-defined categories will remain as 50

Optimized API:

shopee.shopcategory.UpdateShopCategory

Add pagination offset (optional) when retrieving items in one Shop Category

Currently the code to call the API needs ‘pagination_offset’ & ‘pagination_entries_per_page’ as an input

Optimized API:

shopee.shopcategory.GetItems

For Shop accounts with fulfillment service by Shopee (in MY, PH, ID), we will add a new Category called ‘Shopee24 Category’

Other Shop Categories need to have sort_weight < 2147483546 （Shopee 24 will be displayed at the top).

Optimized API:

shopee.shopcategory.AddShopCategory

shopee.shopcategory.UpdateShopCategory

Add the maximum character limit on Shopcategory name - 40 characters

Effective Date on Live: 2020/10/22

2. Wholesale Price will be Available for Taxable Sellers:

Affected APIs

shopee.item.Add

shopee.item.UpdateItem

shopee.item.GetItemDetail

Affected Sellers

All ID Taxable sellers

API Changes

Wholesale price will be available to ID taxable sellers on Oct 22nd.

Due to new ID government tax laws, Shopee have disabled taxable sellers from using wholesale price temporarily on April 30th. Since then, Shopee has made the necessary changes to support taxable sellers to use wholesale price.

item.Add and item.UpdateItem API can be used to upload/update items with wholesale price. The response will show the listing wholesale price before and after tax.

item.GetItemDetail API will show the listing wholesale price before and after tax.

Effective Date on Live: 2020/10/22

尊敬的開發者:

请留意以下變動：

1. 与店舖類目API相关的變動:

部分入參data_type調整

shopid —> 從 ‘uint64’ 變為 ‘uint32’

shop_category_id —> 從 ‘uint64’ 變為 ‘uint32’

涉及變動的APIs:

shopee.shopcategory.AddShopCategory

shopee.shopcategory.DeleteShopCategory

shopee.shopcategory.UpdateShopCategory

shopee.shopcategory.GetShopCategory

shopee.shopcategory.AddItems

shopee.shopcategory.GetItems

shopee.shopcategory.DeleteItems

最大可激活類目數增加：

用戶自定義類目上限從50增至100

系統定義類目上限仍保持為50

涉及變動的APIs:

shopee.shopcategory.UpdateShopCategory

當獲取某店舖類目下商品列表時，新增pagination offset (選填) 支持

目前API支持通過傳入參數至 ‘pagination_offset’ & ‘pagination_entries_per_page’ 來進行分頁

涉及變動的APIs:

shopee.shopcategory.GetItems

對於使用SBS Fulfillment 服務的店舖 (目前僅限於 MY, PH, ID市場)來說，我們將新增一個shopee 24 類目，因此

其他店舖類目的sort_weight設置必須小於2147483546（Shopee 24將置頂展示)

涉及變動的APIs:

shopee.shopcategory.AddItems

shopee.shopcategory.UpdateShopCategory

新增shopcategory name的最大字符長度限制 - 40個字符

上線日期：2020年10月22日

2. 印尼應納稅賣家開放使用批發價功能：

影响接口

shopee.item.Add

shopee.item.UpdateItem

shopee.item.GetItemDetail

影响卖家

應納稅賣家

改动说明

應納稅賣家可以在10月22日之後使用批發價功能(wholesale price)。

由於印尼在2020年初出台新的賦稅政策後，應納稅賣家從4月30日開始暫時“禁用批發價功能。 10月22日起，批發價功能已經重新開放支持所有賣家使用，並且應納稅賣家在商品詳情頁可看得到對應的稅後價。

shopee.item.Add和shopee.item.UpdateItem可以用來新增/更新商品的批發價，接口返回信息中新增返回稅後批發價(unit_price_after_tax)字段信息。

shopee.item.GetItemDetail接口返回信息中新增返回稅後批發價(unit_price_after_tax)字段信息。

上線日期：2020年10月22日