60 Prozent aller Lieferanten-XMLs scheitern am Standard-Import von Magento 2. Der Grund ist banal: Attributnamen, Knotenstrukturen und Verschachtelungstiefe entsprechen selten dem, was das Shopsystem erwartet. Wer Produktdaten aus ERP-Systemen, CRMs oder direkt vom Großhändler bezieht, kennt das Problem – und die Lösung heißt XSLT-Transformation.
Magento Open Source und Adobe Commerce akzeptieren von Haus aus CSV-Dateien in einer fest definierten Struktur. XML wird im Kern nur rudimentär unterstützt. Liegt der Lieferantenkatalog als XML mit eigenem Tabellenaufbau vor – etwa mit <article> statt <product> oder abweichenden Attributbezeichnungen – bleibt der Standard-Importer stumm oder bricht mit Fehlern ab. Bisher halfen zwei Wege: manuelles Umwandeln per Skript oder ein Middleware-Tool, das monatliche Kosten verursacht.
Warum scheitert der Standard-Import an Lieferanten-XMLs?
Die Antwort liegt im Datenmodell. Magento erwartet ein flaches Schema, in dem jede Zeile einem Produkt entspricht und jede Spalte einem Attribut. Lieferanten liefern jedoch oft hierarchisch verschachtelte Strukturen: Varianten als Kindknoten, Preise in separaten Blöcken, Kategorien als Referenz-IDs. Solche Dateien lassen sich nicht eins zu eins mappen – der Importer findet die Pflichtfelder schlicht nicht.
XSLT (Extensible Stylesheet Language Transformations) greift genau hier ein. Die Stylesheet-Sprache beschreibt Regeln, nach denen ein XML-Dokument in ein anderes Format überführt wird. Konkret heißt das: Ein einmal definierter Stylesheet wandelt die Lieferantenstruktur automatisch in ein Magento-kompatibles Schema um. Attributnamen werden umbenannt, Knoten flachgezogen, Werte formatiert – und zwar bei jedem Importlauf reproduzierbar.
Wie funktioniert die XSLT-Transformation im Import-Prozess?
Der Ablauf folgt drei Schritten. Zuerst lädt der Händler die Original-XML des Lieferanten hoch. Anschließend wendet der Import-Prozess das hinterlegte XSLT-Stylesheet an: Es definiert, welche Quellknoten auf welche Magento-Attribute abgebildet werden. Zum Schluss validiert das System die transformierten Daten gegen das Magento-Schema und schreibt Produkte, Preise und Lagerbestände in den Katalog.
Praxisrelevant wird das bei heterogenen Lieferantenstrukturen. Ein Fashion-Händler mit zwölf Großhändlern pflegt zwölf Stylesheets statt zwölf Skripte – und tauscht bei einer Strukturänderung des Lieferanten nur eine Regel aus. Auch der Export profitiert: CRM- oder Warenwirtschaftssysteme mit eigenen XML-Formaten lassen sich auf demselben Weg bedienen.
Für Shops ohne interne Entwicklungskapazität existieren Extensions, die diesen Workflow in den Admin-Bereich holen. Die Improved Import & Export Extension von Firebear Studio etwa unterstützt XSLT-basierte Transformationen direkt im Import-Profil, inklusive Cron-basierter Automatisierung und Fehlerprotokoll. Solche Lösungen kosten je nach Umfang einmalig zwischen 300 und 800 Euro – gerechnet gegen Middleware-Abos oft nach wenigen Monaten amortisiert.
Was bedeutet das für den Shop-Alltag?
Kurzfristig: weniger manuelle Arbeit, weniger Fehlerquellen. Wer heute Lieferanten-XMLs vor dem Import per Hand oder Excel-Makro aufbereitet, eliminiert einen Arbeitsschritt, der bei jedem Katalog-Update erneut anfällt. Langfristig zählt die Skalierbarkeit – jeder neue Lieferant bedeutet ein neues Stylesheet statt eines neuen Integrationsprojekts.
Zwei Fallstricke bleiben. XSLT erfordert Einarbeitung; die Syntax ist mächtig, aber nicht intuitiv. Und komplexe Transformationen mit bedingter Logik (etwa unterschiedliche Steuerklassen je Herkunftsland) erhöhen die Pflege des Stylesheets. Händler sollten daher mit einem einzelnen Lieferanten starten, den Workflow validieren und erst dann weitere Quellen anbinden.
Der nächste sinnvolle Schritt: die eigenen Lieferanten-XMLs auf Strukturabweichungen prüfen. Wo der Standard-Importer bereits heute scheitert, lohnt der Test eines XSLT-Ansatzes – im Zweifel zuerst auf einer Staging-Umgebung, bevor Produktivdaten wandern.