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 Variant Masters (Liste) → Eintrag anklicken
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. Alle laufen ausschließlich über Ihren Klick in Business Central – nichts wird automatisch übertragen.

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 Variants), 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

General

Feld	Beschreibung
Shop-Code	Shop, zu dem dieser Master gehört. 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 Listings 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.

Variants

Feld	Beschreibung
Variantensatz	Varianten-Set (Property-Gruppen und -Optionen), das die Variantendimensionen definiert (z. B. Farbe, Größe). Siehe Eigenschaftssets.
Variantenauswahl	Darstellung im Shop: Standard (Dropdown), Bild (Vorschaubilder) oder Farbe (Farbfelder).

Darunter der Bereich Zugeordnete Varianten – die zugeordneten Artikel (Kinder). Hier ordnen Sie über Artikel hinzufügen weitere Artikel zu und legen mit Als Hauptvariante festlegen die Hauptvariante fest.

Description

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 Description Long 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.
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 im Storefront-Listing 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.
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.
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 Source Item No. 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.

Bestehende Varianten migrieren

Wurde eine Struktur früher noch über den alten Weg („Upload Item with Variants") hochgeladen, erkennen Sie sie im Shop am M-Suffix des Container-Produkts (z. B. 01.0000.32M). So überführen Sie sie in einen Varianten-Master, ohne den Shop-Container neu anzulegen:

Öffnen Sie in BC die Shopware-6-Artikelkarte des bisherigen 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 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).

Bekannte Einschränkungen (Phase 1)

Container-Bilder: Der Container erhält keine eigenen Bilder; im Listing 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.
Import Shop → BC: Der Abgleich vom Shop nach BC legt (noch) keine Varianten-Master an (Phase 2).