Dieser Artikel gehört zu JTL-Wawi 1.x mit Klar verbinden. 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	Bestellungen, die das Programm noch einmal versucht. Alles außer 0 blockiert neue Bestellungen.
Validation errors	Bestellungen, die Klar abgelehnt hat und die das Programm aufgegeben hat. Sie blockieren nichts, fehlen aber in Klar.
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.
Loading customers, 12.000 of 89.000 und ähnliche Sätze	Der Dienst lädt beim Start seine Nachschlagelisten. Das ist kein Fehler.	Warte, bis der Start fertig ist. Bei sehr großen Installationen dauert das einige Minuten.
Cannot reach JTL-Wawi at http://127.0.0.1:5883. Is JTL-Wawi running?	Der JTL-API-Server antwortet beim Start nicht	Starte JTL-Wawi und den JTL-API-Server. Prüfe danach die API URL im Einstellungsfenster mit Test connection.
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.
Cannot determine service state	Der Zustand des Dienstes ließ sich nicht abfragen	Prüfe den Dienst `JtlKlarSync` in `services.msc`.

Abgelehnte Bestellungen

Klar prüft jede Bestellung. Lehnt Klar eine Bestellung mehrfach ab, gibt das Programm sie auf und zählt sie in der Zeile Validation errors. Diese Bestellungen blockieren den Sync nicht — sie fehlen aber in Klar.

So gehst du vor:

Öffne View Logs im Taskleisten-Menü.
Suche nach der Bestellnummer oder nach dem Wort reject. Das Log nennt für jede abgelehnte Bestellung das Feld und den Grund.
Korrigiere die Bestellung in JTL-Wawi, wenn dort etwas fehlt oder falsch ist.
Klicke auf Re-export orders with validation errors im Taskleisten-Menü. Das Programm liest genau diese Bestellungen neu aus JTL-Wawi und sendet sie einmal.

Gut zu wissen: Der Menüpunkt ist ausgegraut, solange Validation errors auf 0 steht. Was nach dem Re-Export weiterhin abgelehnt wird, bleibt in der Liste.

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

Wenn Zahlen nicht stimmen

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.
In Klar fehlen alte Bestellungen	Der beim Setup gewählte Startmonat liegt später, oder im Einstellungsfenster steht ein Earliest order date	Prüfe Earliest order date im Einstellungsfenster. Hole den Zeitraum danach mit Re-import a date range… im Taskleisten-Menü nach.
Erstattungen fehlen oder sind zu niedrig	Gutschriften ohne zugehörige Retoure wurden früher nicht übertragen	Ab Version 1.0.0 werden sie übertragen. Für bestehende Bestellungen brauchst du einmalig Re-export: full refresh from JTL.
Erstattete Versandkosten fehlen in Klar	Klar erfasst Erstattungen pro Artikel. Versandkosten- und Gutscheinzeilen einer Gutschrift werden deshalb nicht übertragen.	Das ist so vorgesehen. Erstattete Artikel und Mengen stimmen, erstattete Versandkosten sind in Klar nicht abgebildet.
Ein Verkaufskanal heißt in Klar Online-Shop 2	JTL-Wawi nennt den Namen dieses Shops nicht über die API — typisch für B2B-Shops und für gelöschte Shops	Das ist kein Fehler. Ist der Shop aktiv und trotzdem unbenannt, melde ihn uns mit seiner Nummer.
Verkaufskanal- oder Plattformnamen fehlen für ältere Bestellungen	Namen und Plattform kamen erst mit Version 1.0.0 dazu. Ein umbenannter Shop löst allein keine Neuübertragung aus.	Einmalig Re-export: full refresh from JTL ausführen.
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.

Probleme bei Installation und Einrichtung

Symptom	Ursache	Maßnahme
Der Setup-Assistent oder das Einstellungsfenster öffnet sich nicht	Der Grafiktreiber liefert kein OpenGL 2.1 — typisch auf Windows Server und über Remotedesktop	Führe den Installer erneut aus und setze auf der Komponenten-Seite den Haken bei Software OpenGL.
Nach dem Setzen von Software OpenGL ruckeln die Fenster	Die Software-Darstellung ist langsamer als ein echter Treiber	Auf einem normalen PC den Haken wieder entfernen und neu installieren. Der Installer entfernt die Software-Darstellung dabei.
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.
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.
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.
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

Das Programm sucht täglich nach neuen Versionen und bietet sie im Taskleisten-Menü an. Du musst dafür nichts einstellen.

Symptom oder Meldung	Ursache	Maßnahme
Das Programm meldet nie ein Update	Die Installation stammt aus der Beta-Phase und prüft nicht auf Updates	Einmalig den aktuellen Installer von update.getklar.com ausführen. Danach aktualisiert sich das Programm selbst.
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.

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, Errors und Validation errors.
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].

JTL-Klar-Sync: Fehler beheben