v2.logistics.update_operating_hours
POST /api/v2/logistics/update_operating_hours
This API is designed to allow sellers to update their operating hours. It is essential that the values provided in this API align with the restrictions retrieved from the v2.logistics.get_operating_hour_restrictions API to ensure compliance with platform requirements. This API uses overwriting updates, when updating pickup operating hours, still need to include all parts even those not needing changes.
Endpoint URL
URL: https://partner.shopeemobile.com/api/v2/logistics/update_operating_hours
Common Request Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | Partner ID is assigned upon registration is successful. Required for all requests. |
| timestamp | timestamp | 1610000000 | This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours. |
| shop_id | int | 600000 | Shopee's unique identifier for a shop. Required param for most APIs. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Request Parameters
| Name | Type | Required | Sample | Description |
|---|---|---|---|---|
| regular_operating_hour | object | False | Details of Pickup Operating Hours / Preferred Pickup Hours: You can skip this parameter if you are not updating the Pickup Operating Hours / Preferred Pickup Hours | |
| monday | object | False | Operating hours for Monday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| tuesday | object | False | Operating hours for Tuesday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| wednesday | object | False | Operating hours for Wednesday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| thursday | object | False | Operating hours for Thursday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| friday | object | False | Operating hours for Friday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| saturday | object | False | Operating hours for Saturday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| sunday | object | False | Operating hours for Sunday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| public_holiday | object | False | Operating hours for public holiday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| special_operating_hour | object | False | Details of Special Operating Hours : You can skip this parameter if you are not creating Special Operating Hours or if you do not have access to create Special Operating Hours | |
| name | string | True | 3.3 Campaign | The name of Special Operating Hours |
| start_date | string | True | 2025-03-03 | The start date of the Special Operating Hours. The value should be within [today + 1] and [today + 365 days]. |
| end_date | string | True | 2025-03-05 | The end date of the Special Operating Hours. The value should be within [start_date + 30 days] |
| operating_hours | object[] | True | To specify the operating hours for each date | |
| date | string | True | 2025-03-03 | Date: it should be include all date from start_date until end_date |
| start_time | string | True | 00:00 | Start time for operating hours on that date: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 23:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| enable | boolean | True | true | To specify this value as False if you're not operate on that date (close) |
| instant_operating_hour | object | False | Details of Instant Operating Hours : You can skip this parameter if you are not creating/updating Instant Operating Hours or if you do not have access to create/update Instant Operating Hours | |
| monday | object | False | Operating hours for Monday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| tuesday | object | False | Operating hours for Tuesday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| wednesday | object | False | Operating hours for Wednesday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| thrusday | object | False | Operating hours for Thursday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| friday | object | False | Operating hours for Friday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| saturday | object | False | Operating hours for Saturday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| sunday | object | False | Operating hours for Sunday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| public_holiday | object | False | Operating hours for public holiday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| shop_collection_operating_hour | object | False | Details of Shop Collection Operating Hours : You can skip this parameter if you are not creating/updating Shop Collection Operating Hours or if you do not have access to create/update Shop Collection Operating Hours | |
| monday | object | False | Operating hours for Monday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| tuesday | object | False | Operating hours for Tuesday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| wednesday | object | False | Operating hours for Wednesday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| thursday | object | False | Operating hours for Thursday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| friday | object | False | Operating hours for Friday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| saturday | object | False | Operating hours for Saturday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| sunday | object | False | Operating hours for Sunday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
| public_holiday | object | False | Operating hours for Public Holiday: You can skip this information if you want to mark the day as closed. | |
| start_time | string | True | 09:00 | Start time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. |
| end_time | string | True | 18:30 | End time for operating hours on that day: The time should be in the format XX:YY, where YY is either 00 or 30. Except for a 24-hour, you can input a start_time of 00:00 and an end_time of 23:59 |
Response Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| error | string | error_auth | Indicate error type if hit error. Empty if no error happened. |
| message | string | Invalid access_token. | Indicate error details if hit error. Empty if no error happened. |
| request_id | string | 3dad66f43b8447d282ae6da36626c6b7 | The identifier for an API request for error tracking. |
| response | object | ||
| result_list | object | ||
| regular_operating_hour | object | The result of create/update regular_operating_hour. | |
| status | string | Success | The system will return "Failed" if there are any validation errors. Otherwise, it will return a blank response. |
| fail_message | string | Fail reason | |
| special_operating_hour | object | The result of create/update speicial_operating_hour. | |
| status | string | Success | The system will return "Failed" if there are any validation errors. Otherwise, it will return a blank response. |
| fail_message | string | Fail reason | |
| instant_operating_hour | object | The result of create/update instant_operating_hour. | |
| status | string | Success | The system will return "Failed" if there are any validation errors. Otherwise, it will return a blank response. |
| fail_message | string | Fail reason | |
| shop_collection_operating_hour | object | The result of create/update shop_collection_operating_hour. | |
| status | string | Success | The system will return "Failed" if there are any validation errors. Otherwise, it will return a blank response. |
| fail_message | string | Fail reason |