v2.discount.update_discount_item
POST /api/v2/discount/update_discount_item
Sử dụng API này để cập nhật các sản phẩm trong chương trình khuyến mãi giảm giá.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/discount/update_discount_item
Tham số chung
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi 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 mọi 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 truy cập của bạn. Có thể sử 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 cửa hàng trên Shopee. 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 thông 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 |
|---|---|---|---|---|
| discount_id | int64 | True | 1000029745 | Mã định danh duy nhất của chương trình giảm giá trên Shopee. |
| item_list | object[] | True | Các sản phẩm được chọn vào chương trình giảm giá này. Bạn có thể cập nhật tối đa 50 sản phẩm mỗi lần gọi. | |
| item_id | int64 | True | 1776783 | Mã định danh duy nhất của sản phẩm trên Shopee. |
| item_promotion_price | float | False | 96.0 | Giá khuyến mãi của sản phẩm. |
| model_list | object[] | False | Các phân loại hàng được chọn vào chương trình giảm giá này. | |
| model_id | int64 | True | 1776782 | Mã định danh duy nhất của phân loại hàng trên Shopee. Nếu sản phẩm không có phân loại, không cần nhập tham số này. Mặc định là 0. |
| model_promotion_price | float | True | 96.0 | Giá khuyến mãi của phân loại hàng. |
| purchase_limit | int32 | False | 1 | Số lượng tối đa sản phẩm được mua với giá khuyến mãi. |
Tham số Response
| Name | Type | Sample | Description |
|---|---|---|---|
| error | string | Cho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. | |
| message | string | Cho biết chi tiết lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. | |
| warning | string | Cho biết thông báo cảnh báo bạn cần lưu ý. | |
| request_id | string | da6b348a4a5e4162b885ecc73c85297f | Mã định danh của yêu cầu API để theo dõi lỗi. |
| response | object | Thông tin chi tiết bạn đang truy vấn. | |
| discount_id | int64 | 1000029745 | Mã định danh duy nhất của chương trình giảm giá trên Shopee. |
| count | int32 | 1 | Số lượng sản phẩm được cập nhật thành công. |
| error_list | object[] | Danh sách lỗi của chương trình giảm giá này. | |
| item_id | int64 | 1776783 | Các sản phẩm có lỗi. |
| model_id | int64 | 1776782 | Các phân loại hàng có lỗi. |
| fail_message | string | time error | Cho biết chi tiết lỗi nếu một phần tử gặp lỗi. |
| fail_error | string | discount.error_time | Cho biết loại lỗi nếu một phần tử gặp lỗi. |
] }, { "item_id": 1778783, "purchase_limit": 2, "item_promotion_price": 11 }] }