Voucher Management
Overview
Voucher Management is the earlier build of the voucher applet: vouchers, the tickets (serial numbers) under them, and the scanned-event log — three menus, with the rules, treatments, images and serials each reached through their own route. It writes the same coupon tables and calls the same coupon endpoints as the Voucher Management Applet V2 build, which is where the fields, rules, treatments, ticket statuses, backend behaviour and troubleshooting are documented. This page records only what is different.
VoucherManagementApplet “Voucher Management” (created 2021-07-29) and voucherManagementAppletV2 “Voucher Management Applet V2” (created 2024-03-22) are both ACTIVE and both point their documentation at the V2 page. This build lives in blg-applet-akaun-platform-voucher-management-applet — a one-commit split from the monorepo on 2025-11-18 — at route applets/tnt/wavelet/voucher-management-applet; its appletName is “Voucher Management Applet”. The same repository also holds a snapshot of the V2 project as it was at the split. Each row installs its own build: VoucherManagementApplet points at bigledger/akaun-platform/voucher-management-applet/production/voucher-management-applet-elements.js, the file this repository’s build script writes (micro-fe/elements-build-scripts/akaun-platform/voucher-management-applet-elements-build.js L13); the V2 row points at bigledger/akaun-platform/voucher-management-applet-v2/production/voucher-management-applet-v2-elements.js (es_module_url, queried 2026-09-15).Where it fits
As the V2 page: upstream Doc Item Maintenance (COUPON items) and Membership Admin (member classes and labels for rules); downstream POS General (voucher and coupon settlement) and CP Commerce Admin (website links).
Screens and menus
Route root: applets/tnt/wavelet/voucher-management-applet/. Sidebar: Voucher (voucher-listing), Ticket (ticket-listing), Scanned Event (ticket-scanned-listing). The shell menu of this build also lists a Scheduler entry that points at the applet’s error-page route and a Job Processor page.
| Area | Routes | What differs from V2 |
|---|---|---|
| Voucher | voucher-listing, voucher-create, voucher-edit | Same voucher header; rules, images, serials and treatments are separate routes rather than tabs |
| Rules | rule-add / rule-edit, event-rule-add, redemption-rule-add, entity-type-rule-add, and listing / add / edit routes for entity, member, member-class, member-label, branch, delivery-region, company, item, category and regex rules | Individual Entity and Member rules exist here; V2’s Doc Hdr list has neither |
| Images, serials | image-add / image-edit, serial-create / serial-edit | Separate screens |
| Treatments | treatment-listing, treatment-add, treatment-invoice-level, treatment-item-level, treatment-item-add, treatment-edit | Invoice-level and item-level treatments as screens (V2: For All and Product sub-tabs) |
| Ticket | ticket-listing, ticket-edit | No ticket create route |
| Scanned Event | ticket-scanned-listing, ticket-scanned-edit, ticket-scanned-edit-attachment | Same content |
| Other | job-processor, error-page | V2 has neither |
| Settings | settings/field-settings, feature-visibility, permission-set / user / team / role listings | Menu label “Application Settings” |
| Personalization | personal-default-selection, sidebar | Same |
Not in this build: Recurring Voucher, Import Tickets, Webhook settings, Print, Daily Limit, the PRODUCT voucher type, and the Default Selection settings screen — the settings menu lists a Default Selection entry, but no default-selection route is defined, so the entry leads to the applet’s 404 page.
No screenshots: the images captured for this applet were taken on the V2 build and are quarantined (see the V2 page).
Configuration
Before you can use it
As the V2 page.
Applet settings
Application Settings (settings/field-settings) renders three toggles: ENABLE_MULTIPLE_TICKET, HIDE_VOUCHER_TYPE_REWARD, HIDE_VOUCHER_TYPE_DISCOUNT — the same keys, same effects, as documented on the V2 page. ENABLE_EDIT_VOUCHER_CODE is not offered here. There is no Default Selection screen, so no DEFAULT_TIMEZONE or tab-order setting; Personalization → Default Selection is per user.
Document behaviour settings
Not applicable — master data.
Feature visibility / permissions
The same coupon API permissions (TNT_LOG_COUPON_*, TNT_API_COUPON_*) as the V2 page; no route guards. No client-side permission definitions are registered for this applet (0 rows in bl_applet_client_side_perm_dfn for VoucherManagementApplet, queried 2026-09-15).
Fields
Voucher, treatment, rule and ticket fields are the V2 page’s, minus Daily Limit and the PRODUCT type. The rule set is wider by two Doc Hdr kinds — Entity and Member — each with its own listing, add and edit route.
Lifecycle and effects
Identical to the V2 page: master data, no document type, no journal posting; tickets are four independent status flags; redemption is recorded against the sales document line by the coupon redemption step; expiry is an endpoint, not a scheduled job.
Related applets
- Voucher Management Applet V2 — the current build and the full reference.
- POS General — redeems the tickets.
- Membership Admin — member classes and labels used by rules.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| Settings → Default Selection opens a 404 page | The menu entry exists; the route does not | Use the V2 build, or set defaults per user under Personalization |
| Scheduler menu entry opens an error page | The shell menu points at error-page | Schedule coupon processors from the Scheduler applet |
| No Recurring Voucher, Import Tickets or Daily Limit | Not in this build | Install the V2 build |
Everything else: see the V2 page.