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

[TH] Restricted Time Update for Instant Delivery 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 [TH] Restricted Time Update for Instant Delivery Channel

Dear Developers,

  1. Applicability

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

  1. Background & Update Details

Effective from September 1, 2026, the Now pickup timeslot returned by v2.logistics.get_shipping_parameter for Instant Delivery channels (Channel ID: 70124, 70126) will be updated.

After the update, time_text = Now will only be returned during 06:00 - 19:59. During the restricted time period from 20:00 to 05:59 (D+1), API will return an error message "No available time slot".

Delivery TimeslotStatus from 1 September 2026
06.00 - 19.59When attempting to call v2.logistics.get_shipping_parameter during this period, time_text = Now will be returned in time_slot_list.
20.00 - 05.59 (D+1):When attempting to call v2.logistics.get_shipping_parameter during this period, error will be responded as "No available time slot".
  1. Affected Logistics Channels
logistics_channel_namelogistics_channel_id
Instant Delivery - ส่งทันที (แพ็ก 30 นาที)70124
Instant Delivery - ส่งทันที (แพ็ก 2 ชั่วโมง)70126
  1. Sample of Response Body

Sample of response body:

v2.logistics.get_shipping_parameter

When the API is called during the available time period from 06:00 to 19:59, time_text = Now will be returned.

{

"error": "",

"message": "",

"response": {

"info_needed": {

"pickup": [

"address_id",

"pickup_time_id"

]

},

"pickup": {

"address_list": [

{

"address_id": 200000000,

"region": "TH",

"state": "จังหวัดสมุทรปราการ",

"city": "อำเภอบางพลี",

"district": "ตำบลบางพลีใหญ่",

"town": "",

"address": "Bang Na-Trat Frontage Road, Bang Kaeo, Bang Phli District, Samut Prakan, Thailand",

"zipcode": "10540",

"address_flag": [

"current_address"

],

"time_slot_list": [

{

"date": 0000000000,

"time_text": "Now",

"pickup_time_id": "0000000000_01",

"flags": [

"recommended"

]

}

]

}

]

}

},

"warning": "",

"request_id": "2880a5a28510424eaa3288fd941fae2c"

}

When the API is called during the restricted time period from 20:00 to 05:59 (D+1), API will return an error message "No available time slot".

{

"error": "logistics.no_available_time_slot",

"message": "No available time slot",

"request_id": "e3e3e7f35a039f6c8be12c649ba2b100:01000392f19bfc3e:000000f57589f078"

}

  1. Action to Take from Developers

When receiving an error message "No available time slot" during Restricted Time (20:00 - 05:59 (D+1)), developers should treat the response as ‘No available Now’ pickup timeslot for Instant Delivery.

Please update your display and handling logic based on the new available time range.

  1. Related APIs

v2.logistics.get_shipping_parameter

  1. Effective Date

1 September 2026

尊敬的开发者,

  1. 适用范围

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

  1. 背景与更新详情

自 September 1, 2026 起,Instant Delivery channels(Channel ID:70124、70126)在 v2.logistics.get_shipping_parameter 中返回的 Now 取件时间段将进行更新。

仅在 06:00 - 19:59 期间,API 会在 time_slot_list 中返回 time_text = Now。在限制时间段 20:00 - 05:59(D+1)期间,API 将返回错误:"No available time slot"。

API 调用时间2026年9月1日起 API 返回变化
06.00 - 19.59开发者在该时间段内调用 v2.logistics.get_shipping_parameter 时,time_slot_list 中将返回 time_text = Now。
20.00 - 05.59 (D+1):开发者在该时间段内调用 v2.logistics.get_shipping_parameter 时,将返回错误:"No available time slot"。
  1. 受影响物流渠道
logistics_channel_namelogistics_channel_id
Instant Delivery - ส่งทันที (แพ็ก 30 นาที)70124
Instant Delivery - ส่งทันที (แพ็ก 2 ชั่วโมง)70126
  1. 响应示例

Sample of response body: v2.logistics.get_shipping_parameter

当 API 在可用时间段 06:00 - 19:59 内被调用时,将返回 time_text = Now。

{

"error": "",

"message": "",

"response": {

"info_needed": {

"pickup": [

"address_id",

"pickup_time_id"

]

},

"pickup": {

"address_list": [

{

"address_id": 200000000,

"region": "TH",

"state": "จังหวัดสมุทรปราการ",

"city": "อำเภอบางพลี",

"district": "ตำบลบางพลีใหญ่",

"town": "",

"address": "Bang Na-Trat Frontage Road, Bang Kaeo, Bang Phli District, Samut Prakan, Thailand",

"zipcode": "10540",

"address_flag": [

"current_address"

],

"time_slot_list": [

{

"date": 0,

"time_text": "Now",

"pickup_time_id": "0000000000_01",

"flags": [

"recommended"

]

}

]

}

]

}

},

"warning": "",

"request_id": "2880a5a28510424eaa3288fd941fae2c"

}

当 API 在限制时间段 20:00 - 05:59(D+1)内被调用时会返回错误 "No available time slot"。

{

"error": "logistics.no_available_time_slot",

"message": "No available time slot",

"request_id": "e3e3e7f35a039f6c8be12c649ba2b100:01000392f19bfc3e:000000f57589f078"

}

  1. 开发者需采取的行动

如果在限制时段(20:00 - 05:59 (D+1))调用此API收到错误消息“No available time slot”时,您应该将此响应视为“即时配送暂无可用取货时段”。

请根据新的可用时间范围更新您的显示和处理逻辑。

  1. 相关 API

v2.logistics.get_shipping_parameter

  1. 生效时间

2026年9月1日

#