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.

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/logistics/update_operating_hours

Tham số chung

Name	Type	Sample	Description
partner_id	int	1	Partner ID được gán khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu.
timestamp	timestamp	1610000000	Dùng để chỉ định thời điểm gửi yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút.
access_token	string	c09222e3fc40ffb25fc947f738b1abf1	Token dùng để truy cập API, xác định quyền của bạn. Có thể dùng nhiều lần và hết hạn sau 4 giờ.
shop_id	int	600000	Mã định danh duy nhất của Shopee cho một cửa hàng. Tham số bắt buộc cho hầu hết các API.
sign	string	e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2	Chữ ký được tạo từ partner_id, đường dẫn api, timestamp, access_token, shop_id và partner_key qua thuật toán HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Tham số Request

Name	Type	Required	Sample	Description
regular_operating_hour	object	False		Chi tiết giờ hoạt động lấy hàng / giờ lấy hàng ưu tiên. Có thể bỏ qua nếu không cập nhật.
monday	object	False		Giờ hoạt động Thứ Hai: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
tuesday	object	False		Giờ hoạt động Thứ Ba: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
wednesday	object	False		Giờ hoạt động Thứ Tư: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
thursday	object	False		Giờ hoạt động Thứ Năm: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
friday	object	False		Giờ hoạt động Thứ Sáu: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
saturday	object	False		Giờ hoạt động Thứ Bảy: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
sunday	object	False		Giờ hoạt động Chủ Nhật: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
public_holiday	object	False		Giờ hoạt động ngày lễ công cộng: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 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	Tên của giờ hoạt động đặc biệt
start_date	string	True	2025-03-03	Ngày bắt đầu của giờ hoạt động đặc biệt. Giá trị phải trong khoảng [hôm nay + 1] đến [hôm nay + 365 ngày].
end_date	string	True	2025-03-05	Ngày kết thúc của Giờ hoạt động Đặc biệt. Giá trị phải nằm trong khoảng [start_date + 30 ngày].
operating_hours	object[]	True		Để chỉ định giờ hoạt động cho từng ngày
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	Thời gian bắt đầu hoạt động vào ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	23:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
enable	boolean	True	true	Đặt giá trị này là False nếu không hoạt động vào ngày đó (đóng cửa)
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		Giờ hoạt động Thứ Hai: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
tuesday	object	False		Giờ hoạt động Thứ Ba: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
wednesday	object	False		Giờ hoạt động Thứ Tư: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
thrusday	object	False		Giờ hoạt động Thứ Năm: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
friday	object	False		Giờ hoạt động Thứ Sáu: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
saturday	object	False		Giờ hoạt động Thứ Bảy: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
sunday	object	False		Giờ hoạt động Chủ Nhật: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
public_holiday	object	False		Giờ hoạt động ngày lễ công cộng: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 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		Giờ hoạt động Thứ Hai: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
tuesday	object	False		Giờ hoạt động Thứ Ba: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
wednesday	object	False		Giờ hoạt động Thứ Tư: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
thursday	object	False		Giờ hoạt động Thứ Năm: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
friday	object	False		Giờ hoạt động Thứ Sáu: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
saturday	object	False		Giờ hoạt động Thứ Bảy: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
sunday	object	False		Giờ hoạt động Chủ Nhật: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.
public_holiday	object	False		Giờ hoạt động ngày lễ công cộng: Có thể bỏ qua nếu muốn đánh dấu ngày đóng cửa.
start_time	string	True	09:00	Thời gian bắt đầu hoạt động trong ngày đó. Định dạng XX:YY, trong đó YY là 00 hoặc 30.
end_time	string	True	18:30	Giờ kết thúc của giờ làm việc trong ngày đó. Thời gian phải theo định dạng XX:YY, trong đó YY là 00 hoặc 30. Ngoại trừ định dạng 24 giờ, bạn có thể nhập start_time là 00:00 và end_time là 23:59.

Tham số Response

Name	Type	Sample	Description
error	string	error_auth	Cho biết loại lỗi nếu xảy ra. Trống nếu không có lỗi.
message	string	Invalid access_token.	Cho biết chi tiết lỗi nếu xảy ra. Trống nếu không có lỗi.
request_id	string	3dad66f43b8447d282ae6da36626c6b7	Mã định danh của yêu cầu API dùng để theo dõi lỗi.
response	object
result_list	object
regular_operating_hour	object		Kết quả tạo/cập nhật regular_operating_hour.
status	string	Success	Hệ thống trả về "Failed" nếu có lỗi xác thực. Ngược lại, trả về phản hồi trống.
fail_message	string		Lý do thất bại
special_operating_hour	object		Kết quả tạo/cập nhật special_operating_hour.
status	string	Success	Hệ thống trả về "Failed" nếu có lỗi xác thực. Ngược lại, trả về phản hồi trống.
fail_message	string		Lý do thất bại
instant_operating_hour	object		Kết quả tạo/cập nhật instant_operating_hour.
status	string	Success	Hệ thống trả về "Failed" nếu có lỗi xác thực. Ngược lại, trả về phản hồi trống.
fail_message	string		Lý do thất bại
shop_collection_operating_hour	object		Kết quả tạo/cập nhật shop_collection_operating_hour.
status	string	Success	Hệ thống trả về "Failed" nếu có lỗi xác thực. Ngược lại, trả về phản hồi trống.
fail_message	string		Lý do thất bại