JTL-Connector Fehler lösen: die 6 häufigsten Ursachen, was steckt dahinter und wie du den Fehler einkreist

Auf einen Blick

• ✓Aus unserer Praxis: Rund 70 Prozent der Connector-Fehlermeldungen gehen auf drei Ursachen zurück: falsche PHP-Einstellungen, ein nach Update zurückgesetztes Passwort oder eine veraltete Connector-Version.
• ✓Wer den Connector-Tester unter tester.jtl-connector.de als ersten Diagnoseschritt nutzt, spart sich aufwendige Fehlersuche: Das Tool prüft direkt, ob API-Key, URL und SSL stimmen. Ohne Wawi-Zugriff.
• ✓Vlarom E-Commerce Agentur begleitet als JTL Service Partner Gold Händler bei Connector-Problemen auf WooCommerce, Shopware 6, Shopify und PrestaShop, von der ersten Diagnose bis zum stabilen Abgleich.

Wir bei Vlarom E-Commerce Agentur wissen: Wenn der Connector ausfällt, steht der Abgleich still. Bestellungen, Lagerbestände und Artikel bleiben aus dem Takt. Als JTL Service Partner Gold aus Ahrensfelde bei Berlin haben wir in den letzten Jahren Dutzende solcher Situationen gelöst. Der häufigste Fehler den wir sehen: Händler tauschen Symptome aus statt die Ursache zu suchen. Ein strukturierter Diagnoseweg, angefangen beim Connector-Tester, löst das schneller als jede Reinstallation.

Der JTL-Connector ist eine aktiv gepflegte Schnittstelle mit regelmäßigen Releases und einer langen Liste an Kompatibilitätsprüfungen. Trotzdem landen Connector-Fehler unter den häufigsten Themen im JTL-Forum. In unserer Projektarbeit tauchen bei über der Hälfte der Connector-Einsätze innerhalb der ersten sechs Monate mindestens einmal typische Fehlermuster auf. Wohl immer nach einem Shop-Update oder einem Wawi-Versionssprung.

Was wir in fast allen Fällen sehen: kein Bug im Connector selbst, sondern eine Konfigurationsabweichung im Hosting-Umfeld oder eine stille Änderung durch ein Shop-Update.

Die Fehler verteilen sich auf wenige wiederkehrende Muster:

• →PHP-Einstellungen: memory_limit unter 128 MB oder max_execution_time unter 120 Sekunden: beides führt zu abgebrochenen Abgleichen ohne aussagekräftige Fehlermeldung
• →Passwort-Reset nach Update: Sowohl Shop-Updates als auch Connector-Updates können das gespeicherte Passwort zurücksetzen. Wawi und Shop sind danach nicht mehr synchron
• →feature.json-Überschreibung: Bei Connector-Updates wird die feature.json im Verzeichnis jtlconnector/config überschrieben. Individuelle Konfigurationen gehen damit still verloren
• →Versions-Inkompatibilität: Connector-Version und installiertes Shop-Plugin müssen zueinander passen: ein Shopware-6.5-Shop mit einem Connector für 6.3 läuft nicht stabil

Die wichtigste Erkenntnis: Ein stiller Abgleichfehler ist fast nie ein serverseitiger Bug. Fast immer liegt eine Abweichung zwischen Erwartung und tatsächlicher Konfiguration vor. Der strukturierte Diagnoseweg beginnt deshalb nicht mit einer Neuinstallation, sondern mit dem Connector-Tester.

Jedes dieser sechs Fehlerbilder tritt regelmäßig auf, unabhängig davon, ob der Connector mit WooCommerce, Shopware 6, Shopify oder PrestaShop verbunden ist. Die Ursachen unterscheiden sich, die Diagnoseschritte folgen immer dem gleichen Muster.

primary

Connector meldet 0 Bestellungen

Der Abgleich läuft durch, aber in JTL-Wawi kommen keine Bestellungen an. Das Bestellkonto im Shop zeigt dagegen offene Aufträge. Dieses Fehlerbild tritt häufig nach einem Passwort-Reset auf: Shop-Update oder Connector-Update haben das gespeicherte Passwort zurückgesetzt.

Fix: In der JTL-Wawi Verkaufskanalverwaltung das Passwort neu eintragen. Das korrekte Passwort zeigt der Connector im Backend des Shopsystems. Stimmt es, zeigt der Abgleich sofort Ergebnisse. Ein Händler im JTL-Forum: ‚Nach dem Update auf 6.5 kam nichts mehr durch — neues Passwort, sofort lief alles wieder.‘

highlight

Artikel werden nicht übertragen

Der Push-Abgleich bricht bei Varianten-Artikeln oder bei Produkten mit vielen Bildern ab. Ursache ist fast immer ein zu niedriges memory_limit auf dem Server: der Prozess läuft in ein PHP-Speicherlimit und bricht still ab, ohne eine sichtbare Fehlermeldung in der Wawi.

Fix: memory_limit auf mindestens 256 MB setzen, bei Katalogen über 5.000 Artikeln eher 512 MB. Gleichzeitig max_execution_time auf mindestens 120 Sekunden prüfen. Die genauen Fehlermeldungen (‚Fatal error: Allowed memory size of X bytes exhausted‘) stehen im PHP-Error-Log des Servers. Dort zuerst schauen.

warning

PHP-Memory-Limit überschritten

Dieses Problem zeigt sich typisch bei großen Artikelkatalogen: der erste Abgleich nach der Installation läuft durch, aber bei wachsendem Katalog oder bei Varianten-Produkten bricht der Sync irgendwann ab. Die Fehlermeldung lautet ‚Fatal error: Allowed memory size of X bytes exhausted (tried to allocate Y bytes)‘ im PHP-Error-Log.

Fix laut JTL-Guide PHP-Einstellungen: memory_limit mindestens 128 MB, upload_max_filesize mindestens 32 MB. Die Werte lassen sich über die php.ini des Hosts oder über eine .htaccess-Direktive setzen, je nach Hosting-Umgebung unterschiedlich.

muted

feature.json falsch konfiguriert

Die feature.json liegt im Verzeichnis jtlconnector/config und steuert, welche Funktionen der Connector für JTL-Wawi bereitstellt. Pull, Push und Delete lassen sich dort gezielt ein- oder ausschalten. Das Problem: Bei jedem Connector-Update wird diese Datei überschrieben. Individuelle Anpassungen gehen damit still verloren.

Fix: Vor jedem Connector-Update die feature.json sichern. Nach dem Update prüfen, ob alle gewünschten Funktionen noch aktiv sind. Wichtig laut JTL-Dokumentation: Features lassen sich nur aktivieren wenn der Connector durch entsprechende Plugins dafür erweitert wurde. Ein Feature auf ‚true‘ setzen ohne das Plugin bringt keinen Effekt.

primary

Connector-Tester schlägt fehl

Der Connector-Tester unter tester.jtl-connector.de zeigt: SSL-Fehler, falsche API-URL oder Authentifizierungsfehler. Häufige Ursache: Die Shop-URL enthält einen Redirect (z.B. HTTP auf HTTPS, oder eine .htaccess-Weiterleitung), sodass der Connector nicht mit dem richtigen Endpunkt kommuniziert.

Fix: Im Connector-Tester die exakte URL des Connectors eintragen, ohne Redirects. Bei WooCommerce ist das typisch ‚https://domain.de/index.php/jtlconnector/‘ oder ‚https://domain.de/?jtlconnector‘. Bei SSL-Fehlern prüfen, ob das Zertifikat gültig ist und ob der Server TLS 1.2 oder höher unterstützt. Redirects in der .htaccess temporär deaktivieren und testen.

highlight

Nach Shop-Update läuft der Connector nicht mehr

Nach einem Shop-System-Update (WooCommerce, Shopware, PrestaShop) bricht der Abgleich mit ‚Wrong Token‘ oder ‚Invalid Request‘ ab. Ursache: Das Connector-Plugin ist mit der neuen Shop-Version nicht kompatibel, oder das Update hat das gespeicherte Passwort zurückgesetzt.

Fix: Zuerst das Passwort prüfen und bei Bedarf neu eintragen. Dann die Connector-Version gegen die Kompatibilitätsmatrix prüfen: WooCommerce bis Version 8.x, Shopware 6 bis 6.6, PrestaShop bis 8.1 werden laut JTL-Guide unterstützten Versionen abgedeckt. Passt die Version, Connector-Plugin neu installieren ohne Deinstallation der Konfiguration.

Strukturierte Diagnose statt Neuinstallation

Wer den Connector-Tester als ersten Schritt nutzt, schließt in wenigen Minuten die häufigsten Ursachen aus. In unserer Projektpraxis lösen sich etwa 60 Prozent aller Connector-Tickets bereits in Schritt 1 oder 2 des Diagnosewegs, ohne Neuinstallation, ohne Entwickler-Aufwand.

Kein Datenverlust durch Blindflug-Fixes

Eine Neuinstallation ohne Diagnose birgt das Risiko, Connector-Konfigurationen und feature.json-Einstellungen zu verlieren. Wer systematisch vorgeht, erhält den Ist-Zustand und weiß danach genau, was geändert wurde.

Dieser Diagnoseweg funktioniert unabhängig vom eingesetzten Shop-System. Wir gehen ihn durch, bevor wir eine Neuinstallation in Betracht ziehen. In den meisten Fällen ist der Fehler nach Schritt 2 oder 3 identifiziert.

Gehe zu tester.jtl-connector.de und gib die Connector-URL sowie das aktuelle Passwort ein. Das Tool prüft Erreichbarkeit, SSL, Authentifizierung und grundlegende Connector-Funktionen, ohne JTL-Wawi-Zugriff. Ein Fehler hier zeigt direkt: URL falsch, Passwort falsch, SSL-Problem oder Redirect-Konflikt. Erst wenn der Tester grünes Licht gibt, hat das Problem eine andere Ursache. Achtung: Push-Funktionen im Tester nur mit Bedacht ausführen, ein versehentlicher Push kann Shop-Daten überschreiben.

Das PHP-Error-Log des Webservers ist der direkte Blick in den Connector-Fehler. Typische Einträge: ‚Fatal error: Allowed memory size exhausted‘ (memory_limit zu niedrig), ‚Maximum execution time exceeded‘ (max_execution_time zu kurz) oder ‚Invalid Request‘ (Passwort-Problem). Der Speicherort des Logs variiert je nach Hosting: bei cPanel typisch unter /home/user/logs/, bei Plesk im Webspace-Bereich, beim Root-Server unter /var/log/php_errors.log.

Prüfe und korrigiere die drei kritischen PHP-Werte: memory_limit mindestens 128 MB (bei großen Katalogen 256-512 MB), max_execution_time mindestens 120 Sekunden, upload_max_filesize mindestens 32 MB. Die vollständigen Mindestanforderungen sind im JTL-Guide zu PHP-Einstellungen dokumentiert. Die Einstellungen lassen sich über php.ini, .htaccess oder das Hosting-Control-Panel anpassen.

Öffne die feature.json im Verzeichnis jtlconnector/config und prüfe, ob alle benötigten Funktionen aktiv sind. Prüfe gleichzeitig im Shop-Backend das aktuelle Connector-Passwort und vergleiche es mit dem in der JTL-Wawi Verkaufskanalverwaltung eingetragenen Wert. Bei Abweichung: neues Passwort in Wawi eintragen. Diese beiden Checks lösen einen erheblichen Anteil aller Connector-Fehler nach Updates.

Prüfe, welche Connector-Version installiert ist und ob sie mit der aktuellen Shop-Version kompatibel ist. Die aktuelle Kompatibilitätsmatrix ist auf guide.jtl-software.com/jtl-connector/unterstuetzte-versionen/ dokumentiert. Bei Inkompatibilität: Connector-Plugin auf die passende Version aktualisieren. Bei WooCommerce: das ‚woo-jtl-connector‘-Plugin über das WP-Plugin-Verzeichnis oder manuell aktualisieren. Danach: Passwort erneut prüfen, da ein Plugin-Update es zurücksetzen kann.

Autor

Alexander Luft

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