来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Significant OpenAPI Updates for Pickup Service Improvement
Dear Developer,
Please note the following changes:
- Add the following APIs to support sellers to get and set pickup operating hours:
-
Add the v2.logistics.get_operating_hours API to get the pickup operating hours set by sellers, including regular operating hours, instant operating hours, and special operating hours.
-
Add the v2.logistics.get_operating_hour_restrictions API to get the restrictions when setting pickup operating hours.
-
Add the v2.logistics.update_operating_hours API to set and update pickup operating hours. This API uses overwriting updates, when updating pickup operating hours, still need to include all parts even those not needing changes.
-
Add the v2.logistics.delete_special_operating_hour API to delete special operating hours.
- Add the “flags” parameter under the existing “time_slot_list” response parameter for the following APIs. This field will have the value “recommended” for the time slot that Shopee suggests sellers choose. While it is advisable for sellers to choose the recommended time slot, they can also choose other time slots that do not have the recommended flag.
- v2.logistics.get_shipping_parameter
- v2.logistics.get_mass_shipping_parameter
- v2.logistics.get_booking_shipping_parameter
Response Sample:
{
"time_slot_list": [
{
"date": 1740643200,
"flags": [],
"pickup_time_id": "1740643200_1",
"time_text": "09:00 - 12:00"
},
{
"date": 1740643200,
"flags": [
"recommended"
],
"pickup_time_id": "1740643200_2",
"time_text": "12:00 - 15:00"
},
{
"date": 1740643200,
"flags": [],
"pickup_time_id": "1740643200_3",
"time_text": "15:00 - 18:00"
}
]
}
- Some logistics channels may not return any date or time for pickup time slots. In such cases, sellers can arrange shipment without selecting any time slot, and Shopee will arrange a suitable timing for these situations.
Related APIs：
v2.logistics.get_operating_hours
v2.logistics.get_operating_hour_restrictions
v2.logistics.update_operating_hours
v2.logistics.delete_special_operating_hour
v2.logistics.get_shipping_parameter
v2.logistics.get_mass_shipping_parameter
v2.logistics.get_booking_shipping_parameter
v2.logistics.ship_order
v2.logistics.mass_ship_order
v2.logistics.ship_booking
Effective Date on Live：
2025.03.20
尊敬的开发者，
请留意以下变更：
- 新增以下接口支持卖家获取以及设置取件营业时间：
1）新增v2.logistics.get_operating_hours接口，用于获取卖家设置的取件营业时间，包括Regular Operating Hours、Instant Operating Hours以及Special Operating Hours；
2）新增v2.logistics.get_operating_hour_restrictions接口，用于获取设置取件营业时间时的限制条件；
3）新增v2.logistics.update_operating_hours接口，用于设置以及更新取件营业时间 (注意：该接口采用覆盖式更新，更新已设置的取件营业时间时，仍然需要包含其他无需更新的部分)；
4）新增v2.logistics.delete_special_operating_hour接口，用于删除特殊取件营业时间。
- 以下接口的“time_slot_list”响应参数下新增“flags”参数。对于Shopee建议卖家选择的时间段，该参数将返回“recommended”。虽然Shopee建议卖家选择推荐时段，但是卖家仍然可以选择其他没有推荐标志的时段。
- v2.logistics.get_shipping_parameter
- v2.logistics.get_mass_shipping_parameter
- v2.logistics.get_booking_shipping_parameter
响应体示例如下：
{
"time_slot_list": [
{
"date": 1740643200,
"flags": [],
"pickup_time_id": "1740643200_1",
"time_text": "09:00 - 12:00"
},
{
"date": 1740643200,
"flags": [
"recommended"
],
"pickup_time_id": "1740643200_2",
"time_text": "12:00 - 15:00"
},
{
"date": 1740643200,
"flags": [],
"pickup_time_id": "1740643200_3",
"time_text": "15:00 - 18:00"
}
]
}
- 某些物流渠道可能不返回任何取货时间段。在这种情况下，卖家可以不选择任何时间段直接安排发货，Shopee会根据情况安排合适的时间。
影响接口：
v2.logistics.get_operating_hours
v2.logistics.get_operating_hour_restrictions
v2.logistics.update_operating_hours
v2.logistics.delete_special_operating_hour
v2.logistics.get_shipping_parameter
v2.logistics.get_mass_shipping_parameter
v2.logistics.get_booking_shipping_parameter
v2.logistics.ship_order
v2.logistics.mass_ship_order
v2.logistics.ship_booking
上线时间：
2025.03.20