Ordnen Sie Produkte anhand einer stabilen SKU oder externen ID zu, legen Sie für jedes Feld die maßgebliche Datenquelle fest und führen Sie den Import zunächst im Vorschaumodus an einer kleinen Stichprobe aus. Lagern Sie ungültige Zeilen in einen Report aus, gestalten Sie Batches idempotent und erstellen Sie vor dem Produktiv-Update ein Backup der Datenbank und der Medien.
Ein Produktimport in WooCommerce kann den Katalog schneller befüllen oder aktualisieren als die manuelle Pflege, doch ein einziges fehlerhaftes Mapping kann Preise überschreiben, doppelte Attribute anlegen oder Varianten abkoppeln. CSV bildet einen Stapelstand ab, eine API kann Änderungen fortlaufend übertragen. In beiden Fällen sind eine stabile Identität des Datensatzes und eine genaue Regel, welche Felder die Quelle verwaltet, am wichtigsten.
Ein sicherer Import ist ein wiederholbarer Prozess mit Validierung, Vorschau der Änderungen, Batches, Fehlerbericht und Rückgängig-Möglichkeit. Der erste Test gehört auf Staging und auf eine kleine repräsentative Stichprobe, nicht auf den gesamten Produktivkatalog. Bilder, Taxonomien und Varianten benötigen ein eigenes Mapping, da eine textliche Übereinstimmung des Namens für eine eindeutige Zuordnung nicht ausreicht.
Wählen Sie CSV, API oder eine Kombination
CSV eignet sich für eine einmalige Migration, einen kontrollierten Batch oder einen Lieferantenexport mit geringerer Frequenz. Die Daten lassen sich manuell prüfen und archivieren, Änderungskonflikte löst CSV jedoch nicht von selbst. Eine API bietet laufende Aktualität und Statusantworten, erfordert aber Authentifizierung, Limits, eine Warteschlange, Monitoring und eine Vertragsversion. Die Wahl richtet sich nach der benötigten Aktualität und dem Betrieb.
Häufig bewährt sich eine Kombination: Ereignisse aktualisieren Preis und Lagerbestand, während ein regelmäßiger Vollexport Abweichungen prüft. Legen Sie fest, was bei einem Ausfall der Quelle geschieht und welches Datenalter akzeptabel ist. Ein manueller Upload darf ohne Vorrangregel nicht mit der automatischen Synchronisierung um dasselbe Feld konkurrieren.
Erstellen Sie eine Datenkarte und eine stabile Identität
Ordnen Sie jeder Spalte bzw. jedem API-Feld Ziel, Typ, Pflichtstatus, Format, Einheit, Wertebereich und maßgebliche Quelle (Source of Truth) zu. Unterscheiden Sie einen leeren Wert von der Anweisung zum Löschen. Die SKU oder externe ID muss auch nach einer Namensänderung stabil bleiben. Stoppen Sie doppelte Identifikatoren vor dem Schreiben, nicht erst nachdem zwei Produkte angelegt wurden.
Varianten benötigen eine Eltern-ID und eine eigene Varianten-SKU. Ordnen Sie Attribute über einen stabilen Slug oder eine Synonymtabelle bestehenden globalen Terms zu, damit der Import nicht `modrá`, `Modra` und `blue` separat anlegt. Kategorien erhalten eine eigene Zuordnung vom Quellcode zur Zieltaxonomie. Verwenden Sie Freitext nicht ohne Prüfung, um eine kritische Klassifizierung abzuleiten.
- Stabile SKU oder externe ID
- Ausdrückliche Bedeutung eines leeren Werts
- Elternprodukt und Identität der Variante
- Zuordnung von Taxonomien und Einheiten
Validieren Sie die Datei und zeigen Sie eine Vorschau der Änderungen an
Prüfen Sie vor dem Import Kodierung, Trennzeichen, Kopfzeilen, Spaltenanzahl, Datentypen, Pflichtwerte und Eindeutigkeit. Validieren Sie beim Preis das Dezimalformat und die Währung gemäß dem Prozess, beim Lagerbestand eine ganze Zahl oder einen unterstützten Wert. Eine ungültige Zeile soll Nummer, Feld und eine verständliche Fehlermeldung erhalten, ohne dass sicher unabhängige Zeilen angehalten werden.
Ein Dry Run zeigt die Anzahl neuer, aktualisierter, unveränderter, deaktivierter und fehlerhafter Produkte sowie eine Stichprobe der Unterschiede je Feld. So lässt sich ein unerwartetes massenhaftes Löschen von Bildern oder Preisen vor dem Schreiben stoppen. Ein Freigebender bestätigt den Umfang, und die gespeicherte Eingabedatei mit Checksumme ermöglicht es, später nachzuvollziehen, was importiert wurde.
Verarbeiten Sie Batches idempotent und sicher
Teilen Sie einen großen Import in Batches mit Checkpoint und Zeitlimit auf. Derselbe Batch lässt sich nach einer Unterbrechung wiederholen, ohne Duplikate oder ein zweites Bild zu erzeugen. Speichern Sie jeden Datensatz nach Möglichkeit transaktional und protokollieren Sie das Ergebnis. Laden Sie externe Bilder mit Timeout, zulässigem Typ und Größe herunter und prüfen Sie, dass die URL nicht ins interne Netzwerk führt.
Berücksichtigen Sie beim Import Cache, Suchindex, Neuberechnungen und Webhooks. Lösen Sie keine aufwendige Folgeaktion für jedes einzelne Feld aus, wenn sie sich sicher nach dem Batch durchführen lässt. Begrenzen Sie die Parallelität, damit der Import den Checkout nicht blockiert. Der produktive Prozess verfügt über ein Monitoring von Geschwindigkeit, Fehlern und Alter der Queue sowie über die Möglichkeit, ihn ohne Zustandsverlust zu pausieren.
- Batches mit Checkpoint
- Sichere Wiederholung derselben Eingabe
- Limit und Validierung externer Medien
- Kontrollierte nachgelagerte Neuberechnungen
Bereiten Sie Rollback und Nachkontrolle vor
Erstellen Sie vor einer Massenänderung ein wiederherstellbares Backup der Datenbank und – je nach Import – auch der Uploads. Ein Rollback kann den gesamten Wiederherstellungspunkt zurückspielen oder ein Journal der alten Werte verwenden, muss aber vorab getestet sein. Bei laufenden Bestellungen kann eine vollständige Wiederherstellung der Datenbank neue Transaktionen verlieren; planen Sie daher den Zeitpunkt und trennen Sie Katalogänderungen.
Vergleichen Sie nach dem Import die Anzahlen, eine zufällige sowie eine risikobasierte Stichprobe, Preise, Lagerbestand, Varianten, Kategorien, Bilder und Produkt-URLs. Testen Sie Suche, Filter, Warenkorb und den Bestellexport. Korrigieren Sie fehlerhafte Zeilen in der Quelle und starten Sie den Import erneut, statt das Ziel manuell zu bearbeiten, was der nächste Durchlauf überschreiben würde. Bewahren Sie Bericht und Mapping als Betriebsdokumentation auf.
Häufige Fragen
Wie importiert man Produkte, ohne Duplikate zu erzeugen?
Verwenden Sie eine eindeutige, stabile SKU oder externe ID und führen Sie für jede Zeile einen Upsert anhand dieses Schlüssels durch. Lehnen Sie doppelte oder fehlende Kennungen vor dem Schreiben ab. Der Produktname ist keine zuverlässige Identität.
Kann ich Bilder von externen URLs importieren?
Ja, aber mit Timeout, Größenlimit, Typprüfung und Schutz vor Zugriffen auf das interne Netzwerk. Erfassen Sie Herkunft und Rechte. Ein wiederholter Import sollte dieselbe Datei nicht unnötig erneut speichern.
Was bedeutet ein Dry Run beim Import?
Es ist eine Vorschau ohne Schreibvorgang, die die Eingabe validiert und die geplanten neuen, geänderten, unveränderten und fehlerhaften Datensätze anzeigt. Sie ermöglicht es, ein falsches Mapping oder ein massenhaftes Überschreiben zu erkennen, bevor es den Katalog beeinflusst.
Quellen und weiterführende Lektüre
Adam Antoni vyvíja weby, aplikácie a softvér na mieru. Prepája firemné systémy, automatizuje procesy a vytvára AI agentov. Pôsobí v Spišskej Novej Vsi a spolupracuje s firmami na celom Slovensku.
