Daten-Mapping

Ihr Shop nennt eine Spalte article; ein anderer nennt sie sku. Scalarcut verlangt keines von beiden. Sie mappen jede Spalte Ihrer Datei einmal auf ein Scalarcut-Feld, und das Mapping wird gespeichert.

So funktioniert das Mapping

Wenn Sie eine Datei hochladen, liest Scalarcut die Header-Zeile und bildet einen Fingerabdruck daraus. Haben Sie dieses Header-Layout schon einmal importiert, wird das gespeicherte Mapping automatisch angewendet — ein neues Spaltenlayout mappen Sie nur einmal.

Jede gemappte Spalte trägt eine Transformation, die dem Importer sagt, wie der Wert zu lesen ist:

Transformation	Verwendet für	Verhalten
trim	SKU, Name, Kollektion, IDs	Leerraum wird entfernt.
integer	Breite, Höhe, Dicke, Packungsmenge	Wird als ganze Zahl geparst.
parse_size_pair	Kombinierte Größe	Akzeptiert 600×300, 600x300, 600*300, mit mm, cm oder m.
url	Bild-URL	Muss öffentliches HTTPS sein, sonst wird sie mit Warnung verworfen.
enum_map	Materialtyp	Ordnet Werte wie porcelain, gres oder керамогранит einem bekannten Typ zu.

Der Import-Ablauf

1. Hochladen der Datei und Modus wählen (unten).
2. Mappen der Spalten — oder ein gespeichertes Profil automatisch anwenden lassen.
3. Validieren — jede Zeile wird geprüft; Fehler und Warnungen werden gemeldet.
4. Bestätigen — Sie prüfen die Zahlen erstellt / aktualisiert / abgelehnt, bevor etwas veröffentlicht wird.
5. Übernehmen — die Zeilen werden in den Katalog geschrieben und die Revision erhöht.

Schlägt eine Zeile fehl, können Sie ein Fehler-CSV mit Zeilennummer, SKU und Grund herunterladen, die Quelldatei korrigieren und erneut hochladen.

Validierungsregeln

• Eine Zeile braucht einen SKU und eine Größe. Ohne eines davon wird sie abgelehnt.
• Eine Fliesengröße unter 10 mm wird abgelehnt.
• Eine fehlende oder nicht-HTTPS-Bild-URL ist eine Warnung, kein Fehler — die Fliese wird trotzdem importiert.

Katalog aktuell halten

Ihr Katalog ändert sich ständig. Sie müssen das Widget nicht neu einbetten oder Ihren Snippet anfassen — das Widget liefert bei jedem Laden immer die letzte übernommene Revision aus. Der Ablauf für alltägliche Änderungen:

Neue Produkte hinzufügen

Fügen Sie die neuen Zeilen Ihrem üblichen Export hinzu und laden Sie erneut hoch. Dieselben Header werden automatisch erkannt, sodass neue SKUs hinzugefügt und bestehende unangetastet bleiben.

Produkt bearbeiten

Aktualisieren Sie die Zeile dieses Produkts (neue Größe, korrigierte Packungsmenge, neue Bild-URL) und importieren Sie erneut. Der bestehende SKU wird an Ort und Stelle aktualisiert; die anderen Zeilen bleiben unverändert.

Produkte entfernen

Entfernen ist eine bewusste Entscheidung, damit nichts versehentlich verschwindet. Wählen Sie den passenden Modus:

Modus	Was er tut
Upsert	Fügt die Zeilen der Datei hinzu oder aktualisiert sie und lässt alles andere unangetastet. Für Hinzufügen und Bearbeiten.
Kollektion ersetzen	Ersetzt eine Kollektion vollständig — jeder SKU dieser Kollektion, der nicht mehr in der Datei ist, wird entfernt.
Vollständiger Katalog-Sync	Macht den Katalog exakt gleich der Datei — jeder Fliesen-SKU, der in der Datei fehlt, wird entfernt.

Für ein einmaliges Produkt, das ausverkauft oder ausgelaufen ist, bearbeiten Sie die Datei und importieren Sie erneut, statt einen veralteten SKU im Planer zu belassen.

Bilder und Preise bleiben Ihre

Das Mapping zeichnet nur auf, woher Dinge kommen. Bilder bleiben auf Ihren Servern (per URL referenziert), und Preise sind im Widget nur Anzeige — der Checkout bleibt die Quelle der Wahrheit.

Nächste Schritte

• CSV-Struktur — die Spalten und Dateiformate.
• Katalog — was der Katalog speichert und wie das Widget ihn nutzt.