News Shop-Management

JSON-Import in Magento 2 & Adobe Commerce: So binden Händler JSON-Dateien 2026 ein

Wer Produktdaten per JSON in Magento 2 importieren will, stößt auf eine harte Grenze: Adobe Commerce und Magento Open Source verstehen im Standard nur CSV. JSON, das Format, in dem PIM-Systeme, Lieferanten-Feeds und REST-APIs heute liefern, bleibt außen vor. Für Shops ab einer Million Euro Jahresumsatz ist das kein Randproblem – es bremst die gesamte Datenpipeline.

Die Lage hat sich 2026 nicht geändert, aber die Lösungswege sind klarer denn je. Drei Ansätze haben sich im Markt etabliert: eine Import-Extension, der Weg über die Commerce-APIs oder eine Middleware dazwischen. Welcher passt, hängt von Datenvolumen, Takt und Team ab.

Warum ignoriert Adobe Commerce den JSON-Import?

Die Antwort liegt in der Historie: Der native Import von Magento 2 stammt aus einer Zeit, in der CSV-Exporte aus Warenwirtschaften der Standard waren. Adobe hat seither in die GraphQL- und REST-Schnittstellen investiert, nicht in den File-basierten Importer. Der JSON-Import im Backend-Assistenten fehlt daher auch in den aktuellen 2.4.x-Releases.

Praktisch heißt das: Ein JSON-Feed vom Lieferanten – etwa Artikelstammdaten mit verschachtelten Attributen – lässt sich nicht hochladen. Verschachtelung ist dabei der eigentliche Knackpunkt. CSV ist flach, JSON ist baumförmig. Jede Lösung muss diese Struktur auf die Magento-Attribute abbilden.

Extension, API oder Middleware: Was funktioniert im Alltag?

Am weitesten verbreitet ist die Extension Improved Import & Export von Firebear Studio. Sie ergänzt JSON, XML, XLSX und Google Sheets als Importquellen, mappt verschachtelte Felder per Backend-Konfiguration und erlaubt Cron-basierte Jobs direkt aus URLs oder SFTP-Quellen. Für Händler ohne eigene Entwicklungskapazität ist das der schnellste Weg. Kostenpunkt: einige hundert Euro Lizenz, je nach Edition.

Wer ein PIM wie Akeneo, Pimcore oder Contentserv betreibt, fährt mit dem API-Weg meist besser. Statt Dateien zu schieben, schreibt ein Konnektor die Daten über die REST-Endpunkte von Adobe Commerce direkt in den Katalog. Vorteil: Validierung pro Datensatz und saubere Fehlerprotokolle. Nachteil: Bei 100.000 SKUs dauert ein Vollabgleich über die API spürbar länger als ein Datei-Import, und Rate Limits setzen enge Grenzen.

Die dritte Option ist eine Middleware – etwa eine Integrationsplattform oder ein schlanker Eigenbau auf Node.js oder Python, der JSON entgegennimmt, nach CSV oder direkt in die Datenbank transformiert. Das ist der flexibelste Weg, aber auch der teuerste im Unterhalt. Er lohnt sich erst, wenn mehrere Systeme angebunden werden müssen.

Kernsatz: Magento 2 kann nativ kein JSON importieren – die pragmatische Lösung für die meisten Händler ist eine Import-Extension mit Feld-Mapping, bei vorhandenem PIM dagegen der API-Konnektor.

Woran JSON-Importe in der Praxis scheitern

Die häufigste Fehlerquelle ist nicht das Format, sondern das Mapping. JSON-Feeds liefern Attribute oft in anderer Benennung oder Tiefe, als Magento sie erwartet – aus price.gross.EUR muss das Attribut price werden, aus einem Array von Bild-URLs mehrere Media-Gallery-Einträge. Ohne definiertes Mapping-Regelwerk scheitern Jobs still oder schreiben halbe Datensätze.

Zweiter Stolperstein: konfigurierbare Produkte. Der JSON-Feed muss die Verknüpfung zwischen Parent und Varianten sauber liefern, sonst entstehen verwaiste Simple Products. Drittens die Performance: Ein Cron-Job, der nachts 50.000 Produkte aktualisiert, sollte den Indexer nicht komplett neu aufbauen – partieller Reindex ist Pflicht, sonst leidet die Ladezeit am Morgen danach.

Redaktionelle Einschätzung: Dass Adobe den nativen Importer 2026 immer noch auf CSV beschränkt, während der Rest der Branche JSON und Events spricht, ist ein Armutszeugnis für die Roadmap – und ein dauerhaftes Geschäftsmodell für Extension-Anbieter.

Der konkrete nächste Schritt für Betreiber: Prüfen, welche Datenquellen bereits JSON liefern, dann einen Testlauf mit einer Import-Extension auf einer Staging-Instanz fahren. Wer das Mapping einmal sauber aufgesetzt hat, automatisiert danach den gesamten Feed – und hat die CSV-Konvertierung als manuellen Zwischenschritt endgültig abgeschafft.