Alexander LuftVon Alexander Luft
JTL Service Partner Gold · Ahrensfelde bei Berlin · 16. Oktober 2025 · 11 Min. Lesezeit
JTL Connector Shopware 6.7 Kompatibilität — Logo-Komposition JTL und Shopware

JTL Connector und Shopware 6.7: Was Händler wissen müssen, bevor sie das Update starten

Shopware 6.7 ist seit Frühjahr 2025 im Umlauf. Mit der Version kamen Probleme für alle, die ihren Shop per JTL Connector mit der Wawi synchronisieren. Thumbnails brachen ab, Merkmale wurden nicht übertragen, Preisabgleiche liefen in Fehler. Das war kein Zufall. JTL hatte Shopware 6.7 zum Zeitpunkt der ersten Veröffentlichung noch nicht offiziell freigegeben. Viele Händler steckten in einem Interims-Zustand fest. Mit Connector 2.1.0 kam die Lösung, aber auch dort gab es Anlaufschwierigkeiten. In diesem Beitrag fassen wir zusammen, was passiert ist, welche Fehler bekannt sind und wie der aktuelle Stand aussieht.

Kann ich Shopware jetzt auf 6.7 aktualisieren, ohne dass der JTL-Abgleich abbricht?

Kurze Antwort: Ja, aber nur mit der passenden Connector-Version und dem Wissen um einige Fallstricke. Wir haben die relevanten JTL-Forum-Threads, Issue-Tickets und unsere eigene Praxis mit Händlern ausgewertet.

Auf einen Blick

  • ✓JTL hat Shopware 6.7 erst mit Connector 2.1.0 offiziell freigegeben. Händler die früher auf 6.7 aktualisiert haben, liefen in bekannte Fehler: Thumbnail-Abbrüche (CO-3083), fehlerhafte Merkmalsübertragung und „Tax rate not found“ beim Preisabgleich. Vlarom hat diese Konstellation bei mehreren Kundensystemen begleitet.
  • ✓Connector 2.1.0 brachte Shopware-6.7-Kompatibilität und Performance-Verbesserungen bei Produkt-, Kategorie- und Merkmalsübertragung. Das Update wird automatisch eingespielt. Eine manuelle Installation ist nicht nötig.
  • ✓Mit Connector 2.1.3 wurden weitere Fehler behoben, die ab Shopware 6.7.6.0 auftraten (Sonderpreise, CO-3321). Bei neuen Connector-Releases prüfen wir systematisch, ob Kundensysteme betroffen sind. Erst-Einrichtung statt Update? Die komplette Schritt-für-Schritt-Anleitung zur JTL-Connector-Einrichtung für Shopware 6 mit Voraussetzungen, API-Key und Mapping liegt als separater Guide vor.

Als JTL Service Partner Gold aus Ahrensfelde bei Berlin betreuen wir Händler, die ihren gesamten E-Commerce-Betrieb über JTL-Wawi steuern. Wenn Shopware-Updates den Abgleich stören, merken wir das direkt: Bestellungen kommen nicht an, Bestände stimmen nicht, Bilder fehlen. Vlarom hat die Shopware-6.7-Problematik von Anfang an verfolgt und mehrere Kundensysteme durch die Übergangsphase begleitet. Die Informationen in diesem Beitrag kommen aus JTL-Forum-Threads, offiziellen Issue-Tickets und aus unserer eigenen Arbeit mit betroffenen Händlern.

Was ist passiert: die bekannten Fakten zu Shopware 6.7 und dem JTL Connector

Als Shopware 6.7 erschien, war der JTL Connector noch nicht für diese Version freigegeben. Händler die ihr Shop-System trotzdem aktualisierten, standen vor einem Dilemma: zurückrollen oder mit Fehlern arbeiten. JTL-Support teilte damals offiziell mit, dass Shopware 6.7 noch nicht als kompatibel mit dem Connector freigegeben war und die Kompatibilität erst noch hergestellt werden musste. Diese Phase dauerte mehrere Wochen. In dieser Zeit kursierten im JTL-Forum provisorische Workarounds.

Mit dem Release von Connector 2.1.0 (Quelle: JTL-Forum Ankündigung, thread 240671) änderte sich das. Volle Kompatibilität mit Shopware 6.7 plus Performance-Verbesserungen bei Produktdaten, Kategorien, Merkmalen und Attributen. Das Update wurde automatisch eingespielt.

Mit Connector 2.1.3 folgten weitere Fixes speziell für Shopware 6.7.6.0 (Sonderpreise, Lieferschein-Performance).

Quelle Vlarom-Projektdaten: Mehrere Händler die Vlarom betreut, hatten in der Übergangsphase täglich manuelle Eingriffe nötig, um den Abgleich am Laufen zu halten. Der häufigste Workaround war, an Artikelbeschreibungen eine minimale Änderung vorzunehmen und zurückzuändern, damit der Connector einen vollständigen Artikel-Push auslöst.

Die relevanten Issue-Tickets und Fehler aus der Praxis:

  • →CO-3083 — Tax rate not found (Shopware 6.7.x): Preisänderungen in JTL-Wawi lösten beim Abgleich mit Shopware 6.7 die Fehlermeldung ‚Tax rate not found‘ aus, obwohl alle Steuersätze korrekt hinterlegt waren. Ursache: Der Connector sendete bei Preisänderungen nicht automatisch die vollständigen Stammdaten mit. Status: Gelöst. Quelle: issues.jtl-software.de/issues/CO-3083
  • →Thumbnail-Fehler: height/width dürfen nicht leer sein: Beim Komplettabgleich mit Shopware 6.7 brach die Bildübertragung mit dem Fehler ‚FRAMEWORK__WRITE_CONSTRAINT_VIOLATION‘ ab. Der Connector versuchte Thumbnail-Felder (width/height) zu schreiben, die in Shopware 6.7 write-protected sind. Das betraf Händler die nach dem Shopware-Update sofort einen Komplettabgleich starteten.
  • →CO-3321 — Sonderpreise brechen ab (Shopware 6.7.6.0): Ab Shopware 6.7.6.0 brach der Abgleich beim Senden von Sonderpreisen mit einem Fehler ab. Behoben mit Connector 2.1.3. Status: Gelöst. Quelle: issues.jtl-software.de/issues/CO-3321
  • →Merkmale werden nicht übertragen (Shopware 6.7.3.x): Mehrere Händler meldeten im JTL-Forum, dass Merkmale und Eigenschaften nach dem Update auf Shopware 6.7.3 nicht mehr korrekt übertragen wurden. Connector 2.1.0 verbessert laut JTL-Ankündigung explizit die Übertragung von Merkmalen und Attributen.
  • →No supported api version found (Shopware 6.7.6.2): Mit Shopware 6.7.6.2 erkannte der Connector die API-Version des Shops nicht mehr korrekt. Einige Abgleiche liefen, andere liefen in Fehler. Das Problem betraf vor allem Systeme ohne bestehende Connector-Verbindung vor dem Shopware-Update.

Der gemeinsame Nenner aller Fehler: Shopware 6.7 brachte API-Änderungen mit, auf die der Connector erst in mehreren Schritten angepasst wurde. Wer in dieser Phase vorschnell aktualisiert hat, hatte ohne Workaround keinen funktionierenden Abgleich.

Drei Szenarien: warum der Abgleich nach dem Shopware-Update abbricht

Die Fehler nach dem Shopware-6.7-Update lassen sich auf drei Hauptursachen zurückführen. Das Muster ist in der Praxis gut erkennbar, wenn man weiß, wonach man schaut.

1

Connector-Version ist zu alt für Shopware 6.7

Der Connector wird automatisch aktualisiert, aber das Update läuft nicht sofort auf allen Systemen durch. Wenn der Connector noch auf einer Version vor 2.1.0 läuft und Shopware bereits auf 6.7 aktualisiert wurde, ist keine vollständige Kompatibilität gegeben. Erkennbar an Abgleich-Fehlern bei Produkten, Preisen oder Bildern direkt nach dem Shopware-Update.

Ein Händler im JTL-Forum schrieb es präzise: ‚Wir haben aktuell einige Fehler und wissen nicht ob es ab 6.7 liegt oder JTL oder ob wir etwas in der Datenbank zerschossen haben.‘ Dieser Zweifelszustand ist typisch für die Übergangsphase. Die Connector-Version in der JTL-Wawi unter Plattformen > Verkaufskanäle zeigt, auf welchem Stand man ist.

2

Komplettabgleich direkt nach Shopware-Update gestartet

Wer sofort nach dem Shopware-6.7-Update einen Komplettabgleich startet, triggert alle Sync-Punkte auf einmal, inklusive der API-Bereiche die in 6.7 geändert wurden. Das führt zu Kaskadenfehlern: zuerst die Thumbnails, dann die Merkmale, dann die Preise.

Laut JTL-Dokumentation führt die Wawi nach dem Einrichten eines Verkaufskanals. Das bedeutet: Shopware wird nach dem ersten Abgleich zur Slave-Datenbank. Fehlt ein stabiler Connector, riskiert man inkonsistente Artikeldaten im Shop. Bilder fehlen, SEO-URLs werden nicht übertragen, Merkmale erscheinen leer.

3

Übertragungsgröße im Connector zu niedrig eingestellt

Mit Connector 2.1.0 wurden Performance-Verbesserungen eingeführt, die bei höherer Übertragungsgröße besser wirken. JTL empfiehlt laut Forum-Ankündigung ausdrücklich, die Übertragungsgröße in den Connector-Einstellungen hochzusetzen. Wer diesen Wert nicht anpasst, verliert einen Teil der Performance-Gewinne und riskiert bei großen Katalogen Timeouts.

Die Übertragungsgröße wird in den JTL-Wawi-Einstellungen unter Plattformen > Verkaufskanäle konfiguriert. Ein zu niedriger Wert zeigt sich oft erst bei größeren Abgleichen: der Abgleich dauert unverhältnismäßig lang oder bricht mit einem Timeout-Fehler ab.

Was Connector 2.1.0 und 2.1.3 konkret verbessern

Volle Shopware-6.7-Kompatibilität ohne Workarounds

Bis zu Connector 2.1.0 mussten Händler in der Shopware-6.7-Übergangsphase manuell eingreifen, um Preisabgleiche zu erzwingen oder Bilder neu zu übertragen. Ab 2.1.0 läuft der Abgleich ohne diese Behelfsmaßnahmen. Merkmale, Attribute, Produktdaten und Kategorien werden korrekt übertragen. Das automatische Update auf 2.1.0 schließt die Kompatibilitätslücke zu Shopware 6.7.

Schnellere Übertragung bei großen Artikelkatalogen

Connector 2.1.0 bringt laut JTL-Ankündigung deutlich schnellere Übertragung von Produktdaten, Kategorien, Merkmalen und Attributen. Für Händler mit großen Katalogen bedeutet das kürzere Abgleich-Fenster und weniger Belastung für den Server. Wer die Übertragungsgröße in den Connector-Einstellungen hochgesetzt hat, profitiert stärker von dieser Verbesserung.

Die Lektion

Unsere Erkenntnis aus der Praxis: Die Shopware-6.7-Episode zeigt ein Muster, das wir bei jedem größeren Shopware-Release beobachten. Händler die sofort aktualisieren, bevor JTL die Kompatibilität freigegeben hat, zahlen den Preis in Form von Abgleich-Fehlern und manuellem Aufwand. Wer auf die offizielle Freigabe wartet, vermeidet diesen Aufwand komplett. Für kritische Systeme gilt: erst testen, dann live schalten.

Abgleich nach Shopware-6.7-Update wieder zum Laufen bringen

Diese Reihenfolge hat sich bei Systemen bewährt, die nach dem Shopware-6.7-Update in Abgleich-Fehler gelaufen sind. Schritt 1 und 2 klären den aktuellen Zustand, bevor irgendetwas verändert wird.

Connector-Version prüfen

In JTL-Wawi unter Plattformen > Verkaufskanäle den konfigurierten Shopware-6-Kanal öffnen. Die Connector-Version steht in den Verbindungsdetails. Mindestvoraussetzung für Shopware 6.7-Kompatibilität ist Connector 2.1.0. Für Shopware 6.7.6.0 und höher ist Connector 2.1.3 nötig. Das Update läuft automatisch, aber nicht sofort nach dem Shopware-Update. Falls die Version älter ist, einige Stunden warten und dann die Verbindung erneut testen.

Fehlermeldung eingrenzen

Das Abgleich-Log in JTL-Wawi zeigt, bei welchem Controller und welcher Action der Fehler auftritt. ‚Controller = Image | Action = push‘ mit FRAMEWORK__WRITE_CONSTRAINT_VIOLATION deutet auf das Thumbnail-Problem hin. ‚Controller = ProductPrice | Action = push | Tax rate not found‘ ist CO-3083. ‚Controller = Product | Action = delete‘ mit SQL-Fehler Code 1064 deutet auf einen Datenbankfehler in Shopware selbst hin. Die genaue Fehlermeldung bestimmt den nächsten Schritt.

Verbindung testen und Connector-Einstellungen prüfen

In den Verkaufskanal-Einstellungen ‚Verbindung testen‘ ausführen. Schlägt der Test fehl, stimmt etwas mit der API-Verbindung zwischen Wawi und Shopware. Häufig hilft es, die Zugangsdaten (Zugangs-ID und Sicherheitsschlüssel) aus dem Shopware-Backend neu zu lesen und in der Wawi zu aktualisieren. Die Einrichtung im Detail beschreibt der JTL-Guide zur Shopware-6-Anbindung.

Übertragungsgröße anpassen

In den Connector-Einstellungen die Übertragungsgröße erhöhen, falls sie noch auf dem Default-Wert steht. JTL empfiehlt laut Forum-Ankündigung zu Connector 2.1.0 ausdrücklich, diesen Wert hochzusetzen, um die Performance-Verbesserungen voll auszuschöpfen. Bei Systemen mit vielen Artikeln und Varianten zahlt sich das direkt in kürzeren Abgleich-Zeiten aus. Zu niedriger Wert äußert sich in Timeouts bei größeren Abgleichen.

Nach Connector-Update einen eingeschränkten Abgleich starten

Statt direkt einen Komplettabgleich zu starten, zunächst einen Artikelquicksync oder einen manuellen Abgleich für eine kleine Artikelgruppe ausführen. So sieht man schnell, ob der Abgleich grundsätzlich funktioniert, ohne bei einem Fehler den gesamten Katalog in einen inkonsistenten Zustand zu bringen. Erst wenn der Quicksync sauber durchläuft, einen vollständigen Abgleich starten. Weitere Hinweise zu Connector-Einstellungen und Abgleich-Optionen stehen im JTL-Guide zu den Shopware-6-Funktionsattributen.

Häufige Fragen zum JTL Connector und Shopware 6.7

Ist der JTL Connector jetzt mit Shopware 6.7 kompatibel?

Ja, der JTL Connector ist mit Shopware 6.7 kompatibel, und zwar ab Connector-Version 2.1.0. Für Shopware 6.7.6.0 und höher ist Connector 2.1.3 nötig, der weitere Fehler bei Sonderpreisen behebt. Das Update läuft automatisch ein, eine manuelle Installation ist nicht erforderlich. Die Kompatibilität gilt ab dem Zeitpunkt des automatischen Updates auf 2.1.0.

Der Abgleich bricht nach einem Shopware-6.7-Update ab, wenn der Connector noch nicht auf Version 2.1.0 oder höher aktualisiert wurde. Shopware 6.7 brachte API-Änderungen mit, die ältere Connector-Versionen nicht unterstützen. Konkrete Fehler sind: ‚Tax rate not found‘ (CO-3083) beim Preisabgleich, Thumbnail-Fehler mit FRAMEWORK__WRITE_CONSTRAINT_VIOLATION und fehlerhafte Merkmalsübertragung. Alle drei sind mit Connector 2.1.0 bzw. 2.1.3 behoben.

‚Tax rate not found‘ beim Preisabgleich mit Shopware 6.7 war ein bekannter Fehler, dokumentiert als Issue CO-3083 im JTL-Issue-Tracker. Der Connector sendete bei Preisänderungen nicht automatisch die vollständigen Artikelstammdaten mit, was zu diesem Fehler führte. Der Workaround war, zusammen mit der Preisänderung auch eine kleine Stammdaten-Änderung (z.B. Leerzeichen in der Beschreibung) auszulösen. Der Fehler ist mit dem Connector-Update gelöst.

Dieser Fehler trat beim Übertragen von Produktbildern nach dem Update auf Shopware 6.7 auf. Der Connector versuchte Thumbnail-Dimensionen (width/height) per API zu schreiben, die Shopware 6.7 als write-protected markiert. Die Fehlermeldung lautet ‚FRAMEWORK__WRITE_CONSTRAINT_VIOLATION – This field is write-protected‘. Konkret bricht der Komplettabgleich bei der Bildübertragung ab. Das Problem ist mit Connector 2.1.0 behoben.

Fehlende Merkmale nach einem Shopware-6.7-Update sind ein bekanntes Problem, das in mehreren Forum-Threads berichtet wurde. Connector 2.1.0 verbessert laut JTL-Ankündigung explizit die Übertragung von Merkmalen und Attributen. Wenn Merkmale weiterhin fehlen, zuerst die Connector-Version prüfen. Falls der Connector bereits auf 2.1.0 oder höher steht, einen manuellen Abgleich nur für die betroffenen Artikel starten und das Abgleich-Log auf spezifische Fehlermeldungen prüfen.

Ja, ein Update auf Shopware 6.7 ist mit dem aktuellen JTL Connector möglich. Voraussetzung ist, dass der Connector automatisch auf Version 2.1.0 oder höher aktualisiert wurde, bevor das Shopware-Update durchgeführt wird. Für Shopware 6.7.6.0 und höher wird Connector 2.1.3 benötigt. JTL empfiehlt in der Dokumentation, die Datenbank vor dem ersten Connector-Einsatz zu sichern und den initialen Abgleich in einem ausreichend großen Zeitfenster zu planen.

Connector 2.1.0 brachte Performance-Verbesserungen, die aber erst dann voll wirken, wenn die Übertragungsgröße in den Connector-Einstellungen hochgesetzt ist. Wer noch auf dem Default-Wert arbeitet, sieht keine Verbesserung gegenüber dem alten Zustand. JTL empfiehlt ausdrücklich, den Wert zu erhöhen. Zusätzlich kann ein erster Abgleich nach einem Shopware-Update länger dauern, weil alle Stammdaten neu abgeglichen werden.

‚No supported api version found‘ bedeutet, dass der Connector die API-Version des Shopware-Systems nicht erkennt. Das trat bei einigen Systemen mit Shopware 6.7.6.2 auf. Häufig hilft es, die Verbindung in den Verkaufskanal-Einstellungen der JTL-Wawi neu zu testen und die Zugangsdaten (Zugangs-ID und Sicherheitsschlüssel) aus dem Shopware-Backend zu erneuern. Falls bereits eine bestehende Connector-Verbindung vorhanden war, liefen laut Forum-Berichten viele Abgleiche trotzdem durch.

Connector 2.1.0 brachte die grundlegende Shopware-6.7-Kompatibilität sowie Performance-Verbesserungen bei Produktdaten, Kategorien, Merkmalen und Attributen. Connector 2.1.3 behebt zusätzlich Fehler, die erst ab Shopware 6.7.6.0 auftraten, konkret beim Senden von Sonderpreisen (Issue CO-3321) und bei der Lieferschein-Übertragung. Beide Updates werden automatisch eingespielt.

Für den Connector selbst ist kein manueller Eingriff nötig, das Update läuft automatisch. Was sich jedoch lohnt: In den Connector-Einstellungen die Übertragungsgröße prüfen und ggf. erhöhen, nach dem Shopware-Update zunächst einen eingeschränkten Abgleich starten statt direkt einen Komplettabgleich, und im Shopware-Backend sicherstellen, dass die Integration für den JTL-Connector die Administrator-Berechtigung hat.

Wir kennen die Shopware-Connector-Fehler aus der täglichen Arbeit und beheben sie direkt am System.

Connector-Probleme mit Shopware 6.7? Vlarom schaut drauf.

Als JTL Service Partner Gold aus Ahrensfelde bei Berlin betreuen wir Händler die ihren Shopware-Shop per JTL Connector synchronisieren. Wenn der Abgleich abbricht, Bilder fehlen oder Merkmale nicht übertragen werden, kommen wir per Fernzugriff rein und schauen direkt ins System. Ruf uns an unter +49 30 91473862, schreib an info@vlarom.de oder nutze unser Kontaktformular für eine schnelle Ersteinschätzung.

Autor

Alexander Luft

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