来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 [Important][PH] New Instant Delivery Channel
Dear Developers,
The updates below are applicable to select whitelisted Shopee PH local sellers only.
Shopee PH is providing a new integrated logistics channel: Instant Delivery.
| logistics_channel_name | logistics_channel_id | mask_channel__id |
|---|---|---|
| Instant Delivery | 40079 | 0 |
Note that for Instant Delivery, orders paid before 3PM must be arranged for shipment within two hours and handed over to 3PLs within 1.5 hours 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 12NN Verified between 10AM and 3PM - Within two hours Verified after 3PM - D+1 12NN | Within 1.5 hours of shipment arrangement |
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": 30,
"length": 30,
"unit": "cm",
"width": 30
},
"logistics_capability": {
"direct_delivery": false,
"seller_logistics": false,
"spx_instant": false
},
"logistics_channel_id": 40079,
"logistics_channel_name": "Instant Delivery",
"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": 10,
"item_min_weight": 0
}
The Instant Delivery 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."
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:
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 | Sort Codes | [Required] Font Size: Refer to the diagram List of Sort Codes first_recipient_sort_code third_recipient_sort_code return_first_sort_code zone_code dely_sun_label |
| 7 | Recipient and Sender Info | [Required] Font size: ≥ 16 |
| 8 | Order Info (Order SN, Ship By Date, Weight) | [Required] Font size: ≥ 12 |
| 9 | “PDG” Label | [Required] Font size: ≥ 30 Display "PDG" label in the upper right corner of the Buyer Address section if is_lm_dg_bool = 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.logistics.get_shipping_document_data_info
Effective Date on Live:
January 5, 2026
亲爱的开发者,
以下更新仅适用于Shopee PH地区部分已经列入白名单的本土卖家。
Shopee PH提供了一个新的集成物流渠道：Instant Delivery。
| logistics_channel_name | logistics_channel_id | mask_channel__id |
|---|---|---|
| Instant Delivery | 40079 | 0 |
请注意，对于Instant Delivery，在下午3点之前付款的订单必须在两小时内安排发货，并在安排发货后1.5小时内交给第三方物流（3PL）。其他渠道类型的详细信息请参考下表，以便进行比较。
| 渠道类型 | 买家创建订单时间 | 卖家安排发货SLA | 3PL取货 |
|---|---|---|---|
| 常规（Regular） | 下午2点 | 下午4点 | 晚上9点 |
| 当天达（Same Day Delivery） | 上午11点 | 中午12点 | 下午2点 |
| 即时配送（Instant Delivery） | 下午3点 | 上午 10点前确认 - 当天中午12点 上午 10点至下午 3 点之间 确认 - 两小时内 下午 3 点后确认 - 第二天中午12点 | 安排发货后 1.5 小时内 |
响应主体示例：
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": 30,
"length": 30,
"unit": "cm",
"width": 30
},
"logistics_capability": {
"direct_delivery": false,
"seller_logistics": false,
"spx_instant": false
},
"logistics_channel_id": 40079,
"logistics_channel_name": "Instant Delivery",
"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": 10,
"item_min_weight": 0
}
Instant Delivery渠道已强制启用，无法禁用。
如果调用v2.logistics.update_channel来关闭这个渠道，会收到报错“Sorry that this channel can’t be disabled since it is force enabled.”
请参考下图和表格，了解即时配送的自画面单要求。 Instant Delivery的图标显示在左上角，中间需要带有“Instant”水印，方便卖家识别通过此新渠道发货的包裹。
即时配送的图标：
请注意：某些或所有的分拣码可能会返回为空，这是预期的情况，因为即时配送涉及卖家与买家之间的点对点配送，正常情况下并不会经过任何中转中心。
| # | Waybill Fields | Instant Delivery |
|---|---|---|
| 1 | 显示COD金额 | 不要求 |
| 2 | 显示COGS金额 | 不要求 |
| 3 | Instant 水印 | [必需] |
| 4 | 条形码 | [必需] 宽度: ≥ 10 cm 高度: ≥ 2 cm |
| 5 | 二维码 | [必需] 宽度: ≥ 2.5 cm 高度: ≥ 2.5 cm |
| 6 | 分拣码 | [必需] Font Size: 请参考图中说明 分拣码清单 first_recipient_sort_code third_recipient_sort_code return_first_sort_code zone_code dely_sun_label |
| 7 | 收货和送货人信息 | [必需] Font size: ≥ 16 |
| 8 | 订单详情 (Order SN, Ship By Date, Weight) | [必需] Font size: ≥ 12 |
| 9 | 危险品标签 | [必需] 如果 is_lm_dg_bool = 1，在买家地址的右上角显示 "PDG" 标签。 Font size: ≥ 30 |
影响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.logistics.get_shipping_document_data_info
上线生效日期：
2026年1月5日