Vouchers and Coupons

Vouchers and coupons are electronic coupons with a unique code. They are managed in the More > Vouchers and Coupons section.

Vouchers and Coupons screen

At the top of the screen there is a toolbar with controls:

• New — button for creating a new voucher/coupon (requires the voucher management permission)
• Type filter — toggle chips: All / Gift voucher / Deposit / Discount coupon
• Magnifier icon — shows/hides the search field (searches the code and the note)
• Sort icon — toggles the sort direction (ascending/descending by creation date)

Below the toolbar there is a table with the columns: Code, Filter, Value, Status, Created, Valid until, Used, Note.

At the bottom of the screen there is a filter bar by status:

• Active (green, default) — valid, not yet redeemed vouchers
• Redeemed (gray) — already used vouchers
• Expired (red) — vouchers past their validity date
• Canceled (pink) — manually invalidated vouchers

You can have multiple status filters active at the same time.

In compact mode, a list of cards is shown instead of the table. Each card shows the voucher code and value (in CZK or %) on the first line, and the type, validity date, and status on the second line. The type and status filters are scrollable horizontally. Sorting is not available in compact mode.

Voucher types

Gift voucher

A gift voucher works as a gift certificate with a specific value in CZK. The customer purchases it and later redeems it at payment.

When creating a gift voucher, you enter the value in CZK using the numpad. The button at the bottom is "Sell voucher" — a tab is created to sell the voucher and the payment dialog opens. After payment, the voucher is activated.

Deposit

A deposit voucher works as prepaid credit. You enter an amount in CZK, and it is created via "Sell voucher" just like a gift voucher.

Discount coupon

A discount coupon provides a discount (percentage or absolute). When you select the "Discount coupon" type, additional settings appear in the dialog:

• Discount scope: Whole tab / Product / Category — defines the set of items to choose from
• Max. uses: the number of item units the discount applies to (default 1), adjustable with the − and + buttons
• On the numpad, a % button is shown in place of the decimal point to switch between CZK and %

The button at the bottom is "Create voucher" (without payment — a discount voucher is not sold).

How a percentage discount works: A coupon with a percentage discount is always applied to a specific number of units (per "Max. uses") of the most expensive items within the given scope. With the default setting (Max. uses = 1), the discount is applied to 1 unit of the most expensive item. The "Whole tab" scope means that any item on the tab is a candidate; "Category" limits candidates to items from the given category; "Product" to a specific product. An absolute discount (in CZK) is deducted from the total amount of the covered items.

Voucher creation dialog

The "New voucher" dialog contains:

• Type selection — chips: Gift voucher / Deposit / Discount coupon
• Discount scope (discount coupons only) — chips: Whole tab / Product / Category. When you select Product or Category, a search dialog opens for choosing a specific item.
• Value — a field showing the entered amount (or percentage for the discount type) with a numpad below it
• Max. uses (discount coupons only) — a row with − and + buttons for setting the number of repeated uses
• Note — a "Note" button that opens a dialog for entering text when clicked. When a note is filled in, it is shown as text with an edit icon.
• Valid until — the expiration date (default one year ahead from today's date), with a × button to clear the date
• Buttons at the bottom: Cancel / Sell (for gift and deposit vouchers — creates a tab and opens payment) or New (for a discount coupon — creates the voucher directly without payment)

For the discount type, a % button is shown on the numpad in place of the decimal point to switch between CZK and %.

The system automatically generates a unique code for each voucher.

Voucher detail

Clicking a voucher in the table opens the detail with the voucher code in the header. The dialog shows information in clear key–value rows:

• Filter — the voucher type (Gift / Deposit / Discount)
• Status — the current status of the voucher
• Value — the amount or percentage
• Discount — the discount scope and target item (discount type only)
• Max. uses — the maximum number of uses (discount type only)
• Used — the number of uses out of the maximum (e.g. "1/3")
• Valid until — the expiration date
• Redeemed — the redemption date (shown only if the voucher has been redeemed)
• Created — the creation date and time
• Created by — the name of the user who created the voucher
• Note — optional text

In the dialog header there is a Print button (printer icon) — it prints the voucher to a thermal printer. Available only for active, non-expired vouchers.

At the bottom of the dialog there is a Cancel voucher button — it invalidates the voucher (a destructive action, requires confirmation). It is shown only for active vouchers.

Redeeming a voucher

A voucher is redeemed while working with a tab. On the sales screen, the toolbar has a Voucher button. After clicking it, a dialog opens for entering the voucher code. The system verifies validity (it exists, is not expired, is not depleted) and applies the corresponding discount or credit.

For managers and administrators

Module requirements

The Vouchers and Coupons section is visible in the menu only if at least one of these modules is enabled in Settings > System > Modules:

• Sales vouchers (moduleVouchersSales) — allows creating and redeeming gift and deposit vouchers
• Discount vouchers (moduleVouchersDiscount) — allows creating and redeeming discount vouchers

If only one module is enabled, only the corresponding types are shown in the voucher creation dialog. Paying with a voucher in the payment dialog requires the Sales vouchers module.

Voucher permissions

The "New" button on the Vouchers and Coupons screen is shown only to users with the vouchers.manage permission. The "Cancel voucher" button in the voucher detail also requires vouchers.manage.

To redeem a voucher as a payment method in the payment dialog, the vouchers.redeem permission is required (and the voucher method must be enabled in the register settings).