Overview

This node interacts with the KiotViet API to manage vouchers and promotional campaigns. Specifically, for the operation 'Lấy Voucher Theo ID' (Get Voucher By ID), it retrieves detailed information about a voucher using its unique ID. This is useful in scenarios where you need to fetch specific voucher details for validation, reporting, or further processing within an automation workflow.

Use Case Examples

1. Retrieve voucher details by providing the voucher ID to verify its status and discount value before applying it to a customer's order.
2. Fetch voucher information to display in a customer service dashboard for support agents.

Properties

Output

JSON

• voucherId - The unique ID of the voucher.
• voucherCode - The code associated with the voucher.
• name - The name or title of the voucher.
• description - Description of the voucher.
• discountType - Type of discount (e.g., fixed amount or percentage).
• discountValue - Value of the discount.
• status - Current status of the voucher.
• startDate - Start date of the voucher validity.
• endDate - End date of the voucher validity.
• quantity - Number of vouchers issued or available.

Dependencies

• KiotViet API key credential required for authentication.

Troubleshooting

• Ensure the voucher ID provided is valid and exists in the KiotViet system to avoid 'not found' errors.
• Check API credentials and network connectivity if the node fails to connect to the KiotViet API.
• If the node throws an error about missing parameters, verify that the 'ID Voucher' field is correctly set and passed.

Links

• KiotViet API Documentation - Official API documentation for KiotViet, useful for understanding voucher and campaign endpoints.