v2.discount.add_discount_item
POST /api/v2/discount/add_discount_item
Sử dụng API này để thêm sản phẩm vào chương trình giảm giá của cửa hàng.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/discount/add_discount_item
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ả |
|---|---|---|---|---|
| discount_id | int64 | True | 665123666665499 | Định danh duy nhất của Shopee cho một chương trình giảm giá. |
| item_list | object[] | True | Các sản phẩm được thêm vào chương trình giảm giá này. | |
| item_id | int64 | True | 1776783 | Định danh duy nhất của Shopee cho một sản phẩm. |
| item_promotion_price | float | False | 11.0 | Giá khuyến mãi của sản phẩm. Nếu sản phẩm không có phân loại, tham số này là bắt buộc. |
| item_promotion_stock | int32 | False | 22 | Tồn kho dự trữ của sản phẩm. |
| model_list | object[] | False | Các phân loại thuộc sản phẩm này. | |
| model_id | int64 | True | 1776782 | Định danh duy nhất của Shopee cho một phân loại sản phẩm. 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 | 11.0 | Giá khuyến mãi của sản phẩm. |
| model_promotion_stock | int32 | False | 22 | Tồn kho dự trữ của phân loại, mặc định là không giới hạn và không thể cập nhật. Để chỉnh sửa tồn kho khuyến mãi, cần xóa giảm giá hiện tại và thêm lại. |
| purchase_limit | int32 | True | 2 | Số lượng tối đa sản phẩm này được mua với giá khuyến mãi. Nếu không giới hạn, nhập 0 cho tham số này. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Loại lỗi nếu có lỗi xảy ra. Rỗng nếu không có lỗi. | |
| message | string | Chi tiết lỗi nếu có lỗi xảy ra. Rỗng nếu không có lỗi. | |
| request_id | string | da6b348a4a5e4162b885ecc73c85297f | Đị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 | 665123666665499 | Định danh duy nhất của Shopee cho một chương trình giảm giá. |
| count | int32 | 1 | Số lượng sản phẩm được thêm thành công. |
| error_list | object[] | Chi tiết thông tin lỗi. | |
| item_id | int64 | 1776783 | Định danh duy nhất của Shopee cho một sản phẩm. |
| model_id | int64 | 1776782 | Định danh duy nhất của Shopee cho một phân loại sản phẩm. 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. |
| fail_message | string | time error | Chi tiết lỗi nếu một phần tử gặp lỗi. |
| fail_error | string | discount.error_time | Loại lỗi nếu một phần tử gặp lỗi. |
] }, { "item_id": 100862614, "purchase_limit": 2, "model_list": [ { "model_id": 10000153738, "model_promotion_price": 460, "model_promotion_price": 200 } ] } ] }