JTL-POS Kassensystem mit Fehlermeldung auf dem Bildschirm — Diagnose und Lösung

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

Die Kasse öffnet nicht, der Tagesabschluss bricht ab oder neue Artikel aus der Wawi tauchen am Kassenterminal einfach nicht auf. Solche Situationen entstehen meistens nicht durch einen Softwarebug, sondern durch eine falsch gesetzte Konfiguration, einen unterbrochenen Sync-Prozess oder eine inkompatible Hardware-Einstellung. Wir sehen das regelmäßig: In vielen JTL-POS-Setups, die zu uns kommen, liegt der Fehler schon seit Wochen vor, wurde aber mit Workarounds umgangen statt behoben. Die sechs Fehlerbilder in diesem Beitrag decken den Großteil der Kassenbetrieb-Probleme ab, die uns aus der Praxis bekannt sind.

Die Kasse streikt und der Betrieb wartet auf eine Lösung?

Dieser Beitrag zeigt dir, welche sechs Ursachen hinter den häufigsten JTL POS Fehlern stecken und in welcher Reihenfolge du die Diagnose sinnvoll angehst.

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.

Was hinter JTL POS Fehlern wirklich steckt

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.

Die 6 häufigsten JTL POS Fehler mit ihren Ursachen

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.

Was nach dem Fix messbar besser wird

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.

Die Lektion

Unsere Erkenntnis aus JTL-POS-Projekten bei Vlarom E-Commerce Agentur: Die meisten POS-Fehler haben keine einmalige Ursache. Fast alle entstehen durch die Kombination aus einer nicht dokumentierten Erstkonfiguration und einem späteren Update, das einen Parameter verändert hat. Wer sein Setup einmal sauber dokumentiert, hat beim nächsten Fehler eine Ausgangsbasis statt einer leeren Seite.

JTL POS Fehler systematisch diagnostizieren

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.

POS-Server-Verbindung prüfen (Schritt 1)

Ö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.

Wawi-Sync auslösen und Log prüfen (Schritt 2)

Ö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.

Bondrucker und Zahlungsgerät testen (Schritt 3)

Ö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.

TSE-Status und Tagesabschluss-Log prüfen (Schritt 4)

Ö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.

Artikel-Preise und Preisgruppen abgleichen (Schritt 5)

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.

Häufige Fragen zu JTL POS Fehlern

Warum startet JTL-POS nicht und hängt am Begrüßungsbildschirm?

JTL-POS hängt am Begrüßungsbildschirm, weil die App keine Verbindung zum POS-Server herstellen kann. Häufigste Ursachen sind: POS-Server-Dienst auf dem Windows-Rechner ist gestoppt, IP-Adresse des Servers hat sich durch einen Router-Neustart geändert, oder der POS-Standardport 8080 ist durch eine Firewall blockiert. Erster Prüfschritt: Browser auf dem Kassentablet öffnen und http://[Server-IP]:8080 aufrufen. Wenn die Seite lädt, ist der Server erreichbar und das Problem liegt in der App-Konfiguration. Wenn nicht, liegt ein Server- oder Netzwerkproblem vor.

Wenn neue Artikel nicht an der Kasse erscheinen, ist der Sync zwischen Wawi und POS-Server nicht durchgelaufen. Gehe in der Wawi zu Kassensysteme > JTL-POS und stoße den Sync manuell an. Prüfe den Sync-Status auf Fehlermeldungen, besonders auf Datenbankverbindungsfehler. Wenn der Sync mit Fehler abbricht, hat der POS-Server keine aktive Verbindung zur Wawi-Datenbank. Das passiert häufig nach Wawi-Updates, wenn der Datenbankport oder die Zugangsdaten geändert wurden.

Ein fehlgeschlagener Tagesabschluss hat in den meisten Fällen eine von drei Ursachen: Ein Kassierprozess wurde unterbrochen und ist halb gebucht, die TSE-Verbindung hat Fehler produziert, oder Buchungen mit unterschiedlichen Steuersätzen sind nicht korrekt getrennt. Erste Prüfung: Kassierprotokoll des betroffenen Tages in der POS-App auf unterbrochene Vorgänge prüfen. TSE-Selbsttest durchführen. Wenn Buchungen mit Fehlerstatus existieren, müssen diese manuell abgeschlossen oder storniert werden, bevor der Abschluss durchläuft.

Verbindungsabbrüche beim EC-Gerät entstehen fast immer durch eine veränderte IP-Adresse des Terminals oder durch einen falschen ZVT-Port in den Zahlungseinstellungen. Prüfe in der POS-App unter Einstellungen > Zahlungsarten die konfigurierte IP-Adresse des Terminals und gleiche sie mit der aktuellen Geräte-IP im Router-Interface ab. Wenn die IP stimmt, erfrage beim Zahlungsanbieter den aktuellen ZVT-Port. Manche Anbieter haben nach Updates den Standardport geändert ohne Kundenmitteilung.

Nach einem POS-App-Update werden USB-Geräteberechtigungen auf Android regelmäßig zurückgesetzt. Trenne den Bondrucker vom USB-Anschluss, verbinde ihn neu und öffne in Android unter Einstellungen > Apps > JTL-POS > Berechtigungen die USB-Berechtigung und erteile sie erneut. Bei Netzwerkdruckern prüfe die in POS konfigurierte IP gegen die aktuelle Drucker-IP im Router. Eine detaillierte Übersicht unterstützter Druckermodelle und Verbindungstypen findest du in der JTL-POS Hardware-Dokumentation.

Preisabweichungen zwischen Wawi und Kasse entstehen, wenn der Sync nach einer Preisänderung nicht ausgeführt wurde oder wenn der Artikel einer Preisgruppe zugeordnet ist, die am Terminal nicht verknüpft ist. Gehe in der Wawi zu Kassensysteme > JTL-POS und stoße den Sync manuell an. Prüfe danach in den Terminal-Einstellungen, welche Preisgruppe dem Terminal zugewiesen ist, und gleiche das mit dem betroffenen Artikel ab. Sonderpreislisten müssen explizit in den POS-Einstellungen verknüpft werden, das passiert nicht automatisch beim Anlegen der Liste.

Wawi↔POS-Datenpipeline: Stornos, Bestand, Worker

JTL POS Fehler haben fast immer eine klare Ursache. Meistens liegt sie in der Verbindungsschicht, nicht in der App selbst.

Wir lösen dein POS-Problem. Strukturiert, nicht durch Ausprobieren.

Als JTL Service Partner Gold aus Ahrensfelde bei Berlin unterstützt Vlarom E-Commerce Agentur Händler bei der Diagnose und Behebung von JTL-POS-Fehlern, von der Ersteinrichtung über Hardware-Inkompatibilitäten bis zu Sync-Problemen im laufenden Kassenbetrieb. Ruf uns direkt an unter +49 30 91473862, schreibe an info@vlarom.de oder nutze unser Kontaktformular für ein unverbindliches Erstgespräch.