Produkte per CSV in WooCommerce importieren

Option 1: Der integrierte WooCommerce-CSV-Importer

WooCommerce liefert einen CSV-Importer und -Exporter für Produkte mit. Gehen Sie im WordPress-Backend zu Produkte → Alle Produkte und wählen Sie Importieren. Laden Sie Ihre CSV hoch, ordnen Sie die Spalten den WooCommerce-Feldern zu und starten Sie den Import. Mit der Option „Vorhandene Produkte aktualisieren“ aktualisieren Sie Produkte, die über ID oder SKU zugeordnet werden, statt Duplikate anzulegen.

• Exportieren Sie zuerst ein vorhandenes Produkt und verwenden Sie diese Datei als Vorlage — sie zeigt die genauen Spaltennamen, die Ihr Shop erwartet.
• Typische Spalten sind Type, SKU, Name, Published, Short description, Description, Regular price, Categories, Tags, Images und Attribute 1 name / Attribute 1 value(s).
• Bilder werden über URLs importiert und müssen daher beim Import öffentlich erreichbar sein.
• Variable Produkte benötigen eine Elternzeile vom Typ „variable“ und je Variante eine Zeile, die auf das übergeordnete Produkt verweist.
• Sehr große Dateien können bei Shared Hosting in einen Timeout laufen — teilen Sie sie in Stapel von einigen Hundert Zeilen auf.

Option 2: Import-Plugins

Import-Plugins von Drittanbietern ergänzen Funktionen, die dem Kern-Importer fehlen: zeitgesteuerte oder wiederkehrende Importe aus einem Lieferanten-Feed, XML-Unterstützung, Regeln zur Feldtransformation und eine bessere Verarbeitung sehr großer Dateien. Sie sind sinnvoll, wenn ein Lieferant regelmäßig aktualisierte Preis- und Bestandsdateien schickt.

Auch Plugins erwarten strukturierte Eingaben. Wenn Ihr Lieferant PDFs statt eines Feeds liefert, nimmt Ihnen ein Plugin die Arbeit nicht ab, diese PDFs in Zeilen zu überführen.

Option 3: Die WooCommerce REST API

Entwickler und Integrationswerkzeuge können Produkte über die WooCommerce REST API anlegen, einschließlich eines Batch-Endpunkts, der viele Produkte in einer Anfrage erstellt oder aktualisiert. Das eignet sich für automatisierte Pipelines und Apps, die Produkte direkt und ohne CSV-Schritt erstellen.

Doc2Shelf nutzt diesen Weg: Nach der Prüfung sendet es Produkte als einfache Entwurfsprodukte mit langen und kurzen Beschreibungen an WooCommerce, sodass Sie sie in WooCommerce kontrollieren können, bevor sie live gehen. Globale Filterattribute und variable Produkte werden separat in WooCommerce eingerichtet.

Produktdaten für den Massenimport vorbereiten

Welche Importmethode Sie auch verwenden: Die Datenqualität entscheidet über das Ergebnis. Vor dem Import:

• Vergeben Sie jedem Produkt eine eindeutige SKU — darüber findet ein späteres Update das richtige Produkt.
• Legen Sie Kategorien und globale Attribute zuerst in WooCommerce an und verweisen Sie dann einheitlich darauf.
• Normalisieren Sie Spezifikationen: gleiche Einheiten, gleiche Attributnamen, ein Wert pro Zelle.
• Schreiben Sie eigene Beschreibungen, statt Lieferantentext einzufügen; Marktplätze und Suchmaschinen belohnen einzigartige Texte.
• Importieren Sie beim ersten Durchlauf als Entwürfe – setzen Sie Published auf -1 (0 macht Produkte privat) – und prüfen Sie dann eine Stichprobe, bevor Sie alles veröffentlichen.

Wenn Ihr Lieferant nur PDFs schickt

Viele Lieferanten stellen Datenblätter und Kataloge als PDFs bereit, nicht als CSV-Feeds. Dann ist die Extraktion der Engpass: Jemand muss jedes PDF lesen, die Spalten ausfüllen und eine Beschreibung schreiben.

Das können Sie manuell erledigen oder die Daten mit einem Werkzeug extrahieren und prüfen. Doc2Shelf liest Lieferanten-PDFs, extrahiert die Spezifikationen zur Prüfung, entwirft lange und kurze WooCommerce-Beschreibungen und legt die Produkte über die REST API als Entwürfe an — und ersetzt damit bei PDF-basierten Katalogen den Tabellenschritt.

Häufige Fehler beim WooCommerce-Import

Wenn ein Import fehlschlägt oder unerwartete Ergebnisse liefert, prüfen Sie zuerst Folgendes:

• Doppelte oder fehlende SKUs, durch die Zeilen übersprungen oder Produkte dupliziert werden.
• Falsche Dateikodierung — speichern Sie die CSV als UTF-8, damit Umlaute und Akzente korrekt importiert werden.
• Bild-URLs, die weiterleiten, eine Anmeldung erfordern oder auf sehr große Dateien verweisen.
• Uneinheitlich geschriebene Kategoriepfade (verwenden Sie „Eltern > Kind“ für verschachtelte Kategorien).
• Varianten, deren Attributwerte nicht zu den Attributwerten des übergeordneten Produkts passen.

Referenz der WooCommerce-Produkt-CSV-Spalten

Der Core-Importer liest einen festen Satz von Spaltennamen. Wenn Sie ein Produkt aus Ihrem eigenen Shop exportieren, erhalten Sie genau die Kopfzeilen, die Ihre WooCommerce-Version erwartet; die folgende Tabelle erklärt die Spalten, die für einen Massenupload am wichtigsten sind. Nur Name ist erforderlich – alle anderen Spalten sind optional, aber ein Katalog, der ohne Type, SKU, Preise und Kategorien importiert wird, hinterlässt später viel Handarbeit.

Spalten mit einer Einheit in der Kopfzeile, etwa Weight und die drei Abmessungen, zeigen die in Ihren Shop-Einstellungen festgelegte Einheit; kopieren Sie diese Kopfzeilen daher aus einem Export, statt sie abzutippen. Eigene Daten ohne eigene Spalte kommen in eine Spalte, deren Kopfzeile mit meta: beginnt, gefolgt vom Feldschlüssel.

Variable Produkte in einer CSV: übergeordnete Zeilen und Variationszeilen

Ein variables Produkt verteilt sich auf mehrere Zeilen: eine übergeordnete Zeile, die das Produkt und die angebotenen Attributwerte definiert, und je eine Zeile pro Variation, die Preis, SKU und Bestand für eine einzelne Kombination enthält. Die übergeordnete Zeile hat den Type „variable“; jede Variationszeile hat den Type „variation“ und verweist in der Spalte Parent auf das übergeordnete Produkt, mit dessen SKU oder id: gefolgt von dessen ID.

Die Attributspalten verbinden die Zeilen miteinander. Beim übergeordneten Produkt listet Attribute 1 value(s) alle angebotenen Werte auf, durch Kommas getrennt. Bei jeder Variation steht derselbe Attribute 1 name mit genau einem dieser Werte. Schreibweise und Groß-/Kleinschreibung müssen übereinstimmen: Eine Variation mit „rot“ unter einem übergeordneten Produkt mit „Rot“ kann am Ende ohne verwendbaren Attributwert dastehen.

Setzen Sie Attribute 1 global beim übergeordneten Produkt und bei seinen Variationen auf 1, wenn Sie ein shopweites Attribut verwenden, das unter Produkte → Attribute angelegt wurde – damit arbeiten die Filternavigation und Filter-Widgets. Seit WooCommerce 11.1 kann ein Update-Import außerdem neue Variationen zu einem bereits vorhandenen variablen Produkt hinzufügen, sodass Sie eine Produktreihe erweitern können, ohne das übergeordnete Produkt neu aufzubauen.

• Halten Sie jede übergeordnete Zeile oberhalb ihrer Variationen, damit sich die Datei leicht prüfen lässt und das übergeordnete Produkt existiert, wenn seine Variationen darauf verweisen.
• Geben Sie jeder Variation eine eigene SKU und einen eigenen Preis; eine Variation ohne Preis kann nicht gekauft werden.
• Steuern Sie mit Attribute 1 default beim übergeordneten Produkt, welche Option vorausgewählt ist.

Produktbilder über die CSV hinzufügen

Die Spalte Images nimmt eine oder mehrere Bild-URLs auf, durch Kommas getrennt. Die erste URL wird zum Beitragsbild, die übrigen bilden die Produktgalerie in der angegebenen Reihenfolge. Beim Import lädt WordPress jede Datei in Ihre Mediathek herunter, daher muss jede URL in diesem Moment öffentlich erreichbar sein – ohne Login, ohne ablaufenden Freigabelink und ohne Weiterleitung auf eine Webseite statt auf die Datei.

Bilder sind meist der langsamste Teil eines Imports: Einige hundert Produkte mit je fünf Bildern bedeuten über tausend Downloads. Verkleinern Sie Bilder, bevor Sie sie hosten, verwenden Sie aussagekräftige Dateinamen (kettle-red-front.jpg, nicht IMG_0042.jpg) und teilen Sie große Kataloge in kleinere Dateien auf.

Der Core-Importer kann keinen Alt-Text für Bilder setzen. Ergänzen Sie Alt-Texte nachträglich in der Mediathek, über die REST API oder mit einer Import-Erweiterung, die dies unterstützt. Eine Variation enthält nur ein Bild, geben Sie daher jeder Variationszeile höchstens eine URL.

Produkte per WooCommerce REST API in großen Mengen anlegen

Die REST API ist der bessere Weg, wenn Importe sich wiederholen, wenn die Produktdaten bereits in einem anderen System liegen oder wenn niemand mehr mit einer CSV hantieren soll. Der Batch-Endpunkt für Produkte (POST /wp-json/wc/v3/products/batch) akzeptiert Anlegen-, Aktualisieren- und Löschen-Vorgänge in einer einzigen Anfrage.

Standardmäßig ist eine Batch-Anfrage auf 100 Objekte für Anlegen, Aktualisieren und Löschen zusammen begrenzt. Dasselbe Limit gilt für die Batch-Endpunkte für Variationen, Kategorien, Attribute und Attributbegriffe. Ein Katalog mit 1.000 Produkten benötigt daher mindestens zehn Anfragen, mit Variationen mehr.

1. Erstellen Sie unter WooCommerce → Einstellungen → Erweitert → REST-API einen REST-API-Schlüssel mit Lese-/Schreibrechten, oder lassen Sie eine App über den Autorisierungsbildschirm von WooCommerce einen anfordern.
2. Legen Sie zuerst die Kategorien, globalen Attribute und Attributbegriffe an und notieren Sie deren IDs.
3. Senden Sie einfache und übergeordnete Produkte in Batches von bis zu 100 mit dem Status „Entwurf“ (draft).
4. Legen Sie die Variationen jedes variablen Produkts über den Variationen-Batch-Endpunkt dieses Produkts an.
5. Prüfen Sie in der Antwort das Ergebnis für jeden Eintrag und wiederholen Sie nur die fehlgeschlagenen Einträge.
6. Prüfen Sie im Admin-Bereich stichprobenartig einige Entwürfe und veröffentlichen Sie sie dann.

Ein Plugin oder einen Weg für den WooCommerce-Massenupload von Produkten wählen

Reicht der Core-Importer nicht aus, beurteilen Sie ein Import-Plugin oder eine Erweiterung danach, wie es mit Ihren Daten umgeht, nicht nach der Länge der Funktionsliste, und testen Sie es mit einer echten Lieferantendatei auf einer Staging-Kopie des Shops, bevor Sie sich festlegen. Die Tabelle vergleicht die vier Wege; danach folgen die Fragen, die Sie an jedes Plugin stellen sollten.

• Quellformate: nur CSV oder auch XML, Tabellendateien und per URL abgerufene Remote-Feeds.
• Zeitplanung: ob ein Import nach Zeitplan erneut ausgeführt werden kann, um neue Preise und Bestände zu übernehmen.
• Zuordnung und Transformation: Spalten umbenennen, Werte aufteilen, Einheiten umrechnen und Preisregeln während des Imports anwenden.
• Variable Produkte: ob übergeordnete Produkte, Variationen und globale Attribute zuverlässig aufgebaut werden.
• Bilder: wie sie heruntergeladen werden, ob Duplikate erkannt werden und ob Alt-Texte gesetzt werden.
• Große Dateien: Verarbeitung im Hintergrund oder in Teilen, damit lange Importe nicht in ein Timeout laufen.
• Update-Regeln: über welchen Schlüssel abgeglichen wird (ID, SKU oder GTIN) und welche Felder überschrieben werden dürfen.

Checkliste vor dem Import und Fehlerbehebung

Die meisten fehlgeschlagenen Importe gehen auf einen übersprungenen Vorbereitungsschritt zurück. Arbeiten Sie vor jedem großen Import die Checkliste ab und nutzen Sie die Tabelle, um Probleme zu diagnostizieren, die trotzdem auftreten.

1. Sichern Sie die Datenbank oder führen Sie den Import auf einer Staging-Kopie des Shops aus.
2. Exportieren Sie ein vorhandenes Produkt und kopieren Sie dessen Kopfzeile in Ihre Datei.
3. Legen Sie die Kategorien, globalen Attribute und Attributbegriffe an, auf die sich die Datei bezieht.
4. Prüfen Sie, dass jede SKU eindeutig ist und dass der Parent-Wert jeder Variation zur SKU eines vorhandenen übergeordneten Produkts passt.
5. Verwenden Sie in den Spalten für Preis, Bestand, Gewicht und Abmessungen reine Zahlen.
6. Öffnen Sie eine Stichprobe der Bild-URLs in einem privaten Browserfenster und prüfen Sie, dass sie ohne Login geladen werden.
7. Setzen Sie Published auf -1, damit die Produkte als Entwürfe ankommen.
8. Speichern Sie die Datei als UTF-8-CSV.
9. Importieren Sie eine Testdatei mit zehn Zeilen, prüfen Sie die Ergebnisse und importieren Sie dann den Rest in Batches.

Mit Testprodukten testen, bevor der echte Import startet

Eine kleine Testdatei fängt Zuordnungsfehler ab, bevor sie Hunderte Produkte betreffen. Erstellen Sie sie aus Ihrer echten Vorlage, damit die Kopfzeilen identisch sind, und versehen Sie jedes Testprodukt mit einer deutlichen Markierung – einem SKU-Präfix „TEST-“ und einem Schlagwort „test“ –, damit Sie die Produkte später finden und löschen können.

Decken Sie jeden Fall ab, der in Ihrer echten Datei vorkommt, nicht nur den einfachen. Etwa zehn Zeilen genügen meist:

• Ein einfaches Produkt, bei dem alle Spalten ausgefüllt sind, die Sie verwenden wollen.
• Ein variables Produkt mit zwei Attributen und mindestens drei Variationen.
• Ein Produkt mit einer Galerie aus mehreren Bildern und eines ohne Bilder.
• Ein Produkt in einer verschachtelten Kategorie, die noch nicht existiert.
• Ein Produkt mit Umlauten und Akzentzeichen, Anführungszeichen und einem Komma in der Beschreibung.
• Eine Zeile, die ein vorhandenes Produkt über die SKU aktualisiert.
• Prüfen Sie die Ergebnisse im Admin-Bereich und im Shop – Preise, Variations-Auswahllisten, Bildreihenfolge und Kategorieseiten – und löschen Sie die Testprodukte vor dem echten Import.