Nhanh.vn Open API
Trang chủHướng dẫn sử dụngApps
v1
v1
  • Giới thiệu
  • Get data from Nhanh.vn
    • Lấy hãng vận chuyển
    • Lấy danh sách thành phố, quận huyện
    • Tính phí vận chuyển
    • Lấy danh sách đơn hàng
    • Lấy danh sách lịch sử đơn hàng
    • Lấy danh mục sản phẩm
    • Lấy danh sách sản phẩm
    • Lấy thông tin chi tiết sản phẩm
    • Lấy danh sách quà tặng sản phẩm
    • Lấy danh sách IMEI
    • Tra cứu IMEI bán ra theo ngày
    • Lấy danh sách khách hàng
    • Lấy danh mục tin tức
    • Lấy danh sách tin tức
    • Lấy danh sách nhà cung cấp
    • Lấy danh sách phiếu xuất nhập kho
    • Lấy danh sách sản phẩm xuất nhập kho
    • Lấy danh sách sản phẩm xuất nhập kho nháp
    • Lấy danh sách kho doanh nghiệp
    • Lấy danh sách coupon
    • Lấy danh sách nhân viên
    • Lấy danh sách bảo hành
    • Nhúng khung đặt hàng Nhanh
    • Tích hợp-elastix
  • Send data to Nhanh.vn
    • Tạo gian hàng
    • Thêm sản phẩm
    • Thêm đơn hàng
    • Cập nhật đơn hàng
    • Gửi khiếu nại đơn hàng
    • Thêm khách hàng
    • Cấu hình webhooks
  • Listen webhooks from Nhanh.vn
    • Nhận cập nhật trạng thái đơn hàng
    • Nhận cập nhật sản phẩm
    • Nhận cập nhật tồn kho
    • Nhận cập nhật thay đổi cấp độ, thêm điểm, trừ điểm
    • Nhận cập nhật hóa đơn mới
    • Nhận cập nhật khiếu nại
Powered by GitBook
On this page
  • Lấy danh sách chương trình Coupon
  • Request
  • Response
  • Lấy danh sách coupon code
  • Request
  • Response
  • Lấy thông tin coupon code
  • Request
  • Response
  • Tặng mã coupon
  • Request
  • Response
  • Sử dụng mã coupon
  • Request
  • Response

Was this helpful?

  1. Get data from Nhanh.vn

Lấy danh sách coupon

PreviousLấy danh sách kho doanh nghiệpNextLấy danh sách nhân viên

Last updated 1 year ago

Was this helpful?

  • 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.

Lấy danh sách chương trình Coupon

  • /api/promotion/coupon?act=list

Request

  • See

  • Cấu trúc data đẩy lên

    data = [
      page: int, //page load
      id: int // lọc ID đợt phát hành coupon
      couponCode: string // lọc theo mã coupon,
      productStoreId: int // Lọc theo ID sản phẩm
      depotId: int // Lọc theo ID kho
      name: string // Lọc theo tên đợt phát hành coupon
    ]

Response

Key
Type
Description

code

int

1 = success or 0 = failed

messages

array

is an array of error messages if code = 0

data

array

is an array of coupons

[
    {
        'totalPages': int //tổng số page
        'page': int // page hiện tại
        'result': [ // Kết quả trả về
            // coupon 1
            [
                'id': int //id coupon
                'depotIds': array // mảng ID kho được áp dụng
                'name': string // Tiêu đề coupon
                'categories': string // Danh mục
                'description': string // Mô tả,
                'startDate': string // Ngày bắt đầu
                'endDate': string // Ngày kết thúc
                'fromValue':  int // Chỉ được áp dụng cho hóa đơn có giá trị từ fromValue
                'numberOfCodes':  int // Số coupon
                'canUsedTimes': int // Số lần có thể sử dụng
                'usedTimes':  int // Số lần đã sử dụng
                'assignedTimes':  int // Số lần đã tặng
                'valueType': Kiểu giảm giá 1 = tiền mặt, 2= %
                'value':  float // Giá trị coupon
                'valueMax':  float // Giá trị tối đa (VD Coupon giảm 15% nhưng tối đa chỉ được 100K)
                'status':  int // Trạng thái 1 = Active, 2 = Inactive
                'createdDatetime':  string // Ngày tạo
            ]
            // coupon 2
        ]
}

Lấy danh sách coupon code

  • /api/promotion/coupon?act=codes: Tính năng này được sử dụng để lấy danh sách mã coupon

Request

  • Cấu trúc data đẩy lên

data = [
  page: int, //page load
  batchId: int // ID đợt phát hành coupon (bắt buộc)
]

Response

Key
Type
Description

code

int

1 = success or 0 = failed

messages

array

is an array of error messages if code = 0

data

array

is an array of coupon code

[
    {
        'totalPages': int //tổng số page
        'page': int // page hiện tại
        'result': [ // Kết quả trả về
            // couponCode 1
            [
                'code': string // Mã coupon
                'value': int // Giá trị coupon
                'valueType': int // Kiểu áp dụng (1 = Tiền mặt, 2 = %)
                'valueMax': int // Giá trị giảm giá tối đa (VD được giảm 15% nhưng tối đa 100K)
                'canUsedTimes': int // Số lần còn có thể dùng
                'usedTimes': int // Số lần đã dùng
                'assignedTimes': int // Số lần đã tặng
                'status' : int // Trạng thái (1 - Mới, 2 - Đã sử dụng, 3 - Đã bị hủy, 4 - Đã tặng)
             ]
             // couponCode 2
             ...
         ]
}

Lấy thông tin coupon code

  • /api/promotion/coupon?act=check: Tính năng này được sử dụng để lấy chi tiết mã coupon(khoảng ngày, điều kiện được áp dụng, sản phẩm được áp dụng)

Request

  • Cấu trúc data đẩy lên

    data = [
      couponCode: string // Mã coupon,
    ]

Response

Key
Type
Description

code

int

1 = success or 0 = failed

messages

array

is an array of error messages if code = 0

data

array

is an array of coupon

[
    {
        'result': [ // Kết quả trả về
            // coupon
            [
                'batchId': int // ID đợt phát hành coupon
                'batchName': string // Tên đợt phát hành coupon
                'depotIds': array // Mảng ID kho được áp dụng
                'categoryIds' : array // Mảng ID danh mục
                'fromValue' : int // Giá trị áp dụng
                'canUsedTimes': int // Số lần có thể sử dụng coupon
                'usedTimes': int // Số lần đã sử dụng coupon
                'code': string // Mã coupon
                'value': string // Giá trị
                'valueMax': string // Giá trị tối đa
                'startDate': string // Ngày bắt đầu,
                'endDate': string // Ngày kết thúc
                'description': string // Mô tả
                'products': array // Mảng danh sách sản phẩm được áp dụng
            ]
        ]
}

Tặng mã coupon

  • /api/promotion/coupon?act=giveaway: Tính năng này được sử dụng để bạn tặng mã coupon cho khách hàng xong, thì cần báo để server cập nhật lại số lần đã tặng, tránh việc 1 mã được tặng nhiều lần và khách khác không thể sử dụng được nữa.

Request

  • Cấu trúc data đẩy lên

    data = [
      couponCode: string // Mã coupon,
    ]

Response

Key
Type
Description

code

int

1 = success or 0 = failed

messages

array

is an array of error messages if code = 0

[
    {
        'result': [ // Kết quả trả về
            'code' : 1
        ]
}

Sử dụng mã coupon

  • /api/promotion/coupon?act=use: Tính năng này được sử dụng để thông báo cho server biết 1 mã coupon đã được sử dụng, tránh việc 1 mã được sử dụng nhiều lần.

Request

  • Cấu trúc data đẩy lên

 data = [
   couponCode: string // Mã coupon
 ]

Response

Key
Type
Description

code

int

1 = success or 0 = failed

messages

array

is an array of error messages if code = 0

[
    {
        'result': [ // Kết quả trả về
            'code' : 1 // đã cập nhật thành công
        ]
}

See

See

See

See

common request params
common request params
common request params
common request params
common request params