CSV-Struktur

Ihr Katalog ist eine einzige Tabelle mit SKUs. Sie exportieren sie aus Ihrem Shop oder ERP, laden sie einmal hoch, mappen die Spalten einmal, und das Widget fixiert jede Produktseite auf die echten Maße des angezeigten SKUs.

Unterstützte Dateien

• CSV und TXT — mit Komma oder Semikolon getrennt. Der Trenner wird automatisch aus der ersten Zeile erkannt.
• XLSX und XLS — Standard-Tabellen.
• Bis zu 20 MB pro Upload.

Die erste Zeile ist der Header. Jede folgende Zeile ist ein SKU.

So bilden Sie das CSV

Sie müssen Ihre Shop-Spalten nicht umbenennen, um sie an unsere anzupassen. Exportieren Sie die Header, die Ihr System ohnehin erzeugt — article, sku, size, boxes per pack usw. sind alle in Ordnung — und mappen Sie sie im nächsten Schritt auf Scalarcut-Felder (siehe Daten-Mapping). Die wesentliche Anforderung ist nur, dass die benötigten Daten irgendwo in der Datei vorhanden sind:

• ein eindeutiger SKU-Code für jede Zeile und
• die Fliesengröße in Millimetern.

Alles andere ist optional und bereichert das Widget.

Pflichtspalten

Feld	Hinweise
SKU-Code	Der Bezeichner, den Ihr Shop bereits nutzt. Warenkorbzeilen geben genau diesen Wert zurück, er muss also dem entsprechen, was Ihr Checkout erkennt.
Größe	Eines der beiden Formate unten.

Größe

Die Größe kann auf zwei Arten angegeben werden:

• Eine kombinierte Spalte — z. B. 600×300, 600x300 oder 600*300. Millimeter, Zentimeter und Meter werden alle akzeptiert, wenn die Einheit ausgeschrieben ist (z. B. 60×30 cm).
• Zwei getrennte Spalten — eine width- und eine height-Spalte, jeweils in Millimetern.

Eine einzelne kombinierte Spalte ist am häufigsten, da die meisten ERPs und Shops die Größe bereits als ein Feld führen.

Optionale Spalten

Feld	Hinweise
Name	Angezeigt im Material-Dropdown des Widgets. Fällt auf den SKU-Code zurück, wenn leer.
Dicke	In Millimetern.
Packungsmenge	Fliesen pro Karton, damit die Bestellung als Kartons ausgedrückt werden kann. Standard 1, wenn nicht angegeben.
Bild-URL	Öffentliche HTTPS-URL zum Produktbild. Siehe unten.
Materialtyp	ceramic, porcelain, lvt, wood oder other. Unbekannte Werte werden auf other gemappt.
Kollektion	Gruppiert Produkte in den Kollektions-Auswähler des Widgets.
ERP / 1C-ID	Ihr interner Bezeichner, für Ihre eigene Berichterstattung durchgereicht.
Barcode	Für Ihre eigenen Systeme durchgereicht.
Preis	Optionaler Listenpreis für die Bildschirmkalkulation, nur Anzeige.

Bilder bleiben auf Ihren Servern

Scalarcut hostet Ihre Produktbilder nicht. Das CSV enthält eine öffentliche HTTPS-URL zu jedem Bild, und das Widget lädt es zur Renderzeit von Ihrem CDN oder Ihrer Storefront — die Datei wird referenziert, nie kopiert. Lizenzierung, Caching und Speicherung bleiben vollständig bei Ihnen.

• Die URL muss öffentliches HTTPS sein. Eine http://- oder nicht öffentliche URL wird mit einer Warnung ausgelassen, sodass die Zeile trotzdem importiert wird und die Fliese nur ohne Foto gerendert wird.
• Aktualisieren Sie das Bild auf Ihrer Seite, und das Widget übernimmt die Änderung beim nächsten Laden — kein erneuter Upload nötig.

Preise sind nur Anzeige

Wenn Sie Preise einbeziehen, zeigt das Widget sie zur Orientierung in der Kalkulation. Der Endpreis wird immer von Ihrem Checkout angewendet, wenn die Warenkorbzeilen hinzugefügt werden. Das Widget belastet nie einen Käufer.

Ein durchgerechnetes Beispiel

Eine minimale, aber vollständige Datei:

sku,name,width_mm,height_mm,pack_qty,texture_url,material_type,collection
CER-600-300,Porcelain Grey,600,300,8,https://cdn.example.com/cer-600-300.jpg,porcelain,Porcelain
LVT-1210-180,Herringbone Oak,1210,180,10,https://cdn.example.com/lvt-1210-180.jpg,lvt,Wood

Derselbe Katalog mit einer einzigen Größenspalte:

sku,name,size_mm,pack_qty,texture_url
CER-600-300,Porcelain Grey,600×300,8,https://cdn.example.com/cer-600-300.jpg
LVT-1210-180,Herringbone Oak,1210×180,10,https://cdn.example.com/lvt-1210-180.jpg

Für eine vollständige durchgerechnete Datei laden Sie das Beispiel-Katalog-CSV herunter — ein kleines, realistisches Fliesen- und Bodenbelagssortiment über einige Kollektionen, genau in der Form, die der Importer erwartet.

Was als Nächstes passiert

Laden Sie die Datei in Ihrem Scalarcut-Dashboard hoch und mappen Sie die Spalten einmal. Ab dann werden dieselben Header bei jedem erneuten Upload automatisch erkannt. Zum Mapping-Schritt und dem täglichen Prozess des Hinzufügens, Bearbeitens und Entfernens von Produkten siehe Daten-Mapping.