JTL-POS Kassenbildschirm mit Gutschein-Eingabefeld, daneben JTL-Vouchers Portal mit Restwert-Anzeige

JTL-Vouchers an JTL-POS anbinden: Gutschein-Scan, Teileinlösung und die häufigsten Fehler aus der Praxis

JTL-Vouchers ist die zentrale Gutscheinlösung von JTL — ein Code, ein Guthaben, einlösbar in JTL-Shop, JTL-POS und JTL-Wawi gleichzeitig. Für stationäre Händler ist die Anbindung an JTL-POS oft der Punkt, an dem Online- und Offline-Welt sauber zusammenwachsen: Ein Kunde kauft den Gutschein im Webshop und löst ihn an der Kasse ein. Ohne manuelle Listen, ohne Zettelwirtschaft. Technisch läuft das über eine PIN-basierte Verbindung zwischen JTL-Vouchers und JTL-POS, eine eigens angelegte Zahlungsart „Gutschein“ und einen sauberen Abgleich der Client-Gruppen. Klingt einfach, hat aber Stolperstellen: alte JTL-POS-Versionen unter 1.0.5.19, abgelaufene PINs, fehlende Zahlungsart oder Gutschein-Seriennummern, die nach einer Änderung in Vouchers nicht automatisch zur Kasse durchschlagen.

Du willst Gutscheine an der Kasse scannen und bei Teileinlösung den Restwert verwalten?

Hier ist der echte Ablauf so wie wir bei der Vlarom E-Commerce Agentur ihn in Kundenprojekten umsetzen — inklusive der Fehler, die uns regelmäßig in der Praxis begegnen, und wie du sie von Anfang an vermeidest.

Auf einen Blick

  • ✓JTL-POS muss mindestens in Version 1.0.5.19 vorliegen, damit die Verbindung zu JTL-Vouchers überhaupt zustande kommt. Die PIN aus dem Vouchers-Portal ist nur 30 Minuten gültig — wer den Browser-Tab zwischendurch wechselt, fängt von vorne an. Wir richten diesen Schritt vor jedem Go-Live mit einem dokumentierten Protokoll ein.
  • ✓Damit Gutscheine an der Kasse überhaupt akzeptiert werden, muss in JTL-POS die Zahlungsart „Gutschein“ angelegt und unter dem Schalter „Gutschein“ aktiv geschaltet sein. Ohne diesen Schritt erscheint der Gutschein-Button gar nicht erst — ein Punkt, den die Vlarom E-Commerce Agentur in fast jedem POS-Projekt nachschärft.
  • ✓Teileinlösung funktioniert: übersteigt der Gutscheinwert den Artikelwert, bleibt der Rest auf dem Code und ist im Vouchers-Portal abrufbar. Wichtig: der Restbetrag kann nicht in bar ausgezahlt werden — laut JTL-Guide ein bewusstes Designprinzip. Wir kommunizieren das beim Onboarding klar an Kassenmitarbeiter.

Wir sehen dieses Setup regelmäßig in Kundenprojekten: Händler die JTL-POS bereits stationär nutzen wollen ihre Gutscheine vereinheitlichen — ein Code für Shop und Kasse statt zwei getrennten Systemen. Vlarom E-Commerce Agentur aus Ahrensfelde bei Berlin ist JTL Service Partner Gold und hat die Anbindung von JTL-Vouchers an JTL-POS in vielen Kundenprojekten umgesetzt. Wir kennen die typischen Fehler bei PIN-Vergabe, Zahlungsart-Konfiguration und Multi-Filial-Sync und wissen, warum manche Setups stabil laufen und andere nach jedem POS-Update wieder Probleme machen.

JTL-Vouchers mit JTL-POS verbinden: der praktische Ablauf

Die Anbindung hat eine feste Reihenfolge. Wer Schritte überspringt oder die Reihenfolge dreht, bekommt Fehlerbilder die im laufenden Betrieb teuer werden — Kassiererinnen die einen gültigen Gutschein nicht annehmen können oder Restwerte die im Portal anders aussehen als auf dem Bon. Hier ist der Ablauf so wie wir ihn bei der Vlarom E-Commerce Agentur in Kundenprojekten umsetzen.

Voraussetzungen prüfen vor der Verbindung

Prüfe zuerst die JTL-POS-Version: laut offiziellem JTL-Guide ist 1.0.5.19 die Mindestanforderung für die Vouchers-Anbindung. Ältere Versionen lassen sich nicht verbinden, der Menüpunkt fehlt schlicht. Empfohlen ist immer eine aktuelle stabile Version. Prüfe außerdem ob im JTL-Vouchers-Portal mindestens eine Client-Gruppe und ein Client angelegt sind. Ohne diese Basis schlägt die Verbindung fehl oder zeigt einen grünen Status ohne echte Funktion. Backup vor jeder größeren Konfigurationsänderung empfohlen — wir sichern grundsätzlich vorher die POS-Konfiguration.

PIN im JTL-Vouchers-Portal erzeugen

Im Vouchers-Portal über Clients den betreffenden Client aufrufen und über die Link-Schaltfläche eine PIN erzeugen. Im Pop-up-Fenster die PIN sofort kopieren — sie ist nur 30 Minuten gültig (Quelle: guide.jtl-software.com). Wer die PIN erzeugt, dann im Portal weiterarbeitet und erst später an der Kasse einträgt, hat oft keine 30 Minuten mehr und muss den Vorgang wiederholen. Praxis-Tipp aus unseren Projekten: PIN erzeugen, sofort an die Kasse wechseln, dort eintragen — kein Tab-Wechsel dazwischen.

Verbindung in JTL-POS herstellen

An der Kasse über das Menü Einstellungen > Datenabgleich den Punkt JTL-Vouchers öffnen. Auf das Stift-Symbol klicken zum Bearbeiten, unter Autorisierungscode die zuvor erzeugte PIN eintragen und auf Verbindung herstellen klicken. Die Änderungen mit der Haken-Schaltfläche bestätigen. Bei Erfolg ist JTL-Vouchers jetzt mit JTL-POS verbunden. Schlägt die Verbindung fehl, liegt es fast immer an einer abgelaufenen PIN, einem fehlenden Client im Portal oder einer JTL-POS-Version unter der Mindestanforderung.

Zahlungsart Gutschein anlegen und Test-Gutschein anlegen

Damit Gutscheine an der Kasse überhaupt akzeptiert werden, muss in JTL-POS unter Einstellungen > Zahlungsarten eine neue Zahlungsart mit dem Namen Gutschein angelegt werden. Wichtig: den Schalter Gutschein auf aktiv setzen — nur dann erkennt das System die Zahlungsart als Vouchers-fähig. Das DATEV-Buchungskonto solltest du in Abstimmung mit deiner Steuerberatung hinterlegen. Anschließend einen Test-Gutschein im Vouchers-Portal erzeugen (z.B. 50 Euro Mehrweck) und an der Kasse die Einlösung durchspielen.

Teileinlösung testen und Multi-Filial-Sync prüfen

Bon erstellen, Artikel hinzufügen, auf Zur Kasse > Gutschein klicken und den Code eingeben. Übersteigt der Gutscheinwert den Artikelwert, bleibt der Rest auf dem Code und ist im Vouchers-Portal unter der Gutscheinnummer abrufbar (Details: guide.jtl-software.com). Bei mehreren Filialen jeden POS-Client einzeln verbinden und in der gleichen Client-Gruppe halten — sonst entstehen getrennte Gutschein-Töpfe pro Filiale. Nach jedem POS-Update kurz den Verbindungsstatus und die Zahlungsart prüfen, da diese Konfiguration in Einzelfällen zurückgesetzt werden kann.

Häufige Fragen zur JTL-Vouchers-POS-Anbindung

Welche JTL-POS-Version brauche ich für die Vouchers-Anbindung?

JTL-Vouchers benötigt mindestens JTL-POS in Version 1.0.5.19 (Quelle: JTL-Guide, Einrichtung JTL-POS mit JTL-Vouchers verbinden). Ältere Versionen zeigen den Menüpunkt für die Vouchers-Verbindung nicht an. JTL empfiehlt grundsätzlich, immer eine aktuelle stabile Version zu nutzen. Welche Version dein POS-Client gerade hat, siehst du in der Kasse unter Einstellungen. Wir prüfen das vor jeder Anbindung als ersten Schritt — ein Update auf eine kompatible Version dauert kürzer als die Suche nach Fehlern bei einer fehlgeschlagenen Verbindung.

Die PIN aus dem JTL-Vouchers-Portal ist exakt 30 Minuten gültig. Danach verfällt sie automatisch und die Verbindung schlägt fehl. Wer die PIN erzeugt, dann im Portal weiterarbeitet, eine Pause macht oder den Browser schließt, hat oft keine 30 Minuten mehr. Beste Praxis aus unseren Projekten bei der Vlarom E-Commerce Agentur: PIN erzeugen, sofort kopieren, sofort an der Kasse eintragen, ohne Zwischenschritte. Wenn die Verbindung fehlschlägt: einfach im Portal eine neue PIN erzeugen und den Vorgang wiederholen.

Wenn an der Kasse beim Bezahlvorgang kein Gutschein-Button auftaucht, fehlt fast immer die Zahlungsart Gutschein in JTL-POS. Diese muss unter Einstellungen > Zahlungsarten manuell angelegt und der Schalter Gutschein auf aktiv gesetzt werden. Nur dann weiß das System, dass es sich um eine Vouchers-fähige Zahlungsart handelt. Ein häufiger Fehler in der Praxis: Händler verbinden zwar Vouchers korrekt, übersehen aber das Anlegen der Zahlungsart und wundern sich, warum nichts passiert. Bei uns ist dieser Punkt fester Bestandteil des Setup-Protokolls.

Übersteigt der Gutscheinwert den Artikelwert, bleibt der Rest auf dem Gutschein und der Bezahlvorgang wird abgeschlossen. Den Restwert kannst du im JTL-Vouchers-Portal unter der entsprechenden Gutscheinnummer abfragen. Übersteigt der Artikelwert den Gutscheinwert, kann der Rest mit einer anderen Zahlungsart bezahlt werden — der Gutschein wird dann als Teilzahlung vorgemerkt und kann bei Bedarf durch kurzes Halten wieder entfernt werden. Wichtig zu wissen: laut JTL-Guide kann der Restbetrag derzeit nicht in bar ausgezahlt werden — er bleibt auf dem Code und steht beim nächsten Einkauf zur Verfügung.

Das ist ein bekanntes Verhalten und im JTL-Issue-Tracker unter POS-1439 dokumentiert: nach Änderungen in JTL-Vouchers (z.B. neuer Gutschein-Artikel) müssen die Seriennummern in JTL-POS manuell aktualisiert werden. Im POS-Backend in der Artikelverwaltung den Gutschein-Artikel bearbeiten und den Sync-Vorgang anstoßen. Bei größeren Gutschein-Kampagnen lohnt sich ein fester Prozess mit dem Kassenpersonal, damit dieser Schritt nicht vergessen wird. Wir bauen diesen Schritt in Onboarding-Schulungen für Kassenpersonal mit ein.

Ja, das ist genau der Vorteil der zentralen Gutschein-Lösung über JTL-Vouchers. Voraussetzung: alle POS-Clients aller Filialen müssen mit demselben JTL-Vouchers-Konto verbunden sein und in einer Client-Gruppe liegen, die für alle relevanten Standorte einlöseberechtigt ist. Reserviert eine Filiale einen Gutschein im Bezahlvorgang, ist er in der anderen Filiale sofort gesperrt — Doppeleinlösung ist ausgeschlossen. Wer in einzelnen Filialen separate Gutschein-Töpfe haben will, legt dafür eigene Client-Gruppen mit eigenen Einlöseoptionen an. Die Konfiguration der Client-Gruppen ist im JTL-Guide unter Einrichtung dokumentiert.

Wird ein Artikel zurückgegeben, der ganz oder teilweise mit einem Gutschein bezahlt wurde, bucht JTL-POS den entsprechenden Gutschein-Anteil zurück auf den Code — der Restwert im Vouchers-Portal erhöht sich entsprechend. Bei Umtausch-Szenarien gibt es laut JTL-Issue-Tracker Optimierungsbedarf (Ticket POS-2763, Status Informationserfassung). In der Praxis funktionieren Standard-Retouren mit Vouchers stabil, komplexere Umtausch-Vorgänge mit gleichzeitiger Neu-Buchung anderer Artikel lohnen einen kurzen Test im laufenden Setup. Bei uns gehört ein Retouren-Test mit echtem Gutschein-Code vor dem Go-Live zum Standard-Setup.

Nein, JTL-Vouchers funktioniert eigenständig mit JTL-POS. Du musst JTL-Vouchers nicht zwingend an deinen JTL-Shop anbinden. Der Mehrwert der Anbindung an mehrere Kanäle entsteht aber genau dann, wenn ein Kunde einen Gutschein online kauft und stationär einlöst — oder umgekehrt. Wer den Webshop ebenfalls anbinden möchte, findet die Schritte in unserem Beitrag JTL-Vouchers mit JTL-Shop verbinden. Die Grundkonfiguration im Vouchers-Portal — Client-Gruppen, Clients, Einlöseoptionen — ist dabei dieselbe und in unserem Beitrag JTL-Vouchers einrichten im Detail beschrieben.

Die JTL-POS-Grundinstallation muss laufen — also Hardware, Mandant, Mitarbeiter, Steuersätze, grundlegende Zahlungsarten. Wer noch ganz am Anfang steht, findet in unserem Beitrag JTL-POS einrichten die einzelnen Schritte. Erst wenn JTL-POS eigenständig läuft und Bons schreibt, lohnt die Vouchers-Anbindung. Andersrum gilt: das JTL-Vouchers-Portal muss mit mindestens einer Client-Gruppe und einem Client befüllt sein. Wir prüfen beide Voraussetzungen vor jedem Anbindungs-Termin und stellen sicher, dass nichts blockiert.

JTL-Vouchers an JTL-POS sauber anbinden statt Sync-Probleme im Tagesgeschäft

Gutschein-Setup von Anfang an stabil: Vlarom richtet es ein.

Als JTL Service Partner Gold richten wir bei der Vlarom E-Commerce Agentur die Anbindung von JTL-Vouchers an JTL-POS für deinen Filialbetrieb ein: Versions-Check, PIN-Verbindung, Zahlungsart-Konfiguration, Test-Einlösung und Schulung deines Kassenpersonals. Melde dich direkt unter +49 30 91473862, schreibe an info@vlarom.de oder nutze unser Kontaktformular für ein unverbindliches Erstgespräch.