v2.discount.set_sip_discount
POST /api/v2/discount/set_sip_discount
Thiết lập Giảm giá Nước ngoài SIP cho khu vực liên kết SIP. Vui lòng sử dụng Shop ID của cửa hàng chính để gửi yêu cầu và cung cấp khu vực và tỷ lệ giảm giá của cửa hàng liên kết cần thiết lập hoặc cập nhật, API sẽ thiết lập hoặc cập nhật tỷ lệ giảm giá cho cửa hàng liên kết của khu vực đó.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/discount/set_sip_discount
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | ID đối tác đượ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ấu thời gian 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 để truy cập API, dùng để xác định quyền của bạn với API. Có thể dùng nhiều lần và hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Đị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 bởi partner_id, đường dẫn API, timestamp, access_token, shop_id và partner_key thông qua thuật toán băm HMAC-SHA256. Chi tiết hơn: 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ả |
|---|---|---|---|---|
| region | string | True | TH | Khu vực của cửa hàng liên kết SIP cần thiết lập giảm giá. |
| sip_discount_rate | int32 | True | 15 | Tỷ lệ giảm giá thị trường tổng thể sẽ áp dụng cho tất cả sản phẩm của cửa hàng liên kết SIP tại khu vực hiện tại. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Chi tiết lỗi nếu có lỗi xảy ra. Rỗng nếu không có lỗi. | |
| message | string | Loại lỗi nếu có lỗi xảy ra. Rỗng nếu không có lỗi. | |
| request_id | string | Định danh của yêu cầu API để theo dõi lỗi. | |
| response | object | ||
| region | string | TH | Khu vực của cửa hàng liên kết SIP. |
| status | string | upcoming | Trạng thái giảm giá của cửa hàng liên kết SIP tại khu vực hiện tại, có thể là upcoming/ongoing, không bao gồm giảm giá đã hết hạn. |
| sip_discount_rate | int32 | 15 | Tỷ lệ giảm giá được thiết lập cho cửa hàng liên kết SIP tại khu vực hiện tại. |
| start_time | timestamp | 1741688426 | Thời gian bắt đầu giảm giá của cửa hàng liên kết SIP tại khu vực hiện tại, tính theo giây UNIX. Lưu ý: Thời gian bắt đầu là 30 phút sau khi người bán thiết lập sip_discount_rate. |
| end_time | timestamp | 1757240426 | Thời gian kết thúc giảm giá của cửa hàng liên kết SIP tại khu vực hiện tại, tính theo giây UNIX. Lưu ý: Thời gian kết thúc là 180 ngày sau thời gian bắt đầu. |
| create_time | timestamp | 1741686627 | Thời gian tạo giảm giá của cửa hàng liên kết SIP tại khu vực hiện tại, tính theo giây UNIX. |
| update_time | timestamp | 1741686627 | Thời gian cập nhật mới nhất của giảm giá cửa hàng liên kết SIP tại khu vực hiện tại, tính theo giây UNIX. |