Varianten-Master

Karte für einen Varianten-Master – den Anzeige-Container (Elternprodukt) eines Variantenartikels in Shopware 6.

In Shopware besteht ein Variantenartikel aus einem Container (dem Elternprodukt, das die Auswahl anzeigt) und seinen Varianten-Kindern (den kaufbaren Ausprägungen wie „T-Shirt rot", „T-Shirt gelb"). Der Varianten-Master ist dieser Container als eigenes Objekt im Connector.

Der Master ist kein BC-Artikel

Der Varianten-Master wird nie bestandsgeführt, nie verkauft und erscheint nie auf einer Bestellung – Bestellungen verweisen immer auf die Kind-SKUs, und das sind echte BC-Artikel. Der Master hält nur die Container-Daten (Titel, Beschreibung, SEO, Varianten-Set) und die Liste der zugeordneten Varianten.

Seite öffnen

Über die Suche: Shopware 6-Varianten-Master (Liste) → Eintrag anklicken
Über das Shopware 6-Dashboard → Navigation → Varianten-Master
Aus der Artikelliste → Navigation → Varianten-Master
Aus der Shopware 6-Artikelkarte eines Artikels → Aktion Varianten-Master anlegen (neu anlegen) bzw. Varianten-Master öffnen (bereits zugeordnet)

Ablauf (Überblick)

Der Varianten-Master kennt vier Schritte. Angelegt, hochgeladen und aufgelöst wird er über Ihren Klick in Business Central; steht an einem Master, der online ist, oder an einer seiner Varianten eine Änderung aus, lädt ihn zusätzlich der automatische Artikel-Sync hoch.

Anlegen aus Artikel – Auf der Artikelkarte Varianten-Master anlegen. Titel, Beschreibung, SEO, Hersteller und Varianten-Set werden aus dem Artikel kopiert; der Artikel wird zur Hauptvariante. Die Container-SKU ist standardmäßig die Artikel-SKU plus Suffix (M), z. B. 01.0000.32 → 01.0000.32M.
Pflegen – Auf der Master-Karte Titel/Beschreibung/SEO des Containers bearbeiten, weitere Artikel als Varianten zuordnen (Artikel hinzufügen im Bereich Zugeordnete Varianten), Hauptvariante festlegen (Als Hauptvariante festlegen).
Hochladen – Aktion Hochladen: legt den Container in Shopware an bzw. aktualisiert ihn und lädt alle zugeordneten Artikel als Varianten-Kinder hoch.
Auflösen oder Aus Shop entfernen – siehe Aktionen.

Eine Schritt-für-Schritt-Anleitung zur Übernahme bestehender Strukturen finden Sie unter Bestehende Varianten migrieren.

Felder

Allgemein

Feld	Beschreibung
Shop	Shop, zu dem dieser Master gehört, mit seinem Namen. Schreibgeschützt – wird beim Anlegen aus dem Artikel übernommen.
Code	Eindeutiger Code des Masters innerhalb des Shops. Entspricht standardmäßig der Artikelnummer der Quelle. Schreibgeschützt.
Shop-SKU	Shopware-Produktnummer (`productNumber`) des Containers. Standard: Quell-SKU + Container-Suffix (z. B. `…M`). Für die Übernahme eines bestehenden Containers muss diese SKU exakt der vorhandenen Container-SKU im Shop entsprechen – dann aktualisiert der Upload den vorhandenen Container statt einen neuen anzulegen.
Titel	Name des Container-Produkts im Shop (z. B. `T-Shirt`).
Aktiv	Ob das Container-Produkt im Shop aktiv ist.
Hauptvariante Artikelnr.	Artikel, dessen Varianten-Kind die Hauptvariante des Angebots ist (`mainVariantId`). Liefert außerdem die Pflichtfelder Steuer und Preis des Containers.
Quellartikelnr.	Artikel, aus dem der Master kopiert wurde. Rein informativ; per Klick öffnet sich die Shopware 6-Artikelkarte des Quell-Artikels. Über Quelle lösen lässt sich der Verweis lösen.
Beschreibungsvorlage	Beschreibungs-Template für den Container. Wenn gesetzt, wird die Container-Beschreibung beim Upload aus dem Template gerendert (Marketing-Text und technische Daten der Hauptvariante); die manuell gepflegte Beschreibung wird dann nicht gesendet. Wenn leer, wird der Beschreibungstext unverändert übertragen.

Varianten

Feld	Beschreibung
Varianten-Dimensionen	Die Eigenschaftsgruppen, aus denen die Varianten dieses Masters bestehen (z. B. Farbe, Größe). Ein Klick öffnet die vollständige Liste. Die Dimensionen kommen aus dem Shop und werden bei jedem Import neu aufgebaut. Siehe Eigenschaftssets.
Variantenauswahl	Darstellung im Shop: Standard (Dropdown), Bild (Vorschaubilder) oder Farbe (Farbfelder).

Darunter der Bereich Zugeordnete Varianten – die zugeordneten Artikel (Kinder) mit Artikelnr., Artikelbeschreibung, Hauptvariante, Variante aktiv, Marktplatzmenge (nur bei Menge fixiert eingebbar), Artikel synchronisiert und Artikel aktualisieren; Varianten gehen mit dem Master in den Shop. Artikel hinzufügen ordnet Shopware 6-Artikel desselben Shops ohne Master zu (Mehrfachauswahl), Vom Master entfernen löst eine Zuordnung – im Shop wirkt das erst beim nächsten Hochladen oder Auflösen –, und Als Hauptvariante festlegen bestimmt die Hauptvariante, die Steuer und Preis des Containers liefert.

Beschreibung

Feld	Beschreibung
Beschreibung	HTML-Beschreibung des Container-Produkts. Varianten-Kinder ohne eigene Beschreibung erben diesen Text in Shopware. Pflegt eine Variante eine eigene Beschreibung (Feld Beschreibung Langtext auf ihrer Artikelkarte), überschreibt sie den Container-Text; wird das Feld wieder geleert, greift automatisch erneut die Vererbung.

SEO

Feld	Beschreibung
SEO-Titel	SEO-Seitentitel des Containers (max. 56 Zeichen).
SEO-Beschreibung	SEO-Meta-Beschreibung (max. 155 Zeichen).
SEO-Schlüsselwörter	3–5 SEO-Schlüsselwörter.
SEO-URL	SEO-freundlicher URL-Pfad des Containers.

Status

Alle Felder schreibgeschützt.

Feld	Beschreibung
Online	Ob das Container-Produkt derzeit im Shop vorhanden ist.
Synchronisiert	Ob der Master erfolgreich hochgeladen wurde.
Letzte Synchronisation	Zeitpunkt des letzten Uploads.
Artikel aktualisieren	Am Master oder an einer seiner Varianten steht eine Änderung aus. Ist der Master online, lädt ihn der Artikel-Sync hoch und löscht das Kennzeichen; Hochladen tut das sofort.
Sync-Fehleranzahl	Wie oft der automatische Upload hintereinander fehlschlug. Nach 5 Fehlversuchen wird der Master zurückgestellt und nur noch mit Hochladen übertragen; ein Erfolg setzt den Zähler zurück.
Shopware-Produkt-ID	UUID des Container-Produkts in Shopware.

Zuordnungen (Parts)

Unter dem Status folgen dieselben Zuordnungs-Bereiche wie beim Einzelartikel, hier aber für das Container-Produkt: Kategorien (Shop-Kategorien), Tags (Shop-Tags) und Verkaufskanal-Sichtbarkeit (Sichtbarkeit je Verkaufskanal: alle / Suche / Link).

Aktionen

Aktion	Beschreibung
Hochladen	Lädt den Master hoch: legt das Container-Produkt an bzw. aktualisiert es (Titel, Beschreibung, SEO sowie Steuer und Preis der Hauptvariante), meldet die Konfigurator-Optionen an und lädt jeden zugeordneten Artikel als Varianten-Kind hoch (inklusive eigener Beschreibung). Zum Schluss wird die Hauptvariante in der Storefront-Anzeige gesetzt. Fehler einzelner Varianten werden gesammelt gemeldet und brechen den Upload nicht ab.
Aus Shop entfernen	Entfernt die Varianten-Gruppierung aus dem Shop: Das Container-Produkt wird gelöscht und die zugeordneten Artikel, die online waren, werden anschließend automatisch als normale Einzelprodukte wieder hochgeladen — sie bleiben also im Shop verkaufbar und werden vom normalen Artikel-Sync weiter gepflegt. Der Master und alle Zuordnungen bleiben in Business Central erhalten; ein späterer Hochladen gruppiert die Artikel wieder als Varianten. Schlägt das erneute Hochladen einzelner Artikel fehl, nennt die Ergebnismeldung sie; laden Sie diese auf der Artikelkarte mit Artikel hochladen neu hoch.
Auflösen	Löst die Struktur vollständig auf: löscht das Container-Produkt im Shop (die Varianten kaskadieren) und lädt die zugeordneten Artikel anschließend als Einzelprodukte wieder hoch, dann wird der Master in Business Central gelöscht. Es erscheint eine Sicherheitsabfrage. Schlägt das erneute Hochladen einzelner Artikel fehl, nennt die Ergebnismeldung sie; laden Sie diese auf der Artikelkarte mit Artikel hochladen neu hoch.
Von Quelle kopieren	Kopiert die Shop-Inhalte (Titel, Beschreibung, SEO, Hersteller, Varianten-Einstellungen) erneut vom Quell-Artikel auf den Master. Manuelle Änderungen am Master werden nach Rückfrage überschrieben; Shop-SKU und Hauptvariante bleiben erhalten. Nur verfügbar, wenn ein Quell-Artikel hinterlegt ist.
Quelle lösen	Löst den Verweis auf den Quell-Artikel (Feld Quellartikelnr. wird geleert). Alle Inhalte des Masters bleiben unverändert.

Token-Warmup

Beim Hochladen, Aus Shop entfernen und Auflösen wird zuerst das OAuth-Token für den Shop „aufgewärmt", damit der anschließende Aufruf das gecachte Token nutzt. Das ist derselbe Mechanismus wie bei Artikel hochladen auf der Artikelkarte.

Liste Shopware 6-Varianten-Master

Die Liste zeigt je Master Shop, Code, Titel, Shop-SKU, Anzahl Varianten, Online, Synchronisiert, Artikel aktualisieren, Sync-Fehleranzahl und Letzte Synchronisation. Hochladen wirkt wie auf der Karte. Angelegt wird ein Master nur aus der Artikelkarte.

Container prüfen prüft die markierten Master gegen den Shop (ohne Markierung die aktuelle Zeile) und schreibt nichts. Online und Synchronisiert setzt auch Alle Produkte der Datenübernahme, ohne den Container je hochzuladen; ihm kann dann die Hauptvariante fehlen, und die Produktseite hat keinen Kauf-Button. Befunde:

Befund	Abhilfe
keine Hauptvariante in der Storefront-Anzeige	Hochladen
Bestand … auf dem Container	Hochladen setzt ihn auf 0
keine Varianten im Shop zugeordnet	Varianten zuordnen und hochladen
Container … existiert nicht im Shop	Shop-SKU prüfen
Der Container konnte nicht aus dem Shop gelesen werden	Verbindung prüfen

Bestehende Varianten migrieren

Steht im Shop schon ein Container-Produkt mit Varianten, erkennen Sie es meist am M-Suffix (z. B. 01.0000.32M). So überführen Sie es in einen Varianten-Master, ohne den Shop-Container neu anzulegen:

Öffnen Sie in BC die Shopware 6-Artikelkarte des Hauptartikels und wählen Sie Varianten-Master anlegen.
Prüfen Sie, dass die Shop-SKU des Masters exakt der vorhandenen Container-SKU im Shop entspricht (z. B. 01.0000.32M). Dann übernimmt der erste Upload den bestehenden Container per Aktualisierung – kein Löschen, keine Duplikate.
Ordnen Sie im Bereich Zugeordnete Varianten über Artikel hinzufügen die übrigen Varianten-Artikel zu.
Prüfen Sie die Hauptvariante Artikelnr. sowie Titel und Beschreibung des Masters (wurden aus dem Artikel kopiert).
Klicken Sie Hochladen und prüfen Sie im Storefront: Variantenauswahl, Preise, Beschreibung.
Möchten Sie eine Struktur ganz loswerden, nutzen Sie Auflösen (löst im Shop auf und lädt die Artikel als Einzelprodukte wieder hoch).

Einschränkungen

Container-Bilder: Der Container erhält keine eigenen Bilder; in der Auflistung wird das Cover-Bild der jeweiligen Variante angezeigt.
Container-Preis: Der Container übernimmt den Preis der Hauptvariante als Pflicht-Fallback (er ist selbst nicht kaufbar). Die kaufbaren Preise liegen an den Varianten-Kindern.