JTL-POS Kassensystem verbunden mit JTL-Wawi, Worker-Protokoll im Hintergrund

JTL POS Wawi Integration Fehler: Auftragsstände, Stornos und Bestand nach Live-Schaltung

Du hast JTL-POS eingerichtet, die erste Woche läuft. Dann kommen die Meldungen. Aufträge stehen in der Wawi noch als „offen“, obwohl der Kassiervorgang längst abgeschlossen ist. Stornierte Bons tauchen als bezahlt auf. Der Bestand an der Kasse stimmt nicht mit dem überein, was die Wawi zeigt. Das sind keine Ausnahmefälle: Diese JTL-POS-Probleme nach der Live-Schaltung sehen wir bei Händlern, die das System frisch in Betrieb genommen haben, regelmäßig.

Deine Kasse läuft, aber Wawi und POS ziehen nicht am gleichen Strang?

Dieser Beitrag zeigt die vier häufigsten Ursachen hinter JTL POS Wawi Integration Problemen, mit konkreten Diagnoseschritten für jeden Fall. Nicht allgemeines „Neustart hilft“, sondern die Stellen, an denen wir als JTL-POS-Einrichter immer wieder ansetzen.

Auf einen Blick

  • ✓Der Worker ist das häufigste Nadelöhr bei JTL POS Wawi Integration Problemen: Er verarbeitet POS-Aufträge sequenziell, und eine volle Queue bedeutet Stunden Verzögerung beim Auftragsstand in der Wawi.
  • ✓Stornierte Bons, die in der Wawi als „Bezahlt“ ankommen, entstehen fast immer durch einen Timing-Fehler: Der Storno passiert, bevor der vorherige Abgleich abgeschlossen ist. Wir bei der Vlarom E-Commerce Agentur sehen diesen Fall regelmäßig nach Updates.
  • ✓Bestandsabweichungen zwischen Kasse und Wawi lassen sich in 80 Prozent der Fälle auf einen zu langen Abgleich-Intervall oder einen fehlenden manuellen Abgleich direkt nach der Ersteinrichtung zurückführen.

Eine JTL-POS-Einführung ist technisch kein Hexenwerk. Die Integration mit JTL-Wawi hat aber mehr Fallstricke als die JTL-Dokumentation auf den ersten Blick zeigt — laut JTL-Worker-Dokumentation auf guide.jtl-software.com muss der Worker als Windows-Dienst laufen, damit der POS-Abgleich nach einem Serverneustart automatisch wieder startet. Wir sind JTL Service Partner Gold und haben in Ahrensfelde bei Berlin in den letzten Jahren mehrere Händler durch genau diese Phase begleitet: Erst alles eingerichtet, dann drei Wochen lang Fehler diagnostiziert, die bei der Konfiguration hätten verhindert werden können. Was wir dabei gelernt haben, steht in diesem Artikel. Als Vlarom E-Commerce Agentur mit Gold-Partner-Status kennen wir diese Fallstricke aus der täglichen Praxis.

4 Ursachen hinter JTL POS Wawi Integration Problemen

Die meisten Probleme nach der Live-Schaltung lassen sich auf vier Muster zurückführen. Ein Händler im JTL-Forum schrieb es treffend: „Der Worker vom JTL Shop läuft problemlos. Auch der POS Worker wirkt so als würde er korrekt funktionieren. Der letzte Auftrag, der in die Wawi importiert wurde ist vor zwei Tagen.“ Genau das ist die typische Situation: Alles scheint zu laufen, aber der Datenfluss stockt an einer unsichtbaren Stelle.

primary

Worker-Stau: POS-Aufträge hängen in der Queue

Der JTL-Worker verarbeitet Aufgaben sequenziell. Wenn gleichzeitig Shop-Abgleich, Marktplatz-Sync und POS-Import in der Queue liegen, kommen POS-Aufträge als letztes dran — manchmal Stunden nach dem Kassiervorgang. In der Wawi steht der Auftrag so lange als ‚offen‘, auch wenn der Kunde schon bezahlt hat und längst gegangen ist.

Drei Kassen gleichzeitig, ein Worker ohne dedizierten POS-Slot: Das ist der klassische Setup, der in Spitzenlastzeiten einbricht. Laut JTL-Worker-Dokumentation sollte der Worker-Prozess auf dem Wawi-Server laufen und ausreichend CPU-Zeit bekommen — bei geteilter Serverinstanz ist das oft nicht der Fall.

highlight

Storno-Synchronisation bricht ab

Ein stornierter Bon in JTL-POS sendet ein Signal an die Wawi. Wenn der Worker in diesem Moment nicht aktiv ist oder die Verbindung kurz unterbrochen war, landet das Storno-Signal in einer unvollständigen Übertragung. Das Ergebnis: Der ursprüngliche Auftrag steht in der Wawi als ‚Bezahlt: Ja‘, der Storno kommt nicht an.

Noch problematischer wird es, wenn zwischen Bon und Storno ein Wawi-Neustart lag. Dann fehlt dem Worker der Kontext und er verarbeitet die Sequenz in der falschen Reihenfolge. Ein Händler im JTL-Forum beschreibt das Muster so: ‚Stornierte Bons bleiben als positiver Nettoumsatz in der Umsatzstatistik.‘ Das ist kein Anzeigefehler — der Storno wurde tatsächlich nicht korrekt übertragen.

warning

Bestandsabweichungen nach Wawi-Abgleich

Bestand der Kasse stimmt nicht mit der Wawi überein. Das klingt harmlos, kann aber zu Überverkäufen führen. Laut Forum-Berichten greift die POS im Zweifelsfall auf den zuletzt gespeicherten lokalen Bestand zurück, auch wenn die Wawi inzwischen eine andere Zahl hat. Bei einem Abgleich-Intervall von 60 Sekunden kann das bei schnellem Verkauf zu einer Differenz von mehreren Einheiten führen.

Der häufigste Auslöser: Der erste manuelle Datenabgleich direkt nach der Ersteinrichtung wurde übersprungen oder war unvollständig. Wir sehen das bei Händlern, die die Kasse ‚einfach mal ausprobieren‘ wollten und dann im Live-Betrieb die Konsequenzen tragen. Die einzige saubere Lösung ist ein vollständiger Re-Sync: Artikel für POS deaktivieren, manuellen Abgleich starten, Artikel wieder aktivieren, zweiten Abgleich starten.

muted

Verbindungsabbruch nach Update: Dienst vs. Anwendung

Nach einem Wawi- oder POS-Update verliert die Verbindung zwischen beiden Systemen manchmal still die Verbindung. Der POS-Server läuft noch, die Wawi meldet keinen Fehler, aber neue Bons kommen nicht mehr an. Ursache ist oft, dass der JTL-Worker nach dem Update als Anwendung statt als Windows-Dienst läuft.

Als Anwendung beendet sich der Worker, sobald der angemeldete Benutzer sich abmeldet oder die Session endet. Als Dienst läuft er systemweit weiter. Der Unterschied klingt klein, ist aber der Grund für den Klassiker ‚Montag morgen funktioniert die Kasse nicht mehr‘ — am Wochenende hat jemand den Server-PC gesperrt oder neu gestartet.

In 5 Schritten zur stabilen JTL POS Wawi Integration

Diese Diagnoseschritte gehen vom häufigsten zum selteneren Problem. Die Schritte sind nach Häufigkeit geordnet: zuerst das wahrscheinlichste Problem prüfen, nach jedem Schritt abwarten, ob das Problem behoben ist, bevor der nächste Schritt folgt. Die Vlarom E-Commerce Agentur begleitet solche Diagnosen als JTL Service Partner Gold auch remote. Einen Kontakt findest du auf unserer Kontaktseite.

Worker-Status und Queue prüfen

Öffne den JTL-Worker und prüfe das Protokoll auf Fehlermeldungen. Wichtig: Schau dir die Zeitstempel an. Wenn der letzte POS-Import-Eintrag deutlich älter ist als der letzte Shop-Abgleich, ist die Queue das Problem. Nächster Schritt: Worker neu starten, dann beobachten ob POS-Aufträge zeitnah verarbeitet werden. Falls ja, war es eine einmalige Stauung. Falls nein, muss die Worker-Konfiguration angepasst werden.

Storno-Flow in der Wawi nachverfolgen

Für jeden stornierten Bon: Suche den Auftrag in der Wawi über Verkauf > Aufträge, filtere nach Plattform ‚JTL-POS‘. Prüfe ob der Auftrag als storniert oder als bezahlt markiert ist. Wenn bezahlt, öffne das Protokoll des POS-Servers zum Zeitpunkt des Stornos. Der Eintrag ‚Mindestens ein Fehler ist aufgetreten‘ gefolgt von einem Null-Reference-Fehler zeigt an, dass das Mapping zwischen Bon und Wawi-Auftrag gerissen ist. Betroffene Aufträge müssen manuell korrigiert werden.

Bestand-Reconciliation durchführen

Wenn Bestandsabweichungen bestehen, ist der sauberste Weg: Alle betroffenen Artikel in der Wawi für die POS temporär deaktivieren. Dann in JTL-POS einen manuellen Datenabgleich starten und warten bis er vollständig durch ist. Danach die Artikel in der Wawi wieder aktivieren und einen zweiten Abgleich starten. Diesen Zyklus hat JTL selbst als Workaround dokumentiert. Er dauert je nach Artikelzahl zwischen 10 Minuten und einer Stunde.

Abgleich-Intervall und Verbindungsparameter prüfen

In den globalen Einstellungen der Wawi unter Admin > Kasseneinstellungen findest du den Abgleich-Intervall. 60 Sekunden ist der Standardwert — bei mehreren gleichzeitigen Kassen sollte dieser Wert eher auf 30 Sekunden reduziert werden. Wichtiger: Prüfe in den Verbindungseinstellungen, ob die IP-Adresse des Wawi-Servers statisch vergeben ist. Dynamische IPs aus dem DHCP-Pool sind ein häufiger Grund dafür, dass die Kasse nach einem Router-Neustart keine Verbindung mehr findet.

Worker als Windows-Dienst einrichten

Öffne den JTL-Worker und prüfe oben rechts ob ‚Als Dienst aktiv‘ angezeigt wird. Wenn nicht, folge der Worker-Dokumentation auf guide.jtl-software.com und richte den Worker als Windows-Dienst ein. Das verhindert, dass der Abgleich bei einer Benutzerabmeldung stoppt. Nach der Einrichtung: Server einmal neu starten und prüfen ob der Dienst automatisch startet.

Häufige Fragen zu JTL POS Wawi Integration Problemen

Warum werden POS-Aufträge nicht in die Wawi importiert?

POS-Aufträge werden nicht importiert, wenn der Worker gestoppt ist, überlastet ist oder die Verbindung zwischen POS-Server und Wawi unterbrochen wurde. Prüfe zuerst das Worker-Protokoll auf Fehlermeldungen und den Zeitstempel des letzten POS-Imports. Wenn der Worker läuft aber keine Aufträge verarbeitet, ist oft ein fehlgeschlagenes Update das Problem: Nach dem Einspielen einer neuen Wawi-Version muss der Worker neu gestartet und auf Kompatibilität geprüft werden. In einem JTL-Forum-Thread ist dieses Muster ausführlich dokumentiert. Bei anhaltenden Problemen hilft die Vlarom E-Commerce Agentur auch remote bei der Diagnose.

Das entsteht durch eine unterbrochene Übertragung des Storno-Signals. Der ursprüngliche Bon wurde übertragen, der Storno kam nicht an. Diese Aufträge müssen in der Wawi manuell auf ‚Storniert‘ gesetzt werden — einen automatischen Korrekturmechanismus gibt es nicht. Um den Fehler künftig zu verhindern: Worker-Verbindung zum POS-Server stabilisieren und sicherstellen, dass der Worker als Windows-Dienst läuft. Forum-Thread 246049 beschreibt diesen Fall mit mehreren Lösungsansätzen.

Bestandsabweichungen entstehen durch einen fehlenden oder unvollständigen Abgleich bei der Ersteinrichtung. Die POS speichert den zuletzt bekannten Bestand lokal. Wenn die Wawi danach Buchungen vornimmt ohne dass ein Abgleich stattfindet, driften die Zahlen auseinander. Lösung: Vollständigen Re-Sync durchführen. Artikel für POS deaktivieren, manuellen Abgleich starten, wieder aktivieren, zweiten Abgleich starten. Wir bei der Vlarom E-Commerce Agentur sehen dieses Muster nach fast jeder Ersteinrichtung mindestens einmal.

Nach einem Update verliert die POS manchmal die Verbindung zur Wawi, weil sich interne Schnittstellen geändert haben. Prüfe als erstes ob Wawi und POS die gleiche kompatible Version haben — laut JTL-Dokumentation auf guide.jtl-software.com muss die POS-Version zur Wawi-Version passen. Zweiter Check: IP-Adresse des Wawi-Servers in den POS-Verbindungseinstellungen. Wenn der Router die IP neu vergeben hat, schlägt die Verbindung fehl mit der Meldung ‚URL:/api/v1/init — connection refused‘.

Der Standard-Intervall von 60 Sekunden reicht für eine einzelne Kasse aus. Bei zwei oder mehr Kassen gleichzeitig lässt sich der Intervall auf 30 Sekunden reduzieren, damit Bestandsänderungen schnell genug propagiert werden und es keine Überverkäufe gibt. Der Abgleich überträgt eben Aufträge, Zahlungen und Bestandsänderungen in einem Zug. Ein zu langer Intervall erhöht das Risiko, dass ein Artikel an zwei Kassen gleichzeitig verkauft wird.

Der POS-Server wollte einen Bon an die Wawi senden, aber das interne Mapping zwischen Bon-Positionen und Wawi-Auftragszeilen ist fehlgeschlagen. Auslöser ist häufig ein Artikel, der in JTL-POS existiert, aber in der Wawi nicht korrekt für POS freigegeben ist. Lösung: Betroffenen Artikel in der Wawi suchen, im Reiter ‚Allgemein‘ unter Online-Shops / JTL-POS die Freigabe prüfen und einen erneuten Abgleich starten.

Nein, einen manuellen Import-Button für POS-Aufträge gibt es nicht. Die Übertragung läuft ausschließlich über den Worker-Abgleich. Wenn Aufträge fehlen, sind sie entweder noch in der Worker-Queue oder wurden durch einen Fehler nicht verarbeitet. Im POS-Server-Protokoll findest du für jeden Bon einen Eintrag — fehlt der Eintrag ‚Auftrag erfolgreich übertragen‘, ist der Bon nie angekommen. In diesem Fall muss der Händler den Auftrag manuell in der Wawi anlegen.

Hast du nach der POS-Einführung ähnliche Probleme?

Vlarom E-Commerce Agentur löst JTL POS Wawi Integration Probleme, auch remote.

Als JTL Service Partner Gold kennen wir die typischen Stolperstellen nach der Live-Schaltung. Wir diagnostizieren Worker-Probleme, Storno-Fehler und Bestandsabweichungen remote, ohne dass du lange auf eine Antwort warten musst. Ruf uns direkt an unter +49 30 91473862, schreibe an info@vlarom.de oder nutze unser Kontaktformular für eine erste Einschätzung.

Autor

Alexander Luft

JTL Service Partner Gold · Vlarom E-Commerce Agentur · Ahrensfelde bei Berlin