Dieser Artikel gehört zu JTL-Wawi 1.x mit Klar verbinden (Beta). Er hilft dir, wenn die Übertragung stockt oder das Programm eine Warnung zeigt.

Prüfe immer zuerst das Taskleisten-Menü

Klicke auf das Klar-Symbol neben der Uhr. Die oberen Zeilen sagen dir, woran es liegt:

Zeile	Was du dort ablesen kannst
Status	Was der Dienst gerade macht, oder welches Problem vorliegt
Last Sync	Zeitpunkt und Ergebnis des letzten Durchlaufs. Liegt er lange zurück, läuft der Dienst nicht mehr richtig.
Synced to Klar	Wie viele Bestellungen diese Installation in Klar verwaltet, und ab welchem Datum
Errors	Ist der Wert größer als 0, blockiert eine fehlgeschlagene Gruppe die neuen Bestellungen
JTL · Klar	`✓` = erreichbar, `✗` = nicht erreichbar. Dahinter der Gesamtbestand in JTL-Wawi.
Version	Die laufende Version. Nenne sie immer, wenn du den Support kontaktierst.

Braucht das Programm deine Hilfe, erscheint unter den Statuszeilen eine Zeile mit einem ⚠. Sie nennt die konkrete Maßnahme.

[BILD: 04-traymenue-normal.png] — Taskleisten-Menü mit allen Statuszeilen.

Kein Fehler: Synced to Klar: 465 orders since 01.01.2026 und 1.072 orders in JTL sind zwei verschiedene Zahlen und kein Bruch. Die erste gilt nur für den Zeitraum, den du beim Setup gewählt hast. Die zweite ist der Gesamtbestand in JTL-Wawi. Dass die erste kleiner ist, ist normal.

Die Meldungen und was zu tun ist

Diese Meldungen erscheinen in der Zeile Status. Der erklärende Satz darunter steht in der ⚠-Zeile.

Meldung	Ursache	Maßnahme
Service is NOT running - nothing is syncing	Der Dienst ist gestoppt, oder ein Virenscanner hat die Programmdatei entfernt	Nutze Restart Service im Startmenü. Prüfe die Quarantäne deines Virenscanners. Wenn es nicht hilft, installiere das Programm erneut.
Service not installed	Die Registrierung des Dienstes ist fehlgeschlagen	Führe den Installer erneut als Administrator aus.
Service is starting	Der Dienst startet gerade	Warte einen Moment. Öffne das Menü danach erneut.
Cannot determine service state	Der Zustand des Dienstes ließ sich nicht abfragen und es gibt noch keine Statusdatei	Prüfe den Dienst `JtlKlarSync` in `services.msc`.
Waiting for the first status report	Der Dienst läuft, hat aber noch keinen Status geschrieben	Warte bis zu einer Minute. Bleibt es dabei, nutze Restart Service.
JTL API license required	JTL-Wawi antwortet mit HTTP 402. Die API hat keine Lizenz.	Buche die JTL-Wawi-API-Lizenz im JTL-Kundencenter. Bis dahin erreicht keine Bestellung Klar.
No sync for <Zeit> - the service is not responding	Der Dienst läuft, hat aber seinen Zeitplan verpasst	Nutze Restart Service. Schicke die Logdateien an den Support.
Retrying <n> failed order(s)	Klar hat eine Gruppe abgelehnt. Neue Bestellungen warten. Das verhindert Lücken in Klar.	Öffne View Logs. Das Log nennt Bestell-ID, Feld und Grund. Siehe Abgelehnte Bestellungen weiter unten.
JTL unreachable	Der JTL-API-Server ist gestoppt, oder die URL ist falsch	Starte den JTL-API-Server. Prüfe die API URL im Einstellungsfenster mit Test connection.
Klar unreachable	Keine Internetverbindung, oder der Token ist ungültig	Prüfe die Verbindung. Nutze Test connection im Einstellungsfenster. Bei Erfolg erscheint ✓ Connected to Klar.
JTL and Klar unreachable	Beide Verbindungen fehlen, meist ein Netzwerk- oder Firewall-Problem	Prüfe die Netzwerkverbindung des Rechners und die Firewall-Regeln für ausgehendes HTTPS.
Last sync failed	Ein Durchlauf ist fehlgeschlagen	Öffne View Logs. Die letzten Zeilen nennen den Grund.

Weitere Situationen

Symptom	Ursache	Maßnahme
Die Zahl bei Synced to Klar steigt nicht mehr	Eine fehlgeschlagene Gruppe blockiert die neuen Bestellungen. Das ist Absicht und verhindert Datenverlust.	Schau auf die Zeile Errors. Öffne View Logs und beseitige die Ursache. Danach läuft die Übertragung von allein weiter.
Das Taskleisten-Symbol fehlt	Das Taskleisten-Programm läuft nicht, oder das Symbol ist ausgeblendet	Klappe den Bereich der ausgeblendeten Symbole auf. Fehlt es dort auch, starte JTL-to-Klar Sync über das Startmenü. Der Dienst überträgt in der Zwischenzeit trotzdem weiter.
Der Setup-Assistent oder das Einstellungsfenster öffnet sich nicht	Der Grafiktreiber liefert kein OpenGL 2.1, zum Beispiel auf einem Server ohne Grafikkarte oder in einer Remotedesktop-Sitzung	Führe das Fenster direkt an der Konsole des Rechners aus. Melde uns diesen Fall.
Die App-Registrierung in JTL-Wawi kommt nicht an	Die App-Registrierung war in JTL-Wawi nicht geöffnet, oder du bist in einer anderen Datenbank angemeldet	Öffne in JTL-Wawi Admin → App-Registrierung zuerst. Prüfe, dass der Datenbankname in der API-URL zu der Datenbank passt, in der du angemeldet bist (meist `eazybusiness`). Klicke dann erneut auf Register with JTL-Wawi.
Der Assistent wartet 10 Minuten und bricht dann ab	Die Anfrage wurde in JTL-Wawi nicht angenommen	Starte den Vorgang neu. Nimm die Anfrage Klar Sync in JTL-Wawi an und klicke dort auf Fertigstellen.
Der Assistent sagt, eine Registrierung sei noch offen	Ein früherer Versuch wurde abgebrochen, während JTL-Wawi noch wartete	Nimm die offene Anfrage in Admin → App-Registrierung an und klicke erneut auf Register with JTL-Wawi. Eine neue Registrierung würde eine weitere App-ID verbrauchen.
In JTL-Wawi stehen mehrere Registrierungen Klar Sync	Du hast das Programm erneut registriert, ohne den alten API-Key zu verwenden. JTL-Wawi kann einen Key nicht erneut ausgeben.	Nur die neueste Registrierung ist aktiv. Entferne die älteren in Admin → App-Registrierung.
In Klar fehlen alte Bestellungen	Der beim Setup gewählte Startmonat liegt später, oder die Bestellungen sind älter als das Re-check window	Hole den Zeitraum mit Re-import a date range… im Taskleisten-Menü nach.
Die Google-Analytics-Transaktions-IDs passen nicht zu GA4	Es wird das falsche JTL-Feld gesendet	Stelle GA transaction id im Einstellungsfenster auf das Feld um, das dein Shop an GA4 schickt. Für bereits übertragene Bestellungen ist danach ein Re-export: full refresh from JTL nötig.
Zahlen in Klar weichen von JTL-Wawi ab	Eine Änderung an einer Position, die den Gesamtbetrag nicht verändert hat, zum Beispiel eine korrigierte SKU	Warte bis zu 24 Stunden. Das Programm findet solche Änderungen mit einem langsamen Durchgang. Bleibt die Abweichung, melde sie mit der Bestellnummer an den Support.
Der Import dauert sehr lange	Die Geschwindigkeit steht auf Conservative, oder die Historie ist sehr groß	Sprich eine höhere Rate mit dem Support ab. Auf einem Arbeitsplatzrechner ist die vorsichtige Einstellung aber richtig.
Nach einer Änderung an `config.yaml` passiert nichts	Der Dienst hat die Datei noch nicht neu gelesen	Nutze Restart Service im Startmenü.
Das Programm fragt nach dem Setup erneut nach den Zugangsdaten	Die Konfiguration wurde gelöscht, oder der Rechner wurde geklont bzw. ausgetauscht. Die Verschlüsselung ist an den Rechner gebunden.	Führe den Setup-Assistenten erneut aus. Halte den JTL-Wawi-API-Key bereit, oder registriere die App neu.

Probleme mit Updates

Symptom oder Meldung	Ursache	Maßnahme
Das Update-Fenster öffnet sich immer häufiger	Das Update wartet seit mehr als 3 bzw. 7 Tagen	Installiere die neue Version. Remind me tomorrow setzt die Uhr nicht zurück.
Update cannot be installed — The downloaded installer is not signed by Klar Insights GmbH.	Die heruntergeladene Datei ist nicht vertrauenswürdig	Installiere sie nicht. Melde die Meldung an den Support und nenne die Version.
Update cannot be installed — The downloaded installer is damaged…	Der Download ist unvollständig oder beschädigt	Das Programm lädt beim nächsten Prüflauf erneut. Warte einen Tag. Bleibt es dabei, melde es an den Support.
Update failed to start	Der Installer konnte nicht gestartet werden	Prüfe, dass du Administratorrechte bestätigen kannst. Starte den Rechner neu und versuche es erneut.
Nach dem Update fehlt das Taskleisten-Symbol	Das Taskleisten-Programm ist noch nicht zurückgekommen	Warte eine Minute. Starte danach JTL-to-Klar Sync über das Startmenü.
Ein Problem trat erst nach einem Update auf	Die neue Version verhält sich anders	Melde es ausdrücklich als Update-Problem und nenne beide Versionen. Der Support kann auf `jtl-klar-sync.exe.previous` im Programmordner zurückgehen.

Abgelehnte Bestellungen

Klar nennt bei einer Ablehnung für jedes Feld einen Grund. Der Dienst schreibt jede Ablehnung in das Log, mit der Bestell-ID, dem Feld und dem Grund. Es gibt kein eigenes Fehlerfenster.

Öffne View Logs im Taskleisten-Menü.
Suche nach der Bestell-ID oder nach dem Wort reject.
Lies das genannte Feld und den Grund.
Korrigiere die Bestellung in JTL-Wawi, wenn dort etwas fehlt oder falsch ist.
Klicke auf Sync Now. Der Dienst versucht die Gruppe erneut.

Wenn du den Grund nicht deuten kannst, schicke uns den Log-Auszug. Ändere die Daten nicht auf Verdacht.

Logdateien an den Support schicken

Öffne View Logs im Taskleisten-Menü.
Die Datei jtl-klar-sync.log öffnet sich. Notiere den Ordner.
Erstelle ein ZIP-Archiv des Ordners C:\ProgramData\JtlKlarSync\logs\.
Schicke das Archiv an [email protected].

Nenne uns dazu bitte:

Die Version aus dem Taskleisten-Menü.
Die Meldung, die im Taskleisten-Menü steht.
Den Zeitpunkt, an dem das Problem aufgetreten ist.
Die Zahlen aus den Zeilen Synced to Klar und JTL · Klar.
Betroffene Bestellnummern, wenn du welche kennst.

Gut zu wissen: Das Log enthält Bestell-IDs und E-Mail-Adressen. Es enthält nicht den JTL-Wawi-API-Key und nicht den Klar-Token.

Letzte Maßnahmen

⚠️ Warnung: Nutze Factory Reset nur nach Absprache mit dem Support. Er löscht die Konfiguration, den Klar-Token und alle Sync-Positionen. Sichere vorher C:\ProgramData\JtlKlarSync\config.yaml.

Den JTL-Wawi-API-Key bewahrt der Factory Reset auf, weil JTL ihn nicht erneut ausgeben kann. Der Setup-Assistent bietet ihn danach wieder an, sofern er noch funktioniert.

Die Bestellungen in Klar bleiben bei einem Factory Reset erhalten. Ein neuer Sync sendet sie erneut und ersetzt sie über die Bestell-ID. Es entstehen keine Duplikate.

Kommst du nicht weiter, schreib uns an [email protected]. Wir sind im Beta-Test nah dabei.

JTL-Wawi 1.x mit Klar verbinden (Beta)

JTL-Klar-Sync: Fehler beheben (Beta)