JTL POS Fehler lösen: Die 6 häufigsten Probleme im Kassenbetrieb und wie du sie systematisch findest

Auf einen Blick

• ✓Die häufigsten JTL POS Fehler entstehen nicht durch Bugs, sondern durch falsch konfigurierte Sync-Einstellungen, unterbrochene Verbindungen zum POS-Server oder nach System-Updates geänderte Geräteparameter. Vlarom E-Commerce Agentur behebt diese Probleme nach einem festen Diagnose-Schema.
• ✓Wenn Artikel nicht am Kassenterminal erscheinen, liegt das in fast allen Fällen an einem fehlgeschlagenen Sync zwischen Wawi und POS-Server, nicht an der App selbst. Zwei Prüfschritte lösen das in den meisten Setups.
• ✓Als JTL Service Partner Gold unterstützt Vlarom E-Commerce Agentur Händler systematisch bei JTL POS Fehlern: von der Erstdiagnose bis zum stabilen Kassenbetrieb.

Vlarom E-Commerce Agentur behebt JTL-POS-Fehler nach einem festen Diagnose-Schema, weil ein Kassen-Ausfall direkt ins Tagesgeschäft trifft. Der Drucker reagiert nicht, der Tagesabschluss schlägt fehl, Kunden stehen an der Kasse. In unseren Projekten haben wir gelernt, dass die meisten Fehler strukturell dieselbe Ursache haben: ein Konfigurationsschritt wurde beim Einrichten übersprungen oder hat sich nach einem Update geändert, ohne dass jemand davon wusste. Als JTL Service Partner Gold aus Ahrensfelde bei Berlin lösen wir diese Probleme nicht durch Raten, sondern durch einen systematischen Diagnose-Ablauf.

Verbindungsprobleme zwischen POS-Server und Wawi verursachen aus unserer Projektpraxis rund die Hälfte aller JTL-POS-Fehlerbilder. Hardware-Inkompatibilitäten bei Bondrucker und Zahlungsgeräten folgen mit rund 30 Prozent. Konfigurationsfehler bei Artikeln, Preisen und Steuereinstellungen machen den Rest aus. Hintergrund: Die JTL-POS-App läuft auf Android-Geräten und kommuniziert über den POS-Server mit der JTL-Wawi — dieses dreistufige Setup (App, POS-Server, Wawi-Datenbank) hat entsprechend drei potenzielle Fehlerebenen.

Aus unserer Projektpraxis: In drei von vier JTL-POS-Setups, die wir in einem Support oder Onboarding übernehmen, existiert mindestens ein Konfigurationsfehler beim Sync oder in der Gerätebindung, der seit der Ersteinrichtung unbehoben ist.

Die drei Fehlerebenen bei JTL POS und ihre typische Häufigkeit:

• →Verbindungsebene (POS-Server zu Wawi): Rund 50 Prozent der Fehlerbilder. Ursachen: Firewall-Regel blockiert den POS-Port, Server-IP hat sich geändert, Datenbankverbindung wurde nach einem Wawi-Update nicht aktualisiert.
• →Hardware-Ebene (Drucker und Zahlungsgeräte): Rund 30 Prozent der Fehlerbilder. Ursachen: USB-Gerät nach Android-Update nicht mehr erkannt, ZVT-Protokoll-Parameter stimmen nicht mit dem Zahlungsdienstleister überein, Bondrucker-IP im LAN gewechselt.
• →Konfigurationsebene (Artikel, Preise, TSE): Rund 20 Prozent der Fehlerbilder. Ursachen: Artikel in Wawi angelegt aber Sync noch nicht ausgeführt, Preisgruppe am POS-Terminal nicht korrekt zugewiesen, TSE-Verbindung nach Zertifikatserneuerung unterbrochen.

Die wichtigste Erkenntnis aus unserer Praxis: Wenn die POS-App selbst stabil läuft, liegt der Fehler fast nie in der App. Er liegt in der Verbindungsschicht darunter, im POS-Server oder in den Daten aus der Wawi.

Jeder dieser sechs Fehler kann den Kassenbetrieb blockieren oder verlangsamen. Wir listen sie in der Häufigkeit, in der wir sie aus Kundenprojekten und Forum-Meldungen kennen.

primary

POS startet nicht oder hängt am Begrüßungsbildschirm

Die App öffnet, der Begrüßungsbildschirm erscheint, aber die Anmeldemaske kommt nicht. Ein Händler im JTL-Forum: ‚Ich habe den Anmelden-Button gedrückt, dann kam die Meldung, dass die Verbindung nicht hergestellt werden konnte.‘ Das ist das klassische Bild einer nicht erreichbaren POS-Server-Adresse.

Ursachen: POS-Server-Dienst ist gestoppt, die IP-Adresse des Servers hat sich geändert (z.B. nach Router-Neustart mit DHCP), oder der Standardport des POS-Servers (Standard: 8080) ist durch eine Firewall blockiert. Prüfung: POS-Server-Status im Windows-Dienste-Manager, Erreichbarkeit via Browser-Aufruf http://[Server-IP]:8080.

highlight

Sync mit Wawi schlägt fehl: Artikel erscheinen nicht oder Preise stimmen nicht

Neue Artikel werden in der Wawi angelegt, aber am Kassenterminal erscheinen sie nicht. Oder Preise wurden in der Wawi geändert, die Kasse zeigt noch den alten Stand. Ein Händler im JTL-Forum: ‚Neue Produkte werden von der Wawi nicht nach POS synchronisiert, obwohl alle drei Kassen seit Wochen laufen.‘ Das Muster ist in vielen Setups gleich.

Ursachen: Sync-Intervall im POS-Server nicht korrekt konfiguriert, Datenbankverbindung des POS-Servers zur Wawi-Datenbank ist unterbrochen, oder der Artikel hat in der Wawi keine Preiszuordnung für die am POS verwendete Preisgruppe. Prüfung: POS-Server-Log auf Datenbankverbindungsfehler, Wawi-Einstellungen unter Kassensysteme > JTL-POS.

warning

Tagesabschluss schlägt fehl oder produziert falsche Summen

Der Tagesabschluss ist eine der häufigsten Fehlerquellen, die uns gemeldet werden. Entweder bricht der Vorgang ab mit einer Fehlermeldung, oder er läuft durch, aber der ausgedruckte Beleg zeigt falsch kumulierte Steuerbeträge. Ein Händler im JTL-Forum: ‚Seit einigen Tagen tritt ein merkwürdiger Fehler im Tagesabschluss auf. Der Gesamtumsatz nach Steuersätzen wird teilweise falsch kumuliert.‘

Ursachen: Buchungen mit gemischten Steuersätzen (7% und 19%) wurden nicht korrekt getrennt, ein Zahlungsvorgang wurde unterbrochen und ist halb gebucht, oder die TSE-Verbindung hat während des Kassierens Fehler produziert die jetzt den Abschluss blockieren. Prüfung: Kassierprotokoll des betroffenen Tages in JTL-POS, POS-Server-Log auf TSE-Fehler.

muted

Zahlungsgerät (EC-Karte / ZVT) trennt Verbindung

Das Zahlungsgerät ist konfiguriert, aber beim Kassierprozess kommt die Meldung, dass das Terminal nicht erreichbar ist. Oder die EC-Karte wird gestartet, aber das Gerät reagiert nicht. Das betrifft vor allem Setups mit externen Zahlungsterminals die über das ZVT-Protokoll angebunden sind.

Ursachen: IP-Adresse des Terminals hat sich geändert (DHCP im Netzwerk), ZVT-Port stimmt nicht mit den Einstellungen des Zahlungsdienstleisters überein, oder die Verbindung wurde durch ein Android-Update unterbrochen das die Netzwerk-Zertifikate neu gesetzt hat. Prüfung: Terminal-IP in den POS-Zahlungseinstellungen, Erreichbarkeit via Ping, ZVT-Port beim Zahlungsanbieter-Support erfragen.

primary

Bondrucker wird nicht erkannt oder druckt falsch

Nach einem Update läuft der Bondrucker nicht mehr, obwohl er vorher problemlos funktionierte. Fehlermeldung: ‚/dev/bus/usb: Druckvorgang fehlgeschlagen‘. Oder der Drucker wird erkannt, aber der Bon-Ausdruck zeigt fehlende Zeilen, falsches Format oder bricht mitten im Druck ab.

Ursachen: JTL-POS unterstützt Bondrucker über Bluetooth, USB und Netzwerk. Nach einem POS-App-Update kann die USB-Geräteberechtigung zurückgesetzt worden sein und muss neu erteilt werden. Bei Netzwerkdruckern kann sich die IP-Adresse geändert haben. Prüfung: Druckereinstellungen in JTL-POS unter Einstellungen > Peripherie, USB-Geräteberechtigung in Android-Einstellungen prüfen. Dokumentation zu unterstützten Druckern: JTL-POS Hardware-Dokumentation.

warning

Artikel-Preis stimmt nicht mit Wawi überein

Die Kasse zeigt einen anderen Preis als die Wawi. Das tritt häufig nach Preisänderungen in der Wawi auf, wenn der Sync-Prozess nicht vollständig durchgelaufen ist. Oder der Artikel gehört zu einer Preisgruppe, die am POS-Terminal nicht korrekt zugewiesen ist.

Ursachen: Sync nach Preisänderung wurde nicht manuell ausgelöst und das automatische Intervall ist zu lang, der Artikel verwendet eine Kundengruppen-Sonderpreisliste die am Terminal nicht greift, oder es gibt eine Überschneidung zwischen globalem Brutto- und Nettopreis. Prüfung: Wawi > Kassensysteme > JTL-POS: Sync manuell anstoßen. Dann Artikel am Terminal prüfen und mit Wawi-Stammdaten vergleichen.

Stabiler Kassenbetrieb ohne manuelle Eingriffe

Wenn Verbindung, Sync und Gerätekonfiguration sauber eingerichtet sind, läuft JTL-POS in unseren Projekten stabil durch mehrere Monate ohne strukturelle Fehlerbilder. Wir dokumentieren nach jedem POS-Setup die Konfiguration, damit Änderungen nachvollziehbar bleiben und keine Folgeprobleme entstehen.

Tagesabschluss in unter drei Minuten

Ein korrekt konfiguriertes POS-Setup schließt den Tagesabschluss in zwei bis drei Minuten ab. Bei Setups mit TSE-Fehlern oder unterbrochenen Kassierprotokollen dauert der gleiche Vorgang zwanzig Minuten oder schlägt ganz fehl. Nach der Bereinigung berichten Händler regelmäßig, dass der Abendabschluss plötzlich keine Stresssituation mehr ist.

Diese Diagnose-Reihenfolge folgt dem Prinzip: Verbindung zuerst, Hardware zweite, Konfiguration dritte. So vermeidest du, dass du an der falschen Stelle anfängst. Vor jeder Konfigurationsänderung die Einstellungen notieren, damit du bei Bedarf zurücksetzen kannst.

Öffne auf dem Gerät einen Browser und rufe http://[POS-Server-IP]:8080 auf. Wenn die Seite nicht lädt, ist der POS-Server nicht erreichbar. Prüfe auf dem Server-Rechner im Windows-Dienste-Manager, ob der JTL-POS-Server-Dienst läuft und gestartet ist. Prüfe außerdem, ob die IP-Adresse des Servers sich geändert hat (DHCP-Umgebungen verändern IPs nach Router-Neustarts). Trage als Gegenmaßnahme dem POS-Server eine feste lokale IP-Adresse zu. Lies dazu auch die JTL-POS Einrichtungsdokumentation für den vollständigen Setup-Kontext. Wichtig: Vor Änderungen an der Netzwerkkonfiguration den aktuellen Stand notieren.

Öffne in der JTL-Wawi den Bereich Kassensysteme > JTL-POS und stoße einen manuellen Sync an. Prüfe nach dem Sync-Lauf, ob der Status ohne Fehler abgeschlossen hat. Wenn der Sync mit einer Fehlermeldung zur Datenbankverbindung abbricht, prüfe im POS-Server-Log ob die Wawi-Datenbankverbindung korrekt konfiguriert ist. Nach einem Wawi-Update ändert sich manchmal der Datenbankport oder die Authentifizierungsmethode, was die POS-Server-Verbindung unterbricht.

Öffne in der POS-App den Bereich Einstellungen > Peripherie und teste den Bondrucker über die eingebaute Testdruck-Funktion. Wenn der Test fehlschlägt und ein USB-Drucker verwendet wird: Trenne das Gerät, verbinde es neu und erteile in Android unter Apps > JTL-POS > Berechtigungen die USB-Geräteberechtigung erneut. Bei Netzwerkdruckern: Prüfe die konfigurierte IP gegen die aktuelle Geräte-IP im Router. Für das Zahlungsgerät: Überprüfe IP-Adresse und Port in den Zahlungseinstellungen und teste die Verbindung per Ping.

Öffne in der POS-App die TSE-Einstellungen und führe einen TSE-Selbsttest durch. Zeigt der Selbsttest grün, ist die TSE technisch in Ordnung. Wenn der Tagesabschluss trotzdem fehlschlägt: Prüfe das Kassierprotokoll des betroffenen Tages auf unterbrochene Vorgänge. Buchungen die halb durchgelaufen sind (z.B. Verbindungsabbruch während EC-Zahlung) müssen manuell abgeschlossen oder storniert werden, bevor der Tagesabschluss durchläuft. Detaillierte Informationen zur Zahlungsabwicklung: JTL-POS Zahlungen-Dokumentation.

Vergleiche den Artikel-Preis in der POS-App mit dem Wawi-Stammsatz direkt: Öffne in der Wawi den betroffenen Artikel, prüfe den Bruttobasispreis und welche Preisgruppe dem POS-Terminal zugewiesen ist. Wenn der Artikel einer Sonderpreisliste zugeordnet ist, muss diese Preisliste auch in den POS-Terminal-Einstellungen verknüpft sein. Danach Sync erneut manuell anstoßen und am Terminal prüfen. Dokumentiere die Preisgruppen-Zuordnung aller Terminals schriftlich, das spart beim nächsten Update erheblich Zeit.

Wawi↔POS-Datenpipeline: Stornos, Bestand, Worker