Shopware 6 Adapter – Was wird aus dem PIM übertragen?

Der Shopware-6-Adapter in ComBinder synchronisiert E-Katalog-Produkte vollständig in einen Shopware-6-Shop. Dieser Artikel beschreibt, welche Datenfelder, Strukturen und Medien dabei übertragen werden – von der einfachen Artikelnummer bis zur mehrsprachigen Variantenkonfiguration.

Für die grundlegende Einrichtung des Adapters (Verbindungsdaten, Export-Knoten, Durchführung) siehe Shopware 6 Produkt-Upload.

Übersicht: Transferierte Datenbereiche

Bereich	Inhalte
Identifikation	Artikelnummer, EAN, Hersteller-Artikelnummer, Hersteller-Name
Texte	Kurztext (Name), Langtext (Beschreibung), Keywords, Meta-Titel, Meta-Beschreibung
Preise	Einfacher Preis, Staffelpreise, Steuerklasse, Währung
Lager & Logistik	Lagerbestand, Gewicht, Maße, Lieferzeit, Verpackungseinheit
Merkmale	Property Groups (Filtermerkmale), Custom Fields, Meta-Felder, CMS-Layout-ID
Medien	Produktbilder (inkl. Coverbild), Download-Dateien, Alt-Texte
Varianten	Konfigurator-Optionen, Variantenpreise, Variantenbilder, Listing-Konfiguration
Kategorien	Vollständige Gruppenstruktur des E-Katalogs inkl. Übersetzungen
Mehrsprachigkeit	Name, Beschreibung, Merkmale, Kategorien in allen konfigurierten Sprachen

Identifikation

Jedes Produkt wird in Shopware 6 anhand der Lieferanten-Artikelnummer (supplierPid) identifiziert. Diese wird als productNumber übertragen und dient als stabiler Schlüssel für Folge-Exporte. Weitere Identifikationsfelder:

EAN – direkt als ean übertragen, sofern am Produkt gepflegt.
Hersteller-Artikelnummer (manufacturerNumber) – Fallback auf productNumber, falls nicht gepflegt.
Hersteller – Der Hersteller-Name wird in Shopware 6 als Manufacturer-Entität gesucht oder automatisch neu angelegt.

Produkttexte und Sprachen

ComBinder überträgt alle Texte mehrsprachig. Im Export-Knoten wird eine Liste von BMEcat-Sprachcodes (z. B. deu, eng) konfiguriert.

Name (Kurztext / DESCRIPTIONSHORT) – als name des Shopware-Produkts.
Beschreibung (Langtext / DESCRIPTIONLONG) – als description; HTML wird übertragen und kann optional über ein konfigurierbares Tag-zu-CSS-Klassen-Mapping (HTML-Mapping) aufbereitet werden.
Keywords – alle KEYWORD-Felder des Produkts, kommagetrennt als keywords und zusätzlich als customSearchKeywords-Array.

Die Shop-Standardsprache wird als primärer Inhalt des Produktobjekts gesetzt. Alle weiteren Sprachen werden als Shopware-Übersetzungen gesammelt und gebündelt per Bulk-API-Aufruf (/_action/sync) übertragen. Das Sprach-Mapping läuft automatisch: BMEcat-Dreibuchstaben-Code → Shopware-Locale → Shopware-Sprach-ID.

Preise

Welcher Preistyp exportiert wird, ist im Export-Knoten konfigurierbar (Preistypen für Export). ComBinder unterscheidet:

Einfacher Preis

Netto-Betrag und der zugehörige Steuersatz (aus dem Produktpreis) werden übertragen. Shopware 6 berechnet daraus den Brutto-Betrag (gross = net × (tax + 100) / 100). Die Währung wird per ISO-4217-Code auf die entsprechende Shopware-Währungs-Entität abgebildet.

Staffelpreise

Sind mehrere Preisstaffeln am Produkt hinterlegt, werden diese als prices[] übertragen:

Mindestmenge (quantityStart) und Höchstmenge (quantityEnd) pro Staffel
Netto- und Brutto-Betrag
Verknüpfung mit einer Shopware-Preisregel (Rule) – die Regel kann im Export-Knoten festgelegt werden; Fallback ist die Regel mit höchster Priorität.

Produkte ohne Preis

Produkte ohne gepflegten Preis werden übersprungen und im Export-Log als Fehler ausgewiesen. Bei Produkten mit Varianten wird der kleinste Variantenpreis als Hauptpreis des Elternprodukts verwendet.

Lager und Logistik

PIM-Feld	Shopware-Feld
`CBPRODUCTSTOCK` (aus Produktlogistik)	`stock`
Gewicht (`PRODUCTDIMENSIONS`)	`weight` (kg), `purchaseUnit`, `referenceUnit = 1.0`, Einheit „kg“
Breite	`width`
Tiefe	`height` (Shopware-Konvention)
Länge	`length`
Lieferzeit in Tagen (`LEADTIME`)	`deliveryTime` (Shopware-Lieferzeitobjekt)

Alle Produkte werden mit active = true exportiert.

Produktmerkmale (Properties und Custom Fields)

Produktmerkmale aus dem PIM-Workspace können auf drei Arten an Shopware übergeben werden – je nach Konfiguration im Export-Knoten:

Property Groups (Standard)

Merkmale, die nicht explizit anders konfiguriert sind, werden als Shopware-Property Groups mit ihren Options-Werten übertragen. Sie erscheinen im Shop als Filtermerkmale und in der Produkteigenschafts-Liste. Merkmalsname, Optionsname und alle Übersetzungen werden automatisch per Bulk-Upload synchronisiert. Bei ETIM-Workspaces werden die normierten ETIM-Merkmalsnamen und -Werte verwendet.

Custom Fields (freie Attribute)

Bestimmte Merkmals-IDs können im Export-Knoten als Simple Attributes markiert werden. Ihr Wert wird dann als customFields.{merkmalname} (String-Map) übertragen – ideal für Shop-interne Zusatzfelder, die nicht als Filtermerkmale erscheinen sollen.

Meta-Felder

Merkmals-IDs können auch als Quelle für SEO-Felder konfiguriert werden:

Meta-Titel (metaTitle) – Wert des konfigurierten Merkmals
Meta-Beschreibung (metaDescription) – Wert des konfigurierten Merkmals
CMS-Layout-ID (cmsPageId) – UUID eines Shopware-Erlebniswelt-Layouts; ermöglicht produktspezifische Seitenlayouts

Ausschluss von Merkmalen

Merkmals-IDs, die in der Ausschlussliste des Export-Knotens konfiguriert sind, werden komplett ignoriert und weder als Property noch als Custom Field übertragen.

Produktbilder und Medien

Alle MIME-Einträge des Produkts (außer denen mit Zweck DOWNLOAD) werden als Produktbilder übertragen:

ComBinder sucht anhand des Dateinamens (ohne Extension) im Shopware-Media-Repository.
Bereits vorhandene Bilder werden direkt verknüpft – kein erneuter Upload.
Neue Bilder werden je nach MIME-Root-Typ hochgeladen: lokal via Dateipfad, FTP via dekodierten FTP-Pfad, HTTPS via direkten URL-Upload.
Der Alt-Text (MIMEALT) wird als Beschriftung der Shopware-Media-Entität übernommen.
Das erste Bild bzw. ein Bild mit Zweck cover wird als Coverbild (coverId) gesetzt.
Die Reihenfolge der Bilder (position) entspricht der Reihenfolge im PIM.

Download-Dateien: MIME-Einträge mit Zweck DOWNLOAD werden als Shopware-Downloads (downloads[]) an das Produkt angehängt – für digitale Produkte oder Datenblätter.

Option „Bilder an Varianten vererben“: Wenn aktiviert, werden die Bilder des Hauptprodukts zusätzlich auch jeder Variante zugewiesen.

Produktvarianten

Hat ein Produkt im E-Katalog Varianten, analysiert ComBinder automatisch, welche Merkmale die Varianten unterscheiden, und baut das Shopware-Konfiguratoren-System auf:

Konfigurator-Ermittlung

Merkmale, die über alle Varianten hinweg mehr als einen Wert haben, werden zu Konfiguratoren (z. B. Farbe, Größe). Merkmale mit einheitlichem Wert bleiben Properties. Das Ergebnis bildet das configuratorSettings[]-Array des Elternprodukts.

Übertragte Variantenfelder

Artikelnummer, EAN, Hersteller-Artikelnummer
Preis(staffeln), Steuerklasse
Lagerbestand, Gewicht und Maße
Konfigurator-Optionen (options[]) – die konkreten Merkmalswerte der Variante
Bilder (optional: auch Bilder des Hauptprodukts)

Listing-Konfiguration

Im Export-Knoten ist konfigurierbar, was im Shop-Listing erscheint:

Varianten im Listing (Standard): Jede Variante erscheint als eigener Listeneintrag mit eigener Sichtbarkeit.
Hauptprodukt im Listing: Nur das Elternprodukt erscheint im Listing; Varianten sind nur auf der Produktdetailseite auswählbar.

Sichtbarkeit und Sales Channel

Alle exportierten Produkte und Varianten erhalten die Sichtbarkeit Überall sichtbar (visibility = 30) im konfigurierten Shopware-Sales-Channel. Der Sales Channel wird aus der Verbindungskonfiguration des Webshops übernommen.

Export-Ablauf und Update-Verhalten

Beim Export durchläuft ComBinder acht Phasen:

Authentifizierung und Cache-Initialisierung (Steuern, Währungen, Sprachen, Einheiten)
Media-Library-Cache laden
Property Groups und Optionen sammeln
Merkmalswerte pro Produkt aufbereiten
Kategorie-Struktur synchronisieren
Property-Group-Übersetzungen per Bulk-Upload senden
Produkte hochladen (Übersetzungen gebündelt alle 50 Produkte)
Abschluss-Indexierung und Validierung

Update-Verhalten: Bestehende Produkte werden anhand der Artikelnummer gefunden, zuerst vollständig gelöscht (inkl. aller Varianten) und dann neu angelegt. Es gibt kein partielles Update einzelner Felder.

Option „Alle Produkte löschen“: Wenn aktiviert, werden vor dem Export alle Produkte im Shop entfernt – unabhängig davon, ob sie im aktuellen E-Katalog enthalten sind.

Konfigurationsoptionen im Export-Knoten

Option	Bedeutung
Webshop-Verbindung	Welcher konfigurierte Shopware-6-Shop wird angesprochen
Wurzelkategorie	Startpunkt der Kategorie-Hierarchie im Shop
Sprachen	BMEcat-Sprachcodes, die exportiert werden
Preistypen	Welche Preistypen aus dem PIM exportiert werden
Staffelpreis-Regel	Shopware-Regel, unter der Staffelpreise gelten
Merkmale als Custom Fields	Merkmals-IDs, die als `customFields` statt als Properties übertragen werden
Merkmale ausschließen	Merkmals-IDs, die nicht in den Shop übertragen werden
Meta-Titel-Merkmal	Merkmals-ID, deren Wert als SEO-Titel verwendet wird
Meta-Beschreibungs-Merkmal	Merkmals-ID, deren Wert als SEO-Beschreibung verwendet wird
CMS-Layout-Merkmal	Merkmals-ID, deren Wert als Erlebniswelt-Layout-UUID verwendet wird
HTML-Mapping	HTML-Tag → CSS-Klassen-Mapping für die Produktbeschreibung
Hauptprodukt im Listing	Steuert, ob Elternprodukt oder Varianten im Shop-Listing erscheinen
Bilder an Varianten vererben	Hauptprodukt-Bilder zusätzlich auch an Varianten anhängen
Alle Produkte löschen	Shop vor dem Export komplett leeren