Vouchers

eesy Manager supports the sale and redemption of vouchers, tax-compliant with TSE security.

Voucher Types

Single-Purpose Voucher

• Usage: For a specific product or product category
• VAT: Calculated when the voucher is sold
• Example: "Voucher for 1 pizza"

Multi-Purpose Voucher

• Usage: Freely redeemable for any products
• VAT: Calculated only upon redemption (0% at sale)
• Example: "$50 value voucher"

Tax Treatment

The distinction is tax-relevant. Single-purpose vouchers are taxed at sale, multi-purpose vouchers only at redemption.

Voucher Lifecycle

1. Generate → 2. Print → 3. Sell → 4. Redeem
   (inactive)              (active)   (redeemed)

1. Generate Vouchers

Create Voucher Product

1. Go to Admin Panel → Products
2. Create a new product
3. Select as Product Type:
   • Single-Purpose Voucher or
   • Multi-Purpose Voucher
4. Set the price
5. Important: For multi-purpose vouchers, VAT must be set to 0%
6. Save the product

Generate Voucher Codes

1. Open the voucher product in Admin Panel → Products
2. In the Voucher Management section, tap Generate Voucher Batch
3. Configure the batch:
   • Count: 1–100 vouchers
   • Expiration Date: Optional (0–3650 days)
   • Description: Optional (e.g., "Christmas 2024")
   • QR Resolution: Low (512px), Medium (1024px), High (2048px)
4. Tap Generate

Codes have the format: XXXX-XXXX-XXXX-XXXX (16 characters, alphanumeric)

Print Vouchers

After generation:

1. QR codes are downloaded as a ZIP file
2. Extract the ZIP file
3. Each voucher is a separate PNG file: CODE_VALUE_CURRENCY.png
4. Print the vouchers yourself or have them professionally printed

Filename example: ABCD-1234-5678-9012_10.00EUR.png

2. Sell Vouchers

Sales Process

When a customer wants to buy a voucher:

1. Go to the Orders page
2. Add the voucher product to the order
3. Important: Scan or enter the voucher code
   • Tap the voucher code input field
   • Scan the voucher's QR code OR
   • Enter the code manually: XXXX-XXXX-XXXX-XXXX
4. The code is assigned to the order
5. Process the order (Checkout)

Code Must Be Assigned

When selling a voucher, a generated code must be assigned. Without a code, the voucher cannot be redeemed later.

Status After Sale

After successful checkout:

• The voucher status changes from inactive to active
• The voucher can now be redeemed by the customer
• Activation date and user are recorded

3. Redeem Vouchers

Redemption During Billing

When a customer wants to pay with a voucher:

1. Open Billing
2. Add ordered products to the bill
3. Go to Checkout
4. In the Redeemed Vouchers section:
   • Tap Scan Voucher
   • Scan the voucher's QR code OR
   • Enter the code manually

Validation

The system automatically checks:

• Status: Voucher must be active (sold but not yet redeemed)
• Expiration Date: Voucher must not be expired
• Validity: Code must be in the correct format

Error Messages:

Message	Cause
"Voucher has not been activated yet"	Voucher has not been sold
"Voucher has already been redeemed"	Voucher has already been used
"Voucher has expired"	Expiration date exceeded
"Invalid voucher code format"	Code not in format XXXX-XXXX-XXXX-XXXX

Checkout with Voucher

1. The voucher value is displayed in the Redeemed Vouchers section
2. The value is automatically deducted from the total
3. During billing:
   • The voucher status changes from active to redeemed
   • The voucher cannot be used again

Multiple Vouchers

You can redeem multiple vouchers in one transaction:

1. Scan the first voucher
2. Scan additional vouchers
3. All values are added and deducted from the total

Remove Voucher

If a voucher was scanned by mistake:

1. Find the voucher in the Redeemed Vouchers section
2. Tap the Delete icon
3. The voucher is removed and remains active

Voucher Status

Status	Meaning
Inactive	Generated but not yet sold
Active	Sold, can be redeemed
Redeemed	Has been used
Expired	Expiration date exceeded
Cancelled	Manually deactivated

Best Practices

For Admins

• Batch Generation: Generate vouchers in batches (e.g., 50 for Christmas)
• Add Description: Use description for organization (e.g., "Valentine's Day 2024")
• Set Expiration: Prevents old vouchers from being redeemed years later
• Safe Storage: Store unsold vouchers securely

For Servers

• Always Assign Code: Always scan/enter a code when selling
• Check Voucher: Visually inspect voucher before redemption (not damaged)
• Inform Customer: Tell customer about expiration date

Tips

• Use QR Codes: Faster than manual entry
• Quality Vouchers: Have vouchers professionally printed for higher perceived value
• Expiration Date: 1–2 years is common
• Avoid Duplicates: Each code can only be sold and redeemed once