Auf dieser Seite findest du häufig gestellte Fragen zur Shopify-Schnittstelle und unsere Wissensbasis basierend auf der Praxiserfahrung aus zahlreichen Kundenszenarien in den vergangenen Monaten.
Tipp
Wenn du Informationen zu bestimmten Fehlermeldungen suchst, besuche doch mal unsere neue Übersichtsseite: Connect Fehlermeldungen und Abhilfe.
Möglicherweise stimmt die Datenstruktur der Artikel in Shop und Xentral nicht überein. Während ein Artikel in Xentral als Matrixprodukt angelegt ist, ist dieselbe Artikelnummer in Shopify als Variante konfiguriert. Stelle sicher, dass du in beiden Systemen mit derselben Datenstruktur arbeitest. Mehr Informationen zu Matrixprodukten und Artikelvarianten erhälst du auf dieser Hilfeseite: Matrixprodukt: Artikelvarianten erstellen
Besuche zu diesem Thema auch die Artikel in der Prozesswissen-Rubrik:
Ursache: Optionsnamen oder Optionswerte in Xentral stimmen nicht exakt mit den in Shopify vorhandenen Optionen/Values überein. Dadurch können fehlerhafte Varianten ohne SKU entstehen.
Abhilfemaßnahme: Überprüfe die betroffenen Artikel in Xentral: Stimmen die Optionsnamen (z. B. "Farbe") und die Optionswerte (z. B. "grün") in Xentral und im Zielsystem exakt überein? Achte auch auf führende oder nachfolgende Leerzeichen sowie Groß-/Kleinschreibung. Korrigiere die Benennungen gegebenenfalls.
Beachte, dass bei einer Neuanlage von Matrixprodukten eine bestimmte Reihenfolge eingehalten werden muss: Matrixprodukte und Varianten über Connect mit Shopify synchronisieren
Ursache: Optionsnamen oder Optionswerte in Xentral stimmen nicht exakt mit den in Shopify vorhandenen Optionen/Values überein. Dadurch kann der API-Aufruf fehlschlagen.
Abhilfemaßnahme: Überprüfe die betroffenen Artikel in Xentral: Stimmen die Optionsnamen (z. B. "Farbe") und die Optionswerte (z. B. "grün") in Xentral und im Zielsystem exakt überein? Achte auch auf führende oder nachfolgende Leerzeichen sowie Groß-/Kleinschreibung. Korrigiere die Benennungen gegebenenfalls.
Xentral gilt bei der Artikelsynchronisation als führendes System. Setzt du einen Artikel in Xentral auf „inaktiv“ ohne weitere Einstellungen vorzunehmen, wird er automatisch in Shopify auf "Entwurf" gestellt, um zu verhindern, dass bereits archivierte Artikel wieder synchronisiert werden. Um einen solchen Effekt zu vermeiden, hast du diese Möglichkeiten:
-
Artikel aus der Synchronisation entfernen (empfohlen):
-
Navigiere zu Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname]. Öffne dort die Artikelzuordnung.
-
Stelle sicher, dass die Schnittstelle so eingestellt ist, dass nur Artikel mit der Onlineshop-Verknüpfung deines Shops synchronisiert werden (z. B. Filter: Onlineshop-UUID = [deine Shop‑ID]).
-
Entferne die Shop-Verknüpfung bei den betroffenen Artikeln in Xentral unter Artikel > Details > Onlineshop Optionen.
-
-
Artikel sperren:
-
Markiere betroffene Artikel als "gesperrt".
-
Navigiere zu Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname].
-
Öffne dort die Artikelzuordnung. Nimm ein Filterkriterium auf, das gesperrte Artikel ausschließt (z. B. „Gesperrt == false“) und speichere.
-
Wenn in Xentral ein Freifelder-Mapping angelegt ist, wird versucht, bestehende Xentral Freifelder auf die customFields in Shopify zu mappen. Da diese customFields in Shopify bereits existieren und definiert sind, erwarten sie einen bestimmten value. Schicken wir von Xentral einen String an genau dieses customField, schlägt der Call mit einem invalid value Fehler fehl. Bitte überprüfe bei solchen Feldern also zunächst die CustomField Definition im Shop sowie den customField value des Artikels, bei dem die Übertragung fehlschlägt.
Stelle sicher, dass die Feldtypen in Xentral und Shopify übereinstimmen (z. B. Textfeld zu Textfeld). Bei Variantenartikeln muss die Übertragung immer über den Matrix-Parent erfolgen, auch wenn dieser in Shopify nicht aktiv genutzt wird. Beachte, dass Shopify bei fehlerhafter Übertragung eines Feldes den gesamten API-Call für den Artikel abbricht. Verknüpfe die Felder in Xentral auf typengleiche Metafields in Shopify.
Der Filter in der Artikelzuordnung hat nur Einfluss auf die Aktualisierung der Daten. Entfernst du also einen Artikel aus dem Filter, bleibt dieser Artikel zwar im Shop / Marktplatz aufgeführt, erhält aber keine aktuellen Daten mehr aus Xentral.
Wenn du einen Artikel aus dem Shop entfernen möchtest, navigiere zum Artikelstamm, öffne den Reiter Details > Online-Shop Optionen, setze den Haken bei Artikel inaktiv und bestätige auf Speichern.
Weitere Informationen zum korrekten Entfernen eines Artikels aus dem Shop / Marktplatz, findest du in diesem Artikel: Artikel aus dem Angebot des Shops/Marktplatzes entfernen.
Tipp
Wir empfehlen generell, keine Daten zu löschen, sondern die Sperrfunktion zu nutzen, um keine inkonsistenten Daten in der Datenbank zu erzeugen.
Um eine Liste von Artikelnummern zu hinterlegen, wähle im Artikelfilter das Feld “Artikel Nr.”. Wähle anschließend als Operator “IN”. Um als Wert eine Liste von Nummern hinterlegen zu können, musst du am Ende der Filterzeile den Feldtyp von “Text” auf “Array” umstellen. Hinterlege die einzelnen Nummern außerdem kommagetrennt.
Um eine Variante aus deinem Shop-Angebot zu entfernen, gehe bei der Variante in den Artikelstamm und aktiviere die Option Sperre aktiv.
Anmerkung
Behalte die Einstellungen im Artikelstamm im Abschnitt Varianten unbedingt bei. Ein Entfernen der Zuordnung zum Matrixprodukt führt zu einer veränderten Artikelstruktur, die zu inkonsistenten Daten führen kann. Wir empfehlen generell, keine Daten zu löschen, sondern die Sperrfunktion zu nutzen.
Die Information, wie viel Bestand eines Produktes reserviert ist (durch offene Aufträge oder durch Reservierungen) gibt es in Xentral nur auf Produktebene, nicht auf Lagerebene.
Ein Beispiel:
{
"stock": {
"physical": 6,
"pseudoStock": null,
"reservedByOrder": 2,
"stockAdjustment": 0,
"reservedByReservation": 0
},
"productId": "3605",
"locationStock": [
{
"location": {
"id": "1"
},
"physical": 1
},
{
"location": {
"id": "2"
},
"physical": 3
},
{
"location": {
"id": "3"
},
"physical": 2
}
]
}
}
Wenn die drei Xentral Lager mit drei unterschiedlichen Shopify Lagern verknüpft sind, wird der Bestand von allen drei Shopify Lagern abgezogen, um Überkäufe zu vermeiden. Wenn die drei Xentral Lager mit einem Shopify Lager verknüpft sind, wird der reservierte Bestand nur einmal von dem verknüpften Shopify Lager abgezogen.
Regionsspezifische Steuersätze innerhalb eines Landes können im Xentral-Standard nicht unmittelbar konfiguriert werden. Nutze die Lieferschwelle für das Hauptland (z. B. Frankreich), um die korrekten Steuersätze zu erzwingen und aktiviere die Option "Netto Preise anpassen", um falsche Shop-Steuersätze beim Import zu überschreiben. Für echte regionale Sonderfälle ist entweder eine manuelle Anpassung der Belege oder eine technische Anpassung (z. B. über Connect Customizing oder einen Xentral-Partner) im Importprozess notwendig, um Bestellungen aus der Sonderregion zu erkennen und entsprechend zu besteuern. Wende dich in einem solchen Fall gerne an deinen Solution Consultant. Er unterstützt sich bei der kundenindividuellen Beratung und Anpassung oder kann dich an einen geeigneten Partner vermitteln.
Tipp
Du kannst dich aktiv über den Auftragsimport-Status per e-Mail benachrichtigen lassen. Richte einfach über die Systemstatus-Seite > Alarms verwalten > Alarm erstellen ein Abo ein. Du kannst deine Schnittstelle(n) und die Häufigkeit der Benachrichtigung wählen und festlegen, ob eine Benachrichtigung bei Warnung und/oder im Fehlerfall erfolgen soll. Mehr Infos zum Systemstatus findest du unter Systemstatus
Grundsätzlich solltest du sicherstellen, dass Artikel, die über deinen Shop bestellt werden können, vorher in Xentral angelegt sind. Aufträge, die mindestens einen Artikel enthalten, der nicht in Xentral angelegt ist, werden nicht importiert und erzeugen eine Fehlermeldung im Journal. Sollte es in Eurem Fall nicht immer möglich sein, dass Artikel angelegt sind, bevor sie über den Shop verkauft werden, so überprüft regelmäßig das Auftragsjournal. Legt im Fehlerfall den Artikel in Xentral an und stoßt den Auftragsimport anschließend manuell über das Journal an.
Die Fehlermeldung besagt, dass es mindestens einen Artikel aus der Bestellung noch nicht in Xentral gibt. Sorge dafür, dass alle Artikel in Xentral angelegt sind, bevor Auftragsdaten von Shopify zu Xentral importiert werden.
Beachte, dass Auftragsdaten in Shopify nicht nachträglich geändert werden können. Idealerweise legst du die fehlenden Artikel in Xentral an, stornierst die Bestellung in Shopify und legst sie dann mit den vollständigen Daten neu an. Alternativ lässt du die Bestellung in Shopify bestehen und legst den Auftrag in Xentral manuell an. In diesem Fall erfolgt jedoch keine Synchronisation des Auftragsstatus.
Wenn du einen Auftrag manuell importieren möchtest, z. B. weil der automatische Import vorher fehlgeschlagen war, gehe wie folgt vor:
-
Navigiere zu Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname].
-
Öffne das Journal und wechsele dort in den Reiter Aufträge.
-
Suche die betroffene Auftragsnummer und klicke in der Zeile rechts auf den Pfeil (Erneut Ausführen).
Anmerkung
Wenn deine Connect-Schnittstelle Produktiv geschaltet ist, erfolgt der Auftragsimport grundsätzlich automatisch. Den manuellen Import benötigst du nur nach Korrekturen, oder wenn sich deine Schnittstelle noch im Entwicklungsmodus befindet.
Wie kann ich Versandarten in Xentral basierend auf dem Lieferland des Auftrags automatisch zuordnen, insbesondere im Zusammenhang mit dem [ADDRESS] Connector und der neuen DHL-Integration, bei der für jedes DHL-Produkt eine eigene Versandart angelegt werden muss? Gibt es eine Möglichkeit, die Versandart automatisch basierend auf dem Lieferland zu ändern, ohne dies manuell für jeden Auftrag tun zu müssen?
Verwende Versandregeln, um Aufträge nach bestimmten Kriterien wie Versandart, Projekt, Lieferland und Shop zu filtern. Definiere eine Regel, die automatisch das zugewiesene Versandprofil nach dem Auftragsimport ändert, basierend auf dem Lieferland. So kann beispielsweise Aufträgen mit dem Lieferland 'Argentinien' und der Versandart 'DHL_8' automatisch die Versandart 'dhl_6' zugewiesen werden.
Unter “Container” werden die Eltern-Artikel, also das Matrixprodukt verstanden, dem Varianten als Kind-Artikel zugeordnet sind. Container tragen also die Information zu den Variantenstrukturen und die Zuordnung Eltern-Kind. Ihre Anlage erfolgt automatisch und ihr Auftauchen ist ein positives Signal dafür, dass die Varianten korrekt abgeholt wurden.
Während im Shop Produkte als Container-Artikel konfiguriert sind, sind in Xentral keine Matrixprodukte eingerichtet. Stelle sicher, dass du in beiden Systemen mit derselben Datenstruktur arbeitest. Mehr Informationen zu Matrixprodukten und Artikelvarianten erhälst du auf dieser Hilfeseite: Matrixprodukt: Artikelvarianten erstellen.
Die Produktiv-Schaltung bei Connect erfolgt zweistufig, um sicherzustellen, dass alle Workflows getestet wurden und nicht aus Versehen produktiv geschaltet werden.
Schritt 1: Nachdem du die Workflows konfiguriert und getestet hast, setzt du zunächst den Integrationsmodus der gewünschten Features in den Workflows auf Aktiv.
Schritt 2: Anschließend startest du den Produktivmodus der Schnittstelle in den Einstellungen.
Wenn du eine klassische Shop-Schnittstelle (Shopimporter) in die neue Xentral Connect-Schnittstelle migrierst und im Übernahmewizard Artikelzuordnung aus der bestehenden Integration übernehmen wählst, wird die vorhandene Filterung automatisch in Connect übernommen. Als Filterkriterium steht in der Connect Artikelzuordnung in diesem Fall die Online-Shop UUID der alten Schnittstelle. Eine Anpassung ist i. d. R. nicht erforderlich. Prüfe einfach, 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.
Das kann verschiedene Ursachen haben. In den meisten Fällen liegt es an einem lokalen Problem wie einem zwischengespeicherten Browser-Fehler, einer Störung durch den Browser-Cache oder aktiven Plug-Ins/Adblockern.
Probiere folgende Maßnahmen:
-
Nutze einen unterstützten Browser, z. B. Google Chrome.
-
Stelle sicher, dass du als Admin in Xentral eingeloggt bist. Für die Installation, die Einrichtung und die Administration der Schnittstelle sind Admin-Rechte erforderlich.
-
Lade die Seite neu.
-
Leere den Browser-Cache.
-
Arbeite in einem Inkognito-Fenster.
-
Deaktive eventuelle Plug-Ins oder Adblocker vorübergehend.
-
Matrixprodukte und Varianten über Connect mit Shopify synchronisieren: Die beste Vorgehensweise, um Matrixprodukte und ihre Varianten effizient an Shopify zu übertragen und reibungslos abzugleichen.
-
Mit abweichenden Artikelnummern in Shop Marktplatz und Xentral arbeiten: Wie du in Xentral Connect mit Artikeln arbeitest, deren Artikelnummern in Xentral sich von denen in deinem angebundenen Shopsystem unterscheiden.
-
Artikel aus dem Angebot des Shops entfernen: Best Practices zum Entfernen eines Produktes aus dem Shop