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 Chiến Dịch

AI-generated

Overview

This node operation retrieves a list of voucher campaigns from the KiotViet system. It supports fetching either all campaigns or a limited number based on user input, with optional filters such as keyword search, campaign status, and date range. This is useful for users who want to manage or analyze their promotional campaigns by obtaining detailed campaign data from KiotViet.

Use Case Examples

  1. A marketing manager wants to get all active voucher campaigns to review their performance.
  2. A user wants to fetch only the first 20 campaigns created in the last month for reporting purposes.

Properties

Name Meaning
Lấy Toàn Bộ Determines whether to retrieve all campaigns or limit the number of results.
Giới Hạn Specifies the maximum number of campaign results to return when 'Lấy Toàn Bộ' is false.
Bộ Lọc Chiến Dịch Filters to narrow down the list of campaigns based on keyword, status, and date range.

Output

JSON

  • id - Unique identifier of the campaign.
  • code - Campaign code.
  • name - Name of the campaign.
  • startDate - Start date of the campaign.
  • endDate - End date of the campaign.
  • status - Current status of the campaign.
  • description - Description of the campaign.
  • branchIds - List of branch IDs where the campaign is applicable.
  • customerGroupIds - List of customer group IDs applicable for the campaign.
  • discountType - Type of discount applied in the campaign (fixed amount or percentage).
  • discountValue - Value of the discount.
  • quantity - Number of vouchers issued in the campaign.
  • isAutoGenerate - Indicates if voucher codes are auto-generated.
  • isUnlimited - Indicates if the campaign has unlimited voucher quantity.

Dependencies

  • KiotViet API with authentication credentials

Troubleshooting

  • Ensure the API credentials are correctly configured to avoid authentication errors.
  • If no campaigns are returned, verify the filter criteria and date ranges are correct.
  • Handle API rate limits or network issues that might cause request failures.

Links

Discussion