CSV-Import Produkte

Erste Zeile = Spaltenköpfe (Feldnamen exakt wie unten, snake_case). Pro Zeile ein Produkt. Vorhandene Artikel werden anhand SKU oder HAN erkannt und aktualisiert. Neue Zeilen ohne SKU brauchen number_circle_id oder number_circle_code (wie in der API).

category_ids: kommagetrennte IDs (z. B. 1,3). media, suppliers, attributes: jeweils JSON in einer Zelle (wie in der Produkt-API). Unbekannte Spaltenköpfe werden ignoriert. Zahlenfelder mit Dezimalpunkt. Trennzeichen: Komma oder Semikolon — bei Excel (deutsche Einstellung) ist die CSV oft semikolongetrennt; der Import erkennt das an der Kopfzeile automatisch. Zeichensatz: Am besten CSV als UTF-8 speichern. Kommt die Datei aus Excel unter Windows (ANSI/Windows-1252), werden Umlaute beim Import nach UTF-8 umgewandelt.

Wenn alle Zeilen übersprungen werden: In jeder Zeile muss mindestens sku oder han (oder für Neuanlage ohne SKU ein Nummernkreis) in den erkannten Spalten stehen — sonst fehlt der Import die Zuordnung. Häufige Ursachen: Spalten heißen anders (z. B. „Artikelnummer“ statt sku) oder die Datei war mit falschem Trennzeichen eingelesen.

Erlaubte Spalten (alle optional außer dem, was für Anlage/Upsert nötig ist)

Identifikation & Nummernkreis

sku, han, gtin, number_circle_id, number_circle_code, status
Stammdaten & SEO (Kern)

title, brand, short_description, description, seo_title, meta_description
Preise, Maße, Versand

price, cost_price, rrp, weight, length, width, height, tax_class, shipping_class, main_image_url
Amazon

amazon_title, amazon_bullet_1, amazon_bullet_2, amazon_bullet_3, amazon_bullet_4, amazon_bullet_5, amazon_description
eBay

ebay_title, ebay_description
WebShop

webshop_title, webshop_short_description, webshop_description, webshop_bullet_1, webshop_bullet_2, webshop_bullet_3, webshop_bullet_4, webshop_bullet_5, webshop_meta_title, webshop_meta_description, webshop_seo_url
Kategorien & JSON

category_ids — sowie media, suppliers, attributes (JSON je Zelle)