Wer mit Großhändlern arbeitet, kennt das Bild: Der Lieferant schickt eine XML-Datei mit 40.000 Artikeln, Magento 2 verweigert den Import. Die Attribute heißen anders, die Struktur passt nicht zum Magento-Schema, und die Standard-Importfunktion akzeptiert ohnehin nur CSV in einem starren Format. Mit einer XSLT-Transformation lässt sich dieses Problem direkt am Importpunkt lösen, ohne vorher jede Lieferantendatei manuell umzubauen.
XSLT (Extensible Stylesheet Language Transformations) ist eine W3C-Sprache, die XML-Dokumente in andere XML-Strukturen überführt. Für Händler heißt das konkret: Die Datei des Lieferanten bleibt, wie sie ist. Ein definiertes Stylesheet mappt die fremden Felder, etwa <article_no> oder <net_price>, auf die Magento-Attribute sku und price. Der Import läuft anschließend mit den nativen Mechanismen von Magento Open Source beziehungsweise Adobe Commerce.
Warum scheitern Lieferanten-XML-Dateien am Standard-Import?
Die kurze Antwort: Magentos Import-Modul erwartet eine exakt definierte Spalten- und Attributstruktur und versteht keinerlei Fremdformate. Jeder Lieferant liefert jedoch sein eigenes Schema, eigene Feldnamen, verschachtelte Knoten, abweichende Maßeinheiten. Hinzu kommt die Gegenrichtung: Beim Export Richtung ERP, CRM oder Warenwirtschaft will auch dort kein System mit der Magento-Struktur umgehen.
In der Praxis endet das häufig in Excel-Nachtschichten oder wöchentlich angepassten Skripten, die beim nächsten Struktur-Update des Lieferanten wieder brechen. XSLT verlagert die Anpassungslogik in ein zentrales, versionskontrollierbares Stylesheet. Ändert der Lieferant sein Format, wird genau eine Datei angepasst, nicht der gesamte Importprozess.
Wie läuft der XSLT-Import in der Praxis ab?
Der Ablauf ist technisch überschaubar. Zunächst wird ein XSLT-Stylesheet erstellt, das die Quellstruktur des Lieferanten beschreibt und auf das Zielformat abbildet. Beim Import verarbeitet ein XSLT-Prozessor, PHP bringt mit der libxslt-Erweiterung bereits alles Nötige mit, die XML-Datei und erzeugt daraus ein Magento-kompatibles Format. Danach greift der reguläre Import-Job, inklusive der gewohnten Validierung von SKUs, Attributsets und Steuerklassen.
Bemerkenswert an diesem Ansatz ist die Verankerung im Magento-Ökosystem: Die Transformation findet innerhalb der Shop-Infrastruktur statt, nicht in einem externen Middleware-Tool. Für Händler mit mehreren Lieferanten bedeutet das ein Stylesheet pro Quelle, übersichtlich, testbar, und in Git versionierbar statt als undokumentiertes PHP-Skript auf dem Server.
Wann lohnt sich der Aufwand, und wann nicht?
Bei einem einzelnen Lieferanten mit stabiler CSV-Datei ist XSLT überdimensioniert. Anders sieht es aus, sobald mehrere Quellen mit eigenen XML-Schemata ins Spiel kommen oder Produktdaten häufig synchronisiert werden müssen, etwa bei Preis- und Bestandsupdates im Stundentakt. Dann amortisiert sich die initiale Stylesheet-Entwicklung schnell, weil jede weitere Lieferantenanbindung nur noch ein weiteres Mapping bedeutet.
Die Schwäche sollte man nicht verschweigen: XSLT hat eine steile Lernkurve, und komplexe Transformationen werden schnell unleserlich. Wer keine Entwicklungskapazität im Haus hat, sollte die Stylesheets einmalig professionell erstellen lassen und nur noch das Mapping pflegen. Tools wie die Improved Import & Export Extension von Firebear Studio bieten XSLT-basierte Importprofile bereits als fertige Admin-Oberfläche, ein gangbarer Weg für Teams ohne tiefere XML-Erfahrung.
Was Händler jetzt tun sollten: Die Lieferantenformate inventarisieren, prüfen, welche davon überhaupt XML liefern, und für den volumenstärksten Lieferanten ein erstes XSLT-Mapping aufsetzen. Wer den Proof of Concept einmal durch hat, kann die restlichen Quellen in Tagen statt Wochen anbinden, und die Excel-Nachtschichten einstellen.