docs
  1. SCAYLE Resource Center
  2. User Guide
  3. Konfigurationen
  4. Importe & Exporte

Importe & Exporte

Im SCAYLE Panel kannst Du Dateien importieren und exportieren. Bei beidem stehen Dir verschiedene Optionen zur Verfügung. So kannst Du beispielsweise Kampagnen-Preise aktualisieren, Händler-Preise überschreiben oder Übersetzungen von Attributen importieren. Export-Dateien erstellst Du in verschiedenen Bereichen und kannst Dir im Export-Bereich zentral einen Überblick über alle Exporte verschaffen. Was Du zu Importen und Exporten wissen musst, erklären wir Dir nun Schritt für Schritt.

Datei-Importe

Auf der Import-Übersichtsseite werden Dir alle bereits importierten Daten angezeigt. Zu dem Bereich gelangst Du über: Einstellungen > Imports & Jobs > Importieren.

Für jeden Import findest Du folgende Informationen:

SpalteBeschreibung
Bereichzeigt den Typ der importierten Datei
Aktualisiertzeigt, wann die importierte Datei zuletzt aktualisiert wurde
Benutzerzeigt, von wem die Datei importiert wurde
Dateiermöglicht es, eine Datei hochzuladen und den Dateinamen einzusehen
Verarbeitetzeigt, wie viele Artikel bereits verarbeitet wurden
Statuszeigt den Import-Status einer Datei

Die verschiedenen Importstatus verhalten sich für alle Importformate gleich. Die jeweilige Konsequenz eines Status kannst Du der Tabelle unten entnehmen.

StatusEffekt
EntwurfDie zu importierenden Datensätze wurden hochgeladen aber noch nicht aktiviert.
AusstehendDie importierten Datensätze wurden noch nicht genehmigt.
In BearbeitungDer Import wird ausgeführt.
FehlgeschlagenDer Datei-Import ist vollständig fehlgeschlagen.
Teilweise fehlgeschlagenDer Datei-Import ist teilweise fehlgeschlagen: Einige Einträge konnten nicht importiert werden.
AbgeschlossenDer Import von neuen Daten wurde abgeschlossen.
In PrüfungDer Import steht zur Prüfung durch einen anderen Nutzer aus.
AbgelehntDie zu importierenden Datensätze wurden durch den Prüfer abgelehnt und nicht in das SCAYLE Panel hochgeladen.

Du kannst Preise, Händler, Übersetzungen, Einstellungen (Master-Daten), Shop-Kategorien und Produkte importieren.

Mit einem Klick auf den Papierkorb auf der rechten Seite kannst Du noch nicht fertiggestellte importierte Dateien jederzeit löschen.

Import von Preisen

Es gibt verschiedene Optionen, um Preise in SCAYLE zu importieren:

  • Kampagnen-Preise aktualisieren
  • Shop-Preise aktualisieren
  • Händler-Preise überschreiben

Kampagnen-Preise

Der Import von Kampagnen-Preisen aktualisiert die Preise für Produkte, die Teil einer Preiskampagne sind, und weist ihnen den jeweiligen Kampagnenpreis zu oder entfernt ihn.

Mehr zu Rabattaktionen erfährst Du im Abschnitt Preiskampagnen.

[note] Die für den Preis-Import benötigte Kampagnen-ID findest Du auf der Übersichtsseite der Preiskampagnen. [/note]

Für den Import von Kampagnen-Preise stehen Dir zwei unterschiedliche Modi zur verfügung:

ModusBeschreibung
AnhängenProdukte/Reduzierungen werden einer Kampagne hinzugefügt oder Reduzierungen von existierenden Produkten werden aktualisiert.
ErsetzenProdukte/Reduzierungen werden komplett durch den Import ersetzt. Produkte ohne Reduzierung (Feld ist leer oder 0) werden aus der Kampagne entfernt.

[note] Beim Preis-Import dürfen Preiskampagnen-Keys eine maximale Länge von 20 Zeichen haben und dürfen keine Sonderzeichen enthalten. [/note]

Wie Du eine Kampagne anpasst, erfährst Du im Abschnitt Preiskampagnen zuweisen.

Shop-Preise

Der Import von Shop-Preisen aktualisiert die Preise für eine bestimmten Preisgruppe. Die Preise gelten für alle Shops, denen diese Preisgruppe zugewiesen wurde.

Die Validierung der Reduzierung wird aus dem aktuell aktiven Preis und dem Preis aus der zuvor hochgeladenen Datei berechnet.

Händler-Preise überschreiben

Die Option Händler-Preise überschreiben ermöglicht es Dir, die Preisinformationen, die ein Händler an das System übermittelt, zu überschreiben. Die überschriebenen Händler-Preise werden dann künftig nicht mehr automatisch aktualisiert.

Import von Händler-Daten

Durch den Import von Händler-Zuordnungen kannst Du die vom Händler gelieferten Produktdaten auf die eigens definierte Master-Struktur referenzieren ("mappen"). Dabei kannst Du von Händlern gelieferte Attribute bereits bestehenden Master-Attributen zuweisen und Händler-Kategorien bestehenden Master-Kategorien. Zusätzlich kann der Produktstatus von Händler-Produkten, die bereits einem Produkt zugeordnet sind, mithilfe des Händler-Produktstatus-Imports geändert werden.

Mehr über Händler-Zuordnungen erfährst Du in diesem Abschnitt.

Import von Ãœbersetzungen

Das SCAYLE Panel unterstützt den Import von Übersetzungen (Attribute, Attributgruppen und Master-Kategorien). Es ist hilfreich auf diese Option zurückzugreifen, falls Übersetzungen von externen Bearbeitern übernommen werden, die keinen Zugang zum SCAYLE Panel haben.

Mehr zu Ãœbersetzungen findest Du hier.

Synonyme importieren

Synonyme für die Shop-Suche kannst Du ebenfalls bequem über den Import erstellen, aktualisieren oder löschen.

Mehr zu Synonymen findest Du im Abschnitt Konfiguration der Suche.

Import von Master-Daten

Es gibt verschiedene Optionen, um sogenannte "Master-Daten" über das SCAYLE Panel zu importieren. Wie diese Daten grundsätzlich definiert sind, kannst Du im Abschnitt Produktstruktur nachlesen.

Master-Attribute

Wenn Du Attributgruppen neue einfache Attribute hinzufügen oder bestehende Attribute aktualisieren möchtest, kannst Du dies über den Import von "Master-Daten" tun.

SpalteBeschreibung
attribute_group_idDie ID der Attributgruppe, für die Änderungen vorgenommen werden sollen.
attribute_idIst das Feld leer, wird ein neues Attribut erzeugt. Bei vorhandener ID wird das bestehende Attribut aktualisiert.
attribute_nameDer Name des neuen Attributs oder der zu aktualisierenden Attributgruppe.

Master-Kategorien

Durch den Import von Master-Kategorien legst Du neue Kategorien an oder aktualisierst bereits vorhandene.

[note] In der Import-Datei müssen die Oberkategorien vor den Unterkategorien definiert werden, da es sonst zu Problemen mit der Zuordnung kommen kann. [/note]

SpalteBeschreibung
master_category_idFalls vorhanden, wird der Name oder die Position innerhalb des Strukturbaums aktualisiert.
master_category_nameName der neuen Kategorie
master_category_parent_pathPfad der Oberkategorie

Master-Attribut-Zuordnungen

Wenn Du Attribute einem oder mehreren Attributen anderer Attributgruppen zuordnen möchtest, kannst Du dies über den Import von Attribut-Zuordnungen tun. Alternativ kannst Du das Feld target_attribute_id leer lassen und für das Basis-Attribut Keine notwendige Zuordnung auswählen.

SpalteBeschreibung
base_attribute_idID des Quell-Attributs (Händler-Attribut)
target_attribute_ group_idID der Ziel-Attributgruppe (Master-Attribut)
target_attribute_idID des Ziel-Attributs, falls leer wird Keine notwendige Zuordnung ausgewählt
don´t recualculate mappingDurch die Einstellung "true" oder "false" in diesem
Feld wird festgelegt, ob die Zuordnung auf aktuelle Daten mit derselben Basisattribut-ID angewendet und mit der neuen Zuordnung synchronisiert werden soll (=false) oder nicht (=true). Wenn du für dieses Feld nichts ausfüllst, wird es automatisch auf "true" gesetzt. Das bedeutet, dass deine importierte Zuordnung keine Auswirkungen auf bestehende Entitäten mit der gleichen Basisattribut-ID hat

Import von vereinfachten Attributgruppen

Mit einem Import von vereinfachten erweiterten Attributen kannst du erweiterte Attribute mit einem einzelnen Feld des Typs Text, Langtext oder Nummer, zu einzelnen Produkte hinzufügen oder sie entfernen. Sie können sowohl global als auch Shop-spezifisch hinzugefügt werden.

Import von Shop-Kategorien

Durch den Import von Shop-Kategorien legst Du neue Kategorien an oder aktualisierst bereits vorhandene.

[note] Auch hier müssen in der Import-Datei die Oberkategorien vor den Unterkategorien definiert werden, da es sonst zu Problemen bei der Zuweisung kommen kann. [/note]

SpalteBeschreibung
application_idFalls vorhanden, wird der Name oder die Position innerhalb des Baums aktualisiert.
application_category_idFalls vorhanden, wird der Name oder die Position innerhalb des Baums aktualisiert.
application_category_nameName der Kategorie
parent_category_pathPfad der Oberkategorie
is_activeStellt eine Kategorie aktiv oder inaktiv.
is_visibleStellt eine Kategorie sichtbar oder unsichtbar.

[warn] Der Pfad der Kategorie darf nur Buchstaben, Ziffern und Bindestriche beinhalten. [/warn]

Erstellung neuer Shop-Kategorien

Um neue Shop-Kategorien über den Import-Bereich zu erstellen, legst Du eine XLSX-Datei im vordefinierten Format an. Die Spalte application_category_id ist beim Hinzufügen neuer Shop-Kategorien nicht zwangsläufig erforderlich. Kategorien ohne definierte application_category_id werden jedoch automatisch dem entsprechenden Parent Category Path, also dem übergeordneten Pfad zugeordnet.

Der vergebene Name wird als interner Key verwendet und kann im Gegensatz zum im Shop angezeigten Kategorienamen im Nachhinein nicht mehr verändert werden.

Falls eine gemeinsame Struktur verwendet wurde, können Status, Sichtbarkeit und Name für alle Anwendungen innerhalb der erstellten Struktur verwendet und nachträglich bearbeitet werden.

Aktualisierung von Shop-Kategorien

Beim Aktualisieren bestehender Shop-Kategorien über den Import-Bereich werden Name, Status und Sichtbarkeit einer Kategorie nur für den definierten Shop geändert. Der parent_category_path ist nicht zwangsläufig erforderlich, wenn du bestehende Shop-Kategorien aktualisieren möchtest. Ist in Deiner vordefinierten Tabelle die application_category_id angegeben, ist der parent_category_path optional und kann in der Tabelle auch mit einer 0 definiert werden. Nimmst Du Änderungen am parent_category_path vor, wird die betroffene Shop Kategorie samt aller Unterkategorien an eine neue, dem übergeordneten Pfad entsprechende Position bewegt.

Der Kategorie-Pfad oder Kategorie-Slug ergibt sich aus den ausgewählten Kategorienamen.

Status und Sichtbarkeit importierter Shop-Kategorien

Über den Import-Bereich kannst Du vor dem Aktualisieren mehrerer Shop-Kategorien die Sichtbarkeit und den Status in der XLSX-Datei definieren. Diese Funktion ermöglicht beispielsweise das Verbergen oder Verschieben bestimmter Kategorien.

In der Tabelle unten sind die verfügbaren Funktionen aufgeführt.

BefehlFunktion
AktivDie Kategorie und alle übergeordneten Kategorien werden sofort aktiviert.
InaktivDie Kategorie und alle untergeordneten Kategorien werden sofort deaktiviert. Die Shop-Kategorien sind damit im Online-Shop nicht mehr zugänglich.
SichtbarDie Kategorie wird sofort sichtbar und im Online-Shop angezeigt.
UnsichtbarDie Kategorie und alle untergeordneten Kategorien werden sofort unsichtbar und im Online-Shop ausgeblendet. Die Kategorie ist jedoch weiterhin über die URL erreichbar.
Kategorie verschiebenDie Kategorie und alle untergeordneten Kategorien werden sofort an die neue Position verschoben.

Datei-Import

Im ersten Schritt des Uploads musst Du zunächst eine Import-Option auswählen. Das folgende Beispiel zeigt die verfügbaren Optionen für den Import von Preisen.

Sobald Du eine Option ausgewählt hast, öffnet sich ein neues Fenster, in dem Du eine Datei hochladen kannst. Beachte bitte, dass die Struktur des Dokuments den Vorgaben des Systems folgen sollte, um Fehlermeldungen zu vermeiden.

Damit der Upload für den Import neuer Preise erfolgen kann, musst Du eine CSV-Datei im festgelegten Tabellenformat erstellen und die gewünschten Datensätze einpflegen. In dieser Datei müssen die Merkmale, die in der Vorlage ausgefüllt sind, ausnahmslos definiert werden. Nicht vollständig ausgefüllte Attribute sind optional (siehe Händlerpreise).

Nach dem Hochladen der Datensätze werden diese automatisch auf Korrektheit geprüft und Du wirst auf die anstehenden Preisveränderung hingewiesen.

Die Benachrichtigung des folgenden Beispiels zeigt, dass der Upload der Datei erfolgreich war.

[note] Für den Import von Kampagnen-Preisen muss der Modus noch vor der Validierung ausgewählt werden. [/note]

Klicke auf den Button Validieren und das System prüft, ob Format und Inhalt der hochgeladenen Datei den Anforderungen entsprechen, sodass die Daten verarbeitet werden können. Sollte die hochgeladene Datei Fehler enthalten, erhältst Du eine Fehlermeldung. Diese weist Dich darauf hin, wie die Datei korrigiert werden kann.

Sobald Du die Datei korrigiert hast, kannst Du sie erneut hochladen und validieren.

Ist die Datei fehlerfrei, wird Dir eine Validierungs-Zusammenfassung angezeigt. Kritische Änderungen musst Du noch einmal gesondert bestätigen.

Aus Sicherheitsgründen müssen die neuen Werte im Anschluss über das Vier-Augen-Prinzip von einem anderen Nutzer bestätigt werden.

Hierzu wird eine Anfrage via E-Mail an das von Dir ausgewählte Profil versendet, von dem die Preisänderungen final kontrolliert und bestätigt werden müssen.

Alternativ kann die Überprüfung auch direkt in SCAYLE erfolgen. Der angefragte Nutzer erhält eine Benachrichtigung zur Validierungsanfrage im SCAYLE Panel. Benachrichtigungen kannst Du über das Glocken-Symbol neben Deinem Profil ansehen.

Die angefragten Preisdaten-Importe können von dem entsprechenden Nutzer im folgenden Beispiel entweder validiert und damit bestätigt oder abgelehnt werden.

Als "zweite Instanz" bestätigst Du noch einmal den Import neuer Daten sowie das Risiko drastischer Preisveränderungen. Anschließend werden die importierten Daten freigeschaltet und der Import ist abgeschlossen.

Für Preis-Importe lässt sich nach der Bestätigung der Daten über den Validierungsbericht eine CSV-Datei mit den eigenen und den System-Preisen sowie der prozentualen Abweichung herunterladen.

Ein Klick auf den Button Import starten setzt den Import in Gang und leitet Dich auf die Import-Ãœbersichtsseite weiter.

Preisgenehmigungen

Für das Einstellen neuer Händler-Preise befolgst Du die vorhergehende Anleitung zum Datei-Import.

Um Händler-Preise zu überschreiben, müssen die neuen Werte im letzten Schritt zusätzlich über das Preisgenehmigungs-Tool festgelegt werden. Hierfür navigierst Du zu Operations > Preise > Preisgenehmigungen und klickst auf den Filter-Button.

Wähle den gewünschten Händler aus und lege dann den prozentual abweichenden Preisrahmen fest. Du hast hier die Option, nach allen verfügbaren Preisänderungs-Prozenten zu filtern.

Anschließend erhältst Du eine Zusammenfassung aller vorgenommenen Änderungen. Bestätige den Vorgang und die neuen Händler-Preise werden freigegeben.

Den Fortschritt neuer Preisgenehmigungen kannst Du über das Prozess-Symbol im Header oder unter Einstellungen > Imports & Jobs > Hintergrundjobs verfolgen.

Weitere Details zu Preisfreigaben erfährst Du in diesem Abschnitt.

Datei-Export

Exportierte Daten kannst Du in SCAYLE über Reports > Export > Exporte einsehen. Die Startseite zeigt einen Überblick aller Dateien, die in den verschiedenen Bereichen des Panels erstellt wurden und zum Download bereit stehen.

[note] Die erstellten Exporte werden nach 30 Tagen automatisch gelöscht. [/note]

Für jede Datei werden verschiedene Basis-Informationen angezeigt:

SpalteBeschreibung
NameName der Export-Datei
BereichBereich des Panels, in dem die Export-Datei erstellt wurde
BenutzerNutzer, der die Export-Datei erstellt hat
GestartetDatum, an dem der Export gestartet wurde
FertigDatum, an dem die Export-Datei erstellt wurde
StatusStatus der Export-Datei
DatenquelleBereich, aus dem der Export stammt, z.B. Produkte oder Kunden

Export-Dateien können in verschiedenen Bereichen des Panels erstellt werden, beispielsweise im Reports-Bereich oder über die Produktliste.

Erstellst du einen Export, leitet Dich das System automatisch zur Export-Übersichtsseite weiter, auf der die entsprechende Datei zum Download verfügbar ist.