TwoPixelsBeleg-StudioTwoPixels GmbH
← Alle Artikel
21. Juni 2026JTL

JTL-Connector richtig einrichten — Schritt für Schritt

Wer JTL-Wawi als Warenwirtschaft betreibt und gleichzeitig einen Online-Shop führt, steht früher oder später vor der Frage: Wie halte ich Artikel, Bestände und Bestellungen synchron — ohne manuelle Doppelpflege? Die Antwort ist der JTL-Connector. Was er tut, was dafür nötig ist und wo die Einrichtung typischerweise hakt, erfahren Sie hier.

Was der JTL-Connector tut

Der JTL-Connector ist die Brücke zwischen JTL-Wawi und Ihrem Online-Shop. Er sorgt dafür, dass:

  • Artikel und Produktdaten aus der Wawi automatisch in den Shop übertragen werden
  • Lagerbestände in Echtzeit (oder im Takt) synchronisiert bleiben
  • Bestellungen aus dem Shop in die Wawi importiert werden
  • Preisänderungen und Kategorie-Zuordnungen übernommen werden

Ohne Connector bedeutet das alles: manuelle Arbeit, Doppelpflege, Fehler.

Voraussetzungen

Bevor die Einrichtung beginnt, sollten folgende Punkte erfüllt sein:

  • JTL-Wawi in einer aktuellen Version (mindestens 1.6.x empfohlen)
  • Ein kompatibler Online-Shop — der Connector unterstützt verschiedene Shop-Systeme; bei Shopify oder eigenen Lösungen ist die Anbindung komplexer
  • Ein Webserver mit PHP und Datenbankzugang für den Connector-Endpunkt
  • Zugangsdaten für Shop und Wawi-Datenbank
  • Grundlegendes Verständnis von Kategoriestrukturen auf beiden Seiten

Die wichtigsten Einrichtungsschritte

1. Connector-Plugin im Shop installieren

Je nach Shop-System gibt es ein offizielles Plugin oder eine API-Anbindung. Dieses wird auf dem Webserver des Shops installiert und erzeugt einen Endpunkt, über den die Wawi kommuniziert.

2. Verbindung in der Wawi anlegen

In der JTL-Wawi wird unter „Verkaufskanäle" ein neuer Shop angelegt. Dort trägt man die URL des Connector-Endpunkts und einen Zugriffsschlüssel ein. Eine Test-Verbindung zeigt, ob die Kommunikation funktioniert.

3. Kategorien und Attribute mappen

Das ist oft der aufwändigste Schritt: Die Kategoriestruktur in der Wawi muss auf die Struktur im Shop abgebildet werden. Kategorie-Namen, Hierarchien und Attribute können sich unterscheiden. Hier entstehen die meisten Fehler bei der Ersteinrichtung.

4. Ersten Abgleich durchführen

Nach dem Mapping wird ein initialer Abgleich gestartet. Dabei werden alle Artikel aus der Wawi in den Shop übertragen. Das kann je nach Artikelanzahl einige Minuten bis Stunden dauern.

5. Abgleich-Intervall konfigurieren

Im laufenden Betrieb legt man fest, wie oft synchronisiert wird. Für die meisten kleinen Shops reicht ein stündlicher Abgleich. Bei zeitkritischen Beständen (z. B. bei wenigen Exemplaren) empfiehlt sich ein kürzeres Intervall.

Häufige Stolperfallen

Kategorien stimmen nicht überein

Wenn Artikel im Shop in falschen Kategorien landen oder gar nicht erscheinen, liegt es fast immer am Kategorie-Mapping. Prüfen Sie vor dem ersten Abgleich sorgfältig, ob alle Ebenen korrekt zugeordnet sind.

Bilder werden nicht übertragen

Produktbilder liegen in der Wawi lokal vor. Damit sie korrekt übertragen werden, müssen Pfade stimmen und der Webserver des Shops muss die Bilder annehmen können. Firewall-Regeln oder falsche Berechtigungen blockieren das häufig.

Bestände weichen ab

Wenn Bestände im Shop nicht stimmen, ist oft ein doppelter Abgleich-Prozess das Problem — beispielsweise wenn ein alter Cron-Job parallel läuft. Lassen Sie nur einen definierten Prozess synchronisieren.

Bestellungen kommen nicht an

Wenn Bestellungen aus dem Shop nicht in der Wawi ankommen, liegt es meist an einem Timeout oder einer fehlerhaften Endpunkt-Konfiguration. Logs des Connector-Endpunkts geben Aufschluss.

Wann sich professionelle Einrichtung lohnt

Die Einrichtung des Connectors ist technisch machbar — aber sie kostet Zeit und setzt voraus, dass man die Strukturen auf beiden Seiten gut kennt. Wer schon beim ersten Abgleich Fehler macht, riskiert fehlerhafte Artikel, falsche Bestände oder doppelte Bestellungen.

JTL-Connector-Setup professionell einrichten lassen bedeutet: Ein erfahrener Techniker übernimmt Mapping, Testabgleich und Feintuning — und Sie bekommen eine funktionierende Anbindung ohne Trial-and-Error.

Betreiben Sie ein Gastronomie-Konzept mit besonderen Anforderungen an Artikel und Varianten? Dann lohnt ein Blick auf das spezialisierte JTL-Gastronomie-Paket, das zusätzliche Branchenanforderungen berücksichtigt.

Fazit

Ein korrekt eingerichteter JTL-Connector spart täglich Zeit und verhindert Fehler, die im Lager und beim Kunden ankommen. Die Einrichtung ist kein Hexenwerk — aber sie verlangt Sorgfalt beim Mapping und ein gutes Verständnis beider Systeme. Wer sichergehen will, setzt auf professionelle Einrichtung.

Fragen zur Anbindung? Schreiben Sie uns: info@webagentur-twopixels.de oder buchen Sie direkt den JTL-Connector-Setup.


Fragen oder Unterstützung gewünscht?

Die TwoPixels GmbH hilft dir bei JTL, Shop-Templates, Hosting und IT-Sicherheit — persönlich und unverbindlich.

Jetzt Kontakt aufnehmenZum Shop-Katalog →