来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 [PH] New Instant Delivery Priority Channel
Dear Developers,
- Applicability
The updates below are applicable to select whitelisted Shopee PH local sellers only.
- Background & Update Details
Shopee PH is providing a new integrated logistic channel: Instant Delivery Priority.
- Affected Logistics Channels
| shipping_carrier | logistics_channel_id | mask_channel__id |
|---|---|---|
| Instant Delivery Priority | 40080 | 0 |
Note that for Instant Delivery Priority, orders paid before 3PM must be arranged for shipment within 30mins and handed over to 3PLs within 30mins of booking.
Details of other channel types are shown below for comparison.
| Channel Type | Buyer Create Order Time | Seller Arrange Shipment SLA | 3PL Pickup |
|---|---|---|---|
| Regular | 2 PM | 4 PM | 9 PM |
| Same Day Delivery | 11 AM | 12 NN | 2 PM |
| Instant Delivery | 3 PM | Verified before 10AM - D0 11AM Verified between 10AM and 3PM - Within one hour Verified after 3PM - D+1 11AM | Within 1 hour of booking |
| Instant Delivery Priority | 3 PM | Verified before 10AM - D0 1030AM Verified between 10AM and 3PM Within 30 mins Verified after 3PM - D+1 1030AM | Within 30 mins of booking |
Note: D0 represents the current day, and D+1 represents the next day.
- Sample of Response Body
v2.logistics.get_channel_list
{
"block_seller_cover_shipping_fee": false,
"cod_enabled": false,
"enabled": true,
"fee_type": "SIZE_INPUT",
"force_enable": false,
"item_max_dimension": {
"dimension_sum": 0,
"height": 40,
"length": 40,
"unit": "cm",
"width": 40
},
"logistics_capability": {
"direct_delivery": false,
"seller_logistics": false,
"spx_instant": false
},
"logistics_channel_id": 40080,
"logistics_channel_name": "Instant Delivery Priority",
"logistics_description": "",
"mask_channel_id": 0,
"preprint": true,
"seller_logistic_has_configuration": null,
"size_list": [],
"support_cross_border": false,
"support_direct": false,
"support_pre_order": true,
"volume_limit": {
"item_max_volume": 0,
"item_min_volume": 0
},
"weight_limit": {
"item_max_weight": 20000,
"item_min_weight": 0
}
- Action to Take from Developers
The Instant Delivery Priority channel is force enabled and cannot be disabled.
If you call v2.logistics.update_channel to disable this channel, you will receive the error: "Sorry that this channel can’t be disabled since it is force enabled."
This channel supports pre-print AWB. Please refer to the diagram and table below for the customized AWB requirements for Instant Delivery.
The Instant Delivery logo is displayed in the upper-left corner, with an “Instant” watermark in the center, allowing sellers to identify packages shipped through this new channel.
Instant Delivery Logo:
- AWB Sample
Below is a sample AWB for reference. The updated fields are highlighted in red.
Note that some or all sort codes may be returned as null. This is expected as Instant Delivery involves point-to-point delivery between the seller and the buyer and is thus not routed through any hub under normal circumstances.
| # | Waybill Fields | Instant Delivery |
|---|---|---|
| 1 | Display COD Amount | Prohibited |
| 2 | Display COGS Amount | Prohibited |
| 3 | Instant Watermark | [Required] |
| 4 | Barcode | [Required] Width: ≥ 10 cm Height: ≥ 2 cm |
| 5 | QR Code | [Required] Width: ≥ 2.5 cm Height: ≥ 2.5 cm |
| 6 | Pickup Code | [Required] Font size: ≥ 16 List of Sort Codes pickup_code |
| 7 | Recipient and Sender Info | [Required] Font size: ≥ 16 |
| 8 | Order Info (Order SN, Ship By Date, Weight) | [Required] Font size: ≥ 12 |
- Related APIs
v2.logistics.get_channel_list
v2.logistics.update_channel
v2.product.add_item
v2.product.update_item
v2.product.get_item_base_info
v2.order.get_order_detail
v2.order.get_package_detail
v2.logistics.get_shipping_document_data_info
- Effective Date
May 25, 2026
尊敬的开发者,
- 适用范围
以下更新仅适用于部分已列入白名单的 Shopee PH 本地卖家。
- 背景与更新详情
Shopee PH 新增一个一体化物流渠道:Instant Delivery Priority。
- 受影响的物流渠道
| shipping_carrier | logistics_channel_id | mask_channel_id |
|---|---|---|
| Instant Delivery Priority | 40080 | 0 |
请注意,对于 Instant Delivery Priority,下午 3 点前支付的订单,卖家必须在 30 分钟内安排发货,并在预约后 30 分钟内完成与第三方物流(3PL)的交接。
其他渠道类型的详细信息如下,供对比参考。
| 渠道类型 | 买家创建订单时间 | 卖家安排发货 SLA | 3PL 取件 |
|---|---|---|---|
| Regular 常规配送 | 2 PM | 4 PM | 9 PM |
| Same Day Delivery 当日达 | 11 AM | 12 NN(中午 12 点) | 2 PM |
| Instant Delivery 即时配送 | 3 PM | 10 AM 前订单确认:D0 11 AM 10 AM 至 3 PM 之间订单确认:1 小时内 3 PM 后订单确认:D+1 11 AM | 预约后 1 小时内 |
| Instant Delivery Priority 即时配送优先 | 3 PM | 10 AM 前订单确认:D0 10:30 AM 10 AM 至 3 PM 之间订单确认:30 分钟内 3 PM 后订单确认:D+1 10:30 AM | 预约后 30 分钟内 |
注:D0 表示当天,D+1 表示次日。
- 响应示例
v2.logistics.get_channel_list
{
"block_seller_cover_shipping_fee": false,
"cod_enabled": false,
"enabled": true,
"fee_type": "SIZE_INPUT",
"force_enable": false,
"item_max_dimension": {
"dimension_sum": 0,
"height": 40,
"length": 40,
"unit": "cm",
"width": 40
},
"logistics_capability": {
"direct_delivery": false,
"seller_logistics": false,
"spx_instant": false
},
"logistics_channel_id": 40080,
"logistics_channel_name": "Instant Delivery Priority",
"logistics_description": "",
"mask_channel_id": 0,
"preprint": true,
"seller_logistic_has_configuration": null,
"size_list": [],
"support_cross_border": false,
"support_direct": false,
"support_pre_order": true,
"volume_limit": {
"item_max_volume": 0,
"item_min_volume": 0
},
"weight_limit": {
"item_max_weight": 20000,
"item_min_weight": 0
}
- 开发者需要采取的行动
Instant Delivery Priority 渠道为强制启用渠道,无法被禁用。 如果调用 v2.logistics.update_channel 禁用该渠道,将返回以下错误: Sorry that this channel can’t be disabled since it is force enabled.
该渠道支持预打印 AWB。
请参考下方示意图和表格,了解 Instant Delivery Priority 的定制化 AWB 要求。
Instant Delivery标识要展示在面单左上角,面单中间会展示 “Instant” 水印,方便卖家识别通过该新渠道发出的包裹。
Instant Delivery 标识:
- AWB 示例
以下为 AWB 示例,仅供参考。更新字段已用红色标注。
请注意,部分或全部分拣码可能返回为 null,这是预期表现,因为 Instant Delivery Priority 是卖家与买家之间的点对点配送,正常情况下不会经过任何集散中心。
| # | 面单字段 | Instant Delivery |
|---|---|---|
| 1 | 显示 COD 金额 | 禁止 |
| 2 | 显示 COGS 金额 | 禁止 |
| 3 | Instant 水印 | 【必需】 |
| 4 | 条形码 | 【必需】 宽度:≥ 10 cm 高度:≥ 2 cm |
| 5 | 二维码 | 【必需】 宽度:≥ 2.5 cm 高度:≥ 2.5 cm |
| 6 | 取件码 | 【必需】 字体大小:≥ 16 分拣码列表: pickup_code |
| 7 | 收件人与寄件人信息 | 【必需】字体大小:≥ 16 |
| 8 | 订单信息(Order SN、Ship By Date、Weight) | 【必需】字体大小:≥ 12 |
- 影响API
v2.logistics.get_channel_list
v2.logistics.update_channel
v2.product.add_item
v2.product.update_item
v2.product.get_item_base_info
v2.order.get_order_detail
v2.order.get_package_detail
v2.logistics.get_shipping_document_data_info
- 生效日期
2026年5月25日
