Produkte mit einer Tabelle importieren und aktualisieren#

Laden Sie eine Kategorievorlage herunter, tragen Sie Ihre Produkte ein und laden Sie sie im Katalog hoch. Für diesen Ablauf benötigen Sie weder eigenen Code noch API-Zugangsdaten.

Bevor Sie beginnen#

Wählen Sie im Dashboard den richtigen Shop aus. Sie benötigen die Berechtigung, dessen Katalog zu bearbeiten. Wenn die Schaltfläche Produkttabelle hochladen fehlt, prüfen Sie den ausgewählten Shop, Ihre Schreibberechtigung für den Katalog und ob Ihr Konto nur Lesezugriff hat.

Kategorievorlage herunterladen#

1. Öffnen Sie Dashboard → Katalog.
2. Klicken Sie auf Produkttabelle hochladen, um den Dialog Produkte importieren zu öffnen.
3. Wählen Sie unter Produktkategorie wählen die Kategorie aus, die Sie importieren möchten. Die verfügbaren Optionen hängen von Ihrer Shop-Konfiguration ab.
4. Klicken Sie auf Excel-Vorlage herunterladen. Verwenden Sie für jede Kategorie eine separate Vorlage und einen separaten Upload.

Laden Sie für jeden neuen Import eine aktuelle Vorlage herunter, damit die Spalten den aktuellen Anforderungen der Kategorie entsprechen. Die heruntergeladene Arbeitsmappe ist eine Vorlage und kein Export Ihres vorhandenen Katalogs.

Arbeitsmappe ausfüllen#

Verwenden Sie die Arbeitsblätter der Arbeitsmappe wie folgt:

Jede Produktzeile benötigt sku, name, image_url und product_url sowie die für ihre Kategorie erforderlichen Abmessungen. Beachten Sie die Pflichtfeldmarkierungen und Anweisungen in der heruntergeladenen Vorlage. Übersetzen Sie keine Feldnamen und fügen Sie keine unbekannten oder doppelten Spalten hinzu.

• Formatieren Sie SKU-Zellen als Text, damit das Tabellenprogramm keine führenden Nullen entfernt oder lange Kennungen verändert. Verwenden Sie eine Zeile pro SKU; doppelte Werte in derselben Datei werden abgelehnt, auch wenn sie sich nur durch Groß- und Kleinschreibung unterscheiden.
• Verwenden Sie für image_url eine direkte, öffentlich zugängliche HTTP- oder HTTPS-Bildadresse, die ohne Anmeldung, Cookies oder benutzerdefinierte Anfrageheader funktioniert. Tragen Sie die Adresse der Produktdetailseite in product_url ein.
• Geben Sie Abmessungen und Einheiten gemäß den Anweisungen der Vorlage an. Wenn weder bei einer Abmessung noch in dimension_unit eine Einheit angegeben ist, gilt standardmäßig in.
• Wählen Sie für status einen der zulässigen Werte aus Enums. Ein leeres Feld erhält standardmäßig den Wert active; geben Sie den Status beim Aktualisieren von Produkten ausdrücklich an.

Speichern Sie die Datei als .xlsx (empfohlen). Auch .csv wird akzeptiert, wenn die Datei ausschließlich die Kopfzeile der Produkte und deren Daten enthält. Ältere .xls-Dateien werden nicht unterstützt. Jede Datei darf bis zu 50,000 nicht leere Produktzeilen enthalten und höchstens 50 MB groß sein.

Hochladen und Ergebnis prüfen#

1. Kehren Sie zum Importdialog zurück und wählen Sie dieselbe Kategorie wie in der Vorlage.
2. Wählen Sie unter Vervollständigen und hochladen Ihre gespeicherte Datei und klicken Sie auf Import starten.
3. Prüfen Sie unter Aktuelle Importe den Dateinamen, den Verarbeitungsstatus sowie die Anzahl erfolgreicher und fehlgeschlagener Zeilen. Die Übermittlung bestätigt die Annahme; die Verarbeitung läuft im Hintergrund weiter.
4. Warten Sie auf das Ende der Verarbeitung und prüfen Sie fehlgeschlagene Zeilen, auch wenn der Auftrag Abgeschlossen anzeigt. Kehren Sie zum Katalog zurück und prüfen Sie die importierten Produktdaten und die Bereitschaft zur Visualisierung.

Wenn Zeilen fehlschlagen, klicken Sie auf Fehlerdatei, prüfen Sie die Fehlermeldungen, korrigieren Sie die Produktdaten und laden Sie die korrigierte Datei mit derselben Kategorie hoch. Die heruntergeladene Fehlerarbeitsmappe enthält die fehlgeschlagenen Zeilen und Diagnosespalten; diese Diagnosespalten werden beim erneuten Hochladen ignoriert.

Bei einem vorübergehenden Verarbeitungsfehler verwenden Sie Erneut versuchen, sofern diese Option angeboten wird. Das Wiederholen desselben Auftrags korrigiert keine ungültigen Produktdaten. Wenn laut Oberfläche Zeilen vom Support geprüft werden müssen, verwenden Sie Contact support; diese Zeilen werden nicht automatisch erneut verarbeitet.

Vorhandene Produkte aktualisieren#

Verwenden Sie zum Aktualisieren dieselbe Kategorievorlage und behalten Sie die vorhandene SKU jedes Produkts bei. Füllen Sie für jede enthaltene Zeile alle Pflichtfelder aus, ändern Sie die gewünschten Werte und laden Sie die Datei erneut hoch.

• Dieselbe SKU im selben Shop aktualisiert das vorhandene Produkt. Eine noch nicht vorhandene SKU erstellt ein neues Produkt. Wenn Sie eine SKU in der Tabelle ändern, wird das ursprüngliche Produkt dadurch nicht umbenannt.
• Sie können nur die Produktzeilen hochladen, die Sie aktualisieren möchten. Produkte, die in der Datei fehlen, werden weder gelöscht noch deaktiviert oder aus der Veröffentlichung genommen.
• Dies ist keine teilweise Feldaktualisierung: Pflichtfelder benötigen weiterhin Werte. Gehen Sie nicht davon aus, dass eine leere optionale Zelle den bisherigen Wert beibehält. Insbesondere erhält ein leerer status standardmäßig active, und fehlende Maßeinheiten erhalten standardmäßig in.
• Bewahren Sie Ihre ausgefüllte Arbeitsmappe für spätere Aktualisierungen auf. Die heruntergeladene Vorlage enthält nicht Ihre aktuellen Produktdaten.

Prüfen Sie nach Abschluss des Auftrags die betroffenen Produkte im Katalog. Ein erfolgreicher Import allein bestätigt noch nicht die Sichtbarkeit im Onlineshop; prüfen Sie die Bereitschaft der Produkte und die SDK-Launch-Checkliste.

Importe automatisieren#

Verwenden Sie für eine regelmäßige serverseitige Synchronisierung die Product Import API. Ihre Anfragefelder, Grenzen und ihr Verhalten bei Teilaktualisierungen sind getrennt von diesem Tabellenablauf dokumentiert.