News Tools

Magento 2 Import: Mit XSLT jede Lieferanten-XML nach Open Source und Adobe Commerce holen

Ein deutscher Ersatzteilhändler bekommt vom Zulieferer wöchentlich eine 40-Megabyte-XML-Datei. Produktnamen heißen dort „ItemDescription“, Preise stehen in einem Knoten namens „GrossAmount“, Kategorien sind hierarchisch verschachtelt. Der native Import von Magento 2 scheitert an dieser Datei kläglich – und die händische Umwandlung in CSV frisst einen halben Arbeitstag. Genau hier setzt die XSLT-Transformation an: Sie übersetzt beliebige XML-Strukturen in ein Format, das Magento Open Source und Adobe Commerce ohne Umweg verarbeiten.

Warum scheitert der Standard-Import von Magento 2 an Lieferanten-XML?

Die kurze Antwort: Der Kern-Import akzeptiert nur CSV und erwartet exakt die Attributnamen und Spaltenlogik von Magento – jede Abweichung bricht den Lauf ab oder erzeugt fehlerhafte Datensätze. Wer Produkte, Kunden oder Bestellungen aus ERP- und PIM-Systemen oder direkt von Lieferanten anbinden will, steht vor demselben Problem: Kein Lieferant richtet sein Exportformat nach Magentos Wünschen aus. Bisherige Lösungen waren aufwendig. Entweder ein Dienstleister schreibt individuelle Mapping-Skripte, oder eine Middleware wie ein ESB dazwischen formatiert die Daten um. Beides kostet Budget und schafft Abhängigkeiten.

XSLT – Extensible Stylesheet Language Transformations – ist dafür der etablierte Standard aus dem Enterprise-Umfeld. Ein einmal definiertes Stylesheet beschreibt Regel für Regel, wie Knoten der Quelldatei auf Magento-Attribute gemappt werden. Umbenennungen, Verschachtelungen auflösen, Werte zusammenführen, Preise umrechnen: All das passiert deklarativ, ohne Zeilen in PHP.

Wie funktioniert die Transformation im Shop-Alltag?

Der Ablauf ist denkbar einfach: Die Roh-XML kommt per URL, FTP oder Upload ins System, das Stylesheet transformiert sie in eine Magento-kompatible Struktur, danach greift der reguläre Import. Der entscheidende Vorteil liegt in der Wartbarkeit. Ändert der Lieferant sein Format, passt der Integrator ein Stylesheet an – kein Deployment, kein Code-Review, kein Ausfall des Nacht-Crons.

Praxisrelevant wird das bei der FireBear-Erweiterung Improved Import & Export, die XSLT bereits seit mehreren Versionen als Mapping-Ebene unterstützt und unter Magento 2.4.x auf Open Source wie Adobe Commerce läuft. Wer ohnehin mit dieser Extension arbeitet, kann XSLT-Templates direkt im Import-Profil hinterlegen. Alternativ steht es Integratoren frei, die Transformation mit PHP-Bordmitteln (XSLTProcessor) oder einer kleinen CLI-Pipeline vor dem nativen Import zu schalten – das reicht für Shops mit überschaubarer Artikelanzahl völlig aus.

Kernsatz: XSLT verlagert die Format-Anpassung aus dem Programmcode in ein austauschbares Stylesheet – und macht den Magento-Import damit lieferantenagnostisch.

Die gleiche Logik gilt in der Gegenrichtung. Beim Export Richtung Warenwirtschaft, CRM oder Marktplätze erzeugt Magento selten das Format, das das Zielsystem erwartet. Ein Export-Stylesheet formt die Ausgabe so, dass etwa ein SAP-System oder ein Preisportal die Datei ohne Nachbearbeitung schluckt.

Was sollten Shop-Betreiber jetzt konkret prüfen?

Zuerst die Bestandsaufnahme: Welche Schnittstellen laufen heute über händische CSV-Bastelei oder teure Mapping-Skripte? Genau diese Prozesse sind Kandidaten für XSLT. Zweitens die Performance-Grenze im Blick behalten. Sehr große XML-Dateien oberhalb von einigen hundert Megabyte sollten gestreamt oder vorab gesplittet werden, sonst strapaziert die Transformation den Arbeitsspeicher des PHP-Prozesses. Drittens lohnt ein Blick auf die Versionslandschaft: Wer noch auf Magento 2.3.x oder frühen 2.4-Versionen fährt, sollte ohnehin planen – Adobe liefert Sicherheitsupdates nur noch für aktuelle 2.4-Minor-Releases, und moderne Import-Extensions setzen zunehmend PHP 8.2 voraus.

Wer heute Lieferanten-XML per Hand in CSV umwandelt, zahlt doppelt: einmal in Arbeitszeit und noch einmal in Fehleranfälligkeit.

Die ehrliche Einordnung zum Schluss: XSLT ist keine neue Technologie und keine Wunderwaffe. Die Stylesheets wollen gepflegt sein, und bei hochkomplexen ETL-Anforderungen mit Anreicherung aus mehreren Quellen führt an einem echten PIM- oder Integrationslayer kein Weg vorbei. Aber für den klassischen Fall – Lieferant liefert XML, Magento erwartet Magento-Format – ist XSLT die schlankste Lösung, die der Markt kennt. Händler mit mehr als zwei aktiven Lieferantenschnittstellen sollten den Umbau nicht auf die lange Bank schieben: Der ROI rechnet sich typischerweise innerhalb eines Quartals allein über eingesparte Mapping-Stunden.