来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Significant OpenAPI Updates of Account Health, OpenPlatform
Dear Developers
Please find below the OpenAPI updates released this time. These changes aim to enhance functionality, improve flexibility, and provide better integration support.
§2 1.[Only for TW] Add New Metric - "% SPX Listings"
1.[Only for TW] Add New Metric - "% SPX Listings"
To align with the Free Shipping Service (FSS) policy and allow sellers to better understand the activation status of Shopee's in-store logistics options for each product, and to more effectively manage whether products are eligible for Shopee's in-store (SPX) logistics channel, Shopee has added the "% SPX Listings" metric to the v2.account_health.get_shop_performance and v2.account_health.get_metric_source_detail APIs. Details are as follows:
- For v2.account_health.get_shop_performance, the "metric_id" in response parameter now includes a new option: 2035: % SPX Listings, allowing sellers to retrieve the performance data for these metrics.
| Metric | metric_id | metric_name | parent_metric_id |
|---|---|---|---|
| % SPX Listings | 2035 | spx_listing_rate | 0 |
- For v2.account_health.get_metric_source_detail, the "metric_id" in response parameter now includes a new option: 2035: % SPX Listings. Also, include the “spx_listing_list” in the response parameters for this metric to get the related product details data.
| Name | Type | Description |
|---|---|---|
| spx_listing_list | object[] | Relevant Listings for % SPX Listings. |
| >>item_id | int64 | Item ID. |
| >>current_spx_status | int32 | Applicable values: 1: Yes 2: No Refers to Current SPX Listings Status. |
Related APIs:
v2.account_health.get_shop_performance
v2.account_health.get_metric_source_detail
Effective Date on Live:
2026.04.13
§3 2. [KRCB Only] KRSIP Launch Reminder
Shopee International Platform (SIP) is a managed cross-border business model supported by Shopee. Under this model, Shopee is responsible for operating affiliated shops (A shops), including campaign participation and localization, while sellers are responsible for order fulfillment. The seller-operated primary shop (P shop) is linked with Shopee-managed affiliated shops (A shops) to enable cross-border business expansion.
The KRSIP program is now officially launched, enabling KR sellers to expand their business to more cross-border markets, including SG, MY, TH, PH, VN, TW, BR, and MX. To ensure related cross-border APIs can be called properly and business functions operate smoothly, please complete system compatibility as soon as possible.
Applicable Scope Developers involved in KRCB business
Launch Date 2026.04.13
尊敬的开发者
请查收本次的 OpenAPI 功能更新。这些改动旨在提升功能灵活性、优化使用体验，并为集成提供更好的支持。
§4 1. 【仅适用于 TW】新增「% SPX Listings（虾皮店到店商品开通率）」指标
为配合免运服务（FSS）政策，让卖家更了解虾皮店到店相关物流选项在各商品的启用状况，更有效管理商品是否开通虾皮店到店（SPX）物流渠道，Shopee 在v2.account_health.get_shop_performance 和 v2.account_health.get_metric_source_detail API 新增「% SPX Listings」指标，具体内容如下：
1）v2.account_health.get_shop_performance 的返回参数 metric_id 新增 2035: 虾皮店到店商品开通率 选项，支援获得对应指标的表现情况。
| Metric | metric_id | metric_name | parent_metric_id |
|---|---|---|---|
| % SPX Listings | 2035 | spx_listing_rate | 0 |
2）v2.account_health.get_metric_source_detail 的请求参数 metric_id 新增 2035: 虾皮店到店商品开通率 选项，同时，针对上述两个指标，新增 spx_listing_rate 返回参数，用于取得对应商品的细节信息。
| Name | Type | Description |
|---|---|---|
| spx_listing_list | object[] | Relevant Listings for % SPX Listings. |
| >>item_id | int64 | Item ID. |
| >>current_spx_status | int32 | Applicable values: 1: Yes 2: No Refers to Current SPX Listings Status. |
影响API：
v2.account_health.get_shop_performance
v2.account_health.get_metric_source_detail
上线时间：
2026.04.13
§5 2. [KRCB Only]KRSIP 上线提醒
SIP（Shopee International Platform，虾皮国际平台）是一种由平台提供代运营支持的跨境业务模式。该模式下，Shopee 负责附属店铺（A shop）的运营，包括活动提报及本地化优化等，而卖家负责履约。卖家自主经营的主店铺（P shop）将与平台代运营的附属店铺（A shop）关联，从而实现跨境业务拓展。 KRSIP 项目已正式上线，现支持KR卖家将业务拓展至更多跨境市场，包括 SG、MY、TH、PH、VN、TW、BR、MX。为保证涉及跨境业务的相关接口能够正常调用，并确保业务功能稳定运行，请您尽快完成系统兼容。
适用范围
涉及KRCB业务的开发者。
上线时间
2026.04.13