v2.shop.set_shop_holiday_mode
POST /api/v2/shop/set_shop_holiday_mode
Dùng API này để thiết lập trước các khoảng thời gian nghỉ lễ để bật/tắt chế độ nghỉ lễ tự động, với hai chế độ nghỉ lễ cho phép người bán chọn có nhận đơn hàng mới trong thời gian nghỉ hay không.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/shop/set_shop_holiday_mode
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | ID đối tác được cấp sau 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 để xác định thời điểm của 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 đối với API. 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 gian hàng. Tham số bắt buộc cho hầu hết các API. |
| 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 |
Tham số Request
| Tên | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|
| holiday_mode_on | boolean | True | true | Indicate whether to enable holiday mode for the shop. true means turn ON, false means turn OFF. |
| holiday_mode_type | int32 | False | 1 | Holiday type: 0 - Full holiday，buyers cannot place new orders. The behavior remains consistent with the current Holiday Mode. 1 - Partial holiday, buyers can continue placing orders, and the system will automatically extend the order’s Ship-By-Date (SBD). |
| holiday_mode_start_time | timestamp | False | 1770883200 | Holiday start time should be whole hour and could be parsed as "2026:01:16 15:00:00" |
| holiday_mode_end_time | timestamp | False | 1773305999 | Holiday end time plus one second should be whole hour, which means the input timestamp must be able to be parsed as "2025:01:20 17:59:59" and the holiday_end_time must be larger than holiday_start_time |
| holiday_mode_description | string | False | "Spring Festival" | Mô tả kỳ nghỉ lễ |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | error_shop_not_exists | Cho biết loại lỗi nếu xảy ra lỗi. Rỗng nếu không có lỗi. |
| message | string | Invalid partner_id or shopid. | Cho biết chi tiết lỗi nếu xảy ra lỗi. Rỗng nếu không có lỗi. |
| request_id | string | 6745b892295d750abf83a29430510400 | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. |
| response | object | ||
| debug_msg | string | "" | Debug message. |