Shopify-CSV-Dokumentation

CSV-Dateidokumentation – Shopify-Format

Wichtige Informationen zur Struktur:
Shopify erfordert eine spezifische CSV-Dateistruktur. Produkte werden basierend auf der Spalte Handle gruppiert. Jede Größenvariante ist eine separate Zeile in der Datei, aber alle Varianten desselben Modells müssen einen identischen Handle haben.

Struktur der Produktvarianten

Jede Zeile in der Datei beschreibt eine einzelne Produktvariante (eine bestimmte Größe) oder ein zusätzliches Bild.

Die Hauptproduktbeschreibung (Title, Body (HTML)) befindet sich nur in der ersten Zeile für das jeweilige Modell. Nachfolgende Zeilen (weitere Größen) enthalten nur variantenspezifische Daten (z. B. SKU, Größe, Lagerbestand).

Beispiel für eine CSV-Dateistruktur

Unten finden Sie ein Beispielfragment einer CSV-Datei. Beachten Sie den sich wiederholenden Bezeichner in der Spalte Handle.

Handle,Title,Option1 Name,Option1 Value,Variant SKU,Variant Price,Variant Inventory Qty,Image Src
555,"Kleid mit Kragen",Size,S,111-2-S,86.09,15,https://domain.de/img/foto1.jpg
555,,Size,M,111-2-M,86.09,12,
555,,Size,L,111-2-L,86.09,5,
555,,,,,,,https://domain.de/img/foto2.jpg

Gruppierung von Varianten (Schlüsselspalten)

Handle – eindeutige Modellkennung (verbindet Varianten zu einem Produkt)

Option1 Name – Name der Varianteneigenschaft (in dieser Datei immer: "Size")

Option1 Value – Variantenwert (konkrete Größe: XS, S, M, L)

Title – Produktname (nur in der ersten Zeile ausgefüllt)

Damit Shopify die Größen S, M und L korrekt als ein Produkt gruppiert, müssen diese Zeilen einen identischen Wert in der Spalte Handle haben.

Identifikatoren und Mapping

Zur Aktualisierung von Lagerbeständen und Preisen im Shopify-Shop empfehlen wir, die Integration auf folgenden Feldern zu basieren:

Variant SKU – eindeutiger Produktcode, der einer bestimmten Größe zugewiesen ist

Handle – konstanter Identifikator des Hauptprodukts

In dieser Datei ist Handle ein numerischer Identifikator (z. B. 555), was die Stabilität von Aktualisierungen gewährleistet, auch wenn Sie den Produktnamen in Ihrem Shop ändern.

Datenaktualisierung und URL-Links (SEO)

In der Datei verwenden wir konstante ID-Nummern als URL-Identifikatoren (Handle). Dadurch können wir, selbst wenn Sie die Produktnamen in Ihrem Shop ändern, in Zukunft deren Lagerbestände und Preise fehlerfrei aktualisieren.

Änderung von Links (SEO): Wenn Sie die URL-Adressen in SEO-freundliche (mit Namen) ändern möchten, können Sie dies manuell in der Produktbearbeitung (unten im Abschnitt SEO) tun.

Wichtig bei Aktualisierungen:
Beim nächsten Aktualisierungsimport müssen Sie die Option 'Overwrite any current products that have the same handle' (Vorhandene Produkte überschreiben) auswählen. Dadurch verknüpft das System die Daten nach SKU oder ID und aktualisiert die Bestände, anstatt Produktduplikate zu erstellen.

Preise und Verfügbarkeit

Variant Price – Netto-/Bruttopreis der Variante

Variant Inventory Qty – verfügbarer Lagerbestand

Variant Inventory Policy – Lagerrichtlinie (z. B. "deny" - nicht unter 0 verkaufen)

Jede Variante (Größe) hat einen eigenen Lagerbestand und Preis, der in der entsprechenden Zeile definiert ist.

Produktbilder

Image Src – URL-Link zum Bild

Image Position – Anzeigereihenfolge des Bildes

Image Alt Text – Alternativtext für das Bild (SEO)

Achtung: Das Hauptbild ist in der ersten Produktzeile zugewiesen. Zusätzliche Bilder (Galerie) befinden sich in separaten Zeilen am Ende der Produktgruppe, wo nur die Spalten Handle und Image Src ausgefüllt sind.