[VN] Support New Instant Priority Channel Hỏa Tốc - Ưu Tiên

[VN] Support New Instant Priority Channel Hỏa Tốc - Ưu Tiên

Dear Developers,

The updates below are effective for selected Shopee VN local sellers only.

Shopee VN is introducing a new masked channel: Hỏa Tốc Ưu Tiên.

Under this masked logistics channel, two new logistics channels are now available:

• SPX Instant – Hỏa Tốc Ưu Tiên (logistics_channel_id: 50040)
• beDelivery – Hỏa Tốc Ưu Tiên (logistics_channel_id: 50043)

This update is designed to provide faster delivery options and introduces a specialized automatic fulfillment logic for supported sellers.

The channel is default toggle off, sellers can toggle on.

Sample of Response Body

v2.logistics.get_channel_list

Hỏa Tốc Ưu Tiên (Masked Channel):

{

"logistics_channel_id": 5115,

"logistics_channel_name": "Hỏa Tốc Ưu Tiên",

"mask_channel_id": 0,

"enabled": true,

"cod_enabled": true,

"service_type_identifier": "instant",

"weight_limit": {

"item_max_weight": 30,

"item_min_weight": 0.01

}

SPX Instant - Hỏa Tốc Ưu Tiên:

{

"logistics_channel_id": 50040,

"logistics_channel_name": "SPX Instant - Hỏa Tốc Ưu Tiên",

"mask_channel_id": 5115,

"enabled": true,

"cod_enabled": true,

"service_type_identifier": "instant",

"fee_type": "SIZE_INPUT",

"weight_limit": {

"item_max_weight": 30,

"item_min_weight": 0.01

},

"item_max_dimension": {

"height": 60,

"width": 60,

"length": 60,

"unit": "cm"

}

beDelivery - Hoả Tốc Ưu Tiên:

{

"logistics_channel_id": 50043,

"logistics_channel_name": "beDelivery - Hoả Tốc Ưu Tiên",

"mask_channel_id": 5115,

"enabled": true,

"cod_enabled": true,

"service_type_identifier": "instant",

"fee_type": "SIZE_INPUT",

"weight_limit": {

"item_max_weight": 30,

"item_min_weight": 0.01

},

"item_max_dimension": {

"height": 60,

"width": 60,

"length": 60,

"unit": "cm"

}

Action to Take from Developers

• Update Integration Logic: Support new logistics_channel_id 50040, 50043 and mask_channel_id 5115.
• Support Dual Fulfillment Flows:

- If Auto-call feature is ON: The system automatically moves orders to "PROCESSED" status. Developers should skip v2.logistics.ship_order and proceed directly to AWB printing.

- If Auto-call feature is OFF: Sellers must manually call v2.logistics.ship_order. Note: Strict timelines apply (15 minutes to arrange shipment). Failure to comply will impact the Late Delivery Rate (LDR) and Non-Fulfillment Rate (NFR).

• AWB Customization: Display the text "Hỏa Tốc Ưu Tiên" clearly next to the 3PL logo on the printed label.

Note: If a driver is not found after 10 minutes, sellers must visit the Shopee Seller Center to manually trigger the "Retry Finding Driver" option, as this operation is currently not supported via API.

For detailed operational guidance on the Auto-call function and Seller Center workflows, please refer to the related announcement on Shopee Uni VN, which provides step-by-step instructions and operational examples.

AWB Sample

Below is a sample AWB for reference. The Hỏa Tốc Ưu Tiên are highlighted in red.

SPX Instant - Hỏa Tốc - Ưu Tiên:

beDelivery - Hoả Tốc Ưu Tiên:

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

2026-01-16

尊敬的开发者：

以下更新仅适用于特定的 Shopee VN 本土卖家。

Shopee VN 正式推出一个新的masked channel：Hỏa Tốc Ưu Tiên。

在Hỏa Tốc Ưu Tiên 下，新增以下两个logistics channel：

• SPX Instant – Hỏa Tốc Ưu Tiên（logistics_channel_id：50040）
• beDelivery – Hỏa Tốc Ưu Tiên（logistics_channel_id：50043）

本次更新旨在为卖家提供更快的配送服务，并针对符合条件的卖家引入了专属的自动履约逻辑。

以上渠道默认处于关闭状态，卖家可以手动开启。

响应主体示例

V2.logistics.get_channel_list

Hỏa Tốc Ưu Tiên (Masked Channel)：

{

"logistics_channel_id": 5115,

"logistics_channel_name": "Hỏa Tốc Ưu Tiên",

"mask_channel_id": 0,

"enabled": true,

"cod_enabled": true,

"service_type_identifier": "instant",

"weight_limit": {

"item_max_weight": 30,

"item_min_weight": 0.01

}

SPX Instant - Hỏa Tốc Ưu Tiên:

{

"logistics_channel_id": 50040,

"logistics_channel_name": "SPX Instant - Hỏa Tốc Ưu Tiên",

"mask_channel_id": 5115,

"enabled": true,

"cod_enabled": true,

"service_type_identifier": "instant",

"fee_type": "SIZE_INPUT",

"weight_limit": {

"item_max_weight": 30,

"item_min_weight": 0.01

},

"item_max_dimension": {

"height": 60,

"width": 60,

"length": 60,

"unit": "cm"

}

beDelivery - Hoả Tốc Ưu Tiên:

{

"logistics_channel_id": 50043,

"logistics_channel_name": "beDelivery - Hoả Tốc Ưu Tiên",

"mask_channel_id": 5115,

"enabled": true,

"cod_enabled": true,

"service_type_identifier": "instant",

"fee_type": "SIZE_INPUT",

"weight_limit": {

"item_max_weight": 30,

"item_min_weight": 0.01

},

"item_max_dimension": {

"height": 60,

"width": 60,

"length": 60,

"unit": "cm"

}

开发者需采取的操作

• 更新集成逻辑：支持新的 logistics_channel_id 50040、50043 和 mask_channel_id 5115。
• 支持双重履行流程：

- 如果Auto-call功能已开启：系统会自动将订单状态更改为“PROCESSED”。您应跳过调用v2.logistics.ship_order，直接进入获取面单的流程。

- 如果Auto-call功能已关闭：卖家必须手动调用 v2.logistics.ship_order。

• 自画面单要求：在打印标签上的第三方物流 (3PL) 标志旁边清晰显示“Hỏa Tốc Ưu Tiên”字样。

注意：这些渠道有严格的时间限制（15 分钟内安排发货），未能遵守时间限制将影响延迟交货率 (LDR) 和未履行率 (NFR)。

关于 Auto-call 机制说明 及 Seller Center 具体操作流程，请参考 Shopee Uni VN 上的公告，其中提供了更详细的流程说明与操作示例。

AWB Sample

以下是面单样式示例，供您参考，“Hỏa Tốc Ưu Tiên”以红色高亮展示。

SPX Instant - Hỏa Tốc - Ưu Tiên:

beDelivery - Hoả Tốc Ưu Tiên:

影响的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-01-16