Significant OpenAPI Updates

Dear Developer,

Please note the following changes:

1. Currently, local shops can only use template size chart, now Shopee support local shops to use image size chart, then local shops can select to use template size chart or image size chart for product, the updates are as follows:

1. Add size_chart_limit > support_image_size_chart, support_template_size_chart, size_chart_mandatory response parameters in v2.product.get_item_limit to get whether the category support size chart and whether the size chart is mandatory for the category, the logic is as follows:

Note: The existing v2.product.support_size_chart will be sunset on 2024.12.27, please switch to using v2.product.get_item_limit to get the size chart limit as soon as possible.

2. Add size_chart_info > size_chart, size_chart_id request parameters in v2.product.add_item and v2.product.update_item to set and update size chart for product, the logic is as follows:

Note: The existing v2.product.update_size_chart will be sunset on 2024.12.27, please switch to using v2.product.add_item and v2.product.update_item to set and update the size chart for product as soon as possible.

Related APIs:

v2.product.add_item

v2.product.update_item

v2.product.get_item_limit

v2.product.support_size_chart

v2.product.update_size_chart

Effective Date on Live:

2024.10.25

2. To make it easy for sellers to list their products, Shopee provides Shopee Standard Product (SSP), sellers can create product based on SSP without filling in each attribute and field, the updates are as follows:

1. Add v2.product.get_ssp_list API to get the list of SSP with main info as ssp_id, product_name, gtin, oem codes;

2. Add v2.product.get_ssp_info API to get the SSP details with all available info, searching through ssp_id, gtin or oem;

3. Add v2.product.add_ssp_item API to create product based on SSP;

4. Add v2.product.link_ssp API to link the existing product to SSP, replacing its info for the ones from the SSP;

5. Add v2.product.unlink_ssp API to unlink the existing product from SSP, keeping the existing info;

6. Add ssp_id response parameter in v2.product.get_item_base_info to get the SSP ID for product created based on SSP.

For product created based on SSP, the field edit logic is as follows:

Related APIs:

v2.product.get_ssp_list

v2.product.get_ssp_info

v2.product.add_ssp_item

v2.product.link_ssp

v2.product.unlink_ssp

v2.product.get_item_base_info

Effective Date on Live:

2024.10.25

3. (Only applicable for CB sellers) Shopee plans to launch “LFF Hybrid” mode. For the LFF Hybrid Shop, seller can manage, sell and fulfill 3 types of stock: FBS stock (Shopee official warehouse stock), 3PF stock (CB seller own stock in the local market) and CB SLS stock (CB seller own stock in CN/HK/KR), the updates are as follows:

1. Add “LFF Hybrid Shop” option for shop_fulfillment_flag response parameter in v2.shop.get_shop_info to get if the shop is LFF Hybird Shop;

2. FBS stock does not support setting via Open API now, orders are fulfilled by Shopee (identified by fulfillment_flag = fulfilled_by_shopee in v2.order.get_order_detail), 3PF stock and CB SLS stock management and order fulfillment logic is sams as 3PF PFF Shop.

Related APIs:

v2.product.get_shop_info

Effective Date on Live:

2024.10.25

尊敬的开发者，

请留意以下变动：

1. 目前，Local店铺只能使用表格尺寸表 (Template Size Chart)，本期Shopee将支持Local店铺使用图片尺寸表 (Image Size Chart)，后续Local店铺在创建商品时可以自由选择使用表格尺寸表或者图片尺寸表，接口更新如下：

1）在 v2.product.get_item_limit 接口中新增 size_chart_limit > support_image_size_chart、support_template_size_chart、size_chart_mandatory 响应参数，以获取 Category 是否支持尺寸表以及 Category 下尺寸表是否必填，逻辑如下：

注意：现有的 v2.product.support_size_chart 接口将于 2024.12.27 下线，请尽快切换使用 v2.product.get_item_limit 接口获取尺寸表限制。

2. 在 v2.product.add_item 和 v2.product.update_item 接口中新增 size_chart_info > size_chart、size_chart_id 请求参数，用于设置和更新商品的尺寸表，逻辑如下：

注意：现有的 v2.product.update_size_chart 接口将于 2024.12.27 下线，请尽快切换使用 v2.product.add_item 和 v2.product.update_item 设置和更新商品的尺寸表。

影响接口：

v2.product.add_item

v2.product.update_item

v2.product.get_item_limit

v2.product.support_size_chart

v2.product.update_size_chart

上线时间：

2024.10.25

2. 为了便于卖家上架商品，Shopee 提供了 Shopee Standard Product (SSP)，卖家可以根据 SSP 创建产品，无需填写每个属性和字段，接口更新如下：

1）新增 v2.product.get_ssp_list 接口，获取 SSP 列表及其主要信息，包括 ssp_id、product_name、gtin、oem codes 等；

2）新增 v2.product.get_ssp_info 接口，通过 ssp_id、gtin、oem 搜索 SSP 列表以及获取 SSP 详情；

3）新增 v2.product.add_ssp_item 接口，通过 SSP 创建商品；

4）新增 v2.product.link_ssp 接口，将现有商品绑定到 SSP，并将其信息替换为 SSP 的信息；

5）新增 v2.product.unlink_ssp 接口，将现有商品与 SSP 解除绑定，保留现有商品的信息；

6）在 v2.product.get_item_base_info 接口中新增 ssp_id 响应参数 ，以获取根据 SSP 创建的商品的 SSP ID。

对于通过 SSP 创建的商品，字段编辑逻辑如下：

影响接口：

v2.product.get_ssp_list

v2.product.get_ssp_info

v2.product.add_ssp_item

v2.product.link_ssp

v2.product.unlink_ssp

v2.product.get_item_base_info

上线时间：

2024.10.25

3. (仅适用于CB卖家) Shopee计划推出 “LFF Hybrid ”模式 (即：一店三运)。在 LFF Hybrid 模式下，卖家可以管理、销售和履约 3 种库存： FBS 库存 (Shopee官方仓库库存)、3PF 库存 (CB卖家在本地市场的自有库存) 和 CB SLS 库存 (CB卖家在CN/HK/KR的自有库存)，接口更新如下：

1）在 v2.shop.get_shop_info 接口中的 shop_fulfillment_flag 响应参数中添加 “LFF Hybrid Shop”枚举值 ，以获取该店铺是否为 LFF Hybird Shop;

2）FBS 库存暂不支持通过 Open API 设置，订单由 Shopee 履行 (通过 v2.order.get_order_detail 接口中的 fulfillment_flag = fulfilled_by_shopee 识别)，3PF 库存和 CB SLS 库存的库存管理和订单履约逻辑与 3PF PFF Shop 相同。

影响接口：

v2.product.get_shop_info

上线时间：

2024.10.25