快工助手跨境电商知识与商机助手

[PH] New Instant Delivery Priority Channel

Shopee 官方资料 · Shopee Open Platform 变更通知(Announcements) · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.announcements
语言
en
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/announcementtopic/apitopic/changelogtopic/developertopic/logistics-channel-awb-updates

资料正文

§1 [PH] New Instant Delivery Priority Channel

Dear Developers,

  1. Applicability

The updates below are applicable to select whitelisted Shopee PH local sellers only.

  1. Background & Update Details

Shopee PH is providing a new integrated logistic channel: Instant Delivery Priority.

  1. Affected Logistics Channels
shipping_carrierlogistics_channel_idmask_channel__id
Instant Delivery Priority400800

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 TypeBuyer Create Order TimeSeller Arrange Shipment SLA3PL Pickup
Regular2 PM4 PM9 PM
Same Day Delivery11 AM12 NN2 PM
Instant Delivery3 PMVerified before 10AM - D0 11AM Verified between 10AM and 3PM - Within one hour Verified after 3PM - D+1 11AMWithin 1 hour of booking
Instant Delivery Priority3 PMVerified before 10AM - D0 1030AM Verified between 10AM and 3PM Within 30 mins Verified after 3PM - D+1 1030AMWithin 30 mins of booking

Note: D0 represents the current day, and D+1 represents the next day.

  1. 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

}

  1. 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:

  1. 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 FieldsInstant Delivery
1Display COD AmountProhibited
2Display COGS AmountProhibited
3Instant Watermark[Required]
4Barcode[Required] Width: ≥ 10 cm Height: ≥ 2 cm
5QR Code[Required] Width: ≥ 2.5 cm Height: ≥ 2.5 cm
6Pickup Code[Required] Font size: ≥ 16 List of Sort Codes pickup_code
7Recipient and Sender Info[Required] Font size: ≥ 16
8Order Info (Order SN, Ship By Date, Weight)[Required] Font size: ≥ 12
  1. 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

  1. Effective Date

May 25, 2026

尊敬的开发者,

  1. 适用范围

以下更新仅适用于部分已列入白名单的 Shopee PH 本地卖家。

  1. 背景与更新详情

Shopee PH 新增一个一体化物流渠道:Instant Delivery Priority。

  1. 受影响的物流渠道
shipping_carrierlogistics_channel_idmask_channel_id
Instant Delivery Priority400800

请注意,对于 Instant Delivery Priority,下午 3 点前支付的订单,卖家必须在 30 分钟内安排发货,并在预约后 30 分钟内完成与第三方物流(3PL)的交接。

其他渠道类型的详细信息如下,供对比参考。

渠道类型买家创建订单时间卖家安排发货 SLA3PL 取件
Regular 常规配送2 PM4 PM9 PM
Same Day Delivery 当日达11 AM12 NN(中午 12 点)2 PM
Instant Delivery 即时配送3 PM10 AM 前订单确认:D0 11 AM 10 AM 至 3 PM 之间订单确认:1 小时内 3 PM 后订单确认:D+1 11 AM预约后 1 小时内
Instant Delivery Priority 即时配送优先3 PM10 AM 前订单确认:D0 10:30 AM 10 AM 至 3 PM 之间订单确认:30 分钟内 3 PM 后订单确认:D+1 10:30 AM预约后 30 分钟内

注:D0 表示当天,D+1 表示次日。

  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

}

  1. 开发者需要采取的行动

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 标识:

  1. AWB 示例

以下为 AWB 示例,仅供参考。更新字段已用红色标注。

请注意,部分或全部分拣码可能返回为 null,这是预期表现,因为 Instant Delivery Priority 是卖家与买家之间的点对点配送,正常情况下不会经过任何集散中心。

#面单字段Instant Delivery
1显示 COD 金额禁止
2显示 COGS 金额禁止
3Instant 水印【必需】
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
  1. 影响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

  1. 生效日期

2026年5月25日

#