Auf dieser Seite findest du häufig gestellte Fragen zur Shopware6-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.
Wenn in Xentral ein Freifelder-Mapping angelegt ist, wird versucht, bestehende Xentral Freifelder auf die customFields in Shopify bzw. Shopware zu mappen. Da diese customFields in Shopify bzw. Shopware bereits existieren und definiert sind, erwarten sie einen bestimmten value. Beispielsweise kann in Shopware ein customField als Integer definiert werden. 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.
Standardmäßig können folgende Xentral Freifelder in Shopware 6 Eigenschaften übertragen werden:
-
Lieferzeit: Die Lieferzeit wird übermittelt, wenn in Xentral als Freifeld „Lieferzeit“ gepflegt ist. Das System ermittelt automatisch die entsprechende ID des Lieferzeitwerts aus Shopware, wenn das Freifeld exakt mit „Lieferzeit“ bezeichnet ist.
-
Wiederauffüllzeit: Die Wiederauffüllzeit kann ebenfalls als Freifeld konfiguriert und standardmäßig an Shopware 6 übertragen werden, um den Produktbestand und Verfügbarkeitsinformationen im Shop zu aktualisieren.
Für Eigenschaften, die in Shopware 6 keine direkten Standardfelder besitzen, wird ein Customizing benötigt. Durch diese Anpassung können benutzerdefinierte Freifelder oder zusätzliche Produktattribute an Shopware übermittelt werden, die nicht im Standardumfang enthalten sind. Ein Beispiel für solche angepassten Eigenschaften sind spezielle Attribute oder Varianten. Eigenschaften wie „max_purchase“ oder spezielle Maßeinheiten, die Shopware 6 nicht als Standardfeld bietet, müssen über eine manuelle Anpassung durch ein Customizing eingebunden werden. Hierbei wird die Freifeld-ID manuell an die entsprechende ID in Shopware angepasst. 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.
Damit das Xentral‑Feld Lieferzeittext manuell (Artikel > Details > Online-Shop Optionen) an das Shopware 6 Feld Lieferzeit übertragen werden kann, muss der eingetragene Text in der Schreibweise exakt mit den in Shopware 6 verfügbaren Optionen übereinstimmen.
Alternativ kannst du die Lieferzeit in Shopware 6 auch über ein Xentral-Freifeld füllen. Verwende in diesem Fall als Freifeldbezeichnung "shopware6_delivery_time" oder "Lieferzeit".
Dies kann passieren, wenn der Shop-Server nicht genügend Rechte hat, um externe Bild-URLs zu öffnen. Mögliche Abhilfemaßnahmen:
-
Aktiviere in deinem Hosting die PHP-Einstellung allow_url_fopen (z. B. in php.ini oder über das Hosting-Panel). Frage bei Managed-Hosting ggf. beim Hoster an.
-
Deaktiviere temporär Proxy/CDN-Regeln (z. B. Cloudflare) oder setze die Xentral-IPs auf die Whitelist, damit die Verbindungen nicht blockiert werden.
Überprüfe außerdem:
-
dass bei den Artikeln in Xentral die richtigen Medien zugewiesen sind und
-
dass in der Connect-Schnittstelle > Workflows > Artikel der Schalter Bilder aktiviert und im Abschnitt Medien der richtige Medienordner ausgewählt ist.
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 häufigste Ursachen dafür ist ein falsches / fehlendes Mapping.
Grundsätzlich gibt es folgende Möglichkeiten bei den Verkaufspreisen:
-
Einzelner Standardpreis (ohne Staffel)
-
Standard-Staffelpreise
-
Gruppen-Staffelpreise
Einzelner Standardpreis (ohne Staffel)
Der Standardpreis wird (sofern keine Gültigkeit eingetragen ist) automatisch als Standardfeld an den Shop übertragen. Eine Zuordnung (Mapping) in den Workflows ist nicht erforderlich. Im Falle von mehreren Währungen ist jedoch eine Währungszuordnung in den Workflows nötig.
Standard-Staffelpreise
Wenn du in Xentral Standard-Staffelpreise anlegst, kannst du Werte bei Gültig ab und Gültig bis Datum eintragen. Damit die Übertragung an den Shop funktioniert, ist eine Zuordnung in den Workflows zwingend.
Aktiviere dazu in den Workflows > Preise die Schaltfläche "Erweiterte Preise importieren" und lege Preisregeln und die Kundengruppenzuordnung fest. Im Falle von Standardpreisen trage in der Spalte "Xentral" die Bezeichnung "Standardpreis" ein und ordne in der Spalte "Shopware 6" die passende Preisgruppe aus dem Shop zu.
Gruppen-Staffelpreise
Wenn du in Xentral Gruppen-Staffelpreise anlegst, z. B. für den Großhandel, kannst du Werte bei Gültig ab und Gültig bis Datum eintragen. Damit die Übertragung an den Shop funktioniert, ist eine Zuordnung in den Workflows zwingend.
Aktiviere dazu in den Workflows > Preise die Schaltfläche "Erweiterte Preise importieren" und lege Preisregeln und die Kundengruppenzuordnung fest. Trage in diesem Fall in der Spalte "Xentral" die Bezeichnung der Kundengruppe ein, die in der Preisstaffel gewählt wurde, und ordne in der Spalte "Shopware 6" die passende Preisgruppe aus dem Shop zu.
Anmerkung
Wenn in den Workflow-Konfigurationen eine Kundengruppe ausgewählt ist, werden nur die Preise dieser Kundengruppe übertragen. Ein Fallback auf den Standardpreis, sofern es keinen Kundengruppen-Preis für das jeweilige Produkt gibt, gibt es nicht. Dies kann jedoch als Customizing implementiert werden.
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.
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.
Dies kommt vor, wenn in den Artikelstammdaten keine Übersetzung angelegt ist. Um dieses Problem zu beheben, öffne den entsprechenden Artikel zum Bearbeiten, gehe zum Reiter Details > Unterreiter Texte und Beschreibungen. Füge eine geeignete Übersetzung im Feld Artikel (EN) ein:
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.
-
Migration einer Shopware6-Anbindung von Shopimporter zu Xentral Connect: So stellst du eine bestehende klassische Shopware-Schnittstelle (Shopimporter) in wenigen Schritten auf die neue Xentral Connect-Schnittstelle um.
-
Matrixprodukte und Varianten über Connect mit Shopware 6 synchronisieren: Die beste Vorgehensweise, um Matrixprodukte und ihre Varianten effizient an Shopware 6 zu übertragen und reibungslos abzugleichen.
-
Freifeldzuordnung mit Shopware 6: Hier lernst du die verschiedenen Optionen kennen, wie Freifelder an Shopware 6 übertragen werden können.
-
Artikelbaumkategorien mit Shopware 6 managen: Best Practices zum Synchronisieren von Artikelkategorien und zum Vorgehen bei Änderungen am Artikelbaum.
-
Erweiterte Preise mit Shopware 6 verwalten: Auf welche Arten du Preise zwischen Xentral und Shopware verknüpfen kannst erfährst du hier.