CSV-Import & Export · mehrsprachig, mit Mapping

Komplette Mehrsprachigkeit in einer Datei. Zusatzfelder als einzelne Spalten. Abgleich per Artikelnummer, EAN, Herstellernummer oder ID. Mit Profilen, Validierung, Strict Mode und Batch-Sync.

Video · 1:37 Min.Import und ExportDie Funktion in Aktion sehen, mit eingeblendeten Erklärungen.Video ansehen →

Spaltenkonvention für Übersetzungen

Statt für jede Sprache eine eigene Datei: alle Sprachen in EINER CSV. Die Hauptsprache für Export (Standard: aktuelle Admin-Sprache) steht in den Hauptspalten wie name oder description. Weitere Sprachen erscheinen als eigene Spalten nach dem Muster:

• trans_<kanal>_<sprache>_<feld> - zum Beispiel trans_hauptshop_en_GB_name; je Verkaufskanal und Sprache für Name, Beschreibung, Meta-Title, Meta-Description, Keywords, Verpackungseinheit (Singular/Plural) und Suchbegriffe
• cf_<name>__<Sprachcode> - sprachbezogene Werte eines Zusatzfelds

Welche Kanal-Sprachen als Übersetzungsspalten angeboten werden, legst du in der Konfigmatrix fest (Tab Texte & Übersetzungen → „Sichtbare Kanal-Sprachen"). Mit „Daten auch für Hauptsprache importieren" werden übersetzte Felder beim Import zusätzlich in die Hauptsprache des Admins geschrieben.

Zusatzfelder als einzelne Spalten

Zusatzfelder (Custom Fields) bekommen im Export jeweils eine eigene Spalte cf_<name>, sprachbezogen cf_<name>__<Sprachcode>. Beim Import werden sie direkt erkannt - kein JSON-Blob nötig. Die Spalte customFields mit allen Werten als JSON ist dagegen nur ein Export-Feld.

Vordefinierte Export-Profile

Sieben sofort einsetzbare Spaltensets - anpassbar und als eigenes Profil speicherbar:

• Stammdaten - Artikelnummer, Name, Beschreibung, Status, EAN, Hersteller, Herstellernummer, Topseller, Abverkauf, Versandkostenfrei, Tags, Kategorien, Hauptkategorie, Zusatzfelder
• Preise & Lager - Brutto, Netto, Steuersatz, Bestand, verfügbarer Bestand, Einkaufspreis brutto und netto, Streichpreis, UVP, Lieferzeit, Bestellmengen, Grundpreis-Angaben, Verpackungseinheit und Einheit als Klarname
• SEO - Meta-Title, Meta-Description, Keywords, Canonical URL und Suchbegriffe
• Bilder - Cover-URL und alle Bilder
• Übersetzungen - alle Übersetzungsspalten der freigegebenen Kanal-Sprachen
• Varianten - Eltern-Artikelnummer, Varianten-Optionen, Preise, Bestand, EAN und Status
• Vollexport - alle Spalten

Das Standard-Exportprofil, das beim Öffnen vorausgewählt ist, stellst du in der Konfigmatrix im Tab Import / Export ein.

Preis-Spalten - Brutto und Netto getrennt

Für den Einkaufspreis stehen zwei getrennte Spalten zur Verfügung:

• purchasePrice - Einkaufspreis brutto (im Import auch als purchasePrice_gross)
• purchasePrice_net - Einkaufspreis netto

Beim Import sind alle Kombinationen möglich:

• Nur Brutto angegeben → Netto wird über den Steuersatz berechnet
• Nur Netto angegeben → Brutto wird über den Steuersatz berechnet
• Beide angegeben → Werte werden 1:1 übernommen

Verkaufspreise stehen in price_gross und price_net, dazu listPrice (Streichpreis) und regulationPrice (UVP). Staffelpreise sind keine CSV-Spalten.

Alias-Erkennung

Der Importer erkennt auch deutsche und englische Schreibweisen automatisch:

• ek_brutto, einkaufspreis_brutto, cost_gross, purchase_price_gross → Einkaufspreis brutto
• ek_netto, einkaufspreis_netto, cost_net, purchase_price_net → Einkaufspreis netto

CSV-Export

• Spalten beliebig auswählbar, gruppiert nach Basis, Preis & Bestand, Maße & Gewicht, SEO, Datum & Status, Varianten, Sichtbarkeit, Bilder, Eigenschaften, Cross-Selling und Übersetzungen
• Exportumfang: alle Produkte oder aktiver Filter; zusätzlich lässt sich ein Filter-Preset laden
• Dezimaltrennzeichen: Punkt (12.50) für internationales Excel oder Komma (12,50) für deutsches Excel, jeweils auf 2 Nachkommastellen gerundet
• Encoding: UTF-8 mit BOM, damit Excel Umlaute korrekt anzeigt
• Aktive Filter berücksichtigen - Filter aus der Produktliste werden auf den Export angewandt, genauso ausgewertet wie in der Liste: Cover- und Variantencover-Status, Hersteller-, Kategorie- und Eigenschaften-Status, Hauptkategorie, Lieferzeit, Preis, Übersetzungsstatus und „unverändert seit".
• Was sich nicht übertragen lässt, wird benannt - eigene Filter, UVP-Status, Freigabestatus und der Suchbegriff greifen technisch nicht im Export. Der Dialog weist ausdrücklich darauf hin, statt sie still zu ignorieren.
• Voreinstellungen in der Konfigmatrix (Tab Import / Export): Standard-Exportprofil, Trennzeichen (Semikolon, Komma, Tab), max. Produkte (Standard 5.000), Varianten standardmäßig exportieren, Standard-Dateiformat, Dezimaltrennzeichen

Spalte „Einheit (Name)"

Zusätzlich zur Einheit-ID wird die Produkteinheit als Klarname exportiert („Liter", „Kilogramm", „Stück") - Excel-freundlich, ohne UUID-Übersetzung. Im Profil „Preise & Lager" ist der Klarname als Standard aktiviert.

Nur Export

Diese Spalten werden exportiert, aber nicht importiert: Hauptkategorie, Durchschnittsbewertung, Verkäufe, Variantenanzahl, Anzeigegruppe, Zusatzfelder (JSON), verfügbarer Bestand, Verfügbar, Produkt-URL, Bild-URL absolut und Bild-URLs absolut sowie Erstellt am und Geändert am.

CSV-Import

Ablauf

1. Datei auswählen - CSV, TSV, XML, DATANORM oder Excel (.xlsx, .xls) - oder eine CSV-, XML- bzw. DATANORM-Datei von einer URL laden
2. Optional ein gespeichertes Import-Profil laden
3. Trennzeichen, Import-Modus, Produkt-Zuordnung und Bild-Modus wählen
4. Spalten-Mapping prüfen und anpassen - automatische Erkennung anhand der Kopfzeile
5. Validierung starten: Sie zeigt, wie viele Zeilen neu angelegt, aktualisiert oder übersprungen werden, dazu Warnungen (z.B. doppelte Artikelnummern, Zeilen ohne Artikelnummer) und Fehler
6. Import starten - mit Fortschritt in den Phasen Vorbereitung, Produkte speichern, Bilder hochladen und Übersetzungen schreiben

• Import-Modus: Aktualisieren + Neue, Nur aktualisieren oder Nur neue anlegen (erfordert eine Name-Spalte)
• Bild-Modus: Ergänzen oder Ersetzen (alle löschen)
• Strict Mode (alles oder nichts): Treten Fehler auf, werden alle bereits importierten Änderungen automatisch zurückgesetzt
• Fehlerliste: durchsuchbar, kopierbar und als CSV herunterladbar

Match-Logik

• Artikelnummer (productNumber) - Standard
• EAN / GTIN
• Herstellernummer (manufacturerNumber)
• Produkt-ID (UUID)

Auflösung per Artikelnummer

Varianten lassen sich über die Spalte parentProductNumber ihrem Stammartikel zuordnen - UUIDs sind nicht zwingend nötig.

Auto-Erkennung „Einheit"

Der Importer erkennt sowohl „Einheit (Name)" als auch „Produkteinheit" als Spaltennamen automatisch und löst Klarnamen wie „Liter" oder „Kilogramm" in die korrekte Einheit-ID auf.

Automatische Lookups

Fehlende Hersteller, Tags, Steuersätze, Lieferzeiten und Eigenschaftsoptionen werden beim Import automatisch angelegt. Kategorien (Pipe-getrennt, auch als Pfad mit „>") und Produkteinheiten müssen bereits existieren - nicht gefundene Einträge erscheinen in der Fehlerliste.

Performance-Einstellungen

In der Konfigmatrix (Tab Import / Export): Produkte pro Sync-Batch (10, 50 Standard oder 200, bei Fehlern automatischer Fallback auf Einzelverarbeitung), parallele Bild-Uploads pro Produkt (Standard 5), gleichzeitige Produkte beim Bild-Import (Standard 2), Übersetzungen pro Sync-Batch, API-Rate-Limit, Indexierung während des Imports deaktivieren, nach dem Import automatisch re-indexieren und Import bei Fehleranzahl abbrechen (nie oder nach 5, 10, 25, 50 oder 100 Fehlern).

DATANORM-Import (4.0 & 5.0)

Zusätzlich zu CSV liest der Importer das DATANORM-Format aus Lieferanten-Katalogen (verbreitet im Handwerk und Großhandel):

• Version 4.0 und 5.0 werden über den V;-Header automatisch erkannt (inkl. Hersteller); 5.0 hat ein eigenes Feldlayout für Name, Preis und EAN.
• Volume-Dateien mit beliebiger Endung .001-.999 (z.B. DATANORM.500).
• Satzarten: A (Artikel-Stammsatz), B (Warengruppen), T (Langtext), P (Preise/DATPREIS).

Datentyp-Erkennung

• Boolean: 1/0, true/false, ja/nein, aktiv/inaktiv
• Datum: ISO (2026-05-15) und deutsche Notation (15.05.2026)
• Zahl: Komma oder Punkt als Dezimaltrenner, Tausender-Trenner werden erkannt
• Array: Pipe-Separator (|) bei Multi-Select-Custom-Fields
• JSON: bei komplexen Feldern

Spalten-Mapping

Falls die Kopfzeile nicht mit den Shopware-Feldnamen übereinstimmt, ordnest du jeder CSV-Spalte über eine Auswahlliste ein Shopware-Feld zu oder setzt sie auf „Überspringen". Eine Vorschau zeigt die ersten Werte. Mapping, Trennzeichen und Modi speicherst du als Import-Profil; Profile liegen in der Datenbank des Shops und stehen allen Benutzern zur Verfügung.

Änderungslog und Rückgängig

Der Tab Änderungslog im CSV-Fenster listet die Importe:

• Zeitpunkt und Dateiname
• Anzahl neu angelegter und aktualisierter Produkte sowie Fehler
• Die betroffenen Felder

Mit „Letzten Import rückgängig" werden die zuletzt importierten Änderungen auf die vorherigen Werte zurückgesetzt, „Log leeren" entfernt die Liste. Einen Download der Original-CSV gibt es nicht. Zusätzlich legt jeder Import einen Snapshot an (abschaltbar), den du in der Konfigmatrix im Tab Snapshots vergleichen und wiederherstellen kannst.

Berechtigungen

Zum Branchenformat gibt es eine eigene Seite: DATANORM-Import für Shopware 6.

Weiter geht's

Weiter zum Feed Export, um Produktfeeds per URL für Portale und ERP bereitzustellen.

Häufige Fragen