Danh sách mã coupon

• Tính năng này dùng để lấy danh sách mã coupon ở trên Nhanh.vn.

• Coupon là các mã giảm giá ngẫu nhiên do shop tạo ra trên hệ thống của Nhanh.vn, shop có thể tạo nhiều chương trình coupon, mỗi chương trình có nhiều mã coupon. Mã coupon là duy nhất (unique không trùng nhau) trên toàn bộ các chương trình coupon.

• Coupon được đùng để tặng cho khách hàng, khi khách mua hàng, có thể đọc mã cho thu ngân, hoặc điền mã coupon trên các form đặt hàng trên website / app để được áp dụng giảm giá.

• 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 common request params.

• Xem Postman sample.

curl --location 'https://pos.open.nhanh.vn/v3.0/promotion/couponcode?appId={{appId}}&businessId={{businessId}}' \
--header 'Authorization: {{accessToken}}' \
--header 'Content-Type: application/json'
--data '{
    "filters": {
        "batchId": 27642
    },
    "paginator": {
        "size": 100
    }
}'

Filters

Key	Type	Description
batchId	int $^{{\color{red}*}}$	ID chương trình coupon
code	string	Mã coupone cần tìm

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": [
    {
      "depotId": "(int) ID kho hàng",
      "code": "(string) Mã giảm giá",
      "value": "(int) Giá trị",
      "valueMax": "(int) Giá trị tối đa được giảm",
      "valueType": "(int) Loại giảm giá (1= Tiền mặt, 2= Phần trăm)",
      "status": "(int) trạng thái (1 = Active, 2 = Inactive)",
      "usedAt": "(int) Thời gian đã sử dụng mã giảm giá",
      "totalCanUsed": "(int) Tổng số lần có thể sử dụng",
      "totalAssigned": "(int) Tổng số lần đã tặng",
      "totalUsed": "(int) Tổng số lần đã sử dụng",
      "createdAt": "(int) Thời gian tạo"
    }
  ]
}