Significant OpenAPI Updates

尊敬的开发者，请留意以下变动:

1.根据店铺状态限制店铺授权和API接口调用

1. Normal店铺状态变更为Frozen，Open API调用和授权无影响

2. Normal店铺状态变更为Banned，不能调用Open API，不能授权新的Partner

• 如使用Banned店铺账号操作授权会登陆失败，报错信息： “Your login attempt has been rejected due to unusual activities in your account. Please make sure you comply with Shopee policies.”

3. Normal店铺状态变更为Deleted，不能调用Open API，不能授权新的Partner，存量的授权关系会被清除

• 如使用Deleted店铺账号操作授权会登陆失败，报错信息： “The account and/or password is incorrect. Please try again.”

4. 店铺状态恢复为Normal，API接口调用能力和授权能力均会恢复，已经清除了的授权关系不可恢复，只能重新操作店铺授权获取新的授权关系。

上线时间：2021/09/15

2.新增注册品牌接口v2.product.register_brand

上线时间：2021/09/16

影响接口：v2.product.register_brand

3.新增品牌审核结果推送机制Brand Register Result

当卖家通过seller centre或者v2.product.register_brand api注册品牌后，都会触发品牌审核流程。审核的结果将通过Brand Register Result推送，开发者可以选择订阅此类推送信息。

审核结果一共分三种：

1.注册成功

2.注册失败

3.与现有品牌合并为同一个

点击此处查看推送样例

点击此处了解更多

上线时间：2021/09/16

4.新增全球商品类目推荐接口 v2.global_product.category_recommend

上线时间：2021/09/16

影响接口：v2.global_product.category_recommend

5.[MX]墨西哥商品禁止上传商品状态为二手商品，即condition:"used"

1）卖家添加商品或更新商品，如果商品状态设置为used 接口将会返回报错

2）发布全球商品到墨西哥时，商品状态设置为used，将返回报错

3）全球商品商品状态设置为used，可发布的店铺列表将过滤墨西哥店铺

4）已有发布到墨西哥的商品，当卖家修改全球商品的商品状态为used，将会下架已发布的墨西哥产品

上线时间：2021/09/16

影响接口：

shopee.item.Add

shopee.item.UpdateItem

v2.product.add_item

v2.product.update_item

v2.global_product.create_publish_task

v2.global_product.get_publishable_shop

Dear Developer,

Please find below updates:

1. Restrict shop authorization and API calls based on shop status

1. Normal shop status is changed to Frozen, Open API call and authorization will not affect

2. Normal shop status is changed to Banned, Open API cannot be called, and new partners cannot be authorized

• If you use the Banned shop account to operate authorization, the login will fail, and an error message will be reported: "Your login attempt has been rejected due to unusual activities in your account. Please make sure you comply with Shopee policies."

3. Normal shop status is changed to Deleted, Open API cannot be called, new Partner cannot be authorized, and the existing authorization relationship will be cleared

• If you use the Deleted shop account to operate the authorization, the login will fail, and an error message will be reported: "The account and/or password is incorrect. Please try again."

4. The shop status is restored to Normal, you can call API and operate authorization. The authorization relationship that has been cleared cannot be restored. You can only re-operate the shop authorization.

Effective Date on Live: 2021/09/15

2.New register brand api : v2.product.register_brand

Effective Date on Live: 2021/09/16

Related APIs: v2.product.register_brand

3. New brand review results push mechanism：Brand Register Result Push

When a seller registers a brand through the seller centre or v2.product.register_brand api, there will be the brand review process. The results of the review will be pushed through Brand Register Result push mechanism.

There are three types of audit results:

1. Registration is successful

2. Registration failed

3. Merged with existing brands

Click here to view push example

Click here to learn more

Effective Date on Live: 2021/09/16

4.New global product category recommendation api： v2.global_product.category_recommend

Effective Date on Live: 2021/09/16

Related APIs: v2.global_product.category_recommend

5. [MX] Mexican products are not allowed to upload product condition: "used"

1. When seller add or update product, if the product condition is "used", api will return an error

2. When publishing a global product to Mexico, and the condition of the global product is "used", api will return an error

3. When the condition of global product is "used", the publishable shop list will remove the Mexican shops

4. There are products that have been published to Mexico. When the seller changes the condition of the global product to "used", the Mexican products that have been published will be unlisted

Effective Date on Live: 2021/09/16

Related APIs:

shopee.item.Add

shopee.item.UpdateItem

v2.product.add_item

v2.product.update_item

v2.global_product.create_publish_task

v2.global_product.get_publishable_shop