Significant OpenAPI Updates

Dear Developer,

Please note the following changes:

1.Due to the latest official policy, items under infant and medicines categories cannot be sold in any forms of promotions so that Open API will add below rules:

When editing wholesale, if the product belongs to “category” + “attribute” + “attribute value” which is configured with the type of being unable to add wholesale info, the response will return an error.

Error message:

{ "msg": "Wholesale cannot be used in this category and attributes. ", "request_id": "794584cc3e690edab1de407c4be16b51", "error": "product.error_param_validate" }

When editing the item which already has a wholesale, if you want to change the “category” or “attribute”or “attribute value” to be the type of being unable to add wholesale info，Open API will remove the data of its wholesale.

Related APIs:

shopee.item.Add

shopee.item.UpdateItem

v2.product.add_item

v2.product.update_item

Effective Date on Live: 2022/7/28

2.v2.order.get_buyer_invoice_info api is available for AR local sellers, to obtain buyer submitted invoice info.

Related APIs:

v2.order.get_buyer_invoice_info

Effective Date on Live: Lived

3.The v2.product.search_item API has added request parameter "item_sku", it means that the API supports filtering the item_id list with item_sku. If you search for item_sku and item_name at the same time, only the results that match item_sku will be returned. If you search for item_sku and attribute_status at the same time, the results that match both item_sku and attribute_status will be returned.

Related APIs:v2.product.search_item

Effective Date on Live: Lived

Added “currency” response parameter in v2.product.get_model_list api.

Related APIs:v2.product.get_model_list

Effective Date on Live: Lived

In order to optimize the process of adding and deleting models for item, we will add "model_list" request parameter to the update_tier_variation api. For detailed usage scenarios, please refer to the FAQ.

Related APIs:

v2.global_product.update_tier_variation

v2.product.update_tier_variation

Effective Date on Live: 2022/8/11

尊敬的开发者，

请注意以下变动：

1.由于最新官方政策，平台规定婴儿用品与药品等一些品类无法以活动的形式被销售，故新增了以下规则：当编辑wholesale时，若商品所属的“category” + “attribute” + “attribute value”属于不可设置promotion的类型，则报错。

Error message:

{ "msg": "Wholesale cannot be used in this category and attributes. ", "request_id": "794584cc3e690edab1de407c4be16b51", "error": "product.error_param_validate" }

当已有wholesale的商品编辑为不可设置promotion的类型的“category”或“attribute”或“attribute value”时，则清空wholesale的配置。

影响接口：

shopee.item.Add

shopee.item.UpdateItem

v2.product.add_item

v2.product.update_item

上线时间：2022/7/28

2.对于AR本地卖家，也可调用接口v2.order.get_buyer_invoice_info用于获取买家填写的发票信息。

影响接口：

v2.order.get_buyer_invoice_info

上线时间：已上线

3.v2.product.search_item API 新增入参"item_sku",即支持用item_sku搜索产品列表。如果同时搜索item_sku和item_name，将只返回匹配item_sku符合的结果，如果同时搜索item_sku和attribute_status，将返回item_sku和attribute_status同时符合的结果。

影响接口：

v2.product.search_item

上线时间：已上线

v2.product.get_model_list接口新增currency返回参数。

影响接口：v2.product.get_model_list

上线时间：已上线

5.为了优化产品新增和删除变体的流程，我们将在update_tier_variation 接口新增model_list入参，详细使用场景可以查看FAQ。

影响接口：

v2.global_product.update_tier_variation

v2.product.update_tier_variation

上线时间：2022/8/11

Significant OpenAPI Updates

资料正文

§1 Significant OpenAPI Updates