> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/stammdatenverwaltung/konfigurierbare-artikel/varianten-aus-dem-modus-configurator-nach-shopware.md). # Varianten aus dem MODUS Configurator nach Shopware Der Shopware 6 API Connector kann Artikelvarianten, die im **MODUS M365 Configurator** in Business Central erzeugt werden, **nativ als konfigurierbares Shopware-Produkt** uebertragen. Dabei wird der Basisartikel zum konfigurierbaren Shopware-Vater und **jede BC-Artikelvariante (Item Variant) zu einem Shopware-Kindprodukt**. Die variantenbildenden Merkmale (Sachmerkmale/Auspraegungen) werden zu Shopware **Property Groups** und **Property Group Options**. {% hint style="info" %} Dieses Modell ergaenzt das klassische Vater/Kind-Modell ueber die Tabelle Konfigurierbare Artikel (SOUSHW Parent Item). Beide Wege lassen sich parallel nutzen. Der Unterschied: Hier ist der **Basisartikel selbst** der Shopware-Vater und die Kinder sind **echte BC-Artikelvarianten** - kein separater Artikel je Variante. {% endhint %} ### Architektur im Ueberblick * **Vater** = Basisartikel: erhaelt das Feld configuratorSettings (Vereinigung aller Auspraegungen ueber alle Varianten). * **Kind** = jede Item Variant: erhaelt parentId (Shopware-ID des Vaters), options und properties (die Auspraegungen dieser Variante) sowie **Bestand, Preis und Gewicht je Variante**. ### Voraussetzungen * Der Basisartikel besitzt in Business Central **Artikelvarianten** (Standardtabelle Item Variant), z. B. aus dem MODUS M365 Configurator. * Die Mengeneinheit des Artikels ist zu Shopware hochgeladen (wie bei einfachen Artikeln). * Eine aktive Shopware-Konfiguration mit Artikelupload = aktiviert. ### Einrichtung in Business Central {% stepper %} {% step %} #### Artikel als Variantenartikel markieren Oeffnen Sie die **Artikelkarte** und aktivieren Sie im Inforegister Shopware Informationen das Feld **Variantenartikel (konfigurierbar)** (SOUSHW Variant Master). Der Artikel wird dadurch als konfigurierbarer Shopware-Vater behandelt. {% endstep %} {% step %} #### Hochladen Klicken Sie auf der Artikelkarte auf **Als konfigurierbaren Artikel (Varianten) hochladen**. Der Connector legt zuerst die benoetigten Property Groups/Options an, laedt den Vater hoch und erzeugt anschliessend fuer jede Artikelvariante ein Shopware-Kindprodukt. {% endstep %} {% step %} #### Status pruefen Oeffnen Sie die **Artikelvarianten** des Artikels. Dort sehen Sie je Variante die Shopware-Sync-Spalten: aktiv, synchronisiert, Web-ID, synchronisiert am und Meldung. {% endstep %} {% endstepper %} Fuer Massenlaeufe steht im Report **Shopware Upload** zusaetzlich die Option **Variantenartikel (konfigurierbar)** zur Verfuegung. Variantenartikel werden ausserdem automatisch im normalen Produkt-Upload beruecksichtigt. ### Was genau wird hochgeladen? | Element | Shopware-Feld | Herkunft in BC | | ------------------------ | -------------------- | ----------------------------------------------------------------------------------- | | Vater | configuratorSettings | Vereinigung aller Auspraegungen aller Varianten | | Kind Artikelnummer | productNumber | Artikelnr. + Bindestrich + Variantencode | | Kind Zuordnung zum Vater | parentId | Shopware-ID des Basisartikels | | Kind Achsen | options, properties | Sachmerkmal/Auspraegung der Variante | | Kind Bestand | stock | Lagerbestand je Variantencode (Item Ledger Entry) abzueglich offener Verkaufsmengen | | Kind Preis | price | Basisartikel-Preis bzw. Standard-Preisliste | | Kind Gewicht | weight | variantenspezifisch (Configurator) oder Artikelgewicht | ### Sachmerkmale und Auspraegungen (Achsen) Jedes **Sachmerkmal** wird zu einer Shopware **Property Group** (property-group), jede **Auspraegung** zu einer **Property Group Option** (property-group-option). Die Shopware-IDs werden im Mapping (Modul Configurator Attribute) gespeichert und wiederverwendet, damit keine Duplikate entstehen. Der Zusammenhang zum klassischen Attribut-Abgleich ist unter [Attribute und Eigenschaften (Property Groups) abgleichen](/shopware/daten-aus-shopware-download-and-matching/attribute-and-eigenschaften-property-groups-abgleichen.md) beschrieben. {% hint style="warning" %} **Herkunft der Merkmale:** Sind die Symbole des MODUS M365 Configurator noch nicht in der Erweiterung eingebunden, verwendet der Connector einen **Fallback**: Es wird genau eine Achse namens Variante mit der Variantenbeschreibung erzeugt. Vater/Kind-Struktur und der Bestand je Variante funktionieren dann bereits vollstaendig. Zum Aktivieren der echten mehrachsigen Sachmerkmale werden die Configurator-Symbole benoetigt. {% endhint %} ### Abgrenzung: welches Variantenmodell waehle ich? * **Basisartikel + BC-Artikelvarianten (diese Seite):** ideal, wenn die Varianten im MODUS Configurator als echte Item Variant gefuehrt werden. Ein Artikel, viele Varianten. * **Konfigurierbare Artikel ueber SOUSHW Parent Item:** ideal, wenn jede Variante ein **eigener BC-Artikel** ist. Siehe [Konfigurierbare Artikel](/shopware/stammdatenverwaltung/konfigurierbare-artikel.md). Fuer das nachtraegliche Verknuepfen bestehender Shopware-Varianten lesen Sie [Varianten abgleichen (Farbe und Groesse)](/shopware/daten-aus-shopware-download-and-matching/varianten-abgleichen-farbe-and-grosse.md). ### Haeufige Fragen #### Wie werden MODUS-Configurator-Varianten nach Shopware uebertragen? Der Basisartikel wird als konfigurierbarer Shopware-Vater hochgeladen und jede BC-Artikelvariante (Item Variant) als eigenes Shopware-Kindprodukt mit parentId. Aktivieren Sie dazu auf der Artikelkarte das Feld **Variantenartikel (konfigurierbar)** und nutzen Sie die Aktion **Als konfigurierbaren Artikel (Varianten) hochladen**. #### Woraus entstehen die Variantenachsen in Shopware? Aus den Sachmerkmalen und Auspraegungen: Jedes Sachmerkmal wird zu einer Shopware Property Group, jede Auspraegung zu einer Property Group Option. Der Connector legt fehlende Gruppen/Optionen automatisch an und speichert deren Shopware-IDs, um Duplikate zu vermeiden. #### Wie lautet die Artikelnummer (SKU) einer Variante in Shopware? Die productNumber des Kindprodukts setzt sich aus der Artikelnummer des Basisartikels und dem Variantencode zusammen (Artikelnr. + Bindestrich + Variantencode). Dadurch ist jede Variante eindeutig identifizierbar. #### Wird der Bestand je Variante berechnet? Ja. Der Bestand wird je Variantencode aus den Artikelposten (Item Ledger Entry) ermittelt und um offene Verkaufsmengen dieser Variante reduziert. Ueber Nicht vorraetig je Variante laesst sich der Bestand gezielt auf 0 setzen. #### Muss ich das bestehende Vater/Kind-Modell umstellen? Nein. Das Modell ueber SOUSHW Parent Item (eigener Artikel je Variante) bleibt unveraendert nutzbar. Das neue Modell ist additiv und wird ausschliesslich fuer Artikel mit gesetztem Kennzeichen **Variantenartikel (konfigurierbar)** verwendet. #### Was passiert, wenn die MODUS-Configurator-Symbole noch nicht eingebunden sind? Dann greift ein Fallback mit einer einzigen Achse Variante (Wert = Variantenbeschreibung). Die konfigurierbare Vater/Kind-Struktur und der Bestand je Variante funktionieren bereits vollstaendig; die mehrachsigen Sachmerkmale werden aktiviert, sobald die Configurator-Symbole verfuegbar sind. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.solutioo.de/shopware/stammdatenverwaltung/konfigurierbare-artikel/varianten-aus-dem-modus-configurator-nach-shopware.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.