来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Significant OpenAPI Updates
Dear Developer,
Please note the following changes:
- To support sellers creating Shop Flash Sale for single item (item without variation), Shopee has made the following updates:
| API | Updates |
|---|---|
| v2.shop_flash_sale.add_shop_flash_sale_items | Add “item_input_promo_price”, “item_stock” request parameters to support sellers creating Shop Flash Sale and setting the Discounted Price and Campaign Stock for single items. |
| v2.shop_flash_sale.update_shop_flash_sale_items | Add “item_input_promo_price”, “item_stock”, “item_status” request parameters to support sellers updating the Discounted Price, Campaign Stock and Enable/Disable for single items in Shop Flash Sale. |
| v2.shop_flash_sale.delete_shop_flash_sale_items | Support sellers deleting the single items from Shop Flash Sale. |
| v2.shop_flash_sale.get_shop_flash_sale_items | Add the following response parameters to support sellers getting the Original Price, Discounted Price, Campaign Stock, Stock, Purchase Limit, Enable/Disable information for single items in Shop Flash Sale. - item_status - original_price - input_promotion_price - promotion_price_with_tax - purchase_limit - campaign_stock - stock - reject_reason - unqualified_conditions - unqualified_code - unqualified_msg Note: 1) If the product does not have variations, the product's basic information (item_id, item_name, status, image, etc.) and campaign information (original_price, input_promotion_price, campaign_stock, stock, purchase_limit, etc.) will be returned under item_info; 2) If the product has variations, the campaign information (original_price, input_promotion_price, campaign_stock, stock, purchase_limit, etc.) of models will be returned under models, but the basic information (item_id, item_name, status, image, etc.) of the product to which the model belong will still be returned under item_info. |
Related APIs:
v2.shop_flash_sale.add_shop_flash_sale_items
v2.shop_flash_sale.update_shop_flash_sale_items
v2.shop_flash_sale.delete_shop_flash_sale_items
v2.shop_flash_sale.get_shop_flash_sale_items
Effective Date on Live:
2025.01.10
- Under current 3PF model, Shopee is unable to verify seller’s actual stock. To implement more precise compliance management for 3PF sellers, Shopee provide a new “v2.logistics.batch_update_tpf_warehouse_tracking_status” Open API to support 3PF Warehoouse Vendors to transmit more information to platform, such as the time of 3PF warehouse order create and outbound done. The API updates is as follows:
For CB orders that fulfilled by 3PF:
-
When 3PF warehouse receives the order, please call the API to update the tpf_tracking_status to "3pf_warehouse_order_created" and update_time to the time when 3PF warehouse actually receive the order;
-
When 3PF warehouse completes the outbound of the package, please call the API to update the tpf_tracking_status to "3pf_warehouse_outbound_done" and update_time to the time when 3PF warehouse actually complete the package outbound.
Note: 3PF Warehouse Vendors that do not complete the API integration in time according to platform's requirements will not be able to participate in the Recommended Warehouse Selection and other subsequent policies that favor warehouses.
Related APIs:
v2.logistics.batch_update_tpf_warehouse_tracking_status
Effective Date on Live:
2025.01.13
- Support for Querying Attribute Values of Specific Attributes (e.g., Manufacturer):
The v2.product.get_attribute_tree and v2.global_product.get_attribute_tree APIs now return the support_search_value flag for manufacturer attributes. This flag indicates whether the attribute values need to be retrieved through the search APIs.
Currently, only for Manufacturer attributes, the support_search_value will be true. For other attributes, it will be false.
If support_search_value is true, you can use the v2.product.search_attribute_value_list and v2.global_product.search_global_attribute_value_list APIs to perform fuzzy searches and filter manufacturer attribute values by value_name.
- Ban characters in product descriptions in Indonesia
We have implemented a new validation rule in Indonesia to prohibit non-standard characters in product descriptions during listing upload or edits
Listings containing non-standard characters will now be rejected when calling v2.product.update_item and v2.product.add_item
Error messages will be returned via OpenAPI responses, such as: {"error": "product.",
"message": "Your description contains invalid characters: 🔸. Please adjust it"}
尊敬的开发者，
请留意以下变更：
- 为了支持卖家为单品 (没有变体的商品) 创建 Shop Flash Sale，Shopee 做出了以下更新：
| 接口 | 更新内容 |
|---|---|
| v2.shop_flash_sale.add_shop_flash_sale_items | 新增 “item_input_promo_price”、“item_stock” 请求参数，支持卖家为单品创建 Shop Flash Sale，并且设置单品的折扣价和活动库存。 |
| v2.shop_flash_sale.update_shop_flash_sale_items | 新增 “item_input_promo_price”、“item_stock”、“item_status” 请求参数，支持卖家更新 Shop Flash Sale 中的单品的折扣价、活动库存和启用/禁用。 |
| v2.shop_flash_sale.delete_shop_flash_sale_items | 支持卖家将单品从 Shop Flash Sale 中删除。 |
| v2.shop_flash_sale.get_shop_flash_sale_items | 新增下述响应参数，支持卖家获取 Shop Flash Sale 中的单品的原价、折扣价、活动库存、库存、购买限制和启用/禁用信息。 - item_status - original_price - input_promotion_price - promotion_price_with_tax - purchase_limit - campaign_stock - stock - reject_reason - unqualified_conditions - unqualified_code - unqualified_msg 注意： 1）若商品没有变体，则商品的基础信息 (item_id, item_name, status, image等) 和 活动信息 (original_price、input_promotion_price、campaign_stock、stock、purchase_limit等) 将在 item_info 下返回； 2）若商品有变体，则变体的活动信息 (original_price、input_promotion_price、campaign_stock、stock、purchase_limit等) 将在 models 下返回，但是变体所属的商品的基础信息 (item_id, item_name, status, image等) 仍然在 item_info 下返回。 |
影响接口:
v2.shop_flash_sale.add_shop_flash_sale_items
v2.shop_flash_sale.update_shop_flash_sale_items
v2.shop_flash_sale.delete_shop_flash_sale_items
v2.shop_flash_sale.get_shop_flash_sale_items
上线时间:
2025.01.10
- 3PF 现有模式下，Shopee 无法验证卖家的真实库存。为了对 3PF 卖家进行更精细化的合规管理，Shopee 提供了一个新接口“v2.logistics.batch_update_tpf_warehouse_tracking_status”，支持 3PF 仓库服务商向平台回传更多信息，例如 3PF 仓库收到订单的时间和完成包裹出库的时间。接口更新如下：
对于由 3PF 仓库履约的 CB 订单：
1）当 3PF 仓库收到订单时，请调用该接口将 tpf_tracking_status 更新为 “3pf_warehouse_order_created”，并将 update_time 更新为 3PF 仓库实际收到订单的时间；
2）当 3PF 仓库完成包裹出库时，请调用该接口将 tpf_tracking_status 更新为 “3pf_warehouse_outbound_done”，并将 update_time 更新为 3PF 仓库实际完成包裹出库的时间。
注意：未及时按照平台要求完成接口对接的仓库服务商，将无法参与推荐仓评选等后续利好仓库的政策。
影响接口:
v2.logistics.batch_update_tpf_warehouse_tracking_status
上线时间:
2025.01.13
- 支持部分特殊属性的属性值查询(例如: Manufacturer)：
v2.product.get_attribute_tree 和 v2.global_product.get_attribute_tree API 现在返回制造商属性的 support_search_value 标志。该标志指示属性是否需要通过搜索接口去获取value值。
目前仅对于Manufacturer属性，support_search_value 将为 true；对于其他属性，support_search_value 将为 false。
如果support_search_value等于true，可以调用 v2.product.search_attribute_value_list 和 v2.global_product.search_global_attribute_value_list API 通过value_name 模糊查询和筛选制造商属性值
- 禁止印尼含有非标准字符商品上架
我们在印度尼西亚实施了一项新的校验规则，以禁止在商品描述中使用非标准字符（适用于商品上传或编辑操作）。
通过调用 v2.product.update_item 和 v2.product.add_item 接口时，包含非标准字符的商品信息将被拒绝。
错误信息将通过 OpenAPI 响应返回，例如：
{"error": "product.",
"message": "Your description contains invalid characters: 🔸. Please adjust it"}