Chuyển tới nội dung chính

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

NameTypeSampleDescription
partner_idint1Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu.
timestamptimestamp1610000000Dù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_tokenstringc09222e3fc40ffb25fc947f738b1abf1Token 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_idint600000Mã đị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.
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Chữ 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

NameTypeRequiredSampleDescription
discount_idint64True1000029745Mã định danh duy nhất của chương trình giảm giá trên Shopee.
item_listobject[]TrueCá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_idint64True1776783Mã định danh duy nhất của sản phẩm trên Shopee.
item_promotion_pricefloatFalse96.0Giá khuyến mãi của sản phẩm.
model_listobject[]FalseCác phân loại hàng được chọn vào chương trình giảm giá này.
model_idint64True1776782Mã đị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_pricefloatTrue96.0Giá khuyến mãi của phân loại hàng.
purchase_limitint32False1Số lượng tối đa sản phẩm được mua với giá khuyến mãi.

Tham số Response

NameTypeSampleDescription
errorstringCho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi.
messagestringCho biết chi tiết lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi.
warningstringCho biết thông báo cảnh báo bạn cần lưu ý.
request_idstringda6b348a4a5e4162b885ecc73c85297fMã định danh của yêu cầu API để theo dõi lỗi.
responseobjectThông tin chi tiết bạn đang truy vấn.
discount_idint641000029745Mã định danh duy nhất của chương trình giảm giá trên Shopee.
countint321Số lượng sản phẩm được cập nhật thành công.
error_listobject[]Danh sách lỗi của chương trình giảm giá này.
item_idint641776783Các sản phẩm có lỗi.
model_idint641776782Các phân loại hàng có lỗi.
fail_messagestringtime errorCho biết chi tiết lỗi nếu một phần tử gặp lỗi.
fail_errorstringdiscount.error_timeCho 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 }] }