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

• 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

Key	Type	Description
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)",
      "isCategoryApplyOnce": "(int) 1: Áp dụng một lần nếu có sản phẩm thuộc nhiều danh mục đã chọn",
      "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"
    }
  ]
}