1. Das Fehlerbild: Synchronisiert heißt nicht sichtbar

Der Ausgangspunkt war ein Serverumzug. Anschließend sah es zunächst so aus, als funktioniere die Verbindung zwischen JTL-Wawi und Shopware 6: Preise und Bestände wurden weiterhin synchronisiert. Trotzdem tauchte ein neu übertragener Artikel nicht im Onlineshop auf. Eine aktualisierte Produktbeschreibung erschien ebenfalls nicht.

Die entscheidende Beobachtung: Der Artikel existierte in der Shopware-Datenbank, hatte aber keine gültige Zuordnung zum Verkaufskanal. In der Tabelle product_visibility fehlte für den betroffenen Vaterartikel der entsprechende Eintrag. Damit war die Sichtbarkeit ein eigenes Problem – unabhängig davon, ob bereits andere Daten synchronisiert wurden.

01 / ERFOLGREICHPreise und Lagerbestand

Der Austausch einzelner Daten lief weiter.

02 / FEHLENDVerkaufskanal-Zuordnung

Der Artikel blieb im Storefront unsichtbar.

03 / FEHLERHAFTArtikelaktualisierung

Ein ungültiges Attribut störte den Abgleich.

2. Die Ursache: Ein Komma im Verkaufskanalnamen

JTL dokumentiert für Shopware 6 das Funktionsattribut sales_channels. Sein Wert ist eine durch Kommata getrennte Liste von Verkaufskanalnamen. Ein Komma innerhalb eines einzigen Kanalnamens kann daher wie ein Trennzeichen für zwei verschiedene Kanäle behandelt werden.

Im konkreten Fall enthielt der interne Shopware-Verkaufskanalname eine Formulierung mit einem Komma. Dieselbe Bezeichnung war für den betroffenen Shop in den Artikelattributen der JTL-Wawi hinterlegt. Der Connector konnte den Verkaufskanal damit nicht wie beabsichtigt zuordnen.

BEISPIEL – VEREINFACHT
PROBLEMATISCHMein Shop | Beratung, Service
FUNKTIONIERTMein Shop | Beratung - Service

Die bestätigte Lösung: Den internen Verkaufskanal in Shopware ohne Komma benennen und anschließend den zugehörigen sales_channels-Wert in JTL-Wawi exakt auf denselben Namen umstellen. Beim erneuten Abgleich des Testartikels funktionierte die Zuordnung wieder.

Wichtig: Es geht um den internen Namen des Shopware-Verkaufskanals, nicht um die Shop-Domain, den Seitentitel oder den sichtbaren Markenslogan. Mehrere echte Verkaufskanäle können mit Kommata getrennt werden – ein einzelner Kanalname sollte selbst jedoch kein Komma enthalten.

3. Zweiter Fehler: Ungültiger Attributname blockiert Produktupdates

Zusätzlich meldeten die Shopware-Produktionsprotokolle wiederholt den Fehler CUSTOM_FIELD_NAME_INVALID. In JTL-Wawi existierte ein überflüssiges Artikelattribut, dessen Name als langer lesbarer Verkaufskanaltitel angelegt worden war – inklusive Sonderzeichen und Leerzeichen.

Ein solcher Text gehört gegebenenfalls in den Wert des Funktionsattributs sales_channels, aber nicht als technischer Name eines frei angelegten Shopware-Custom-Fields. Nach dem Entfernen des störenden Zusatzattributs ließen sich auch Änderungen an der Produktbeschreibung des Testartikels übertragen.

4. So lässt sich der Fehler systematisch beheben

  1. In Shopware nachsehen: Ist der Artikel im Backend vorhanden und aktiv? Unter der Zuordnung/Sichtbarkeit prüfen, ob der richtige Verkaufskanal eingetragen ist.
  2. Kanalnamen prüfen: In Shopware → Einstellungen → Verkaufskanäle den internen Namen kontrollieren. Enthält der Name ein Komma, eine eindeutige Schreibweise ohne Komma festlegen.
  3. JTL-Attributwert anpassen: In den Artikelstammdaten Attribute/Merkmale öffnen. Für sales_channels den Attributwert des betroffenen Shopware-Verkaufskanals auf den neuen, exakten Namen setzen.
  4. Andere Shops unberührt lassen: Bei mehreren angebundenen Shops nur den Wert für den tatsächlich betroffenen Verkaufskanal ändern. Ein leerer JTL-Wawi-Standardwert ist nicht automatisch falsch, wenn der shopbezogene Wert korrekt hinterlegt ist.
  5. Zusatzattribute kontrollieren: In JTL-Wawi nach frei angelegten Attributen suchen, deren technischer Name lediglich ein ausgeschriebener Kanal- oder Markenname ist. Solche Attribute nur nach Datensicherung und Prüfung der Verwendung entfernen.
  6. Abgleich auslösen: Einen betroffenen Artikel erneut senden und danach in Shopware die Kanalzuordnung sowie die tatsächlich aktualisierte Beschreibung kontrollieren.

5. Optional: Verkaufskanalzuordnung mit SQL prüfen

Wenn phpMyAdmin verfügbar ist, zeigt eine reine Leseabfrage, ob für eine Artikelnummer eine Zuordnung existiert. Die Abfrage ändert keine Daten:

SELECT
    p.product_number AS artikelnummer,
    CASE
        WHEN pv.product_id IS NULL THEN 'NICHT ZUGEORDNET'
        ELSE 'ZUGEORDNET'
    END AS shopzuordnung,
    pv.visibility AS sichtbarkeit
FROM product p
LEFT JOIN product_visibility pv
    ON pv.product_id = p.id
   AND pv.product_version_id = p.version_id
WHERE p.product_number = 'MEINE-ARTIKELNUMMER';

Achtung bei Varianten: In Shopware kann die Sichtbarkeit über den Vaterartikel gesteuert werden. Eine Variante ohne eigenen product_visibility-Datensatz ist deshalb nicht zwangsläufig fehlerhaft. Im Praxisfall betraf die fehlende Zuordnung den Vaterartikel.

6. Was tun bei Tausenden betroffenen Artikeln?

Ein korrigierter Testartikel ist der Nachweis, dass die grundsätzliche Konfiguration funktioniert. Für große Sortimente bietet sich anschließend die gezielte Korrektur über einen JTL-Ameise-Export und -Import an: betroffene Artikelattribute exportieren, den falschen Attributnamen beziehungsweise alten Kanalwert identifizieren und nur diese Datensätze korrigieren. Die übrigen Attribute, Artikel und Shops bleiben erhalten.

Vor einem Massenimport gehören eine JTL-Datenbanksicherung, ein prüfbarer Export und eine eindeutige Zuordnung per Artikelnummer dazu. Nicht pauschal alle Attribute entfernen und keine Shopware-Tabellen wie product_visibility auf Verdacht leeren – dadurch können funktionierende Produktzuordnungen verlorengehen.

7. Waren der Serverumzug oder das Connector-Update schuld?

Im untersuchten Shop fiel das Problem nach dem abgeschlossenen Serverumzug vom 13. November 2026 auf. JTL hatte bereits am 5. November 2026 die Connector-Version 2.2.0 für Shopware 6 ausgerollt. Das Update umfasste unter anderem eine Umstellung auf Connector Core 6.

Diese zeitliche Abfolge ist für die Fehlersuche relevant. Ein ursächlicher Zusammenhang des Updates oder des Umzugs mit den Fehlern ist dadurch aber nicht bewiesen. Nachweisbar waren in diesem Fall der problematische Trenner im Kanalnamen und der ungültige technische Attributname – und die erfolgreiche Korrektur am betroffenen Artikel.

Fazit: Bei einem erfolgreichen Abgleich genauer hinsehen

Die wichtigste Erkenntnis: Ein grüner Abgleich bestätigt nicht automatisch, dass ein Artikel im gewünschten Shop sichtbar ist oder jede Änderung übernommen wurde. Gerade bei JTL-Wawi und Shopware 6 lohnt es sich, Verkaufskanalzuordnung, Funktionsattribute und Fehlermeldungen getrennt zu prüfen.

Manchmal steckt hinter einer umfangreichen Fehlersuche tatsächlich nur ein einziges Komma – die Auswirkungen können bei mehreren Tausend Artikeln allerdings erheblich sein.

Weiterführende Quellen