JTL-Vouchers Webportal — Einrichtung von der Lizenz bis zum ersten Gutschein

JTL-Vouchers einrichten: Von der Lizenz bis zum ersten Gutschein — der vollständige Ablauf

JTL-Vouchers ist das zentrale Gutschein-Modul im JTL-Ökosystem. Es verwaltet Gutscheine kanalübergreifend über ein cloudbasiertes Webportal: Ein Gutschein, der im JTL-Shop gekauft wird, lässt sich an der JTL-POS-Kasse einlösen. Klingt einfach, hat aber ein paar konkrete Einrichtungsschritte, die in der falschen Reihenfolge oder mit falsch gesetzten Berechtigungen schnell zu Problemen führen. Wir sehen das regelmäßig bei Händlern, die das Modul ohne Anleitung aktivieren.

Du hast JTL-Vouchers gebucht — und weißt jetzt nicht genau, in welcher Reihenfolge du Portal, Wawi-Verbindung und Gutscheine einrichtest?

Dieser Beitrag zeigt dir den konkreten Ablauf: von der Lizenz-Aktivierung über das Webportal bis zum ersten funktionierenden Gutschein im JTL-Shop — inklusive der Fehler die wir in der Praxis am häufigsten sehen.

Auf einen Blick

  • ✓JTL-Vouchers läuft über ein separates Webportal unter vouchers.jtl-software.com — die Einrichtung beginnt dort, nicht in JTL-Wawi. Wir richten dieses Portal als ersten Schritt gemeinsam mit der Lizenz-Aktivierung ein.
  • ✓Vor dem ersten Gutschein müssen Rollen und Rechte im Portal konfiguriert, mindestens eine Client-Gruppe und ein Client angelegt und die Verbindung zu JTL-Wawi hergestellt sein. In genau dieser Reihenfolge.
  • ✓Die häufigsten Fehlerquellen, die wir bei Vlarom E-Commerce Agentur aus mehreren Projekten kennen: fehlerhafte Steuerklassen beim Gutschein-Artikel und eine fehlende Autorisierung der Client-Verbindung. Beides lässt sich mit einem sauberen Setup vor dem Go-Live vermeiden.

Vlarom E-Commerce Agentur aus Ahrensfelde bei Berlin richtet JTL-Vouchers bei Händlern mit Cross-Channel-Vertrieb ein, also überall dort, wo Kauf und Einlösung in unterschiedlichen Kanälen stattfinden. Als JTL Service Partner Gold kennen wir die typischen Stolperstellen dieses Moduls. Die häufigste Frage, die wir nach einer Eigeninstallation bekommen: „Das Portal ist aktiv, aber Wawi zeigt nichts.“ Der Grund ist fast immer derselbe: Die Client-Verbindung wurde zwar angelegt, aber nie korrekt autorisiert. Das ist lösbar, braucht aber einen klaren Blick auf die Portal-Einstellungen.

Was JTL-Vouchers kostet und was es leistet — die wichtigsten Kennzahlen

Bevor die Einrichtung beginnt, lohnt sich eine kurze Einordnung: JTL-Vouchers ist kein kostenloses Add-on für alle JTL-Editionen. Die Lizenzkosten und das Einsatzspektrum bestimmen, ob das Modul für einen Händler-Case sinnvoll ist.

Quelle JTL-Preismodell (Stand 2026): JTL-Vouchers ist ab der Edition JTL Pro ohne Zusatzkosten enthalten. In den Editionen Start und Advanced fällt eine Zusatzgebühr von 39 Euro pro Monat an. Wer also noch in Start oder Advanced ist und Vouchers einrichten möchte, sollte vorher durchrechnen, ob der Upgrade auf JTL Pro wirtschaftlicher ist.

Diese drei Dimensionen sind für die Einrichtungsentscheidung relevant:

  • →Gutschein-Typen: Wert- und Einzweckgutscheine: JTL-Vouchers unterscheidet zwischen Wertgutscheinen (offener Betrag, einlösbar auf beliebige Produkte) und Einzweckgutscheinen (gebunden an Warengruppe, Kanal oder Zeitraum). Beide Typen werden über das Webportal angelegt und an JTL-Shop, JTL-Wawi und JTL-POS synchronisiert.
  • →Drei Kanäle — ein Guthaben-Pool: Shop, POS und Wawi greifen auf dieselbe Gutschein-Datenbank zu. Teileinlösungen sind möglich — das Restguthaben bleibt kanalübergreifend erhalten. Für Händler ohne POS reicht die Basis-Gutschein-Funktion in JTL-Shop oft aus.
  • →Digital und physisch in einem System: PDF-Gutscheine per E-Mail nach Shop-Kauf und vorgedruckte Gutscheinkarten für den stationären Verkauf nutzen denselben Code-Raum. Aktivierung, Einlösung und Restguthaben laufen zentral über das Webportal — nicht pro Kanal getrennt.

Die Faustregel: JTL-Vouchers lohnt sich ab dem Moment, wo ein Händler mehr als einen Verkaufskanal hat und Gutscheine kanalübergreifend einlösbar sein sollen. Für reine Online-Shops ohne POS ist die native Gutschein-Funktion in JTL-Shop oft ausreichend. Details dazu direkt in der JTL-Guide Dokumentation zu JTL-Vouchers.

Häufige Fehler bei der JTL-Vouchers-Einrichtung — und was dahintersteckt

Aus mehreren Vouchers-Einrichtungen sehen wir immer wieder dieselben Fehlerquellen. Keine davon ist ein Bug — alle sind Konfigurationsprobleme die sich mit der richtigen Reihenfolge vermeiden lassen.

1

Portal aktiv, Wawi zeigt keine Gutscheine

Das passiert wenn die Client-Verbindung zwischen Webportal und JTL-Wawi angelegt, aber nicht korrekt autorisiert wurde. Im Portal sieht alles korrekt aus, doch die Synchronisation findet nicht statt. Händler suchen dann zuerst in Wawi nach dem Fehler, der Fehler sitzt aber im Portal.

Lösung: Im Webportal unter den Client-Einstellungen prüfen ob der Autorisierungs-Token aktiv ist. Nach dem ersten Anlegen eines Clients muss die Verbindung explizit bestätigt werden — das übersehen viele beim ersten Setup.

2

Gutschein-Artikel mit falscher Steuerklasse

Ein Gutschein ist steuerlich ein Zahlungsmittel beim Kauf — die Mehrwertsteuer fällt erst bei der Einlösung auf die eingelöste Ware an, nicht beim Gutschein-Verkauf selbst. Wenn der Gutschein-Artikel in JTL-Wawi mit 19 % MwSt angelegt wird, wird der Gutschein-Verkauf falsch verbucht.

Lösung: Gutschein-Artikel in Wawi mit Steuerklasse 0 % beim Verkauf konfigurieren, separate Warengruppe und eigenes Buchungskonto anlegen. Das ist keine Vouchers-Fehlkonfiguration, sondern eine Artikelanlage-Entscheidung, die vor dem ersten Verkauf feststehen muss.

3

Rollen nicht gesetzt — Portal-Nutzer sehen nichts

JTL-Vouchers unterscheidet im Webportal zwischen verschiedenen Benutzerrollen — Administratoren, Händler, Filialen. Wenn Mitarbeiter ans Portal angebunden werden, aber keine Rolle zugewiesen bekommen, können diese sich einloggen, aber keine Gutscheine anlegen oder einsehen.

Lösung: Die Rollen-Konfiguration ist laut JTL der zweite offizielle Einrichtungsschritt, vor der Client-Gruppen-Anlage. Viele überspringen diesen Schritt beim ersten Testen und wundern sich dann, warum Filial-Accounts keine Berechtigungen haben.

4

Sync-Fehler: Gutschein-Wert wird falsch übertragen

Gelegentlich ist ein Gutschein über 50 Euro im Portal korrekt angelegt, wird in JTL-Shop aber mit einem anderen Wert angezeigt. Ursache ist meistens ein Währungsformat-Problem — Komma vs. Punkt als Dezimaltrennzeichen je nach System-Locale.

Lösung: Gutschein-Beträge immer ohne Tausendertrennzeichen und mit Punkt als Dezimaltrennzeichen eingeben. Nach jedem neuen Gutschein-Typ einen kurzen Testlauf im Shop durchführen und den angezeigten Wert mit dem Portalwert abgleichen.

Was JTL-Vouchers konkret bringt — zwei Praxisbeispiele

Online-Gutschein an der Ladenkasse — ohne Excel-Liste

Ein Händler (anonymisiert) mit stationärem Laden und JTL-Shop hatte vor der Vouchers-Einführung eine Excel-Liste für ausgegebene Gutscheine. Kunden kauften im Shop einen Gutschein, kamen in den Laden und das Ladenpersonal musste manuell prüfen ob der Code noch gültig war. Nach der Einrichtung entfiel diese Liste vollständig — Code scannen, Guthaben wird live aus dem Portal abgerufen, Restbetrag bleibt erhalten.

Physische Gutscheinkarten — skalierbar aktiviert

Ein anderer Händler (anonymisiert) nutzt vorgedruckte Gutscheinkarten an der Kasse. Früher wurden die Karten manuell mit Codes beschriftet und in einem Heft dokumentiert. Heute werden die Karten beim Verkauf durch Scannen des Barcodes an der JTL-POS-Kasse aktiviert — das Guthaben ist sofort im Portal sichtbar und lässt sich auch im JTL-Shop einlösen. Die Karten laufen jetzt über dasselbe System wie alle anderen Gutscheine, ohne Extra-Verwaltung.

Die Lektion

Unsere Erkenntnis aus mehreren Vouchers-Einrichtungen bei Vlarom E-Commerce Agentur: Der technische Aufwand ist überschaubar — der tatsächliche Umfang hängt von Datenbankgröße, Anzahl der Kanäle und bestehendem Setup ab. Wer die Einrichtungsschritte in der richtigen Reihenfolge durchgeht und Rollen plus Steuerklassen vor dem ersten Test konfiguriert, hat ein stabiles System. Die meisten Probleme entstehen nicht durch das Modul selbst, sondern durch das Überspringen der Voraussetzungen.

JTL-Vouchers einrichten: Die 5 Phasen in der richtigen Reihenfolge

Das Folgende ist die Einrichtungsreihenfolge die wir in der Praxis verwenden. Die offiziellen JTL-Schnellstart-Schritte sind hier zu fünf klaren Phasen zusammengefasst, ergänzt um die Fehlerquellen die wir aus eigenen Projekten kennen.

Phase 1: Lizenz aktivieren und Portal-Zugang prüfen

JTL-Vouchers wird im JTL-Kundencenter oder JTL-Store gebucht — ab Edition JTL Pro inklusive, in Start und Advanced für 39 Euro pro Monat zusätzlich. Nach der Aktivierung erscheint das Portal unter vouchers.jtl-software.com. Häufigster Fehler: Vouchers wird aktiviert ohne zu prüfen, ob die laufende Wawi-Version das Modul unterstützt. Das klärt ein kurzer Blick in die Systemanforderungen der JTL-Vouchers-Dokumentation.

Phase 2: Rollen, Rechte und Client-Struktur anlegen

Im Webportal zuerst Benutzerrollen konfigurieren (Administrator, Händler, Filiale), erst danach Client-Gruppen anlegen. Eine Client-Gruppe fasst mehrere Verkaufsstellen unter einem gemeinsamen Gutschein-Pool zusammen. Innerhalb der Gruppe dann einzelne Clients für Wawi, Shop und POS anlegen und die Verbindung autorisieren. Token-Status nach dem Anlegen immer prüfen: aktiv oder noch ausstehend.

Phase 3: Systemeinstellungen und Gutschein-Artikel in Wawi konfigurieren

Im Portal Systemeinstellungen setzen: Währung, Ablaufdaten-Logik, Restguthaben-Regeln. Parallel in JTL-Wawi den Gutschein-Artikel anlegen: Steuerklasse 0 % beim Verkauf, eigene Warengruppe, separates Buchungskonto. Das ist die Grundlage für alle späteren Gutscheine. Für physische Karten einen eigenen Artikel mit EAN-Pool anlegen.

Phase 4: Ersten Gutschein anlegen und Sync-Test durchführen

Im Webportal den ersten Testgutschein anlegen, mit einem klar erkennbaren Testwert (z.B. 1 Euro). Danach: im JTL-Shop prüfen ob der Code im Checkout akzeptiert wird, in Wawi prüfen ob der Code in der Gutschein-Übersicht sichtbar ist, und bei vorhandenem POS einen Testeinlösungsvorgang durchführen. Restguthaben nach Einlösung im Portal kontrollieren. Nur wenn alle drei Kanäle korrekt antworten, ist das Setup bereit für den Live-Betrieb.

Phase 5: Team-Schulung und Monitoring nach Go-Live

Das Ladenpersonal braucht eine kurze Einweisung: Gutschein verkaufen, Code scannen, Restguthaben prüfen, ungültigen Code behandeln. Nach dem Go-Live lohnt es sich, die Gutschein-Transaktionsliste im Portal regelmäßig zu kontrollieren, denn Inkonsistenzen zeigen sich meist in den ersten Verkaufstagen. Wir begleiten diesen Zeitraum bei Projekten aktiv mit.

Häufige Fragen zu JTL-Vouchers einrichten

Wo finde ich das JTL-Vouchers Webportal?

Das Webportal ist unter vouchers.jtl-software.com erreichbar. Der Zugang wird nach der Lizenzaktivierung im JTL-Kundencenter freigeschaltet. Falls das Portal nach der Aktivierung nicht erreichbar ist, kann es bis zu einer Stunde dauern bis die Freischaltung greift — danach lohnt sich ein Blick in die JTL-Kundencenter-Benachrichtigungen.

JTL-POS ist für JTL-Vouchers nicht erforderlich. Das Modul funktioniert auch ohne POS — zum Beispiel nur mit JTL-Wawi und JTL-Shop. POS ist ein optionaler Kanal. Die Verbindung zu weiteren JTL-Produkten wird in Phase 2 der Einrichtung konfiguriert. Wer JTL-POS nicht einsetzt, überspringt diesen Client einfach.

Der häufigste Grund ist eine fehlende oder fehlerhafte Autorisierung der Client-Verbindung im Webportal. Im Portal unter den Client-Einstellungen prüfen ob der Token-Status ‚aktiv‘ anzeigt oder noch auf Autorisierung wartet. Zweiter möglicher Grund: Die Gutschein-Synchronisation läuft nicht in Echtzeit — ein kurzes Warten und manuelles Aktualisieren der Wawi-Gutschein-Übersicht kann helfen.

Ja, über JTL-Ameise ist ein Import möglich. Der Standardweg ist ein CSV-Export aus dem Altsystem mit Code, Wert und Restguthaben, der dann per Ameise in die Gutschein-Tabelle importiert wird. Vor dem vollständigen Import unbedingt 5 bis 10 Codes testweise importieren und im Portal sowie im Shop auf korrekte Werte prüfen.

Ab der Edition JTL Pro ist JTL-Vouchers ohne Zusatzkosten enthalten. In den Editionen Start und Advanced kostet das Modul 39 Euro pro Monat. Die aktuellen Konditionen findest du direkt bei JTL — die Preise können sich ändern. Die genaue Kalkulation für ein individuelles Setup besprechen wir im Erstgespräch.

JTL-Shop ist für JTL-Vouchers kein Pflichtbestandteil. Das Modul arbeitet über eine REST-API, über die sich auch externe Systeme anbinden lassen. Wer keinen JTL-Shop einsetzt, kann Vouchers trotzdem über Wawi und POS nutzen oder ein Drittsystem per API einbinden. Die Shop-Integration ist einer von mehreren optionalen Clients.

JTL-Vouchers einrichten und kanalübergreifend nutzen — wir übernehmen das.

Vlarom E-Commerce Agentur richtet JTL-Vouchers in deinem Setup ein.

Vlarom — JTL Service Partner Gold in Ahrensfelde bei Berlin — übernimmt die komplette Vouchers-Einrichtung: von der Lizenz-Aktivierung über die Portal-Konfiguration bis zur Wawi-Verbindung und dem ersten funktionierenden Gutschein im Testlauf. Wir prüfen vorher das Wawi-Shop-POS-Setup und geben eine klare Einschätzung, ob JTL-Vouchers für den jeweiligen Fall sinnvoll ist. Ruf uns direkt an unter +49 30 91473862, schreibe an info@vlarom.de oder nutze unser Kontaktformular.