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

[VN] Support New Channel Tủ nhận hàng - SPX

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 [VN] Support New Channel Tủ nhận hàng - SPX

Dear Developers,

  1. Applicability

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

  1. Background & Update Details

Shopee VN is introducing a new integrated logistics channel, Tủ nhận hàng - SPX, which allows buyers to collect their orders from SPX lockers.

This channel is managed by SPX Express and only supports prepaid payments, so COD is not currently supported.

The maximum order value allowed for this channel is 3,000,000 VND.

  1. Affected Logistics Channels
logistics_channel_namelogistics_channel_idmask_channel_id
Tủ nhận hàng - SPX500520

The channel is default toggle on.

  1. Sample of Response Body

v2.logistics.get_channel_list

{

"logistics_channel_id": 50052,

"logistics_channel_name": "Tủ nhận hàng - SPX",

"mask_channel_id": 0,

"enabled": true,

"cod_enabled": false,

"service_type_identifier": "null",

"weight_limit": {

"item_max_weight": 10,

"item_min_weight":

},

"item_max_dimension": {

"height": 44,

"width": 53,

"length": 38,

"unit": "cm"

}

  1. Action to Take from Developers

● Update Integration Logic: Support the new logistics_channel_id 50052.

● AWB Customization: Display the text TỦ NHẬN HÀNG SPX clearly under the Shopee logo on the printed label.

● Validation Logic: Ensure product weight and dimensions do not exceed the channel limits.

● Fulfillment Logic: The handling deadlines and shipping service level agreements (SLA) for this channel are identical to the standard Express channel.

● Timeline Configuration: Developers should configure system alerts based on the 14:00 cut-off time:

○ Orders before 14:00: Arrange shipment by 23:59 same day.

○ Orders after 14:00: Arrange shipment by 23:59 the next day.

For more details regarding the channel's features and seller operations, please refer to this announcement.

  1. AWB Sample

Below is a sample AWB for reference. The TỦ NHẬN HÀNG SPX are highlighted in red.

  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 15, 2026

尊敬的开发者,

  1. 适用范围

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

  1. 背景与更新内容

Shopee VN 将推出新的整合物流渠道:Tủ nhận hàng - SPX。通过该渠道,买家可以选择在 SPX 自提柜领取订单包裹。

此渠道由 SPX Express 管理,仅支持预付费,因此目前不支持货到付款(COD)。

该渠道允许的最高订单金额为 3,000,000 越南盾。

  1. 受影响的物流渠道
logistics_channel_namelogistics_channel_idmask_channel_id
Tủ nhận hàng - SPX500520

The channel is default toggle on.

  1. 响应主体示例

v2.logistics.get_channel_list

{

"logistics_channel_id": 50052,

"logistics_channel_name": "Tủ nhận hàng - SPX",

"mask_channel_id": 0,

"enabled": true,

"cod_enabled": false,

"service_type_identifier": "null",

"weight_limit": {

"item_max_weight": 10,

"item_min_weight":

},

"item_max_dimension": {

"height": 44,

"width": 53,

"length": 38,

"unit": "cm"

}

  1. 开发者需采取的行动

● 集成逻辑更新:支持新的渠道 logistics_channel_id = 50052。

● 自画面单:在打印面单上 Shopee Logo 下方清晰显示文字:TỦ NHẬN HÀNG SPX。

● 校验逻辑:确保商品重量与尺寸不超过该渠道限制。

● 履约逻辑:该渠道的揽收时效与发货 SLA 与标准 Express 渠道一致。

● 时间节点配置:开发者需基于 14:00 截单时间 配置系统提醒:

○ 14:00 前订单:需在当日 23:59 前安排发货

○ 14:00 后订单:需在次日 23:59 前安排发货

更多关于该渠道功能及卖家操作的详情,请参考相关公告

  1. AWB示例

以下为 AWB 示例,红色部分为 TỦ NHẬN HÀNG SPX 标识。

7.相关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月15日

#