v2.discount.get_discount

GET /api/v2/discount/get_discount

Sử dụng API này để lấy chi tiết một 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/get_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ả
discount_id	int64	True	1000029882	Định danh duy nhất của Shopee cho một chương trình giảm giá.
page_no	int32	True	1	Chỉ định số trang dữ liệu cần trả về trong lần gọi hiện tại. Bắt đầu từ 1. Nếu dữ liệu nhiều hơn một trang, page_no có thể dùng làm điểm bắt đầu cho lần gọi tiếp theo.
page_size	int32	True	50	Mỗi kết quả được trả về theo từng trang. Dùng bộ lọc "page_size" để kiểm soát số lượng mục tối đa trả về mỗi trang và "page_no" để bắt đầu lần gọi tiếp theo. Giá trị nguyên này dùng để chỉ định số mục tối đa trả về trong một "trang" dữ liệu.

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.
status	string	ongoing	Trạng thái của chương trình giảm giá
discount_name	string	test-upload-keep	Tiêu đề của chương trình giảm giá.
item_list	object[]		Các sản phẩm được chọn trong chương trình giảm giá này.
item_id	int64	2800140208	Định danh duy nhất của Shopee cho một sản phẩm.
item_name	string	hahahahahah	Tên sản phẩm theo ngôn ngữ địa phương.
normal_stock	int32	10	Số lượng tồn kho hiện tại của sản phẩm.
item_promotion_stock	int32	12	Tồn kho dự trữ 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_original_price	float	11.1	Giá gốc trước giảm giá của sản phẩm. Nếu có phân loại, giá trị này là 0.
item_promotion_price	float	1.92	Giá khuyến mãi của sản phẩm. Nếu có phân loại, giá trị này là 0.
item_inflated_price_of_original_price	float	12.1	Giá gốc sau thuế của sản phẩm (chỉ dành cho cửa hàng chịu thuế).
item_inflated_price_of_promotion_price	float	12.0	Giá khuyến mãi sau thuế của sản phẩm (chỉ dành cho cửa hàng chịu thuế).
item_local_price	float	9.99	Giá nội địa của sản phẩm được tính theo công thức: Giá nội địa = Giá gốc CB × Tỷ lệ điều chỉnh nội địa. Phản ánh giá nội địa cuối cùng dựa trên các quy tắc điều chỉnh cấp cửa hàng và tính theo tiền tệ nội địa.
item_local_promotion_price	float	1.72	Giá khuyến mãi nội địa của sản phẩm được tính theo công thức: Giá khuyến mãi nội địa = Giá nội địa × Tỷ lệ giảm giá. Phản ánh giá khuyến mãi nội địa cuối cùng của người bán và tính theo tiền tệ nội địa.
item_local_price_inflated	float		Giá nội địa sau thuế của sản phẩm (chỉ dành cho cửa hàng chịu thuế).
item_local_promotion_price_inflated	float		Giá khuyến mãi nội địa sau thuế của sản phẩm (chỉ dành cho cửa hàng chịu thuế).
model_list	object[]		Các phân loại thuộc sản phẩm này.
model_id	int64	1755762	Định danh duy nhất của Shopee cho một phân loại sản phẩm.
model_name	string	hahahahah	Tên phân loại thuộc cùng một sản phẩm.
model_normal_stock	int32	2	Số lượng tồn kho hiện tại của phân loại.
model_promotion_stock	int32	10	Tồn kho dự trữ của phân loại.
model_original_price	float	1.90	Giá gốc trước giảm giá của phân loại.
model_promotion_price	float	1.86	Giá khuyến mãi của phân loại.
model_inflated_price_of_original_price	float	2.2	Giá gốc sau thuế của phân loại (chỉ dành cho cửa hàng chịu thuế).
model_inflated_price_of_promotion_price	float	2.1	Giá khuyến mãi sau thuế của phân loại (chỉ dành cho cửa hàng chịu thuế).
model_local_price	float	1.71	Giá nội địa của phân loại được tính theo công thức: Giá nội địa = Giá gốc CB × Tỷ lệ điều chỉnh nội địa. Phản ánh giá nội địa cuối cùng dựa trên các quy tắc điều chỉnh cấp cửa hàng và tính theo tiền tệ nội địa.
model_local_promotion_price	float	1.67	Giá khuyến mãi nội địa của phân loại được tính theo công thức: Giá khuyến mãi nội địa = Giá nội địa × Tỷ lệ giảm giá. Phản ánh giá khuyến mãi nội địa cuối cùng của người bán và tính theo tiền tệ nội địa.
model_local_price_inflated	float		Giá nội địa sau thuế của phân loại (chỉ dành cho cửa hàng chịu thuế).
model_local_promotion_price_inflated	float		Giá khuyến mãi nội địa sau thuế của phân loại (chỉ dành cho cửa hàng chịu thuế).
purchase_limit	int32	1	Số lượng tối đa sản phẩm này được mua với giá khuyến mãi.
start_time	timestamp	1604408400	Thời gian bắt đầu chương trình giảm giá.
discount_id	int64	1000029882	Định danh duy nhất của Shopee cho một chương trình giảm giá.
end_time	timestamp	1605276000	Thời gian kết thúc chương trình giảm giá.
more	boolean	false	Cho biết danh sách sản phẩm có nhiều hơn một trang hay không. Nếu giá trị này là true, bạn có thể tiếp tục kiểm tra trang tiếp theo để lấy các sản phẩm còn lại.