DE
EN
Wir arbeiten mit JTL-Wawi und bauen jetzt einen Shopware-6-Shop — wie kommen die Artikel da rein?“ Diese Frage kommt inzwischen fast wöchentlich. Die gute Nachricht vorweg: Es gibt einen offiziellen Connector, er ist stabil, und für Shopware 6 kostet er keine Lizenzgebühr. Die weniger gute: Zwischen „installiert“ und „läuft sauber“ liegen ein paar Stolperfallen, die sich hartnäckig halten — und die fast alle mit einem einzigen Denkfehler zusammenhängen.
Dieser Beitrag beschreibt, was der JTL-Connector für Shopware 6 leistet, wie die Einrichtung tatsächlich abläuft, und welche fünf Probleme in der Praxis regelmäßig Zeit kosten. Er ist bewusst technisch — wer stattdessen wissen möchte, was ein Shopware-Projekt insgesamt umfasst, Ablauf, Leistungen und Preise inklusive, findet das bei unserer Shopware Entwicklung und Migration. Und wer dieselbe Frage für Magento 2 hat: Dafür gibt es einen eigenen Praxisguide zur JTL-Anbindung an Magento.
Was der JTL-Connector für Shopware 6 heute wirklich leistet
Der JTL-Connector ist keine Erweiterung, die Sie in Shopware installieren und dann vergessen. Er ist eine Middleware: ein Vermittler, der zwischen JTL-Wawi und dem Shop sitzt, in beide Richtungen spricht und dabei entscheidet, welches System bei welchem Datensatz recht hat.
Synchronisiert werden Artikel samt Beschreibungen, Bildern, Varianten und Kategorien, dazu Bestände und Preise, Kundendaten mit Adressen und Kontaktdaten sowie Bestellungen inklusive Status. Auch shopware-spezifische Felder wie Metaangaben lassen sich befüllen. Für Shopware 6 fällt dabei keine Lizenzgebühr an — abgerechnet wird über auftragsbasierte Pakete, und mehrere Shopware-Instanzen dürfen an derselben JTL-Wawi hängen, ohne dass es teurer wird. Die Einzelheiten dazu stehen in der offiziellen Übersicht zur Shopware-Schnittstelle von JTL.
Was er nicht ist: eine Zwei-Wege-Straße für alles. Nach dem ersten vollständigen Abgleich führt die Warenwirtschaft. Das steht so in der Dokumentation, es klingt harmlos, und es ist der wichtigste Satz des ganzen Themas. Warum, dazu gleich mehr.
Drei Wege, JTL-Wawi und Shopware 6 zu verbinden
Bevor es an Zugangsdaten geht, lohnt die Grundsatzentscheidung. Es gibt drei Wege, und sie unterscheiden sich weniger im Ergebnis als im Aufwand und darin, wem später ein Fehler gehört.
Weg eins: der offizielle JTL-Connector. Der Standardweg und für die meisten Shops der richtige. Er ist dokumentiert, wird gepflegt, deckt Artikel, Bestände, Preise, Kunden und Bestellungen ab, und wenn etwas klemmt, gibt es einen Support, der zuständig ist. Der Preis dafür ist ein festes Datenmodell: Was er nicht vorsieht, kommt auch nicht durch.
Weg zwei: eine eigene Anbindung über die Shopware-Admin-API. Shopware 6 ist API-first gebaut, die Admin-API deckt praktisch den gesamten Datenbestand ab. Damit lässt sich alles abbilden, was das Geschäft verlangt — auch Felder, Preislogiken und Abläufe, die der Standard nicht kennt. Der Preis ist Verantwortung: Jedes Shopware-Update, jede Änderung im Wawi-Datenmodell ist dann Ihre Baustelle. Für einen normalen B2C-Shop lohnt das nicht.
Weg drei: Connector plus schmale Ergänzung. Der Standardweg trägt die Masse — Artikel, Bestände, Bestellungen — und ein zusätzlicher, klar abgegrenzter Abgleich kümmert sich um die zwei, drei Dinge, die das Geschäft besonders machen. Etwa kundenindividuelle Preise aus einem B2B-Szenario oder ein zusätzliches Feld, das die Produktion braucht. Nach unserer Erfahrung ist das in gewachsenen Mittelstandsbetrieben der häufigste Fall.
Eine Empfehlung dazu: Fangen Sie nicht mit Weg zwei an, weil ein einzelnes Feld fehlt. Prüfen Sie erst, ob das Feld nicht doch über die Attribut- und Zusatzfelder abbildbar ist — der Standard kann mehr, als seine Oberfläche vermuten lässt.
Wie richte ich den JTL-Connector für Shopware 6 ein?
Die Einrichtung verteilt sich auf drei Oberflächen, und das ist der Grund, warum sie beim ersten Mal länger dauert als gedacht. Man springt zwischen Shopware-Backend, JTL-Kundencenter und JTL-Wawi hin und her, und jeder Schritt liefert einen Wert, den der nächste braucht.
Schritt eins, im Shopware-Backend: Unter Einstellungen → System → Integrationen legen Sie eine neue Integration an. Shopware erzeugt daraufhin eine Zugangs-ID und einen Sicherheitsschlüssel. Beides notieren — der Schlüssel wird nur einmal angezeigt.
Schritt zwei, im JTL-Kundencenter: Unter den Shop-Connectoren tragen Sie Shop-URL, Zugangs-ID und Sicherheitsschlüssel ein und buchen die Connector-Lizenz. Zurück bekommen Sie eine Connector-URL und einen Token.
Schritt drei, in JTL-Wawi: Unter Plattformen → Verkaufskanäle legen Sie einen neuen Verkaufskanal vom Typ „JTL-Connector“ an, tragen URL und Token ein und starten den Verbindungstest. Die ausführliche Anleitung mit allen Feldern steht im JTL-Guide zur Anbindung von Shopware 6 über den JTL-Connector.
Zwei Voraussetzungen, die gern übersehen werden: Der Connector läuft grundsätzlich ab JTL-Wawi 1.0, empfohlen werden aber Versionen ab 1.5.27.1 — bei älteren Ständen sollten Sie zuerst die Wawi aktualisieren, nicht den Connector debuggen. Und die Dokumentation sagt an einer Stelle sehr deutlich: Sichern Sie die JTL-Wawi-Datenbank, bevor der Connector das erste Mal läuft. Das ist kein Formalsatz.
Wichtig für das Verständnis der Struktur: Der Connector hängt an einem Verkaufskanal. Shopware 6 trennt Datenbestand und Verkaufskanal konsequent — derselbe Artikel kann in mehreren Kanälen mit unterschiedlicher Sichtbarkeit, Sprache und Währung liegen. Wie Shopware das organisiert, beschreibt die Shopware-Dokumentation zu Verkaufskanälen. Wer das vorher nicht sortiert hat, wundert sich später, warum Artikel zwar in der Datenbank stehen, im Shop aber niemand sie findet.
Der eine Satz, der alle Fallen erklärt
Nach dem Erstabgleich führt JTL-Wawi. Alle Pflege findet ab diesem Moment in der Warenwirtschaft statt, nicht mehr im Shop.
Klingt nach einer Empfehlung. Ist aber eine Architekturaussage. Der Connector hält den Shop-Zustand gegen den Wawi-Zustand — was er im Shop findet und in der Wawi nicht kennt, ist für ihn kein Bestand, sondern eine Abweichung. Fast jedes „der Connector hat mir etwas zerschossen“ lässt sich darauf zurückführen, dass jemand nach der Inbetriebnahme noch im Shopware-Backend gepflegt hat: eine Kategorie umbenannt, eine Eigenschaft angelegt, ein Bild getauscht.
Wenn Ihr Team also bisher gern direkt im Shop gearbeitet hat, ist die Anbindung nicht nur ein technisches, sondern auch ein organisatorisches Projekt. Diesen Teil sollten Sie einplanen, bevor der erste Abgleich läuft — nicht danach.
Welche Probleme treten bei der JTL-Shopware-Anbindung am häufigsten auf?
1. Der Vaterartikel steht plötzlich selbst im Shop
Der Klassiker bei Variantenartikeln: In JTL-Wawi ist der Vaterartikel eine reine Hülle — kein Preis, kein Bestand, kein eigenes Bild, die Verkaufsdaten liegen bei den Kindern. Nach dem Abgleich taucht er in der Storefront trotzdem als eigenständiges, kaufbares Produkt auf: 0 Euro, kein Bild, ein Bestand, der mit nichts zusammenpasst.
Der Grund ist ein Modellunterschied. Shopware 6 kennt einen Elternartikel mit Varianten, deren Sichtbarkeit von der Konfiguration abhängt. Prüfen Sie deshalb vor dem Live-Gang gezielt einen Variantenartikel in der Storefront — nicht im Backend, sondern so, wie ein Kunde ihn sieht. Verwandt und ebenfalls dokumentiert: Wenn bei Variationsartikeln der Name des Kindartikels statt des Vaterartikels erscheint, lässt sich im JTL-Kundencenter einstellen, dass Kindartikel den Namen des Vaterartikels übernehmen — danach ist ein Komplettabgleich nötig.
2. Merkmale und Variationen kollidieren
Diese Fehlermeldung sehen Sie früher oder später: „The delete request for property_group_option was denied due to a conflict. The entity is currently in use by: product_option.“
Dahinter steckt kein Bug, sondern ein Datenmodellkonflikt. JTL-Wawi verwaltet Merkmale und Variationen getrennt voneinander. Shopware 6 führt beides in derselben Tabellenstruktur — eine Eigenschaft, die als Variantenachse benutzt wird, lässt sich nicht einfach löschen, solange ein Produkt sie als Option führt. Wenn dieselbe Ausprägung, sagen wir „Farbe: Rot“, in der Wawi einmal als Merkmal und einmal als Variation existiert, treffen sich beide in Shopware an derselben Stelle und blockieren sich gegenseitig.
Die dokumentierte Lösung führt über den JTL-Support: Die Eigenschaften werden auf Datenbankebene gelöst und entfernt, danach folgt ein Komplettabgleich. Deutlich angenehmer ist die Vorbeugung — vor dem ersten Abgleich in der Wawi klären, welche Ausprägungen Variationsachse sein sollen und welche reine Merkmale bleiben. Diese halbe Stunde spart Ihnen später einen Support-Fall.
3. In Shopware gelöschte Kategorien
Wird eine Kategorie direkt in Shopware gelöscht statt über die Warenwirtschaft, verliert der Connector die Zuordnung und meldet beim nächsten Lauf Fehler. Die Reparatur ist unspektakulär — ein Komplettabgleich der Kategorien setzt den Zustand neu — kostet aber je nach Katalogtiefe Zeit. Siehe wieder: Nach dem Erstabgleich führt die Wawi.
Nebenbei ein nützliches Detail für alle, die mit Erlebniswelten arbeiten: Ein individuelles Layout lässt sich einer Kategorie zuweisen, indem in den Kategoriestammdaten das Attribut cms_page.name mit dem Namen des gewünschten Layouts gefüllt wird.
4. Eine Sprache, die später dazukommt
Mehrsprachigkeit nachträglich einzuschalten ist die unangenehmste der fünf Fallen. Eigenschaften gelten in Shopware artikelübergreifend — kommt eine Sprache später hinzu, lassen sich die bestehenden Eigenschaften nicht sauber nachübersetzen. Der dokumentierte Weg: sämtliche Eigenschaften im Shop löschen und einen Komplettabgleich fahren.
Bei einem Katalog mit ein paar hundert Artikeln ist das ein Nachmittag. Bei mehreren zehntausend ist es ein Projekt. Wenn Mehrsprachigkeit auch nur als Möglichkeit im Raum steht, richten Sie sie vor dem ersten Abgleich ein.
5. Lieferzeiten, die nicht ankommen
Die im Shop angezeigte Lieferzeit stammt aus dem Lieferstatus in JTL-Wawi — und die Zuordnung läuft über den Namen. Heißt der Lieferstatus in der Wawi anders als in Shopware, passiert schlicht nichts. Kein Fehler, keine Meldung, nur eine fehlende Angabe im Shop. Diese und weitere Fälle sind in der FAQ zum JTL-Connector für Shopware 6 beschrieben, die vor jedem Live-Gang einen Blick wert ist.
Reicht der Standard-Connector, oder brauchen wir eine eigene Anbindung?
Für einen typischen B2C-Shop mit überschaubarem Sortiment, einer Sprache, einer Währung und normalen Varianten reicht der Standard-Connector. Genau dafür ist er gebaut, und er macht seine Arbeit ordentlich.
Enger wird es, wenn mehrere dieser Punkte zusammenkommen: kundenindividuelle Preise und Kundengruppen aus einem B2B-Szenario, Stücklisten oder Konfigurationen, mehrere Lager mit eigener Verfügbarkeitslogik, Marktplätze parallel zum Shop, oder Felder, die es im Standarddatenmodell schlicht nicht gibt. Dann ist die Frage nicht mehr „Connector oder nicht“, sondern „Connector plus was“ — ein ergänzender Abgleich für die Sonderfälle, während der Standardweg den Rest trägt.
Das ist übrigens der Regelfall in unseren Projekten: nicht Standard oder Eigenbau, sondern Standard und eine schmale Ergänzung dort, wo das Geschäft von der Norm abweicht. Welche Systeme wir sonst noch an Shops anbinden, steht in der Übersicht zur Warenwirtschafts- und ERP-Anbindung.
Wir nutzen JTL-Wawi und stehen vor der Systemwahl — spricht das für Shopware?
Auf die Connector-Frage bezogen: ja, ziemlich deutlich. Und das ist ein Punkt, über den erstaunlich wenig geschrieben wird.
Für Shopware 6 pflegt JTL einen eigenen Connector, ohne Lizenzgebühr. Für Magento sieht es anders aus: JTL hat den eigenen Magento-Connector 2017 eingestellt. Wer ihn davor aktiviert hatte, kann ihn weiter nutzen; für alle anderen führt der Weg über Drittanbieter — die Geld kosten und selbst wieder eingestellt werden können. Das ist kein Detail, sondern eine Frage der Abhängigkeit: Bei Shopware liegt die Schnittstelle beim Hersteller der Warenwirtschaft, bei Magento bei einem Dritten.
Zwei Einschränkungen, damit das nicht falsch ankommt. Erstens: Wer einen laufenden Magento-Shop betreibt, hat damit keinen Grund zu migrieren — Anbindungen an Magento funktionieren, sie sehen nur anders aus. Wie, steht in unserem Praxisguide zur JTL-Anbindung an Magento. Zweitens: Die Systemwahl hängt an deutlich mehr als der Warenwirtschaft — B2B-Logik, Redaktion, Mehrsprachigkeit, vorhandenes Team. Der Connector ist ein Argument, nicht das Argument.
Wir bauen beides und verdienen an beidem. Genau deshalb sagen wir es so: Wenn JTL-Wawi gesetzt ist und das Shopsystem noch nicht, ist Shopware 6 an dieser Stelle der bequemere Weg.
Ein Wort zu Shopware 5
Anbindungen an Shopware 5 funktionieren technisch weiterhin, aber die Version gilt als abgekündigt: keine Funktions- und keine Sicherheitsupdates aus dem Standard. Wer noch auf 5 läuft und ohnehin über die JTL-Anbindung nachdenkt, sollte beides zusammen betrachten. Eine Anbindung, die auf einem auslaufenden System aufsetzt, ist Arbeit, die man in absehbarer Zeit ein zweites Mal macht.
Häufige Fragen zur JTL-Wawi-Anbindung an Shopware 6
Kostet der JTL-Connector für Shopware 6 eine Lizenzgebühr?
Für Shopware 6 fällt keine Lizenzgebühr für den Connector an. Abgerechnet wird auftragsbasiert über Pakete, die sich am Bestellvolumen orientieren. Mehrere Shopware-Instanzen an einer JTL-Wawi verursachen keine zusätzlichen Connector-Kosten.
Welche Daten laufen in welche Richtung?
Artikel mit Beschreibungen, Bildern, Varianten und Kategorien sowie Bestände und Preise laufen aus der Wawi in den Shop. Bestellungen und Kundendaten laufen aus dem Shop in die Wawi, Statusänderungen zurück. Nach dem Erstabgleich ist JTL-Wawi das führende System.
Wie lange dauert der erste Abgleich?
Das hängt an Artikelzahl, Variantentiefe und Bildmenge — von Minuten bei kleinen Katalogen bis zu mehreren Stunden bei großen. Planen Sie den Erstabgleich außerhalb der Geschäftszeiten und rechnen Sie damit, dass er mehr als einmal laufen muss, bis die Zuordnungen sitzen.
Können wir Artikel weiterhin im Shopware-Backend pflegen?
Nach dem Erstabgleich nicht mehr sinnvoll. Änderungen, die nur im Shop stehen, kennt die Warenwirtschaft nicht und werden beim nächsten Abgleich überschrieben oder erzeugen Konflikte. Die Pflege gehört ab dann in die Wawi.
Was ist mit B2B-Preisen und Kundengruppen?
Kundengruppen und Preise lassen sich abbilden, aber sobald kundenindividuelle Konditionen, Staffeln und Freigabeprozesse zusammenkommen, lohnt der Blick auf den Einzelfall. Hier entscheidet die konkrete Preislogik, ob der Standardweg trägt.
Wir wollen JTL-Wawi mit einem Onlineshop verbinden — wer setzt das um?
Kleinere Shops richten den Connector oft selbst ein; die Anleitung ist gut. Sinnvoll wird externe Hilfe dort, wo die Datenmodelle nicht deckungsgleich sind: Variationen gegen Merkmale, Stücklisten, mehrere Lager, B2B-Preise. Wir übernehmen wahlweise nur die Einrichtung, die Datenaufbereitung davor oder die komplette Anbindung inklusive Sonderfällen.
Brauchen wir eine Freigabe in der Firewall?
Wenn Ihr Server Zugriffe filtert, muss die Adresse des JTL-Connector-Dienstes erreichbar sein. Die aktuell gültige IP-Adresse für die Freigabe nennt JTL in der verlinkten FAQ — prüfen Sie sie dort, statt sie aus einem Blogbeitrag zu übernehmen, denn solche Adressen ändern sich.
Fazit: Die Technik ist das kleinere Problem
Der JTL-Connector für Shopware 6 ist erwachsen geworden. Die Einrichtung ist in einer guten Stunde erledigt, wenn man weiß, welcher Wert wohin gehört. Was Projekte teuer macht, sind nicht die drei Schritte aus der Anleitung, sondern die Entscheidungen davor: Welche Ausprägung ist Variation, welche Merkmal? Brauchen wir Mehrsprachigkeit? Und ist im Team wirklich verstanden, dass die Pflege ab dem Erstabgleich in der Warenwirtschaft stattfindet?
Wer diese drei Fragen vorher beantwortet, spart sich vier von fünf Fallen aus diesem Beitrag.
Und jetzt sind Sie dran: Auf welcher Stufe stehen Sie gerade — noch in der Planung, mitten im Erstabgleich oder schon im Live-Betrieb mit einem Sonderfall, den der Standard nicht abdeckt? Schreiben Sie es uns über die Kontaktseite, gern mit Kataloggröße und Variantentiefe. Besonders interessiert uns, wer den property_group_option-Konflikt anders gelöst hat als über den Support — dafür hätten wir Verwendung.
{% endif %}
{% if title and title != "" %}
{{ title }}
{% endif %}
{% if excerpt and excerpt != "" %}