Voucher KiotViet icon

Voucher KiotViet

Quản lý voucher và chiến dịch khuyến mãi từ KiotViet

Actions8

Lấy Danh Sách Voucher

AI-generated

Overview

This node interacts with the KiotViet API to manage vouchers and promotional campaigns. Specifically, for the operation 'Lấy Danh Sách Voucher' (Get All Vouchers), it retrieves a list of vouchers from KiotViet, supporting filtering and pagination. This is useful for scenarios where users want to fetch voucher data for reporting, analysis, or further automation in workflows, such as retrieving all active vouchers or filtering vouchers by campaign ID or status.

Use Case Examples

  1. Fetch all vouchers without limit to get a complete list for analysis.
  2. Retrieve a limited number of vouchers filtered by campaign ID and status to monitor active promotions.

Properties

Name Meaning
Lấy Toàn Bộ Determines whether to fetch all vouchers or limit the number of results.
Giới Hạn Specifies the maximum number of voucher results to return when not fetching all.
Bộ Lọc Filters to narrow down the voucher list based on campaign ID, keyword, status, and date range.

Output

JSON

  • voucherId - Unique identifier of the voucher.
  • voucherCode - Code of the voucher.
  • status - Current status of the voucher.
  • campaignId - Identifier of the campaign the voucher belongs to.
  • startDate - Start date of the voucher validity.
  • endDate - End date of the voucher validity.
  • discountType - Type of discount applied by the voucher (fixed amount or percentage).
  • discountValue - Value of the discount.
  • quantity - Number of vouchers issued.
  • isAutoGenerate - Indicates if the voucher codes are auto-generated.
  • isUnlimited - Indicates if the voucher quantity is unlimited.

Dependencies

  • KiotViet API with API key credential

Troubleshooting

  • Ensure the API credentials are correctly configured to avoid authentication errors.
  • If no vouchers are returned, check the filter criteria and date ranges for correctness.
  • Handle API rate limits by enabling 'Continue On Fail' to avoid workflow interruptions.

Links

Discussion