Produktdatenimport

Produktimport — Hilfe

Mit dem Produktimport koennen 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

  1. Laden Sie die Datei im Bereich Produkte > Import hoch.
  2. Pruefen Sie die Vorschau — jede Zeile zeigt an, ob sie als neues Produkt angelegt oder ein bestehendes aktualisiert wird.
  3. Klicken Sie auf Import starten.

Dateiformate

CSV Excel (.xlsx)
Trennzeichen Semikolon ; — (Zellentrennung)
Zeichensatz UTF-8 (mit BOM) Standard
Zeilenumbrueche in Feldern \n schreiben Normaler Zeilenumbruch in der Zelle
Empfohlen fuer Programmatische Erstellung Manuelle Bearbeitung

> Tipp: Wenn Sie eine CSV-Datei in Excel oeffnen moechten, verwenden Sie Daten > Aus Text/CSV und waehlen 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 enthaelt die Produktdaten, weitere Zeilen enthalten nur die Variantendaten.
  • Produktspalten in Folgezeilen werden ignoriert (leer lassen).

Spaltenreferenz

Gruppierung

Spalte Pflicht Beschreibung
handle Ja Eindeutiger Bezeichner innerhalb der Datei. Gruppiert Zeilen zu einem Produkt (z.B. splitt-01, bitumen-heiss).
product_type Nein Simple (Standard) oder Variant. Nur in der ersten Zeile pro Handle.
locale Nein Sprachcode. Standard: de.

Produktdaten (nur erste Zeile pro Handle)

Spalte Pflicht Beschreibung
name Ja Produktname (max. 255 Zeichen)
short_description Nein Kurzbeschreibung
description Nein Langbeschreibung. Zeilenumbrueche in CSV mit \n.
primary_category Ja Name der Hauptkategorie (z.B. Sicherheitsschuhe). Muss exakt mit einer bestehenden Kategorie uebereinstimmen.
additional_categories Nein Weitere Kategorienamen, getrennt durch ; (z.B. Arbeitsschutz;Fussschutz)
shipping_profile_id Nein ID des Versandprofils
is_active Nein TRUE oder FALSE (Standard: TRUE)

Variantendaten (jede Zeile)

Spalte Pflicht Beschreibung
variant_name Nein Anzeigename der Variante (Standard: Standard)
sku Ja Artikelnummer — muss eindeutig sein
price Ja Basispreis, z.B. 49.90 — Dezimaltrenner ist immer der Punkt
stock_quantity Nein Lagerbestand. Leer = unbegrenzter Bestand.
weight Nein Gewicht in kg
length Nein Laenge
width Nein Breite
height Nein Hoehe

Staffelpreise (optional, pro Variante)

Spalte Beschreibung
price_tiers Format: Mindestmenge:Stueckpreis getrennt durch ;. Beispiel: 10:45.00;50:40.00;100:35.00

Produkteigenschaften (optional, nur erste Zeile)

Dynamische Spalten mit dem Praefix prop: , z.B. prop:material , prop:norm .

Der Wert haengt vom Attributtyp ab: - Text — Freitext - Number — Zahl - Select — Options-Code (nicht der angezeigte Name)

> Die Attribute muessen vorab im System angelegt sein. Der Code nach prop:  muss exakt mit dem Attributcode uebereinstimmen.

Variantenattribute (fuer Variantenprodukte)

Dynamische Spalten mit dem Praefix vattr: , z.B. vattr:koernung , vattr:gebindegroesse .

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

> Variantenattribute muessen vom Typ Select  mit Verwendung Variante  sein.

Bilder (optional)

Spalte Beschreibung
image_url_1 bis image_url_5 URLs zu Produktbildern. In der ersten Zeile = Produktbilder, in Variantenzeilen = variantenspezifische Bilder.
image_primary Welches Bild das Hauptbild ist: 1–5 (Standard: 1). Nur in der ersten Zeile.

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

Dokumente (optional, nur erste Zeile)

Spalte Beschreibung
doc_url_1 bis doc_url_3 URLs zu Dokumenten (z.B. PDF-Datenblaetter)
doc_name_1 bis doc_name_3 Dateiname, z.B. datenblatt.pdf
doc_desc_1 bis doc_desc_3 Beschreibung des Dokuments

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 Koernung. 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 ausfuellen.
  5. prop: -Spalten werden nur aus der ersten Zeile pro Handle gelesen.
  6. Leere prop: - oder vattr: -Spalten werden uebersprungen.
  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 standardmaessig TRUE .
  10. Die Spaltenreihenfolge ist beliebig — der Importer erkennt Spalten anhand der Kopfzeile.

Ablauf im System

Der Import durchlaeuft vier Schritte:

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

2. Spaltenzuordnung (falls noetig) — Wenn Spalten nicht automatisch erkannt werden, koennen 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) - Uebersprungen — Zeile wird nicht verarbeitet

4. Import — Nach Bestaetigung wird der Import im Hintergrund ausgefuehrt. Der Fortschritt wird live angezeigt.

KI-Unterstuetzung

Der Importer bietet optionale KI-Funktionen:

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

Diese Funktionen sind optional und koennen per Klick in der Vorschau aktiviert werden.

Fehlerbehandlung

Fehler Was passiert
Pflichtspalte fehlt (handle, sku, price, name, primary_category) Zeile wird abgelehnt
Doppelte SKU Zeile wird abgelehnt
Unbekannter Attributcode Spalte wird ignoriert (Warnung)
Ungueltiger Options-Code Zeile wird abgelehnt
Unbekannter Kategoriename Zeile wird abgelehnt
Bild-/Dokument-URL nicht erreichbar Import laeuft weiter (Warnung)

Einzelne Fehler stoppen nicht den gesamten Import. Nach Abschluss erhalten Sie einen Bericht mit: - Anzahl erfolgreich importierter Produkte - Uebersprungene Zeilen mit Fehlerdetails - Warnungen

Tipps

  • Testen Sie mit wenigen Zeilen — Laden Sie zuerst eine Datei mit 2–3 Produkten hoch, um das Format zu pruefen.
  • Excel fuer 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 ausgefuellten Felder aktualisiert. Leere Felder bleiben unveraendert.
  • Bilder und Dokumente — Die URLs muessen oeffentlich erreichbar sein, damit das System die Dateien herunterladen kann.
  • Kategorienamen exakt schreiben — Der Kategoriename muss genau mit dem Namen im System uebereinstimmen. Alternativ kann die KI helfen.
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us