[Important] Key Project Update: Instant Delivery

This announcement is provided in English and Chinese. 本公告备有英文及中文版本。

Dear Developers,

Overview

This announcement is for fulfillment ISVs and Developers serving Shopee sellers in Malaysia (MY), Thailand (TH), Indonesia (ID), Vietnam (VN), Philippines (PH), and Brazil (BR).

Instant Delivery is one of Shopee's key fulfillment initiatives, with adoption expected to grow significantly over the next 1–2 years. We encourage all fulfillment ISVs and Developers to prioritize supporting Instant Delivery to help sellers meet growing demand for faster delivery and stay competitive.

Why This Matters

Instant Delivery is Shopee's fastest delivery service, with orders delivered within minutes to a maximum of 4 hours after courier pickup.

Unlike Standard Delivery, where orders are typically prepared and handed over in batches during scheduled pickups, Instant Delivery requires sellers to process orders individually within a much shorter timeframe, as riders are dispatched to collect each order shortly after it is placed.

To support this operational shift, fulfillment solutions should enable sellers to quickly identify, prioritize, and process Instant Delivery orders so they can meet the required fulfillment SLA.

At the same time, consumer demand for faster delivery continues to grow. Instant Delivery helps sellers:

● Increase conversion for time-sensitive purchases.

● Improve product visibility through Instant Delivery filters and campaign pages.

● Deliver a better customer experience.

● Stay competitive by meeting growing demand for faster delivery.

OpenAPI Support

Shopee OpenAPI provides the following APIs and fields to help ISVs and Developers identify Instant Delivery channels, filter Instant Delivery packages, and prioritize package fulfillment.

1. Identify Instant Delivery Channels

Use v2.logistics.get_channel_list to retrieve the logistics channels available for the shop.

When the service_type_identifier field of a logistics channel is set to instant, the corresponding channel is an Instant Delivery channel.

ISVs and Developers can record the logistics_channel_id of these channels and compare it with the logistics_channel_id returned by v2.order.get_order_detail. If the channel IDs match, the order can be identified as an Instant Delivery order.

The ship_by_date field returned by v2.order.get_order_detail can then be used to determine the latest shipping deadline for the order.

2. Identify or Filter Instant Delivery Packages

For package-level order processing, we recommend using v2.order.search_package_list and v2.order.get_package_detail.

Use v2.order.search_package_list with: order_type = 2 (Instant Order)

This parameter allows ISVs and Developers to directly retrieve packages belonging to Instant Delivery orders.

The shipping_priority parameter can also be used to filter packages by shipping urgency. ISVs can use shipping_priority to quickly filter packages by urgency.

● For MY, PH, TW, and TH shops, as well as VN Preferred, Preferred Plus, and Shopee Mall shops:

● 0: All

● 1: Overdue

● 2: Ship by Today

● 3: Ship by Tomorrow

● For other shops:

● 0: All

● 1: Overdue

● 2: Within 24 hours

● 3: Beyond 24 hours

● The default value is 0 (All)

ISVs and Developers can use shipping_priority to quickly filter packages by urgency, then call v2.order.get_package_detail to retrieve more detailed package-level information for fulfillment processing.

Recommended Best Practices

To help sellers identify and process Instant Delivery orders more efficiently, we recommend to implement:

● A dedicated Instant Orders tab or filter

● Priority sorting for Instant Delivery order by the earliest ship_by_date

● Color coding or badges to distinguish Instant Delivery orders

● Distinct notification sounds for incoming Instant Delivery order

● SLA countdown timers or shipping deadline indicators

These enhancements can help sellers react faster and reduce the risk of missing shipping deadlines.

Additional Features

ISVs and Developers may also consider supporting features that further support instant seller operations, including:

● Pause & Resume (learn more here)

● Auto-call Driver (learn more here)

● Order reminders and escalation alerts (learn more here)

● Partial Cancellation / Partial Fulfillment (learn more here)

● Reschedule Pickup (where applicable) (learn more here)

Note: Availability of these features may vary across markets, and some features may be enabled only for selected whitelisted sellers.

For any questions or further clarification, feel free to contact us by raising an Open Platform Ticket here.

Thank you for your cooperation.

-------------------------------------------------------------------------------------------------------------------------------------------------------

尊敬的开发者:

本公告适用于为 Shopee 马来西亚（MY）、泰国（TH）、印度尼西亚（ID）、越南（VN）、菲律宾（PH）和巴西（BR）卖家提供履约解决方案的开发者。

Instant Delivery 是 Shopee 重点推进的履约项目之一，预计未来 1–2 年内将持续快速增长。我们建议所有履约开发者优先升级产品，以支持 Instant Delivery，帮助卖家满足不断增长的极速配送需求，并保持竞争优势。

重要性说明

Instant Delivery 是 Shopee 最快的配送服务，订单可在骑手取件后数分钟至最长 4 小时内送达。

与 Standard Delivery 通常按照预约取件时间进行批量备货和交付不同，Instant Delivery 要求卖家在更短的时间窗口内逐笔处理订单，因为骑手会在订单产生后较短时间内安排取件。

为了支持这一运营模式的变化，履约解决方案需要帮助卖家快速识别、优先处理并高效处理 Instant Delivery 订单，从而满足所需的履约 SLA 要求。

与此同时，消费者对于更快速配送的需求持续增长。Instant Delivery 可以帮助卖家：

● 提升时效性商品的订单转化率。

● 通过 Instant Delivery 筛选条件和活动页面提升商品曝光度。

● 提供更优质的客户体验。

● 通过满足消费者对快速配送不断增长的需求，保持市场竞争力。

OpenAPI 支持

Shopee OpenAPI 提供以下 API 及相关字段，帮助开发者识别 Instant Delivery 配送渠道、筛选 Instant Delivery 订单包裹，并优先处理包裹履约。

1. 识别 Instant Delivery 配送渠道

调用 v2.logistics.get_channel_list 获取店铺可用的物流渠道。

当某个物流渠道返回的 service_type_identifier 字段值为 instant 时，表示该渠道属于 Instant Delivery（即时配送）渠道。

开发者可以记录这些渠道对应的 logistics_channel_id，并与 v2.order.get_order_detail 返回的订单 logistics_channel_id 进行匹配。若两者一致，则可以判断该订单属于 Instant Delivery 订单。

随后，可结合 v2.order.get_order_detail 返回的 ship_by_date 字段，获取该订单最晚的发货截止时间。

2. 识别或筛选 Instant Delivery 订单包裹

对于包裹维度的订单处理，建议使用 v2.order.search_package_list 和 v2.order.get_package_detail。

调用 v2.order.search_package_list 时，可传入：order_type = 2：Instant Order

通过该参数，开发者可以直接筛选并获取属于 Instant Delivery 订单的包裹列表。

此外，shipping_priority 参数可用于按照发货紧急程度筛选包裹。

● 对于 MY、PH、TW 和 TH 店铺，以及 VN Preferred、Preferred Plus 和 Shopee Mall 店铺：

● 0：全部

● 1：已逾期

● 2：今天前发货

● 3：明天前发货

● 对于其他店铺：

● 0：全部

● 1：已逾期

● 2：24 小时内

● 3：24 小时后

● 默认值为 0（全部）

开发者可以使用 shipping_priority 快速筛选不同紧急程度的包裹，并进一步调用 v2.order.get_package_detail 获取包裹维度的详细信息，用于后续履约处理。

推荐最佳实践

为帮助卖家更高效地识别和处理 Instant Delivery 订单，建议在产品中实现以下功能：

● 提供独立的Instant Orders tab or filters

● 按 ship_by_date 最早优先排序 Instant Delivery 订单。

● 使用颜色标识或徽章突出显示 Instant Delivery 订单。

● 为新收到的 Instant Delivery 订单提供独立通知音效。

● 显示 SLA 倒计时或发货截止时间提醒。

以上优化可帮助卖家更快速地响应订单，降低错过发货时限的风险。

推荐功能

开发者还可考虑支持以下功能，以进一步提升Instant卖家的运营效率：

● Pause & Resume (了解更多)

● Auto-call Driver (了解更多)

● Order reminders and escalation alerts (了解更多)

● Partial Cancellation / Partial Fulfillment (了解更多)

● Reschedule Pickup (where applicable) (了解更多)

注意： 以上功能的可用性可能因不同市场而有所差异，部分功能仅对指定的白名单商家开放。

如有任何疑问或需要进一步协助，请随时点击此处提交 Open Platform 工单与我们联系。

感谢您的合作 。