Shopware 6 Import Guide: CSV, Excel, ERP und API Integration

Daten in Shopware 6 zu bekommen klingt nach einer technischen Kleinigkeit. In der Praxis ist es einer der häufigsten Gründe, warum Shopware-Projekte ins Stocken geraten. Falsch formatierte CSV-Dateien, manuelle Fehler bei der Datenaufbereitung, ERP-Systeme die nicht synchronisieren, und Bestellungen die außerhalb des Shops eingehen und mühsam nachgepflegt werden müssen. Dieses Problem wächst mit Ihrem Unternehmen, es verschwindet nicht.

Dieser Guide gibt Ihnen einen vollständigen Überblick über alle Import-Methoden in Shopware 6: vom einfachen CSV-Import bis zur bidirektionalen ERP-Anbindung. Für jeden Ansatz erkläre ich, wie er funktioniert, wo seine Grenzen liegen, und wann er durch eine robustere Lösung ersetzt werden sollte.

Was dieser Guide abdeckt

Shopware 6 bietet mehrere Wege, Daten in das System zu bringen. Welcher Weg der richtige ist, hängt von der Datenmenge, der Häufigkeit der Aktualisierungen und der vorhandenen Systemlandschaft ab. Die vier relevanten Methoden im Überblick:

• CSV-Import: Der eingebaute Import/Export-Mechanismus von Shopware, geeignet für einmalige oder seltene Datenübertragungen mit überschaubaren Datenmengen.
• Excel-Workflow: Der in der Praxis häufigste Ansatz bei kleinen und mittleren Unternehmen, mit bekannten Skalierungsproblemen ab einem bestimmten Volumen.
• API-Import: Der technisch sauberste Weg für automatisierte, wiederholbare Importe direkt über die Shopware Admin API.
• ERP-Integration: Die vollständige Anbindung eines ERP-Systems für bidirektionale Datensynchronisation in Echtzeit oder nach Zeitplan.

Dieser Guide richtet sich an Shop-Betreiber, Operations-Teams und Entscheidungsträger, die verstehen wollen, welche Methode für ihre konkrete Situation geeignet ist, und an welchem Punkt eine Investition in Automatisierung mehr spart als sie kostet.

1. CSV und Excel Import in Shopware 6

Wie der eingebaute Import funktioniert

Shopware 6 bringt ein eigenes Import/Export-Modul mit, das über die Administration erreichbar ist. Es unterstützt CSV-Dateien und arbeitet mit konfigurierbaren Profilen: Sie legen fest, welche Spalte Ihrer Datei welchem Feld in Shopware entspricht, und Shopware übernimmt die Zuordnung beim Import.

Unterstützte Entitäten umfassen Produkte, Kategorien, Kunden, Bestellungen (eingeschränkt) und Medien. Für jeden Entitätstyp gibt es ein Standardprofil, das als Ausgangspunkt dient und angepasst werden kann.

Der Ablauf in der Praxis: CSV-Datei vorbereiten, Importprofil auswählen oder konfigurieren, Datei hochladen, Import ausführen, Protokoll prüfen. Bei kleinen Datenmengen und seltenen Importen ist das ein handhabbarer Prozess.

Typische Probleme beim CSV und Excel Import

Die häufigsten Fehler, die ich in der Praxis sehe:

• Zeichenkodierung. Excel speichert CSV-Dateien standardmäßig nicht in UTF-8. Shopware erwartet UTF-8. Das Ergebnis sind fehlerhaft dargestellte Umlaute und Sonderzeichen, die erst nach dem Import auffallen.
• Dezimaltrennzeichen. Deutsche Excel-Dateien verwenden Komma als Dezimaltrennzeichen, Shopware erwartet Punkt. Ein Preis von 29,90 wird als 29 importiert oder schlägt komplett fehl.
• Fehlende Pflichtfelder. Shopware bricht den Import eines Datensatzes ab, wenn ein Pflichtfeld fehlt, ohne den Rest der Datei zu stoppen. Das Protokoll zeigt den Fehler, aber wer das Protokoll nicht liest, merkt es nicht.
• Duplikate durch fehlende ID-Referenzen. Shopware identifiziert Produkte intern über hexadezimale IDs. Wer beim Update-Import keine korrekte ID-Referenz mitliefert, legt neue Produkte an statt bestehende zu aktualisieren.
• Stille Teilfehler. Shopware importiert, was es kann, und überspringt den Rest. Ein Import kann als erfolgreich abgeschlossen erscheinen, obwohl zwanzig Datensätze nicht verarbeitet wurden.

Wann der Excel Import aufhört zu funktionieren

Der manuelle CSV und Excel Import funktioniert bis zu einem bestimmten Punkt. Die Grenze liegt nicht bei einer bestimmten Produktanzahl, sondern bei der Kombination aus Häufigkeit, Fehlerrate und Zeitaufwand.

Signale, dass dieser Punkt erreicht ist: Der Import nimmt mehr als zwei Stunden pro Woche in Anspruch. Preisfehler oder Bestandsprobleme lassen sich auf fehlerhafte Importe zurückführen. Neue Produkte werden verzögert live gestellt. Das Wissen über den Importprozess steckt in einer einzigen Person. Sie haben mehr als zwei Lieferanten mit unterschiedlichen Datenformaten.

Eine detaillierte Analyse dieses Problems und was eine Automatisierung stattdessen leisten kann finden Sie hier: Shopware 6 und Excel: Wann der manuelle Import aufhört zu funktionieren.

2. Automatisierung des Import-Prozesses

Manuell vs. automatisiert: wo die Zeit verloren geht

Der offensichtliche Unterschied zwischen manuellem und automatisiertem Import ist die Ausführungszeit. Der tatsächliche Unterschied liegt tiefer: Ein manueller Prozess erfordert menschliche Aufmerksamkeit bei jedem Schritt. Datei öffnen, bereinigen, konvertieren, hochladen, prüfen. Jeder dieser Schritte ist eine Gelegenheit für Fehler und eine Beanspruchung von Arbeitszeit, die sich wöchentlich wiederholt.

Ein automatisierter Prozess erledigt diese Schritte nach Zeitplan oder ausgelöst durch ein Ereignis, ohne menschliches Eingreifen. Die Arbeitszeit fällt einmalig für Aufbau und Konfiguration an, danach läuft der Prozess selbstständig.

Wann Automatisierung sinnvoll ist

Automatisierung lohnt sich, wenn mindestens einer dieser Fälle zutrifft: Lieferantenpreislisten oder Bestände werden öfter als einmal pro Woche aktualisiert. Mehrere Lieferanten liefern Daten in unterschiedlichen Formaten. Der manuelle Import produziert regelmäßig Fehler, die nachbearbeitet werden müssen. Der Importprozess hängt an einer einzigen Person.

Technische Ansätze für die Automatisierung

Cron Jobs mit Skripten sind der einfachste Einstieg: Ein Skript lädt die Quelldatei, transformiert sie in das Shopware-Format und übergibt sie an den Import-Mechanismus oder direkt an die API. Wartungsarm, gut kontrollierbar, aber erfordert technisches Wissen für Aufbau und Fehlerbehandlung.

Middleware-Lösungen wie n8n erlauben visuelle Workflow-Konfiguration ohne tiefen Code-Einstieg, sind aber bei komplexen Transformationslogiken schnell an ihrer Grenze.

Custom-Entwicklung über die Shopware Admin API ist der robusteste Ansatz für Produktions-Umgebungen: direkte Kontrolle über Fehlerbehandlung, Logging und Benachrichtigungen, kein Abhängigkeit von Drittanbieter-Tools.

3. API Import in Shopware 6

Wie die Admin API funktioniert

Die Shopware 6 Admin API ist eine vollständige REST-API, die Zugriff auf alle relevanten Entitäten des Systems bietet. Authentifizierung erfolgt über OAuth2. Jede Entität hat eigene Endpunkte für Lesen, Anlegen, Aktualisieren und Löschen.

Für Import-Szenarien relevante Endpunkte:

• /api/product: Produkte anlegen und aktualisieren
• /api/product/{id}/stock: Bestand aktualisieren
• /api/order: Bestellungen anlegen und lesen
• /api/customer: Kundendaten importieren
• /api/category: Kategoriestruktur aufbauen

Die API unterstützt Bulk-Operationen über den Sync-Endpunkt, der mehrere Operationen in einem Request zusammenfasst und damit die Performance bei großen Datenmengen erheblich verbessert.

Vorteile des API-Imports gegenüber CSV

Der API-Import ist dem CSV-Import in fast allen produktionsrelevanten Aspekten überlegen. Fehler werden pro Datensatz zurückgemeldet, nicht als stiller Abbruch. Die Transformationslogik liegt im Code, nicht in einer manuell gepflegten Datei. Updates können in Echtzeit oder nach Zeitplan ausgelöst werden. Mehrere Datenquellen können in denselben Prozess integriert werden. Das System ist testbar und versionierbar.

Wann API-Import statt CSV verwendet werden sollte

API-Import ist die richtige Wahl, wenn der Import automatisiert und wiederholbar sein muss. Wenn die Daten aus einem System kommen, das selbst eine API hat. Wenn Fehler aktiv behandelt und gemeldet werden sollen. Wenn die Datenmenge oder Häufigkeit einen manuellen Prozess unwirtschaftlich macht.

4. ERP-Integrationen

Wie ERP-Systeme Daten mit Shopware austauschen

Eine ERP-Integration ist kein Import im klassischen Sinne, sondern eine dauerhafte, bidirektionale Datenverbindung zwischen zwei Systemen. Typische Datenflüsse:

• ERP nach Shopware: Produkte, Preise, Bestände, Kundendaten
• Shopware nach ERP: Bestellungen, Zahlungsstatus, Versandstatus, neue Kunden

Die Synchronisation kann ereignisgesteuert (Webhook bei neuer Bestellung), zeitgesteuert (stündliche Bestandssynchronisation) oder beides gleichzeitig sein.

Typische Probleme bei ERP-Integrationen

ERP-Integrationen scheitern selten an der technischen Anbindung selbst. Die häufigsten Probleme liegen im Daten-Mapping: Artikelnummern die im ERP anders strukturiert sind als in Shopware. Preislogik die im ERP kundenspezifisch ist und in Shopware abgebildet werden muss. Bestandsführung über mehrere Lager, die Shopware in ein einziges Lagerfeld zusammenführen muss. Statusübergänge die im ERP andere Bezeichnungen haben als in Shopware.

Latenz ist ein weiteres Thema: Wenn der Bestand im ERP aktualisiert wird und Shopware das erst eine Stunde später erfährt, können in dieser Stunde Überverkäufe entstehen.

Wann eine ERP-Integration notwendig wird

Eine vollständige ERP-Anbindung ist notwendig, wenn Bestände über mehrere Lager geführt werden. Wenn Preise kundenspezifisch sind und zentral im ERP verwaltet werden. Wenn das Bestellvolumen so hoch ist, dass manuelle Übertragung ins ERP nicht mehr skaliert. Wenn der Shop in einen bestehenden B2B-Prozess integriert werden muss, der im ERP abgebildet ist.

5. Büro und Telefonbestellungen in Shopware erfassen

Das Problem manueller Bestellungen

Nicht jede Bestellung kommt über den Online-Shop. Gerade im B2B-Bereich laufen Bestellungen häufig per Telefon, E-Mail oder Fax ein. Diese Bestellungen müssen irgendwo erfasst werden, und wenn kein System vorhanden ist, landen sie in Tabellen, E-Mail-Ordnern oder im schlimmsten Fall nur im Gedächtnis der zuständigen Person.

Das schafft Probleme: keine zentrale Bestellübersicht, kein automatischer Bestandsabzug, keine automatische Auftragsbestätigung an den Kunden, und kein strukturierter Übergabeprozess an Lager oder Versand.

Wie manuelle Bestellungen in Shopware erfasst werden

Shopware 6 erlaubt die manuelle Anlage von Bestellungen direkt in der Administration. Das ist der einfachste Weg für gelegentliche Telefonbestellungen: Kunde suchen oder anlegen, Produkte hinzufügen, Preise anpassen, Bestellung anlegen. Die Bestellung läuft dann durch denselben Prozess wie eine Online-Bestellung.

Für höhere Volumen ist dieser manuelle Weg zu langsam. Ab fünf bis zehn manuellen Bestellungen täglich lohnt sich ein strukturierter Fast-Order-Workflow oder eine Import-Lösung für extern erfasste Bestelldaten.

Wann der manuelle Bestelleingang zum Problem wird

Die Grenze liegt dort, wo der Aufwand für die manuelle Erfassung die Kapazität des Teams übersteigt. Signale dafür sind: Bestellungen werden verzögert erfasst. Fehler bei der Übertragung (falsche Mengen, falsche Produkte) häufen sich. Der Bestand im Shop stimmt nicht mit dem tatsächlichen Bestand überein, weil manuell erfasste Bestellungen keinen automatischen Abzug auslösen.

6. Welche Methode passt wann: Entscheidungsmatrix

Die Wahl der richtigen Import-Methode hängt von vier Faktoren ab: Datenmenge, Häufigkeit, Systemlandschaft und Fehlertoleranz.

Fazit: Der häufigste Fehler und wie Sie ihn vermeiden

Der häufigste Fehler, den ich bei Shopware-Projekten sehe, ist das zu lange Festhalten an manuellen Prozessen. Ein CSV-Import der für zehn Produkte eingerichtet wurde, läuft drei Jahre später noch genauso, obwohl das Sortiment auf tausend Produkte gewachsen ist und drei Mitarbeiter täglich damit beschäftigt sind, Fehler zu korrigieren.

Die Investition in einen strukturierten Import-Prozess zahlt sich fast immer schneller zurück als erwartet, weil die laufenden Kosten des manuellen Prozesses meist unterschätzt werden. Nicht nur die Zeit für den Import selbst, sondern die Zeit für Fehlerkorrektur, Nachfragen, verzögerte Listings und die Abhängigkeit von einzelnen Personen.

Die richtige Methode hängt von Ihrer konkreten Situation ab. Wenn Sie nicht sicher sind, wo Ihr aktueller Prozess steht und welcher nächste Schritt sinnvoll ist, helfe ich Ihnen gerne dabei, das einzuschätzen.

Weiterführende Artikel

• Shopware 6 und Excel: Wann der manuelle Import aufhört zu funktionieren
• Shopware 6 Apps vs. Plugins: Was braucht Ihr Shop wirklich?
• Ich habe einen KI-Assistenten für Shopware 6 gebaut: hier ist die Architektur

Was ich für Sie bauen kann

Ich entwickle Import-Lösungen und Schnittstellenanbindungen für Shopware 6, vom automatisierten CSV-Workflow bis zur vollständigen ERP-Integration. Der Stack, mit dem ich arbeite: Shopware 6 Admin API, .NET für die Integrationslogik, und wo sinnvoll direkte Datenbankanbindungen für maximale Performance.

Wenn Sie einen Import-Prozess haben, der zu viel Zeit kostet oder zu viele Fehler produziert, schaue ich mir Ihre konkrete Situation gerne an und sage Ihnen, welcher Ansatz für Sie sinnvoll ist.

Kontakt zu Bojan aufnehmen