Danh sách chương trình coupon
Tính năng này dùng để lấy danh sách chương trình giảm giá ở trên Nhanh.vn.
Coupon có thể được cài đặt:
Khoảng ngày được áp dụng.
Giá trị giảm giá theo %, theo tiền mặt.
Chỉ áp dụng cho hóa đơn từ bao nhiêu.
Chỉ được dùng ở cửa hàng nào.
Chỉ được giảm tối đa bao nhiêu tiền (VD giảm 15% nhưng tối đa 100K).
Coupon cũng có thể được cài đặt để chỉ được sử dụng 1 lần duy nhất hoặc được áp dụng bao nhiêu lần (canUsedTimes), bạn cần chú ý con số này để khi tặng mã Coupon cho khách hàng không nên vượt quá số lượt được sử dụng, tránh tình huống những khách hàng sau không dùng được mã coupon nữa.
Request
Xem Postman sample.
curl --location 'https://pos.open.nhanh.vn/v3.0/promotion/batch?appId={{appId}}&businessId={{businessId}}' \
--header 'Authorization: {{accessToken}}' \
--header 'Content-Type: application/json'
--data '{
"filters": {
},
"paginator": {
"size": 100
}
}'
Filters
id
int
Tìm kiếm theo ID đợt phát hành giảm giá.
couponCode
string
Tìm kiếm theo mã giảm giá.
productId
int
Tìm kiếm theo ID sản phẩm.
depotId
int
Tìm kiếm theo ID kho.
name
string
Tìm kiếm tên đợt phát hành mã giảm giá.
Response
Xem cấu trúc chung tại đây.
Failed response
Xem các mã lỗi chung tại đây.
Successful response
{
"code": 1,
"paginator": {
"next": "Dùng để lấy dữ liệu trang tiếp theo"
},
"data": [
{
"id": "(int) ID chương trình coupon",
"name": "(string) Tên chương trình coupon",
"description": "(string) Mô tả chương trình coupon",
"startDate": "(string) Ngày bắt đầu áp dụng",
"endDate": "(string) Ngày kết thúc áp dụng",
"status": "(int) Trạng thái",
"numberOfCodes": "(int) Số lượng mã giảm giá",
"codeLength": "(int) Độ dài mã giảm giá",
"prefix": "(string) Tiền tố mã giảm giá",
"suffix": "(string) Hâu tố mã giảm giá",
"valueType": "(int) Loại mã giảm giá (1: Tiền mặt, 2: Phần trăm)",
"value": "(int) Giá trị mã giảm giá",
"valueMax": "(int) Giá trị giảm giá tối đa",
"fromValue": "(int) Áp dụng cho hóa đơn có giá trị từ bao nhiêu",
"toValue": "(int) Áp dụng cho hóa đơn có giá trị đến bao nhiêu",
"notApplyWithDiscountPromotion": "(bool) Không áp dụng cùng chương trình chiết khấu (true: Có, false: Không)",
"createdBy": {
"id": "(int) ID người tạo chương trình",
"name": "(string) Người tạo chương trình"
},
"totalUsedTime": "(int) Tổng số đã sử dụng",
"totalAssign": "(int) Tổng số đã tặng"
}
]
}
Last updated