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.
FAQs
Tipp
Wenn du Informationen zu bestimmten Fehlermeldungen suchst, besuche doch mal unsere neue Übersichtsseite: Connect Fehlermeldungen und Abhilfe.
Freifelder
Ich habe Probleme bei der Anlage von Freifeldern und Eigenschaften aus Xentral zu Shopware 6, wie gehe ich hierzu am besten vor?
Ich habe Probleme bei der Anlage von Freifeldern und Eigenschaften aus Xentral zu Shopware 6, wie gehe ich hierzu am besten vor?
Es gibt Freifelder und Eigenschaften die an Shopware 6 übergeben werden können. Da es hier viele Einstellungsmöglichkeiten im Workflow gibt, haben wir zu diesem Thema einen eigenen Artikel im Handbuch sowie wie ein passendes Video. Artikel und Video findest du hier: Freifeldzuordnung mit Shopware 6
Warum wird das Feld "Lieferzeittext manuell" nicht von Xentral an Shopware 6 übertragen? Es erscheint keine Fehlermeldung, die Info kommt einfach nicht im Shop an.
Warum wird das Feld "Lieferzeittext manuell" nicht von Xentral an Shopware 6 übertragen? Es erscheint keine Fehlermeldung, die Info kommt einfach nicht im Shop an.
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".
Medien
Warum werden Medien nicht von Xentral zu Shopware übertragen? Artikelstammdaten, Bestand und Preise sind vorhanden, aber die Medien erscheinen nicht im Shop (kein Eintrag in ProductMedia / DB).
Warum werden Medien nicht von Xentral zu Shopware übertragen? Artikelstammdaten, Bestand und Preise sind vorhanden, aber die Medien erscheinen nicht im Shop (kein Eintrag in ProductMedia / DB).
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.
Artikelzuordnung
Ich habe einen alten Artikel über die Artikelzuordnung rausgefiltert, er wird aber nach wie vor im Shop / Marktplatz aufgeführt. Wie erreiche ich, dass alte Artikel aus dem Shop verschwinden?
Ich habe einen alten Artikel über die Artikelzuordnung rausgefiltert, er wird aber nach wie vor im Shop / Marktplatz aufgeführt. Wie erreiche ich, dass alte Artikel aus dem Shop verschwinden?
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.
Ich möchte zur Auswahl der Artikel eine Liste von Artikelnummern hinterlegen, aber der Filter funktioniert nicht.
Ich möchte zur Auswahl der Artikel eine Liste von Artikelnummern hinterlegen, aber der Filter funktioniert nicht.
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.
Ich möchte die Variante eines Matrixproduktes nicht mehr im Shop anbieten. Wie gehe ich bei der Entfernung korrekt vor?
Ich möchte die Variante eines Matrixproduktes nicht mehr im Shop anbieten. Wie gehe ich bei der Entfernung korrekt vor?
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.
Bestände
Preise und Steuern
Woran liegt es, dass Preise nicht an den Shop übertragen werden? Antwort am Beispiel Shopware 6
Woran liegt es, dass Preise nicht an den Shop übertragen werden? Antwort am Beispiel Shopware 6
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.
Auftragsimport
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
Was passiert mit einem Auftrag, der einen Artikel enthält, der nicht in Xentral angelegt ist?
Was passiert mit einem Auftrag, der einen Artikel enthält, der nicht in Xentral angelegt ist?
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.
Wie kann ich einen Auftrag manuell importieren?
Wie kann ich einen Auftrag manuell importieren?
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?
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.
Belegausgabe
Auf unseren englischsprachigen Belegen fehlen Informationen, z. B. die Bezeichnung von Portoartikel oder Rabatt.
Auf unseren englischsprachigen Belegen fehlen Informationen, z. B. die Bezeichnung von Portoartikel oder Rabatt.
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:
Initialer Datenimport
Warum haben einige der importierten Artikel das Stichwort “Container“ in der Artikelnummer?
Warum haben einige der importierten Artikel das Stichwort “Container“ in der Artikelnummer?
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.
Warum fehlen in Xentral Container-Artikel?
Warum fehlen in Xentral Container-Artikel?
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.
Connect vs. Classic Schnittstelle
Wie muss ich den Prozessstarter für Connect einrichten?
Wie muss ich den Prozessstarter für Connect einrichten?
Der Prozessstarter ist für die modernen Xentral Connect Schnittstellen nicht mehr erforderlich. Du musst hier keine spezifischen Einstellungen für Connect vornehmen.
Grundsätzliche technische Fragen
Ich habe die Features in den Workflows auf Aktiv geschaltet, die Schnittstelle scheint aber Daten nicht automatisiert auszutauschen. Was kann der Grund sein?
Ich habe die Features in den Workflows auf Aktiv geschaltet, die Schnittstelle scheint aber Daten nicht automatisiert auszutauschen. Was kann der Grund sein?
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.
Woher stammt die UUID für die Artikelzuordnung?
Woher stammt die UUID für die Artikelzuordnung?
Wenn du eine klassische Shop-Schnittstelle (Shopimporter) in die neue Xentral Connect-Schnittstelle migrierst und im ÜbernahmewizardArtikelzuordnung 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.
Woran kann es liegen, dass die Deaktivierung der alten Schnittstelle nicht gespeichert wurde?
Woran kann es liegen, dass die Deaktivierung der alten Schnittstelle nicht gespeichert wurde?
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.
Best Practices im Umgang mit Shopware6
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.