来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Significant OpenAPI Updates
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. Important Notice: Open Platform Adds Support for AR / KH / LA / MM Markets
1. Important Notice: Open Platform Adds Support for AR / KH / LA / MM Markets
Applicable to: CNCB ISVs & Developers
To support global business expansion, the Shopee Open Platform will introduce support for the AR, KH, LA, and MM markets, along with updates to related authorization and API capabilities. Relevant ISVs are requested to complete the necessary compatibility adjustments according to the information below.
§3 1）AR Market (Already Available, Mainly for Cross-border Sellers)
1）AR Market (Already Available, Mainly for Cross-border Sellers)
CNCB Sellers (Already Live)
CNCB sellers can join AR Shops under the SIP program or directly open cross-border AR Shops. The Open Platform already supports CNCB seller authorization (SIP AR A Shops, CNCB self-operated AR Shops), and related APIs have also been updated to support the AR region.
Impact on ISVs: ISVs should ensure their systems are compatible with AR region-related business logic and API integrations.
§4 2）KH / LA / MM Markets (Mainly for Cross-border Sellers)
2）KH / LA / MM Markets (Mainly for Cross-border Sellers)
CNCB Sellers (Coming Soon)
CNCB sellers will be able to join KH / LA Shops under the SIP program, with an expected launch time in Q2 2026.
The Open Platform will support CNCB seller authorization (SIP KH / LA A Shops), and related APIs will also support the KH and LA regions.
Impact on ISVs: ISVs should ensure compatibility with KH and LA region-related business logic and API integrations.
§5 2. Holiday Mode Adds New Holiday Types and Supports Scheduled Holidays
2. Holiday Mode Adds New Holiday Types and Supports Scheduled Holidays
To meet sellers’ needs for more refined management of store holiday status, the platform has upgraded the existing Holiday Mode feature:
- Support scheduling holiday periods in advance, enabling Holiday Mode to be automatically activated and deactivated.
- Introduce two types of holiday modes, allowing sellers to flexibly choose whether to accept new orders during the holiday period.
As part of this upgrade:
New request parameters have been added to v2.shop.set_shop_holiday_mode.
New response parameters have been added to v2.shop.get_shop_holiday_mode.
The newly introduced fields include holiday_mode_start_time, holiday_mode_end_time, and holiday_mode_description, which are used to define the holiday time range and provide a description. The specific holiday mode is specified through the holiday_mode_type parameter.
The supported holiday modes are as follows:
-
Partial Holiday: The shop can continue receiving new orders (buyers can place orders as usual), and the system will automatically extend the order’s Ship-By-Date (SBD).
-
Full Holiday: The shop will stop accepting new orders (buyers cannot place orders), and only orders generated before the vacation period will continue to be processed.
| Name | Type | Description |
|---|---|---|
| holiday_mode_type | int32 | Holiday type:0 - Full holiday，buyers cannot place new orders. The behavior remains consistent with the current Holiday Mode.1 - Partial holiday, buyers can continue placing orders, and the system will automatically extend the order’s Ship-By-Date (SBD). |
| holiday_mode_start_time | timestamp | Holiday start time should be a whole hour and could be parsed as "2026:01:16 15:00:00" |
| holiday_mode_end_time | timestamp | Holiday end time plus one second should be a whole hour, which means the input timestamp must be able to be parsed as "2025:01:20 17:59:59"and the holiday_end_time must be larger than holiday_start_time |
| holiday_mode_description | string | Description of the holiday |
Related APIs：
v2.shop.set_shop_holiday_mode
v2.shop.get_shop_holiday_mode
Effective Date on Live：
2023.03.13
§6 3. Instant Orders Supports Reschedule Pickup Feature
3. Instant Orders Supports Reschedule Pickup Feature
To further improve the seller experience in the pickup process for Instant orders, Shopee introduces the Instant Order Reschedule Pickup feature.
When the logistics driver does not arrive in time or pickup cannot be completed after the shop’s operating hours, sellers can use APIs to reschedule the pickup time for eligible Instant orders without contacting customer service manually, thereby improving sellers’ operational efficiency and optimizing the buyer delivery experience. 1. Applicable Conditions This feature applies to Instant Orders in the regions of ID, MY, VN, and TH.
Packages must meet all of the following conditions in order to initiate a pickup rescheduling request. 1) Logistics Service Type: The service type of the logistics channel corresponding to the package is instant logistics. Note: You can determine the service type of the channel by using the service_type_identifier returned by the v2.logistics.get_channel_list. If it is instant, then it is instant logistics. 2) Package Fulfillment Status: The package's fulfillment status (fulfillment_status/logistics_status) is LOGISTICS_REQUEST_CREATED, meaning the package has not yet been picked up. 3) Time Window Requirement: The current time must satisfy the following conditions: the Instant pickup end time has passed and has not yet reached the Instant pickup operating start time of the next day Note: You can retrieve the seller’s Instant pickup operating hours through the v2.logistics.get_operating_hour by checking the instant_operating_hour response field. 2. Operation Flow When the above conditions are met, sellers can reschedule the pickup through OpenAPI. The detailed operation flow is as follows. 1) Retrieve Shipping Parameters
● Call v2.logistics.get_shipping_parameter or v2.logistics.get_mass_shipping_parameter to retrieve available shipping parameters and new pickup time options.
● This API is only allowed for packages that meet any of the following conditions:
○ The package's fulfillment status is LOGISTICS_READY
○ The package's fulfillment status is LOGISTICS_PICKUP_RETRY
○ The package's fulfillment status is LOGISTICS_REQUEST_CREATED and meets the above conditions for rescheduling pickup.
- Update Pickup Time ● Pass the address_id and pickup_time_id returned from the v2.logistics.get_shipping_parameter as request parameters to v2.logistics.update_shipping_order to reschedule the pickup time. Note: If the above APIs return the error "Package {package_number} not eligible for rescheduling", it indicates that the current parcel does not meet the conditions for rescheduling, and a new pickup cannot be arranged. Related APIs v2.logistics.get_shipping_parameter v2.logistics.update_shipping_order
Effective Date on Live 2026.03.09
§7 4. [ID]New Field medicine_id(ID-PSEF License for Drug Selling Practice)
4. [ID]New Field medicine_id(ID-PSEF License for Drug Selling Practice)
To meet regulatory requirements, Shopee will launch a remote consultation process for pharmaceutical-related products. Buyer must complete a consultation and receive a prescription from the doctor and may only buy the exact prescribed medicine. To allow a listing to be recommended by the prescription, a new field called medicine_id is required for this feature.
Scope
Only applicable to ID local sellers.
Affected Categories
When sellers create or update products under the following categories through OpenAPI, they need to provide medicine_id:
| Category ID | Category Name |
|---|---|
| 100119 | Health > Medicine & Medical Supplies > Over-the-counter Medicine |
| 102058 | Health > Medicine & Medical Supplies > Prescription |
API Update
| API | Field | Type | Description |
|---|---|---|---|
| v2.product.add_item | medicine_id | New Request Field | When creating or updating products under the specified medicine category, sellers must provide medicine_id as the unique identifier for each standardized medicine. If a medicine_id is not provided for the specified |
| v2.product.update_item | medicine_id | New Request Field | category, the API will return the error “Medicine ID is mandatory for products in Prescription/OTC category.”If an incorrect medicine_id is provided, the API will return the error “Please input the correct medicine ID.” |
| v2.product.get_item_base_info | medicine_id | New Response Field | If the product contains standardized medicine information, the API will return medicine_id. If the product does not contain medicine information, the field will not be returned. |
Note: medicine_id belongs to seller-side information and currently ISVs cannot obtain this value through OpenAPI.
Therefore, the ISV system can only support manual entry of medicine_id by the seller. If the seller enters an incorrect medicine_id, OpenAPI will return the corresponding error, and the ISV system can only pass on this error message for the seller to correct and resubmit.
Related APIs:
v2.product.add_item v2.product.update_item v2.product.get_item_base_info
Effective Date on Live： 2026.03.12
尊敬的开发者
请查收本次的 OpenAPI 功能更新。这些改动旨在提升功能灵活性、优化使用体验，并为集成提供更好的支持。
§8 1. 【重要通知】开放平台新增 AR / KH / LA / MM 市场支持公告
1. 【重要通知】开放平台新增 AR / KH / LA / MM 市场支持公告
适用对象：CNCB ISV & 开发者
为支持业务全球拓展，Shopee 开放平台将新增 AR、KH、LA、MM 市场支持，并更新相关授权与 API 能力。请相关 ISV 根据以下说明完成适配。
§9 1）AR 市场（已开放，主要面向跨境卖家）
1）AR 市场（已开放，主要面向跨境卖家）
CNCB 卖家（已上线）
CNCB 卖家可在 SIP 项目中加入 AR Shop，或直接开设跨境 AR Shop。 开放平台已支持 CNCB 卖家授权（SIP AR A Shops、CNCB 自营 AR Shops），相关 API 也已支持 AR 地区。
对 ISV 的影响： ISV 需确保系统已兼容 AR 地区相关业务及接口调用。
§10 2）KH / LA / MM 市场（主要面向跨境卖家）
2）KH / LA / MM 市场（主要面向跨境卖家）
CNCB 卖家（即将上线）
支持 CNCB 卖家在 SIP 项目中加入 KH / LA Shop，预计 2026 年 Q2 上线。 开放平台将支持 CNCB 卖家授权（SIP KH / LA A Shops），相关 API 也将支持 KH、LA 地区。
对 ISV 的影响： ISV 需兼容支持 KH、LA 地区相关业务及接口调用。
§11 2. Holiday Mode新增休假类型并支持预约休假
2. Holiday Mode新增休假类型并支持预约休假
为满足卖家对店铺休假状态更精细化的运营管理需求，平台对现有休假模式功能进行升级：
- 支持提前设置休假时段，实现休假模式的自动开启与关闭
- 新增两种休假模式类型，允许卖家灵活选择休假期间是否接收新订单
本次升级中：
v2.shop.set_shop_holiday_mode 接口新增请求参数
v2.shop.get_shop_holiday_mode 接口新增响应参数
新增参数包括 holiday_mode_start_time、holiday_mode_end_time、holiday_mode_description，用于设置假期时间范围及假期说明，并通过 holiday_mode_type 指定具体的假期模式。
支持的假期模式如下：
-
Partial Holiday：店铺仍可接收新订单 (买家可正常下单)，系统将自动延长订单的发货时效 (Ship By Date)
-
Full Holiday：店铺暂停接收新订单 (买家无法下单)，仅处理休假前已产生的订单。
| Name | Type | Description |
|---|---|---|
| holiday_mode_type | int32 | Holiday type:0 - Full holiday，buyers cannot place new orders. The behavior remains consistent with the current Holiday Mode.1 - Partial holiday, buyers can continue placing orders, and the system will automatically extend the order’s Ship-By-Date (SBD). |
| holiday_mode_start_time | timestamp | Holiday start time should be a whole hour and could be parsed as "2026:01:16 15:00:00" |
| holiday_mode_end_time | timestamp | Holiday end time plus one second should be a whole hour, which means the input timestamp must be able to be parsed as "2025:01:20 17:59:59"and the holiday_end_time must be larger than holiday_start_time |
| holiday_mode_description | string | Description of the holiday |
影响接口：
v2.shop.set_shop_holiday_mode
v2.shop.get_shop_holiday_mode
上线时间：
2023.03.13
§12 3. 即时订单支持重新预约取件功能
3. 即时订单支持重新预约取件功能
为进一步提升卖家在即时订单物流取件环节的体验，Shopee 推出 即时订单重新预约取件 功能。 当物流司机未及时上门、超出营业时段无法取件时，卖家可通过接口自助对符合条件的即时物流订单重新安排取件时间，无需人工联系客服处理，从而提升卖家运营效率并优化买家配送体验。 1.适用条件 本功能适用于 ID、MY、VN、TH 站点的即时订单，包裹需同时满足以下条件，方可发起重新预约取件操作： 1）包裹物流类型：包裹对应物流渠道的服务类型为即时物流。 补充：可以通过 v2.logistics.get_channel_list 接口返回的 service_type_identifier，判断渠道的服务类型，若为 instant，则为即时物流。 2）包裹履约状态：包裹的履约状态 (fulfillment_status/logistics_status) 为 LOGISTICS_REQUEST_CREATED，即包裹尚未完成物流取件。 3）时间窗口要求：当前时间已超过即时取件截止时间，且未到次日的即时取件营业开始时间。 补充：可以通过v2.logistics.get_operating_hour接口返回的 instant_operating_hour，获取卖家设置的即时取件营业时间。 2.操作流程 当满足上述条件时，卖家可通过 OpenAPI 重新安排取件，具体操作流程如下： 1）获取发货参数： ● 调用 v2.logistics.get_shipping_parameter 或 v2.logistics.get_mass_shipping_parameter 获取可用发货参数及新的取件时间选项。 ● 只允许满足以下任意条件的包裹调用该接口： ○ 包裹的履约状态为 LOGISTICS_READY ○ 包裹的履约状态为LOGISTICS_PICKUP_RETRY ○ 包裹的履约状态为 LOGISTICS_REQUEST_CREATED 且满足上述重新安排取件条件
2）更新取件时间： ● 将从 v2.logistics.get_shipping_parameter接口返回的 address_id 和 pickup_time_id 作为请求参数传递给 v2.logistics.update_shipping_order 用于重新安排取件时间。 注意：如果以上两个 API 返回报错 "Package {package_number} not eligible for rescheduling"，均表示当前包裹不满足重新预约条件，无法安排新的取件。 Related APIs: v2.logistics.get_shipping_parameter v2.logistics.update_shipping_order 上线时间: 2026.03.09
§13 4. [ID]新增药品标识字段 medicine_id（ID-PSEF 药品销售许可）
4. [ID]新增药品标识字段 medicine_id（ID-PSEF 药品销售许可）
为满足监管要求，Shopee 将上线药品相关商品的远程问诊流程。
在该流程下，买家需先完成问诊并获得医生处方，且仅可购买处方中指定的药品。为支持处方准确推荐对应商品，系统将新增 medicine_id 字段作为必要信息。
适用对象
仅适用于 ID 本地卖家（ID local sellers）。
适用场景
当卖家通过 OpenAPI 创建或更新以下类目下的商品时，需要提供 medicine_id：
| 类目 ID | 类目名称 |
|---|---|
| 100119 | Health > Medicine & Medical Supplies > Over-the-counter Medicine |
| 102058 | Health > Medicine & Medical Supplies > Prescription |
API 更新
| API | 字段 | 类型 | 说明 |
|---|---|---|---|
| v2.product.add_item | medicine_id | 新增入参字段 | 在指定药品类目下创建或更新商品时，卖家必须提供 medicine_id 作为每一款标准化药品的唯一标识 |
| v2.product.update_item | medicine_id | 新增入参字段 | 如指定类目未提供的medicine_id，接口将报错 “Medicine ID is mandatory for products in Prescription/OTC category. 如提供错误的medicine_id 接口将报错“Please input the correct medicine ID.” |
| v2.product.get_item_base_info | medicine_id | 新增响应字段 | 若商品包含药品信息，则接口会返回 medicine_id；若商品未包含药品信息，则不会返回该字段 |
注意：medicine_id 属于卖家侧信息，目前 ISV 无法通过 OpenAPI 获取该值。
因此，ISV 系统只能支持由卖家手动填写 medicine_id。若卖家填写的 medicine_id 不正确，OpenAPI 将返回相应错误，ISV 系统也只能透传该报错信息，由卖家自行修改后重新提交。
影响接口：
v2.product.add_item v2.product.update_item v2.product.get_item_base_info
上线时间：
2026.03.12