来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 [TH] Restricted Time Update for Instant Delivery Channel
Dear Developers,
- Applicability
The updates below are effective for selected Shopee TH local sellers only.
- 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 Timeslot | Status from 1 September 2026 |
|---|---|
| 06.00 - 19.59 | When 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". |
- Affected Logistics Channels
| logistics_channel_name | logistics_channel_id |
|---|---|
| Instant Delivery - ส่งทันที (แพ็ก 30 นาที) | 70124 |
| Instant Delivery - ส่งทันที (แพ็ก 2 ชั่วโมง) | 70126 |
- 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"
}
- 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.
- Related APIs
v2.logistics.get_shipping_parameter
- Effective Date
1 September 2026
尊敬的开发者,
- 适用范围
以下更新仅适用于特定的 Shopee TH本土卖家。
- 背景与更新详情
自 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"。 |
- 受影响物流渠道
| logistics_channel_name | logistics_channel_id |
|---|---|
| Instant Delivery - ส่งทันที (แพ็ก 30 นาที) | 70124 |
| Instant Delivery - ส่งทันที (แพ็ก 2 ชั่วโมง) | 70126 |
- 响应示例
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"
}
- 开发者需采取的行动
如果在限制时段(20:00 - 05:59 (D+1))调用此API收到错误消息“No available time slot”时,您应该将此响应视为“即时配送暂无可用取货时段”。
请根据新的可用时间范围更新您的显示和处理逻辑。
- 相关 API
v2.logistics.get_shipping_parameter
- 生效时间
2026年9月1日
