Produktdatenimport

Produktdatenimport

Mit dem Produktimport können Sie Ihre Produkte per CSV-Datei oder Excel-Datei (.xlsx) in das System laden. So lassen sich viele Produkte auf einmal anlegen oder bestehende Produkte aktualisieren.

Schnellstart

So importieren Sie Ihr erstes Produkt:

1. Erstellen Sie eine CSV- oder Excel-Datei mit mindestens diesen Spalten:

   handle;name;primary_category;sku;price
   bitumen-70-100;Bitumen 70/100;Bitumen;BIT-70100;890.00

2. Laden Sie die Datei im Bereich Produkte → Import hoch.
3. Prüfen Sie die Vorschau – jede Zeile zeigt an, ob sie als neues Produkt angelegt oder ein bestehendes aktualisiert wird.
4. Klicken Sie auf Import starten.

Dateiformate

Tipp: Wenn Sie eine CSV-Datei in Excel öffnen möchten, verwenden Sie Daten → Aus Text/CSV und wählen Sie UTF-8 als Zeichensatz und Semikolon als Trennzeichen.

Aufbau der Importdatei

Grundprinzip

• Eine Zeile pro Variante. Ein einfaches Produkt hat genau eine Zeile. Ein Produkt mit mehreren Varianten hat mehrere Zeilen.
• Die Spalte handle gruppiert Zeilen zu einem Produkt. Die erste Zeile eines Handles enthält die Produktdaten, weitere Zeilen enthalten nur die Variantendaten.
• Produktspalten in Folgezeilen werden ignoriert (leer lassen).

Spaltenreferenz

Gruppierung

Produktdaten (nur erste Zeile pro Handle)

Variantendaten (jede Zeile)

Staffelpreise (optional, pro Variante)

Produkteigenschaften (optional, nur erste Zeile)

Dynamische Spalten mit dem Präfix prop:, z. B. prop:material, prop:norm.

Der Wert hängt vom Attributtyp ab:

• Text – Freitext
• Number – Zahl
• Select – Options-Code (nicht der angezeigte Name)

Die Attribute müssen vorab im System angelegt sein. Der Code nach prop: muss exakt mit dem Attributcode übereinstimmen.

Variantenattribute (für Variantenprodukte)

Dynamische Spalten mit dem Präfix vattr:, z. B. vattr:koernung, vattr:gebindegroesse.

Der Wert ist der Options-Code des jeweiligen Select-Attributs. Jede Variantenzeile muss die Variantenattribute ausfüllen.

Variantenattribute müssen vom Typ Select mit Verwendung Variante sein.

Bilder (optional)

Die Bilder werden von den angegebenen URLs heruntergeladen und im System gespeichert.

Dokumente (optional, nur erste Zeile)

Beispiele

Einfaches Produkt

handle;name;primary_category;sku;price;prop:norm
bitumen-70-100;Bitumen 70/100;Bitumen;BIT-70100;890.00;DIN EN 12591

Ein Produkt mit einer einzigen Variante (wird automatisch „Standard“ genannt).

Produkt mit Varianten

handle;product_type;name;primary_category;variant_name;sku;price;vattr:koernung
splitt-01;Variant;Basalt-Edelsplitt;Gesteinskoernungen;2/5 mm;SPLITT-2-5;28.50;2_5
splitt-01;;;;;5/8 mm;SPLITT-5-8;32.00;5_8
splitt-01;;;;;8/11 mm;SPLITT-8-11;30.00;8_11

Drei Varianten mit unterschiedlicher Körnung. Die Produktdaten (Name, Kategorie) stehen nur in der ersten Zeile – die Folgezeilen enthalten nur die Variantendaten.

Wichtige Regeln

1. Jedes Produkt braucht mindestens eine Zeile mit sku und price.
2. handle gruppiert Zeilen – das erste Vorkommen definiert die Produktdaten.
3. Simple-Produkte haben genau eine Zeile.
4. Variantenprodukte haben zwei oder mehr Zeilen pro Handle. Jede Zeile muss die vattr:-Spalten ausfüllen.
5. prop:-Spalten werden nur aus der ersten Zeile pro Handle gelesen.
6. Leere prop:- oder vattr:-Spalten werden übersprungen.
7. Dezimaltrenner ist immer der Punkt (.), auch in CSV-Dateien.
8. Die SKU muss innerhalb der Datei und im System eindeutig sein.
9. is_active ist standardmäßig TRUE.
10. Die Spaltenreihenfolge ist beliebig – der Importer erkennt Spalten anhand der Kopfzeile.

Ablauf im System

Der Import durchläuft vier Schritte:

1. Hochladen – Datei per Drag & Drop oder Dateiauswahl hochladen (CSV oder Excel, max. 10 MB).

2. Spaltenzuordnung (falls nötig) – Wenn Spalten nicht automatisch erkannt werden, können Sie die Zuordnung manuell anpassen. Optional kann die KI eine Zuordnung vorschlagen.

3. Vorschau – Jede Zeile wird mit einem Status angezeigt:

• Neu – Produkt wird neu angelegt
• Update – Bestehendes Produkt wird aktualisiert (SKU bereits vorhanden)
• Fehler – Zeile kann nicht importiert werden (Grund wird angezeigt)
• Übersprungen – Zeile wird nicht verarbeitet

4. Import – Nach Bestätigung wird der Import im Hintergrund ausgeführt. Der Fortschritt wird live angezeigt.

KI-Unterstützung

Der Importer bietet optionale KI-Funktionen:

• Spaltenzuordnung – Die KI kann unbekannte Spaltennamen den richtigen Feldern zuordnen (z. B. Artikelnummer → sku).
• Kategorievorschläge – Wenn die Kategorie fehlt oder nicht erkannt wird, kann die KI anhand des Produktnamens eine passende Kategorie vorschlagen.

Diese Funktionen sind optional und können per Klick in der Vorschau aktiviert werden.

Fehlerbehandlung

Einzelne Fehler stoppen nicht den gesamten Import. Nach Abschluss erhalten Sie einen Bericht mit:

• Anzahl erfolgreich importierter Produkte
• Übersprungene Zeilen mit Fehlerdetails
• Warnungen

Tipps

• Testen Sie mit wenigen Zeilen – Laden Sie zuerst eine Datei mit 2–3 Produkten hoch, um das Format zu prüfen.
• Excel für manuelle Bearbeitung – Excel-Dateien (.xlsx) sind einfacher zu bearbeiten als CSV.
• Punkt als Dezimaltrenner – Schreiben Sie 49.90, nicht 49,90.
• Bestehende Produkte aktualisieren – Wenn die SKU bereits im System existiert, werden nur die ausgefüllten Felder aktualisiert. Leere Felder bleiben unverändert.
• Bilder und Dokumente – Die URLs müssen öffentlich erreichbar sein, damit das System die Dateien herunterladen kann.
• Kategorienamen exakt schreiben – Der Kategoriename muss genau mit dem Namen im System übereinstimmen. Alternativ kann die KI helfen.