In diesem Artikel erfährst du, wie du Freifelder reibungslos über die Connect-Schnittstelle von Xentral an Shopware 6 überträgst. Wir geben einen Überblick über die verschiedenen Mapping-Optionen, damit deine Produktdaten genau dort im Shop landen, wo du sie benötigst. Wir zeigen dir:
wo du die Freifeldzuordnung in den Workflows konfigurierst,
wie du Freifelder als Zusatzfelder oder Eigenschaften an Shopware übergibst und
wie du Standardfelder in Shopware 6 über deine Xentral-Freifelder befüllen kannst.
Anmerkung
Dieser Artikel setzt grundlegende Kenntnisse über die Xentral Connect Funktionen und eine vollständig eingerichtete Shopware 6-Schnittstelle voraus. Wenn du die Einrichtung noch nicht abgeschlossen hast, findest du dazu alle Informationen unter Shopware 6.
Video-Tutorial
Schau dir gern das folgende Video an, um praxisnah zu sehen, wie du Freifelder zwischen Xentral und Shopware 6 synchronisieren kannst:
Xentral Freifelder zuordnen
Grundsätzlich bestehen folgende Möglichkeiten, Freifelder an Shopware 6 zu übertragen:
Xentral Freifelder > Shopware-Zusatzfelder (Steuerung über Dropdown-Feld)
Alle
Manuelle Auswahl
Xentral Freifelder > Shopware-Eigenschaften (Steuerung über Dropdown-Feld)
Alle
Manuelle Auswahl
Xentral Freifelder > Shopware-Standardfelder
Die Einstellung für die Zusatzfelder und Eigenschaften nimmst du in der Connect-Schnittstelle vor. Navigiere dazu unter Einstellungen > Verkaufen > Shops/Marktplätze > Shopware6 > Workflows in den Reiter Artikel. Dort findest du das Dropdown-Feld Freifeldzuordnung mit vier verschiedenen Auswahlmöglichkeiten, die wir in den folgenden Abschnitten im Detail erklären.
Tipp
Wie du unabhängig von dieser Einstellung die Standardfelder befüllst, erfährst du weiter unten in diesem Artikel.
Zuordnung zu Shopware 6 Zusatzfelder
Die ersten beiden Optionen aus dem Dropdown schreiben deine Xentral-Freifelder in die Zusatzfelder von Shopware 6.
Möglichkeit 1: Freifelder aus Xentral übernehmen
Wenn du diese Option wählst, werden in Xentral bestehende Freifelder automatisch als Zusatzfelder in Shopware angelegt. Ein manuelles Mapping ist hierbei nicht erforderlich.
Xentral legt dafür automatisch ein so genanntes Zusatzfeld-Set mit der Bezeichnung "Connect" an. In diesem Set werden dann so genannte Labels, die eigentlichen Zusatzfelder (bzw. Freifelder in Xentral) angelegt, z. B. "Farbe" oder "Herkunft". Du findest das Set mit den Freifeldern in Shopware unter Einstellungen > System > Zusatzfelder. Im Shopware-Artikel stehen die Daten im Reiter Spezifikationen, im Bereich Zusatzfelder.
Hinweis
Bitte beachte: Der Name des automatisch angelegten Sets ("Connect") sowie die Labels (entsprechen den Freifeldnamen) sind in Shopware anschließend nicht mehr editierbar.
Möglichkeit 2: Manuelle Zuordnungstabelle
Diese Option bietet dir eine bessere Kontrolle über deinen Export. Du definierst hier gezielt, welche Freifelder exportiert und angelegt werden sollen. In diesem Fall müssen das Set und das Label in Shopware bereits existieren.
Du wählst das gewünschte Zusatzfeld dann über das Dropdown-Menü aus oder tippst es einfach ein (1). Falls sich in Shopware Namen oder Labels geändert haben, kannst du die Optionen neu laden (2), damit die aktuellen Werte frisch aus dem Shop gezogen werden.
In diesem Fall werden ausschließlich die von dir zugeordneten Freifelder exportiert.
Zuordnung zu Shopware 6 Eigenschaften
Die dritte und vierte Option schreiben deine Xentral-Freifelder in die Eigenschaften von Shopware 6. Du findest diese in Shopware unter Kataloge > Eigenschaften und im jeweiligen Shopware-Artikel im Reiter Spezifikation im Bereich Eigenschaften.
Möglichkeit 3: Freifelder aus Xentral automatisch in verfügbare Eigenschaften schreiben
Diese Option verhält sich ähnlich wie Möglichkeit 1, benötigt jedoch die Eigenschaftsnamen (z. B. Farbe) bereits in Shopware. Ist der Wert noch nicht vorhanden, wird dieser (z. B. gelb) automatisch in die Shopware-Eigenschaft hinzugefügt und erscheint dann im Artikel.
Möglichkeit 4: Freifelder aus Xentral den im Verkaufskanal verfügbaren Eigenschaften manuell zuordnen
Mit der letzten Option hast du wiederum mehr Kontrolle, analog zur Möglichkeit 2. Du kannst genau eingrenzen, welche deiner Freifelder in Shopware als Eigenschaft und -wert übergeben werden sollen. Sie müssen bereits in Shopware angelegt sein.
Besonderheit: Shopware 6 Standardfelder befüllen
Unabhängig von deiner Auswahl im Dropdown Freifeldzuordnung kannst du auch Shopware-Standardfelder – etwa Mindestabnahme, Verkaufsintervall oder Verpackungseinheit – direkt aus Xentral befüllen. Dafür gibt es zwei Wege:
Über Freifelder: Lege das Xentral-Freifeld so an, dass es den Namen des entsprechenden Shopware-Felds enthält. Ist das der Fall, landen die Werte direkt in den Artikelstammdaten von Shopware.
Über Eigenschaften: Arbeitest du lieber mit Eigenschaften, nutze stattdessen den technischen Namen des Shopware-Felds.
Folgende Felder kannst du auf beiden Wegen befüllen:
Shopware-Feld | Name (für Freifeld) | Technischer Name (für Eigenschaft) |
Maßeinheit | Maßeinheit | shopware6_unit |
Verkaufseinheit oder Inhalt | Verkaufseinheit oder Inhalt | shopware6_purchase_unit |
Grundeinheit | Grundeinheit | shopware6_reference_unit |
Verpackungseinheit | Verpackungseinheit | shopware6_pack_unit |
Verpackungseinheiten (Mehrzahl) | Verpackungseinheiten | shopware6_pack_unit_plural |
Maximalabnahme | Maximalabnahme | shopware6_max_purchase |
Mindestabnahme | Mindestabnahme | shopware6_min_purchase |
Erscheinungsdatum | Erscheinungsdatum | shopware6_release_date |
Wiederauffüllzeit | Wiederauffüllzeit | shopware6_restock_time |
Lieferzeit | Lieferzeit | shopware6_delivery_time |
Verkaufsintervall | Verkaufsintervall | shopware6_purchase_steps |
Hinweis – Freifeld hat Vorrang
Freifelder werden vorrangig abgefragt. Nutze deshalb nicht Freifeld und Eigenschaft für dasselbe Shopware-Feld – sonst gewinnt immer das Freifeld.
Hinweis – Nur befüllte Werte werden übertragen
Sobald ein passendes Freifeld (bzw. eine Eigenschaft) befüllt ist, wird der Wert immer exportiert – unabhängig von deiner Auswahl bei der Freifeldzuordnung. Möchtest du einen Wert nicht übergeben, lass das Feld in Xentral einfach leer. Es werden nur befüllte Werte in den Shop geschrieben.