Anmerkung
Die hier beschriebene Funktion ist ausschließlich für Kunden relevant, die derzeit eine klassische Shop-Anbindung nutzen und auf die Xentral Connect Schnittstelle umstellen möchten.
In dieser Anleitung erfährst du, wie du in wenigen Schritten eine bestehende klassische Shop-Schnittstelle (Shopimporter) in die neue Xentral Connect-Schnittstelle migrieren kannst. Die Übernahme der Einstellungen aus der alten Schnittstelle in die Connect-Schnittstelle durchläuft folgende Schritte, die wir in den nächsten Abschnitten im Detail erläutern:
-
Alten Shopimporter deaktivieren
Warnung
Stelle sicher, dass du den Livemodus der alten Shop-Anbindung deaktivierst, bevor du die Connect-Schnittstelle live schaltest, um Konflikte und doppelte Auftragsimporte zu vermeiden!
Die alte Shop-Integration muss weiterhin im System verbleiben und darf nicht gelöscht werden!
Um eine reibungslose Übernahme und Funktionalität der Schnittstelle zu gewährleisten, ist es wichtig, zunächst einige allgemeine Einstellungen in Xentral durchzuführen. Beachte dazu diesen Handbuchabschnitt. Prüfe deine Einstellungen insbesondere dann, wenn deine bisherige Shop-Schnittstelle individuell angepasst war, z. B. über Smarty.
Die Connect-Schnittstelle bietet eine hohe Standardisierung, was die Wartbarkeit und die Upgradefähigkeit deines Systems erhöht. Viele Funktionen, die in der klassischen Schnittstelle nur über einer individuelle Anpassung möglich waren, sind in Connect im Standard bereits enthalten. Bei der Übernahme einer individuell angepassten klassischen Schnittstelle musst du die Einstellungen jedoch sorgsam vornehmen und auf das korrekte Verknüpfen von Datenfeldern (sog. Mapping) achten. Nimm im Zweifel vorher Kontakt zu deinem Solution Consultant auf.
Anmerkung
Dieser Schritt ist nur für die erste Anbindung eines Shops erforderlich und entfällt bei weiteren Integrationen desselben Shop-Anbieters.
Anmerkung
Wir schalten die Funktion schrittweise frei, um eine maximale Stabilität und die reibungslose Migration zu gewährleisten. Du bekommst von uns aktiv in der Software Bescheid, sobald die Xentral Connect-Schnittstelle für Dich zur Verfügung steht. Möchtest du vorzeitig Zugriff haben, wende dich gerne an deinen Solution Consultant.
-
Klicke in deinem Xentral auf das Zahnrädchen oben rechts, um zu den Systemeinstellungen zu gelangen:
-
Folge dem Menüpfad Einstellungen > Verkaufen > Shopware6:
-
Klicke jetzt auf Install App um das System vorzubereiten (hier als Beispiel: WooCommerce Connector):
Sobald die Connect-Schnittstelle angelegt wurde, kannst du mit dem Übernahmewizard fortfahren.
-
Klicke auf Integration übernehmen, um den Wizard zu starten:
-
Wähle die bestehende Shop-Anbindung, aus der du die Einstellungen zu Xentral Connect übernehmen möchtest und klicke auf Weiter.
-
Wähle die Art der Artikelzuordnung. Du kannst…
-
… die Artikelzuordnung von deiner bestehenden Anbindung übernehmen oder
-
… eine neue Artikelzuordnung anhand selbst gewählter Kriterien einrichten. Wenn du diese Option wählst, kannst du die Filterkriterien für die Artikelzuordnung nach Abschluss des Wizards eintragen.
-
-
Belasse den Schalter Bilderübertragung auf links, wenn Bilder aus dem Onlineshop weiter verwendet werden sollen. Du kannst die Synchronisierung von Bilddateien zwischen Xentral und Shop später in den Workflows aktivieren. (Nur falls du sichergestellt hast, dass die Artikelbilder in Xentral vollständig und aktuell sind, kannst du den Schalter nach rechts setzen. In diesem Fall werden alle im Shop vorhandenen Bilder von den Bildern in Xentral ersetzt.)
Warnung
Belasse den Schalter “Bilderübertragung” auf links, wenn Bilder aus dem Onlineshop weiter verwendet werden sollen. Wenn du den Schalter nach rechts setzt und Bilder in Xentral unvollständig und/oder veraltet sind, droht Datenverlust! Dies schließt z. B. auch SEO-Informationen ein, sofern sie in den Xentral-Bildern nicht enthalten sind. Im Shop vorhandene Bilder werden bei aktivierter Schaltfläche von Xentral überschrieben. Orientiere dich am besten an der bisherigen Bildquelle: Kommen die Bilder bisher auch oder ausschließlich aus dem Shop, lasse die Schaltfläche deaktiviert.
-
Bestätige die Übernahme der Schnittstellen-Konfiguration und beachte die Hinweise:
-
Die Integration wird angelegt:
-
Nach Abschluss erhälst du eine Erfolgsmeldung:
Bevor du die Liveschaltung aktivierst, solltest du alle übernommenen Einstellungen gründlich überprüfen. Dazu gehören die Artikelzuordnung und die Workflow-Konfiguration.
Um die Artikelzuordnung zu prüfen oder neu anzulegen, klicke auf diese Schaltfläche:
Anmerkung
Dieser Abschnitt ist relevant, falls du im Wizard Artikelzuordnung aus der bestehenden Integration übernehmen gewählt hast.
Die vorhandene Zuordnung ist hier bereits eingetragen. Stelle sicher, dass die gefundene Anzahl der Artikel korrekt ist. Falls sie nicht deinen Erwartungen entspricht, überprüfe die Online-Shop Optionen in den Artikeln oder lege deine Artikelzuordnung neu an, wie im nächsten Abschnitt beschrieben.
Anmerkung
Dieser Abschnitt ist relevant, falls du im Wizard Artikel anhand einer definierten Regel (z. B. Projekt, Freifeld etc. zuordnen gewählt hast oder dich später entscheidest, eine neue Artikelzuordnung zu definieren.
Richte dir die Filterkriterien nach deinem Bedarf ein. Schaue dir dazu den Handbuchabschnitt Artikel zuordnen an.
Um die Workflows zu prüfen oder anzupassen, klicke auf diese Schaltfläche:
Überprüfe in allen Reitern, ob die übernommenen Einstellungen deiner Erwartung entsprechen, falls nicht, nehme Änderungen vor und speichere sie. Eine detaillierte Anleitung zu den Workflows findest du unter diesem Link: Shopware6: Workflows konfigurieren
Falls du die Bilderübertragung beim Übernahmewizard deaktiviert hattest und Bilder zwischen Xentral und Shop synchronisieren möchtest, aktiviere die entsprechende Schaltfläche. Du findest sie in den Workflows > Reiter Artikel > Datentypen:
Mit Hilfe des Journals kannst du einzelne Testdaten anstoßen und deren korrekte Übertragung testen. Um zum Journal zu gelangen, klicke auf diese Schaltfläche:
Stoße für jeden Datentyp, den du nutzen möchtest - also z. B. Artikel und Aufträge - einzelne Datensätze zur Synchronisierung an, indem du beispielsweise bei einem Artikel auf Artikel synchronisieren oder bei den Aufträgen auf Workflow starten klickst und eine Auftragsnummer eingibst. Anschließend aktualisierst du den Status durch die Neu laden-Schaltfläche und prüfst, ob die Datenübertragung funktioniert. Falls nicht, orientiere dich an den Fehlerhinweisen im Journal und nimm Korrekturen vor. Nähere Informationen zur Nutzung des Journals findest du unter diesem Link: Shopware6: Journal
Die Schnittstelle synchronisiert nach der Produktiv-Schaltung - je nach Feature Artikel, Bestände, Preise, Aufträge und Auftragsstatus - automatisch zwischen Xentral und deinem Shop. Der Prozessstarter ist dafür nicht mehr erforderlich.
Nachdem du alle Einstellungen erfolgreich geprüft hast, ist deine neue Xentral Connect Schnittstelle grundsätzlich bereit zur Liveschaltung.
Warnung
Stelle sicher, dass du den Livemodus der alten Shop-Anbindung deaktivierst, bevor du die Connect-Schnittstelle live schaltest, um Konflikte und doppelte Auftragsimporte zu vermeiden!
Die alte Shop-Integration muss weiterhin im System verbleiben und darf nicht gelöscht werden!
Um die alte Shop-Anbindung zu deaktivieren, führe folgendes aus:
-
Navigiere zur Übersicht der Shops & Marktplätze: Systemeinstellungen (Zahnrädchen) > Verkaufen > Shops & Marktplätze Übersicht. Öffne die zu deaktivierende Schnittstelle (hier am Beispiel Shopify):
-
Entferne den Haken Aktiv, entferne die Einträge in den Feldern URL, API-Key, Passwort, Token und klicke unten auf der Seite auf Speichern:
-
Stelle in der Übersicht sicher, dass die alte Schnittstelle deaktiviert ist:
Mehr Informationen zur Xentral Connect-Schnittstelle und ihrer Konfiguration, findest du in den Handbuch-Artikel des Shop-Systems. Hier ist auch beschrieben, wie du die Schnittstelle vor der Produktiv-Schaltung testen kannst:
Warnung
Stelle sicher, dass die alte Schnittstelle wie im vorherigen Abschnitt beschrieben deaktiviert ist, bevor du die Connect-Schnittstelle produktiv schaltest, um Konflikte und doppelte Auftragsimporte zu vermeiden!
Die alte Shop-Integration muss jedoch weiterhin im System verbleiben und darf nicht gelöscht werden!
Nach Überprüfung der Konfiguration kannst du den Produktiv-Modus aktivieren. Wie du dabei vorgehst, erfährst du hier: Shopware6-Connector: Produktiv schalten