Shopware Import: Produktdaten und CSV sauber halten

Eine CSV-Datei ist schnell hochgeladen. Ob danach Preise, Bestände und Bilder stimmen, siehst du oft erst im Shop. Der Shopware Import bringt dafür eigene Werkzeuge mit: Profile, einen Testlauf und ein Protokoll mit den fehlerhaften Einträgen. Mit Vorlage, Testlauf und einer Kontrolle danach fängst du die meisten Fehler von Hand ab. Für den Rest gibt es zwei Plugins, die dir das Prüfen abnehmen.

So arbeitet der Shopware Import: Profil, Testlauf, Protokoll

Ich entwickle seit über 20 Jahren Plugins für Shopsysteme und bin seit 2014 als Hersteller im Shopware Store vertreten. Beim Import liegt die Herausforderung selten in der Technik selbst. Sie liegt in Dateien, die aus einem anderen System kommen und dort anders aufgebaut sind, als Shopware es erwartet.

Du findest den Import im Admin unter „Einstellungen“, Reiter „Automatisierung“, „Import/Export“. Dort gibt es drei Reiter: „Import“, „Export“ und „Profile“. Ein Profil beschreibt, wie eine Datei aufgebaut ist:

Die mitgelieferten Standardprofile kannst du nicht ändern. Brauchst du andere Spalten, duplizierst du ein Standardprofil und passt die Kopie an. Über „Template herunterladen“ bekommst du eine leere Datei mit genau den Spaltenüberschriften, die das Profil erwartet. Das ist der sicherste Start für jede neue Datei.

Gestartet wird der Import im Reiter „Import“: Profil wählen, CSV-Datei hochladen, dann „Testlauf starten“ oder „Import starten“. Shopware arbeitet die Datei im Hintergrund ab, über die Nachrichtenwarteschlange des Systems. In der Liste der Import-Aktivitäten siehst du den Status: „Verarbeite“, „Erfolgreich“, „Fehlgeschlagen“ oder „Abgebrochen“. Über das Menü am Ende jeder Zeile öffnest du die Zusammenfassung und lädst die fehlerhaften Einträge herunter.

Das Schaubild in Kürze:

• Datei vorbereiten: Spalten wie im Profil, passendes Separator-Zeichen, Preise mit Punkt wie 19.99.
• Testlauf starten: Shopware schreibt probeweise, nimmt alles zurück und zeigt die fehlerhaften Einträge.
• Import starten: Er läuft im Hintergrund über die Warteschlange, der Status steht auf „Verarbeite“.
• Ergebnis prüfen: Zusammenfassung lesen, fehlerhafte Einträge herunterladen, Stichprobe im Shop.
• „Fehlgeschlagen“ heißt nicht „nichts importiert“: Gültige Zeilen stehen schon im Shop.

Der manuelle CSV-Import in sechs Schritten

Der folgende Ablauf passt für Produkte, Preise und Bestände gleichermaßen. Ich rate dazu, ihn auch dann einzuhalten, wenn die Datei „nur ein paar Preise“ ändert. Gerade kleine Änderungen werden gern ohne Testlauf eingespielt.

1. 1

   Vorlage aus Shopware holen

   Lade im Reiter „Profile“ über „Template herunterladen“ die leere Vorlage des Profils herunter oder exportiere einige bestehende Produkte mit demselben Profil. So stimmen Spaltennamen und Aufbau von Anfang an. Eine Liste aus dem ERP oder vom Lieferanten überträgst du in diese Vorlage, statt Shopware an die fremde Datei anzupassen.

2. 2

   Datei sauber speichern

   Speichere als CSV mit dem Trennzeichen, das im Profil eingestellt ist, im Standard also Semikolon, und in der Zeichenkodierung UTF-8. Prüf Preise und Mengen: Shopware erwartet Zahlen mit Punkt als Dezimaltrennzeichen und ohne Tausenderpunkt, also 1299.90 statt 1.299,90. Jede Produktnummer kommt nur einmal vor.

3. 3

   Mit einer kleinen Datei anfangen

   Nimm für den ersten Durchgang zehn bis zwanzig Zeilen, darunter ein Produkt mit Varianten und eines mit Bild. Fehler im Aufbau zeigen sich in einer kleinen Datei genauso, und du findest sie schneller.

4. 4

   „Testlauf starten“ und Zusammenfassung lesen

   Die Zusammenfassung zählt je Datensatz „Erstellt“, „Aktualisiert“, Fehler und „Übersprungen“. Passt die Zahl nicht zu deiner Datei, etwa weil Produkte neu angelegt werden, die es schon gibt, stimmt der Bezeichner im Profil nicht.

5. 5

   Fehlerhafte Einträge herunterladen

   Gibt es Fehler, lädst du über das Menü der Zeile „Fehlerhafte Einträge herunterladen“. Die Datei enthält nur die betroffenen Zeilen und zu jeder die Meldung von Shopware. Korrigiere dort und starte den Testlauf erneut, bis er ohne Fehler durchläuft.

6. 6

   Import starten und im Shop nachsehen

   Erst jetzt läuft der echte Import, danach mit der ganzen Datei. Öffne anschließend einige Produkte in der Storefront: Preis, Bestand, Bild, Kategorie und Varianten. Der Testlauf prüft, ob Shopware schreiben kann, nicht ob die Werte inhaltlich stimmen.

Was der Testlauf zeigt und was nicht

Beim Testlauf führt Shopware den Import vollständig aus, allerdings in einer Datenbank-Transaktion, die am Ende zurückgenommen wird. Alle Änderungen an der Datenbank sind danach wieder verschwunden. Er findet deshalb alles, was beim Schreiben scheitert: fehlende Pflichtangaben, Werte im falschen Format, Verweise auf Kategorien oder Steuersätze, die es nicht gibt. Was formal gültig, aber inhaltlich falsch ist, findet er nicht. Ein Bestand von 1200 statt 12 oder ein Preis in der falschen Spalte läuft ohne Meldung durch.

Für große Dateien gibt es den Import auch auf der Kommandozeile mit bin/console import:entity. Der Befehl kennt ebenfalls einen Testlauf (Option --dryRun) und kann Fehler direkt ausgeben (--printErrors).

Typische Fehler beim Shopware CSV-Import

Die meisten Fehlimporte gehen auf eine Handvoll Ursachen zurück. Die Tabelle zeigt, woran du sie erkennst und was hilft.

Der Import hängt bei „Verarbeite“

Bleibt ein Import lange auf „Verarbeite“ stehen, liegt das selten an der Datei. Shopware verarbeitet Importe als Nachrichten in einer Warteschlange. Ist kein Hintergrunddienst eingerichtet, übernimmt das der sogenannte Admin-Worker, und der arbeitet nur, solange ein Admin-Fenster geöffnet ist. Schließt du den Tab, steht der Import still. Für regelmäßige oder große Importe gehört deshalb ein Dienst auf den Server, der die Warteschlange dauerhaft abarbeitet (bin/console messenger:consume), dazu die geplanten Aufgaben von Shopware. Frag dein Hosting oder deine Agentur, ob beides läuft.

Einen hängenden Vorgang brichst du über das Menü der Zeile mit „Vorgang abbrechen“ ab. Bereits verarbeitete Zeilen bleiben dabei im Shop. Prüf deshalb vor einem neuen Versuch, welche Produkte schon angekommen sind.

Leere Felder: was ein fehlerfreier Import nicht prüft

Ein fehlerfreier Import heißt nicht, dass jedes Produkt verkaufsfähig ist. Leere Spalten in der Datei sind für Shopware kein Fehler. Das Produkt steht dann ohne Beschreibung, ohne Kategorie oder ohne Verkaufskanal im System, und im Shop fällt es erst auf, wenn jemand danach sucht. Auch KI-Systeme finden in solchen Produkten nichts, woraus sie eine Antwort bauen können. Was sie in Produktdaten brauchen, zeigt der Ratgeber zur Shopware KI-Suche.

Lücken manuell per Export finden

Exportiere die Produkte mit einem Profil, das Kategorien, Verkaufskanäle (Spalte sales_channel), Hersteller, Beschreibung und Titelbild enthält, und filtere die Datei in der Tabellenkalkulation nach leeren Zellen. SEO-Titel und SEO-Beschreibung sind im Standardprofil nicht enthalten. Für sie legst du eine Profilkopie mit den passenden Zuweisungen an. Dieselbe Kopie nutzt du, wenn du SEO-Titel und SEO-Beschreibung per CSV einspielen willst. Wie wichtig gerade diese Felder für die Sichtbarkeit sind, zeigt der Ratgeber zu Shopware SEO.

Kommen deine Produktdaten regelmäßig aus einer Warenwirtschaft, lohnt sich statt wiederkehrender CSV-Dateien oft eine feste Schnittstelle. Welche Wege es dafür gibt, zeigt der Vergleich zur Shopware ERP-Anbindung.

Vor dem Import prüfen: Import Guard

Der Testlauf allein hätte die übergangene Spalte beim Werkzeughändler nicht gemeldet. Import Guard meldet sie, weil sie nicht zu den Spalten des Prüfprofils gehört. Für den Schritt vor dem Import habe ich das Plugin Import Guard entwickelt. Du findest es im Admin unter „Einstellungen“, Reiter „Erweiterungen“. Dort fügst du den Inhalt der Datei als CSV, XML oder JSON in das Feld „Neue Importdaten“ ein, wählst ein Prüfprofil für Produkte, Varianten, Preise oder Lagerbestand und startest die Prüfung. Das Plugin liest die Daten nur. Es importiert nichts und ändert nichts im Shop.

Das Ergebnis steht als Status ganz oben, „Import blockiert“, „Prüfung nötig“ oder „Import plausibel“, darunter jeder Befund mit Zeile, Feld, Schweregrad und einem Hinweis zur Lösung. Bei einer CSV-Datei kannst du zusätzlich einen Export der bestehenden Shopdaten einfügen. Dann zeigt die Prüfung, welche Zeilen neu sind, welche fehlen und welche sich ändern würden. Die „Core-Diagnose“ im selben Modul schaut auf die Import-Abläufe von Shopware selbst: Sie liest Import- und Export-Protokolle, die Warteschlange und die geplanten Aufgaben.

So ergänzt Import Guard den Testlauf um das, was Shopware nicht prüft: Dubletten, Spalten, die das Prüfprofil nicht kennt, und auffällige Werte wie sehr hohe Bestände oder Streichpreise unter dem Verkaufspreis. Fehler fallen auf, bevor sie im Shop stehen, nicht erst beim Kunden.

Import Guard findest du im Shopware Store, mit Beschreibung, Screenshots und Lizenz. Das Plugin ist meine eigene Entwicklung und kein Produkt der shopware AG.

Nach dem Import prüfen: Catalog Health Center

Der Export mit der Tabellenkalkulation funktioniert, kostet aber bei jedem Durchgang dieselbe Zeit: Profil anpassen, exportieren, filtern, die Funde nach Wichtigkeit sortieren. Das Plugin Catalog Health Center übernimmt diesen Schritt im Admin, ebenfalls unter „Einstellungen“, Reiter „Erweiterungen“. Es bewertet jedes Produkt mit einem Wert von 0 bis 100 und stellt die Produkte mit kritischen Befunden an den Anfang.

Wie viele Produkte ein Durchgang prüft, stellst du vor jeder Analyse ein, bis zu 500, beginnend mit den zuletzt geänderten. Nach einem Import hast du damit vor allem die Produkte im Blick, die sich gerade bewegt haben. Den Bericht gibst du als CSV an dein Team weiter, und mit einem Export vor und nach der Bereinigung siehst du schwarz auf weiß, was sich verbessert hat.

Das Catalog Health Center steht im Shopware Store, dort findest du Beschreibung, Bilder des Berichts und die Lizenz. Auch dieses Plugin ist meine eigene Entwicklung und kein Produkt der shopware AG.

Selbst importieren oder Unterstützung holen?

Mit Vorlage, Testlauf und Kontrolle danach kommst du bei gelegentlichen Importen allein gut zurecht. Unterstützung lohnt sich, wenn Daten aus mehreren Quellen zusammenkommen, wenn Varianten und Preisstaffeln im Spiel sind oder wenn ein Shopumzug ansteht und der ganze Katalog auf einmal wandert. Für den Umzug von Shopware 5 zeigt der Ratgeber zur Shopware 6 Migration, wo die Daten im Ablauf ihren Platz haben. Als Shopware Agentur aus Münster richte ich Profile, Schnittstellen und den Hintergrunddienst für die Warteschlange so ein, dass Importe ohne Handarbeit laufen.

Häufige Fragen zum Shopware Import

Wie importiere ich Produkte per CSV in Shopware?

Im Admin unter „Einstellungen“, Reiter „Automatisierung“, „Import/Export“. Im Reiter „Import“ wählst du ein Profil, lädst die CSV-Datei hoch und startest zuerst den Testlauf, dann den Import. Die passende Vorlage bekommst du im Reiter „Profile“ über „Template herunterladen“.

Welches Trennzeichen erwartet der Shopware CSV-Import?

Im Standard das Semikolon, Werte werden in Anführungszeichen eingefasst. Beides lässt sich in einem eigenen Profil unter „Separator-Zeichen“ und „Einfassungszeichen“ ändern. Meldet Shopware „Keine Einträge importiert“, passt fast immer das Trennzeichen nicht zum Profil.

Was macht der Testlauf beim Shopware Import?

Er führt den Import vollständig aus und nimmt danach alle Änderungen zurück. Du siehst in der Zusammenfassung, wie viele Datensätze erstellt, aktualisiert oder übersprungen würden und welche Zeilen scheitern. Inhaltlich falsche, aber gültige Werte erkennt er nicht.

Warum steht mein Import auf „Fehlgeschlagen“, obwohl Produkte im Shop sind?

Shopware setzt den Status auf „Fehlgeschlagen“, sobald mindestens eine Zeile nicht importiert werden konnte. Alle gültigen Zeilen sind trotzdem im Shop. Die gescheiterten lädst du über „Fehlerhafte Einträge herunterladen“ als eigene Datei mit Fehlermeldung, korrigierst sie und importierst nur diese Zeilen erneut.

Warum hängt mein Shopware Import bei „Verarbeite“?

Meist arbeitet niemand die Warteschlange ab. Ohne Hintergrunddienst auf dem Server läuft sie nur, solange ein Admin-Fenster offen ist. Lass den Tab offen oder richte einen dauerhaften Dienst für die Warteschlange ein. Einen festhängenden Vorgang brichst du über „Vorgang abbrechen“ ab.

Warum übernimmt Shopware meine Preise nicht?

Meist stehen sie mit Komma oder Tausenderpunkt in der Datei. Der Import erwartet Zahlen wie 19.99 oder 1299.90. Prüf außerdem, ob die Preisspalte im Profil zugewiesen ist und ob Netto- und Bruttopreis in den richtigen Spalten stehen.

Warum sind meine Umlaute nach dem Import kaputt?

Die Datei war nicht in UTF-8 gespeichert. Shopware liest sie dann falsch, und aus „ü“ wird ein Fragezeichen oder ein Ersatzzeichen. Speichere die Datei als „CSV UTF-8“ oder sichere sie im Texteditor mit dieser Kodierung und importiere die betroffenen Zeilen erneut.

Wie finde ich Produkte mit fehlenden Daten nach dem Import?

Exportiere die Produkte mit einem Profil, das Kategorien, Verkaufskanäle, Beschreibung und Titelbild enthält, und filtere nach leeren Zellen. SEO-Titel und SEO-Beschreibung brauchen eine eigene Profilkopie. Das Catalog Health Center zeigt dieselben Lücken als Bericht im Admin, sortiert nach Dringlichkeit.