Der JTL-Connector ist die Schnittstelle, über die eine JTL-Wawi mit einem Shopsystem spricht, das nicht aus dem Hause JTL stammt. Wer vor der Entscheidung für ein Shopsystem steht oder einen bestehenden Shop anbinden will, sollte zwei Dinge wissen: welche Systeme überhaupt offiziell unterstützt werden — und bei welchen die Unterstützung inzwischen eingestellt ist.
Der JTL-Shop braucht keinen Connector
Ein Missverständnis vorweg, das in Projektgesprächen regelmäßig auftaucht: Für den JTL-Shop wird kein Connector benötigt. Er ist nativ an die Wawi angebunden, der Abgleich läuft direkt. Der Connector ist ausschließlich für Fremdshops gedacht.
Das ist auch das stärkste Argument für den JTL-Shop, wenn ohnehin die Wawi im Einsatz ist: ein bewegliches Teil weniger in der Kette, das bei Updates beider Seiten Aufmerksamkeit braucht.
Die vier offiziell unterstützten Systeme
JTL stellt derzeit Connectoren für vier Shopsysteme bereit — und zwar in zwei technisch sehr unterschiedlichen Varianten.
Von JTL gehostet (Software as a Service):
- Shopware 6
- Shopify
Bei diesen beiden läuft der Connector auf Servern von JTL. Wartung, Updates, Monitoring und Skalierung liegen damit beim Hersteller. Für Sie bedeutet das weniger Betriebsverantwortung — und weniger Möglichkeiten, selbst einzugreifen, wenn etwas klemmt.
Selbst gehostet:
- WooCommerce
- PrestaShop
Hier läuft der Connector als Erweiterung auf Ihrem eigenen Webserver. Sie haben vollen Zugriff auf Logs und Konfiguration, tragen dafür aber die Verantwortung für PHP-Version, Speichergrenzen und Aktualisierungen. Für diese beiden Connectoren wird mindestens PHP 8.1 vorausgesetzt.
Der Unterschied ist bei der Systemwahl wichtiger, als er zunächst klingt: Er entscheidet, wer im Störungsfall am Hebel sitzt.
Welche Anbindungen abgekündigt sind
Diese Information fehlt in den meisten Vergleichsartikeln, ist aber für eine Systementscheidung zentral. JTL hat die Unterstützung für mehrere Shopsysteme eingestellt:
- Shopware 5 — abgekündigt zum Ende der offiziellen Shopware-5-Unterstützung
- Gambio
- modified
- OXID
Diese Connectoren funktionieren teilweise weiter, erhalten aber keine Weiterentwicklung und keinen Support mehr — und ausdrücklich auch keine Sicherheits- und Fehlerbehebungen. Anforderungen dieser Schnittstellen fließen nicht mehr in die Wawi-Entwicklung ein.
Für Magento bietet JTL ebenfalls keinen eigenen Connector mehr an.
Wenn Sie eines dieser Systeme einsetzen, sollten Sie das nicht als Randnotiz behandeln. Eine Schnittstelle ohne Sicherheitsaktualisierungen ist mittelfristig ein Risiko, und die Frage nach dem Wechsel des Shopsystems oder einer Anbindung über einen Drittanbieter stellt sich früher, als der laufende Betrieb vermuten lässt.
Wer den Abgleich anstößt
Für das Verständnis von Störungen ist die Rollenverteilung entscheidend, und sie wird oft falsch herum gedacht.
Der aktive Teil liegt bei der Wawi. Der JTL-Worker ist ein Hintergrunddienst auf der Wawi-Seite, der die Abgleiche ausführt. JTL empfiehlt, ihn auf demselben Server zu betreiben, auf dem auch die Datenbank liegt, und ihn durchgehend laufen zu lassen.
Der Connector ist der passive Endpunkt auf der Shop-Seite. In der Wawi werden dessen Adresse und ein Token hinterlegt; damit baut der Worker die Verbindung auf.
Daraus folgt eine praktische Regel für die Fehlersuche: Wenn nichts abgeglichen wird, ist die erste Frage nicht „was ist mit dem Shop”, sondern „läuft der Worker überhaupt, und erreicht er den Connector”.
Beim Abgleich fließen Bestellungen aus dem Shop in die Wawi, während in der Gegenrichtung geänderte Artikel, Kategorien, Preise und Statusänderungen an den Shop gehen.
Die häufigsten Fehlerquellen
JTL dokumentiert eine Reihe wiederkehrender Ursachen, und sie decken sich weitgehend mit dem, was uns in Projekten begegnet:
- Fehlende PHP-Erweiterungen — insbesondere JSON, PHAR und SQLite3
- Zu niedriges Speicherlimit in PHP
- Falsche Adresse oder falscher Token in der Verkaufskanal-Konfiguration
- Wartungsmodus oder Zugriffsschutz des Shops, der den Connector aussperrt
- Fehlerhafte Weiterleitungen in der Webserver-Konfiguration
- Passwortschutz des Adminbereichs, der auch den Connector blockiert
Für den JTL-Shop selbst gelten zusätzlich klare Mindestwerte: ein Speicherlimit von mindestens 128 MB und eine maximale Skriptlaufzeit von mindestens 120 Sekunden. Ab Shop-Version 5.7 wird mindestens PHP 8.3 vorausgesetzt.
Aus unserer eigenen Projekterfahrung kommt eine Ergänzung, die nicht in der Herstellerdokumentation steht: Bei größeren Artikelstämmen reichen die Mindestwerte häufig nicht. Wer regelmäßig Abbrüche beim Komplettabgleich sieht, sollte Speicherlimit und Laufzeit großzügiger setzen und die Datenmenge je Durchlauf reduzieren, statt die Ursache im Shop zu suchen.
Komplettabgleich mit Bedacht einsetzen
Ein Komplettabgleich überträgt alle ausgewählten Daten unabhängig davon, ob sie sich geändert haben. Das ist das Mittel der Wahl nach einer Neueinrichtung oder wenn Stände auseinandergelaufen sind — im Alltag aber unnötig teuer.
JTL weist ausdrücklich darauf hin, dass die Dauer mit jedem aktivierten Objekt steigt, und empfiehlt, nur das zu aktivieren, was tatsächlich aktualisiert werden muss. Wer einen Komplettabgleich über den gesamten Artikelstamm zur Gewohnheit macht, erzeugt damit einen erheblichen Teil der Abbrüche, über die er sich später beschwert.
Häufig gestellte Fragen
Welche Shopsysteme unterstützt JTL offiziell? Derzeit vier: Shopware 6 und Shopify als von JTL gehostete Dienste sowie WooCommerce und PrestaShop als selbst gehostete Connectoren. Für den JTL-Shop wird kein Connector benötigt, er ist nativ angebunden.
Gibt es noch einen Connector für Shopware 5 oder Magento? Der Shopware-5-Connector ist abgekündigt, ebenso die Anbindungen für Gambio, modified und OXID. Sie funktionieren teilweise weiter, erhalten aber keine Weiterentwicklung und keine Sicherheitsaktualisierungen mehr. Für Magento bietet JTL keinen eigenen Connector mehr an.
Läuft der JTL-Worker auf dem Shop-Server? Nein. Der Worker ist ein Dienst auf der Wawi-Seite; JTL empfiehlt den Betrieb auf demselben Server wie die Datenbank. Der Connector auf der Shop-Seite ist der passive Endpunkt, den der Worker anspricht.
Warum bricht der Abgleich bei vielen Artikeln ab? Meist wegen zu knapper PHP-Grenzwerte auf der Shop-Seite — Speicherlimit und maximale Skriptlaufzeit. Der zweite häufige Grund ist ein Komplettabgleich mit zu vielen aktivierten Objekten. Beides lässt sich einstellen, bevor man die Ursache im Datenbestand sucht.
Ihr Abgleich bricht ab oder Sie stehen vor einem Shopsystem, dessen Connector abgekündigt wurde? Wir prüfen die Anbindung entlang des Worker-Protokolls und sagen Ihnen, ob sich eine Reparatur lohnt oder ein Wechsel der günstigere Weg ist — mehr dazu unter JTL-Entwickler.
