Deine Produktdaten. Gut vorbereitet.

Der allgemeine Produktimport liest CSV-Dateien und XLSX-Arbeitsmappen. Die vollständige Vorlage auf dieser Seite enthält Stammdaten, Varianten, Texte und SEO, Preise, Lager- und Lieferangaben, Maße, Versandzuordnungen sowie Links zu Bildern, Dokumenten und Produktseiten. Vier zusätzliche Beispielspalten zeigen technische Eigenschaften und Variantenmerkmale.

Lade die Beispieldatei oder die leere Vorlage herunter. Die vier Beispielzeilen zeigen zwei Kaufvarianten, ein Mietprodukt und ein Abo. Ersetze die Beispieldaten; die example.invalid-Adressen sind Platzhalter und müssen ersetzt oder entfernt werden. Eine Zeile steht für einen verkaufbaren Artikel mit eigener Artikelnummer. Öffne im Portal den allgemeinen Produktimport, lade die Datei hoch und prüfe die Feldzuordnung.

Nur Produktname (display_name) und Preis (price) sind in der Produktdatei Pflicht. Alles Weitere ist optional: Spalten leer lassen oder weglassen und eigene technische Angaben ergänzen. Ohne Artikelnummer erzeugt der allgemeine Import automatisch eine. Für spätere Aktualisierungen diese Nummer beibehalten und die Updatefunktion verwenden. Die Kategorie ordnest du bei Bedarf später im Portal zu, bevor du Produkte in den Shop überträgst.

Die Vorlage ist UTF-8-CSV mit Semikolon und unterstützt Umlaute. CSV-Dateien dürfen auch Komma oder Tabulator als Trennzeichen verwenden. Behandle Artikelnummern und EAN als Text, damit führende Nullen erhalten bleiben. Verwende feste Zellwerte statt Formeln. Bei XLSX wird das erste sichtbare Tabellenblatt gelesen. Dateien werden vor dem Einlesen auf Schadsoftware geprüft.

Im allgemeinen Import gibt es keine feste Anzahl technischer Spalten. Es gelten die Dateigrenzen: höchstens 5 MiB Tabellendaten, 5.000 Datenzeilen und insgesamt 500.000 Zellen einschließlich Kopfzeile. Bei XLSX gilt auch die Größe der entpackten Tabelle. Größere Kataloge auf mehrere Dateien verteilen. Pro Artikel sind bis zu 20 Bildlinks und 20 Dokumentlinks möglich.

Verwende für zusammengehörige Varianten dieselbe product_group. Eine eigene productnumber und variant_name sind hilfreich, aber optional. Fehlende Artikelnummern werden vergeben. Farbe und Leistung zeigen Variantenmerkmale, Material und Schutzart technische Eigenschaften. Du kannst beliebig viele weitere technische Spalten ergänzen, solange die Dateigrenzen eingehalten werden. Ordne jede eigene Spalte im Import ausdrücklich als technische Eigenschaft oder Variantenmerkmal zu.

Die Produktvorlage enthält Verkaufspreis, Steuersatz und Rabatt sowie Felder für Kauf (standard), Miete (rental), Abo (subscription) und Anfrageprodukte (quotation). Nur Name und Preis sind Pflicht; ergänze die passenden Angaben bei Bedarf. Für Miete sind Tages-, Wochen- und Monatspreise möglich, für Abos Wochen- und Monatspreise. Preise ohne Währungssymbol und mit höchstens zwei Nachkommastellen eintragen. Zusätzliche Preislisten werden getrennt gepflegt und haben eigene Vorlagen.

Die öffentlichen Vorlagen zeigen den Aufbau mit fiktiven Kennungen. Für tatsächliche Preisänderungen exportierst du unter „Preislisten aktualisieren“ deine persönliche Arbeitsdatei. Bestehende Kennungen, Referenzspalten und Dateinamen beibehalten und die Datei innerhalb von sieben Tagen wieder hochladen. Die Spalte Verpackungseinheit vor den Preisen zeigt den Preisbezug, als Zahl aus dem Gebindeinhalt, z. B. 10 für zehn Stück. Fehlt eine eindeutige Mengenangabe, bleibt sie leer. Diese Referenz unverändert lassen. Für eine neue Preisliste im persönlichen Export eine zusätzliche Spalte mit einem eindeutigen Listennamen anlegen und Preise eintragen. Leere Zellen in neuen Spalten legen keinen Preis an. Dezimalpunkt und Dezimalkomma sind gleichwertig: 12.50 und 12,50 ergeben denselben Preis. Erst Vorschau prüfen und gewünschte Änderungen bestätigen; neue Listen erhalten keine automatische Kundengruppenzuordnung.

Trage direkte öffentliche HTTPS-Adressen in photo_urls und document_urls ein. Mehrere Adressen in derselben Zelle werden mit | getrennt. Ein Bildlink muss auf die Bilddatei zeigen, ein Dokumentlink auf das Dokument. Du prüfst die erkannten Medien in eigenen Schritten, bevor sie gespeichert werden. Login-Links, lokale Dateipfade und interne Netzadressen eignen sich dafür nicht.

Ja. Hinterlege eine öffentliche HTTPS-Produktseite in source_url, bestätige die Zuordnung und starte die Quellenanalyse ausdrücklich. Sie kann verfügbare Produktbeschreibungen, Bilder, Dokumentlinks und technische Angaben erkennen. Du prüfst und wählst die Ergebnisse im Import. Artikelnummern und Preise aus deiner Datei werden dabei nicht durch Website-Werte ersetzt. Verwende eigene oder zur Übernahme freigegebene Inhalte.

Die Analyse liest öffentlich erreichbares HTML. Sie führt keine Website-Skripte aus und meldet sich nicht auf fremden Seiten an. Dynamisch nachgeladene Inhalte, Zugangssperren, Netzfehler oder abweichende Seitenstrukturen können zu fehlenden Treffern führen. Die Dateizeilen bleiben prüfbar: ergänze Angaben manuell, verwende direkte Bildlinks oder fahre ohne Quellenanalyse fort. Ein automatischer Vollcrawl der gesamten Website gehört nicht zu diesem Upload.

Ja. Die Lieferanten-API bietet GET /api/v1/products für die Produktliste und GET /api/v1/products/{product_id} für Details. Anfragen verwenden Authorization: Bearer mit einem freigegebenen API-Schlüssel und products:read. Der Schlüssel begrenzt den Zugriff auf den erlaubten Lieferantenbereich. Die Liste unterstützt limit bis 200 und cursor; für Folgeseiten verwendest du next_cursor aus der Antwort. Dokumentation und ein Abrufbeispiel findest du im API-Abschnitt dieser Seite.

Mit den passenden Schreibrechten stehen POST /api/v1/products für neue Produkte und PATCH /api/v1/products/{product_id} für Änderungen bereit. Dafür wird products:write benötigt. Die JSON-Felder richten sich nach der API-Dokumentation; eine CSV-Zeile ist kein fertiger API-Request. Ein HTTP 202 bestätigt eine vorgemerkte Änderung. Die interne Prüfung und Freigabe sowie die konfigurierte Shopübertragung folgen gesondert.

Eine Verbindung zu eurer API oder einem bereitgestellten Export wird mit euch eingerichtet. Dafür brauchen wir die Schnittstellenbeschreibung, Beispielantworten oder eine Beispieldatei, Produktkennungen, die gewünschten Datenfelder, den Aktualisierungsrhythmus und das Zielsystem. Außerdem stimmen wir Anmeldung, Seitennavigation, Abrufgrenzen und Fehlerbehandlung ab. Der allgemeine Dateiimport richtet durch das Eintragen einer API-URL noch keine regelmäßige Synchronisierung ein.

Im allgemeinen CSV/XLSX-Import prüfst du zuerst Datei, Zuordnung, Quellen und die ausgewählten Artikel. Stammdaten, technische Angaben, Bilder und Dokumente werden in eigenen Schritten vorbereitet. Erst die bestätigte Auswahl im Uploadschritt wird in den dort angezeigten CCV-Zielshop übertragen und zurückgeprüft. API-Änderungen und der einfache Dateiimport nutzen den bestehenden Freigabeprozess. Für einen anderen Shop wird eine passende Anbindung gesondert eingerichtet.

Der Download enthält ausschließlich Beispiel- oder leere Vorlagendaten. Der erste Upload liest und prüft deine Datei und öffnet die Zuordnung. Quellenanalyse, Datenvorbereitung und Shopübertragung sind weitere Schritte mit eigenen Bestätigungen. Du kannst zunächst deine Vorschau prüfen und speichern. Die Uploadvorlage setzt keine Sichtbarkeit im Shop; diese Entscheidung erfolgt im jeweiligen Freigabe- oder Uploadablauf.

Diese Anleitung und alle vier CSV-Downloads sind öffentlich. Für den eigentlichen Import brauchst du einen freigegebenen Portalzugang mit Produkt-Schreibrechten und dem passenden Lieferantenbereich. API-Schlüssel werden mit den nötigen Rechten eingerichtet und gehören in die sichere Konfiguration eures Systems, nicht in die CSV-Datei. Über „Anbindung besprechen“ kannst du uns die Art eurer Datenquelle und den gewünschten Ablauf nennen.