JTL WooCommerce Varianten einrichten: So überträgst du Variationsartikel korrekt

Auf einen Blick

• ✓Vlarom E-Commerce Agentur richtet JTL WooCommerce Varianten in drei Phasen ein: Variantengruppen in JTL-Wawi anlegen, Eigenschafts-Slugs aus WooCommerce zuweisen, initialen Datentransfer mit gezieltem Testabgleich durchführen.
• ✓Die häufigste Fehlerquelle ist die Verwechslung von Eigenschafts-Slug und Begriffsslug im Funktionsattribut wc_v_preselect: Wer hier den falschen Wert einträgt, sieht im Shop entweder keine Vorauswahl oder gar keine Varianten.
• ✓Im laufenden Betrieb gilt die wichtigste Regel: JTL-Wawi führt. Preise, Bestände und Varianten direkt im WooCommerce-Backend zu ändern, erzeugt Synchronisationsfehler die sich ohne Backup-Einspielen kaum sauber auflösen lassen.

Variationsartikel sind technisch der anspruchsvollste Teil des WooCommerce-Connectors. Nicht weil das System kompliziert ist, sondern weil zwei unterschiedliche Datenmodelle zusammengebracht werden müssen. JTL-Wawi denkt in Variantengruppen und Kindelementen, WooCommerce denkt in variablen Produkten und Attributen. Wer diesen Unterschied nicht von Anfang an versteht, korrigiert später per Hand was sich automatisiert hätte lösen lassen. Als JTL Service Partner Gold in Ahrensfelde bei Berlin sehen wir dieses Muster bei fast jedem Connector-Onboarding.

Vlarom E-Commerce Agentur hat diese fünf Schritte aus der offiziellen JTL-Connector-Dokumentation und der Praxis aus Connector-Onboardings zusammengestellt. Die Grundlage bildet der JTL-Guide für Varianten in WooCommerce. Lege vor dem ersten Datentransfer immer ein frisches Backup deiner WooCommerce-Datenbank an, besonders wenn du in einem laufenden Shop arbeitest.

Geh in WooCommerce unter Produkte > Eigenschaften und lege alle Attribute an die du für deine Varianten brauchst: Farbe, Größe, Material. Jede Eigenschaft bekommt automatisch einen Slug. Öffne dann Begriffe konfigurieren und lege alle möglichen Werte an. Jeder Begriff hat ebenfalls einen Slug. Die Eigenschaft Größe hat zum Beispiel einen Begriff xl mit dem Slug xl. Notiere dir Eigenschafts-Slug und Begriffsslug separat, weil du beide gleich in JTL-Wawi brauchst und die Verwechslung dieser beiden Werte der häufigste Fehler beim Einrichten von JTL WooCommerce Varianten ist.

In JTL-Wawi legst du die Variantengruppen an, also die Definitionen deiner Variationstypen. Dann erstellst du den Überartikel und verknüpfst ihn mit der passenden Variantengruppe. Jedes Kindelement ist ein einzelner untergeordneter Artikel mit eigenem Lagerbestand, eigener EAN wenn vorhanden, und eigenem Preis wenn er vom Überartikel abweicht. Prüfe vor dem ersten Abgleich, dass alle Kindelemente eine gültige Artikelnummer haben. Der Connector überträgt nur vollständige Datensätze. Fehlende Artikelnummern bei einzelnen Kindelementen sind ein häufiger Grund für halbfertige Varianten-Übertragungen.

Wenn du im WooCommerce-Shop eine Standardvariante vorauswählen willst, brauchst du ein Funktionsattribut in JTL-Wawi. Lege unter Artikel > Attribute ein neues Attribut an dessen Name dem Schema wc_v_preselect_[eigenschaftslug] folgt, wobei [eigenschaftslug] der Eigenschafts-Slug aus WooCommerce ist, also zum Beispiel wc_v_preselect_Größe. Aktiviere in diesem Attribut die WooCommerce-Option. Weise dann dem Überartikel dieses Attribut zu und trage als Wert den Begriffsslug der vorausgewählten Variante ein, zum Beispiel m für Größe M. Das ist der exakte Ablauf aus dem JTL-Guide. WooCommerce erklärt die Eigenschafts-Slugs in der offiziellen Dokumentation zu variablen Produkten. Tausche Eigenschafts-Slug und Begriffsslug nicht: Der Connector quittiert das stillschweigend mit fehlender Vorauswahl.

Führe den Plattform-Abgleich im Connector-Backend durch und warte den ersten vollständigen Durchlauf ab. Öffne danach im WooCommerce-Backend drei bis fünf variable Produkte und prüfe manuell: Sind alle Varianten übertragen? Ist die Vorauswahl gesetzt? Stimmen Preise und Lagermengen? Wenn der Abgleich nicht vollständig durchgelaufen ist, schau zuerst ins Connector-Log bevor du neu startest. Fehler in diesem Stadium lösen sich nicht von selbst. Häufige Ursachen sind fehlende Pflichtfelder bei einzelnen Kindelementen oder PHP-Timeout-Limits bei großen Sortimenten.

Nach dem initialen Transfer gilt eine Betriebsregel die der JTL WooCommerce Connector technisch voraussetzt: Alle Änderungen an Varianten, Preisen und Lagerbeständen gehören ausschließlich in JTL-Wawi, nicht ins WooCommerce-Backend. Das ist eine technische Notwendigkeit. Wer Preise direkt in WooCommerce bearbeitet, sieht beim nächsten Connector-Abgleich Diskrepanzen die zu falschen Bestellpreisen führen können. Wer Varianten direkt im Shop löscht oder verschiebt, erzeugt Folgefehler die laut JTL-Dokumentation nur per Backup-Einspielen sauber aufzulösen sind. Die Datenhoheit liegt in der Wawi. Dort ändern, Connector synchronisiert, fertig.

Autor

Alexander Luft

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