Skip to main content

Hallo Community! 

Ab sofort habt ihr die Möglichkeit, die neue Xentral Connect Integration für Shopware 6 zu nutzen und so die bisherige Shopware-Integration abzulösen. 

 

Zeitplanung

Bitte beachte, dass wir die bisher von euch genutzte “alte” Shopware 6 Schnittstelle zum 15.02.2025 in den Status "Deprecated" überführen werden. Das bedeutet für euch: Ab diesem Datum leisten wir für dieses Modul nur noch eingeschränkten Support in dringenden Fällen.

Das endgültige “End-of-life” der bisherigen Shopware 6 Schnittstelle wird voraussichtlich zum 15.05.2025 erreicht werden. Ab diesem Datum werden wir keinen Support mehr für die bisherige Lösung leisten. 

Wir empfehlen daher, rechtzeitig die Migration von der bisherigen Shopware 6 Schnittstelle auf die neue Connect-Technologie durchzuführen. 

Lest euch daher bitte die folgenden Informationen aufmerksam durch, damit die Migration auf die neue Technologie für euch so schnell und einfach wie möglich verläuft:

 

Die neue Shopware 6 Schnittstelle

Auf Basis unserer neuen Integrations-Middleware Xentral Connect haben wir unsere Shopware-Schnittstelle komplett überarbeitet. Die neue Schnittstelle bietet euch neben einer deutlich verbesserten Usability, höherer Performance und optimierter Stabilität viele neue und verbesserte Funktionen:

  • Optimierter Export von Orderstatus und Trackinginformationen
  • Export von Statusänderungen bei Storno
  • Regelbasierte Artikelzuordnung
  • Import-/Export-Journal

Zusätzliche Informationen zur Anbindung findet ihr auf unseren Hilfeseiten:

In der linken Menüstruktur unseres Helpcenter findet ihr ebenfalls weitere Hilfeseiten rund um das Thema Xentral Connect.

 

Nächster Schritt: Self-Migration

In eurer jeweiligen Xentral Instanz haben wir den Shopware 6 Connector bereits für euch freigeschaltet. Dieser bietet euch mit dem Migrations-Wizard eine einfache Möglichkeit, um eure bestehende Integration mit wenigen Klicks zu Xentral Connect zu überführen.

Ein Video zur Benutzung des Wizards findet ihr hier:

 

Zur weiteren Unterstützung haben wir weitere Videos zu den verschiedenen Workflows, zum Journal und der Artikelzuordnung des Connectors für euch erstellt:

FAQ

Wie kann ich den Bestellimport problemlos testen?

  1. Deaktiviere vorübergehend den alten Shop-Importer (Details dazu findest du auf der Hilfeseite zur Migration).
  2. Erstelle eine oder mehrere Testbestellungen in deinem Shop.
  3. Hole diese manuell über das Journal des neuen Connect Shops ab.
  4. Aktiviere danach den alten Importer wieder.

Beide Importe prüfen beim Import auf bereits existierende Bestellungen, daher sollten die Testbestellungen nach der Aktivierung des alten Importers nicht erneut in Xentral importiert werden!

Kann ich meine bestehende Schnittstelle nun nicht mehr nutzen?
Bis zum 15.02.2025 kannst du deine bestehende Shopware 6 Schnittstelle ohne Einschränkungen und mit vollem Support nutzen. So kannst du die Migration zu Connect problemlos erst nach der anstehenden Black Week oder dem Weihnachtsgeschäft durchführen.

Wie kann ich mit der neuen Schnittstelle Artikel meinem Onlineshop zuordnen?
Im Rahmen der Migration wird die bestehende Artikelzuordnung pro Verkaufskanal automatisch übernommen. Allerdings bietet die neue Artikelzuordnung eine Reihe zusätzlicher Möglichkeiten. Sieh dir dazu das folgende Video an: Video Artikelzuordnung

Kann ich meine Smarty Scripte weiter nutzen?
Die bisherigen, auf Smarty basierenden, individuellen Anpassungen sind mit der neuen Connect-Technologie nicht mehr kompatibel. Dies gilt in Einzelfällen auch für implementierten Custom Code. Stattdessen bietet Connect eine No-Code-basierte Oberfläche, mit der unsere Standardschnittstellen flexibel angepasst werden können (sogenannte Customizings). Bitte beachte, dass viele Smarty Scripte mit der neuen Technologie überflüssig werden, da die enthaltenen Workarounds durch die neue Lösung schon im Standard abgedeckt werden. Wenn du unsicher bist, ob du auch weiterhin eine individuelle Anpassung deiner Schnittstelle benötigst, wende dich an deinen Implementierungspartner oder das Xentral Consulting Team.

Was kostet die neue Schnittstelle?
Die neue Shopware 6 Schnittstelle ist bereits in deinem gebuchten Plan enthalten und verursacht keine zusätzlichen Kosten. Solltest du jedoch für die Migration oder die Erstellung von Customizings Unterstützung durch unsere Xentral Consultants in Anspruch nehmen, können – abhängig von deinem gebuchten Plan – zusätzliche Kosten entstehen. Hierüber informieren wir dich selbstverständlich im Vorfeld.

Ich kann die Migration nicht selbst durchführen. Wer kann mir helfen?
Wenn du Hilfe bei der Migration zu Connect brauchst, kontaktiere uns einfach über unser Ticketsystem. Wähle als Kontaktgrund → Support → Produktfrage → Shops & Marktplätze und teile uns mit, dass du Unterstützung bei der Migration benötigst. Deine Anfrage wird dann automatisch an unser Consulting-Team weitergeleitet, das alle weiteren Schritte mit dir abstimmen wird.

Bitte beachte: Je nach Aufwand können in diesem Prozess zusätzliche Kosten entstehen, falls der individuelle Aufwand den in deinem Paket enthaltenen Consulting-Aufwand übersteigt.

Ist die Connect mit allen neuen Unterversionen von Shopware 6 kompatibel?

Ja, Connect ist mit allen neuen Unterversionen von Shopware 6 kompatibel.

 

Solltet ihr Fragen zum Ablauf haben oder Probleme auftreten, stehen wir euch jederzeit gerne zur Verfügung!


 

Hallo Dennis,

irgendwie verstehe ich das gerade alles nicht. Einerseits sollen alle Kunden schnellstmöglich auf den neuen Connector wechseln, andererseits gibt es nur wenig Dokumentation und Möglichkeiten Fehlverhalten nachzuvollziehen (keine Logs etc, die es vorher noch gab). Ich habe drei unterschiedliche Probleme (Synchronisation der EURO-Preise, Übertragen der zweiten Währung, Übertragen der Stammdaten aus dem Auftrag) und keins der Tickets wird bearbeitet. Seid ihr wirklich sicher, dass ihr uns so schnell auf den neuen Conncector wollt? Ich stehe zumindest jetzt kurz davor noch den alten einzuführen, weil nach meinem “Gefühl” der neue Connector noch gar nicht die notwendige Reife hat und sich meine m.E. sehr einfachen Herausforderungen, nicht damit umsetzen lassen hat.

Und jetzt spreche ich ja noch nicht von Integrationen, die vorher auch nur über Smarty etc. möglich waren.

Viele Grüße

TUGE


Hallo ​@tuge !

Erstmal danke für dein Feedback!
Die Connect Anbindung ist an sich funktionsfertig entwickelt und steht auch als solche zur Verfügung.
Die Umsetzung von Anpassungen, die vorher über Smarty möglich waren, müssen jetzt in der Tat leider anders umgesetzt werden und es nachvollziehbar, dass das nicht die angenehmste Änderung ist, wenn man bereits einige Zeit in die Anpassungen per Smarty gesteckt hat.

Fehlermeldungen über Connect sollten eigentlich auch bei allen anderen in den Logs auftauchen. Ich muss dazu sagen, dass ich die Connect-Anbindungen selbst noch nicht getestet habe, da mir hierfür die Testshops fehlen, aber ich habe mehrere Tickets in unserem System dazu gefunden, wonach es sicher Logs oder auf jeden Fall Einträge im Journal geben sollte. Im Journal findest du (eigentlich) relativ klare Statusmeldungen dazu, ob es Fehler gab, und wenn ja, welche. Solltest du hierzu direkt fragen haben oder einige der Meldungen unklar sein, kann unser Connect-Team dazu gern im Ticket genauer drauf eingehen.

Es kann sein, dass es gerade durch eine höhere Krankheitsrate zu Verzögerungen in der Ticketbearbeitung kommt. Du kannst mir aber auch gern deine Ticketnummern per Nachricht senden und ich schaue einmal rein, ob ich dir hierzu vielleicht schon einen Zwischenstand geben kann.

VG


Hallo ​@tuge !

Erstmal danke für dein Feedback!
Die Connect Anbindung ist an sich funktionsfertig entwickelt und steht auch als solche zur Verfügung.
Die Umsetzung von Anpassungen, die vorher über Smarty möglich waren, müssen jetzt in der Tat leider anders umgesetzt werden und es nachvollziehbar, dass das nicht die angenehmste Änderung ist, wenn man bereits einige Zeit in die Anpassungen per Smarty gesteckt hat.

Ich benötige noch kein Customzing am Connector insofern für mich nicht relevant, ich weiß aber, dass es bei anderen schon noch kritisch ist.

Fehlermeldungen über Connect sollten eigentlich auch bei allen anderen in den Logs auftauchen. Ich muss dazu sagen, dass ich die Connect-Anbindungen selbst noch nicht getestet habe, da mir hierfür die Testshops fehlen, aber ich habe mehrere Tickets in unserem System dazu gefunden, wonach es sicher Logs oder auf jeden Fall Einträge im Journal geben sollte. Im Journal findest du (eigentlich) relativ klare Statusmeldungen dazu, ob es Fehler gab, und wenn ja, welche. Solltest du hierzu direkt fragen haben oder einige der Meldungen unklar sein, kann unser Connect-Team dazu gern im Ticket genauer drauf eingehen.

Die Fehlermeldung sind auf dem Niveau “No prices for product found”. Das beschreibt leider nicht, wo etwas erwartet wird (wir haben an der Variante, an der Mutter, an den jeweiligen Online-Shop-Konfigurationen, als Standardpreis, als Gruppenpreis jeweils einen Preis hinterlegt, aber das Ergebnis bleibt gleich). Ich kann nichts finden, wie z.B. die übermittelten Objekte aussehen, was Shopware zurück meldet etc

Es kann sein, dass es gerade durch eine höhere Krankheitsrate zu Verzögerungen in der Ticketbearbeitung kommt. Du kannst mir aber auch gern deine Ticketnummern per Nachricht senden und ich schaue einmal rein, ob ich dir hierzu vielleicht schon einen Zwischenstand geben kann.


VG

Ja, mag der Grund sein. Habe dir als Nachricht die Ticketnummern geschickt ggf.  findest du ja was raus. Wäre klasse!

 

Viele Grüße

 

TUGE


Danke für die Rückmeldung!

Das in diesem Fall ist aber tatsächlich auch ein recht unklares Beispiel, die Irritation darüber, wie das nun besser sein soll, kann ich daher gut verstehen. Die Fehlermeldungen sind (sonst) für den Support wesentlich leichter zu interpretieren und führen nach Rücksprache mit dem Support-Team auch zu einer einfacheren und schnelleren Fehlerbehebung.

Leider haben wir im Team, sowohl dem Support- wie auch dem Connect-Team, aktuell einen relativ hohen Krankheitsstand, was zu Verzögerungen bei der Bearbeitung führt.

Wir werden uns dennoch Mühe geben, dein Anliegen als bald zu bearbeiten und sind dir wirklich dankbar für deine Rückmeldungen hierzu. “No prices for product found” mag vielleicht entweder ein Bug mit der Anzeige oder einfach eine wirklich unglückliche Fehlermeldung sein, solltet ihr jedoch wiederholt andere Fehlermeldungen erhalten, welche euch absolut nicht hilfreich erscheinen, lasst uns das bitte wissen, damit wir hierzu nochmal Rücksprache mit der Entwicklung halten können.

 

Beste Grüße


Wo ist denn die Funktion “Initialer Datenimport” versteckt beim SW6 Connector?

 


Hallo ​@UNICUM Merchandising GmbH ,
ich habe leider keinen Demozugang zu SW6, aber alle Connect Apps sind gleich aufgebaut, der Initiale Datenimport müsste sich also an der selben Stelle finden.

LG


Hallo ​@UNICUM Merchandising GmbH ,
ich habe leider keinen Demozugang zu SW6, aber alle Connect Apps sind gleich aufgebaut, der Initiale Datenimport müsste sich also an der selben Stelle finden.

LG

Hallo ​@Dennis Bernhardt, hallo ​@UNICUM Merchandising GmbH,

ich hänge gerade bei derselben Frage...

Leider erscheint der Button Initialer Datenimport nicht bei SW6. Ich habe auch schon einen Shopify- sowie einen WooCommerce-Shop über den neuen Connector angebunden und bei beiden hat das mit dem initialen Datenimport hervorragend funktioniert. Bei SW6 jedoch ist der Button einfach nicht da. Ich habe den Connector gerade extra nochmal neu eingerichtet, um auszuschließen, dass ich irgendwas übersprungen habe und das hier ist die erste Ansicht direkt nach der Einrichtung.

Gibt es dieses Feature beim SW6-Connector evtl. einfach nicht? Oder handelt es sich um einen Bug?

Danke und viele Grüße

David


Als Workaround habe ich nun einen SW6-Shop über die alte Shopware-6-Schnittstelle erstellt, dort “Artikelliste abholen” angeklickt und diesen nach erfolgreicher Abholung der Artikel zu einer SW6-Connect-App konvertiert. Wäre natürlich schöner, wenn es auch ohne diesen Workaround möglich wäre. Ergebnis ist aber dasselbe...


Als Workaround habe ich nun einen SW6-Shop über die alte Shopware-6-Schnittstelle erstellt, dort “Artikelliste abholen” angeklickt und diesen nach erfolgreicher Abholung der Artikel zu einer SW6-Connect-App konvertiert. Wäre natürlich schöner, wenn es auch ohne diesen Workaround möglich wäre. Ergebnis ist aber dasselbe...

Das kann doch aber keine Lösung sein, zumal die Schnittstelle abgeschaltet werden soll! ​@Dennis Bernhardt Würdet Ihr euch das mal anschauen, bitte!


@David Niermann ​@UNICUM Merchandising GmbH ich habe unser Connect Team bereits darüber informiert. Bitte erstellt zusätzliche Tickets für den Support, damit wir es testen, als Bug weiterverfolgen und euch unmittelbar über die Behebung informieren können.

 

Beste Grüße 


@David Niermann ​@UNICUM Merchandising GmbH ich habe eine Antwort des Connect-Teams erhalten. Für SW6 steht der initiale Datenimport nicht zur Verfügung. Daher lässt sich unsere Aussage aus den Connect Videos, dass der Prozess für alle Connect-Schnittstellen gleich durchgeführt werden könne, leider nicht auf SW6 anwenden. Tickest braucht ihr daher hierfür keine anlegen.


Den einfachsten Import für SW6 erreicht ihr daher über einen CSV-Import.

Beste Grüße


Wann wird das nachgereicht? CSV ist doch keine wirkliche Option. Dann lieber über den von ​@David Niermann beschriebenen Weg und die alte Schnittstelle.

Die Sinnhaftigkeit der Funktion steht ja wohl außer Frage, insbesondere da Ihr diesen Sinn für die anderen Konnektoren auch nicht infrage gestellt habt. 


@Dennis Bernhardt Ist der SW6-Connector noch in der Beta? Nicht mehr, oder? Ich erhalte nun beim Versuch Aufträge zu importieren einfach nur die Fehlermeldung “Failed Xentral call (Code 400)”.

Die Connectoren nutzen vermutlich die neue API zum Auftragsimport? Dann würde der Error Code 400 beim Endpunkt “Import sales order” bedeuten: “IETF RFC 7807 Problem API compliant response”

Ich hoffe, ihr könnt damit was anfangen und das Problem lösen?! Ich habe auch ein Ticket dazu eröffnet: #246725

Scheint leider noch ziemlich buggy zu sein. Ich hoffe wirklich, dass ihr noch nicht die Umstellung der Onlineshops zum Connector zum Jahreswechsel erzwingt. Abgesehen davon, dass das ein äußerst ungünstiger Termin ist, da die meisten im Urlaub sein werden und erfahrungsgemäß zwischen den Jahren auch noch ganz gute Umsätze erzielt werden, muss zuerst sichergestellt sein, dass alles funktioniert mit dem Connector. Wir legen alle neuen Shops jetzt schon über den Connector an, um damit Erfahrung zu sammeln. Aber ich würde mich aktuell noch nicht trauen, bestehende Shops umzuwandeln. Ganz nach dem Motto: Never change a running system (until you are absolutely certain the new system is working reliably AND is superior to the old system)


Also ich versuche seit 17. November das alles über Tickets zu lösen. Ich bleibe bei meiner Meinung, dass das alles nicht ausgereift ist. Damit habe ich auch kein Problem, doch wählt doch einen realistischen Zeitraum für den Übergang. Bei mir stört es nun tatsächlich unsere Weiterentwicklung, weil wir einerseits nicht mehr den alten Connector integrieren können und andererseits der neue noch nicht richtig produktiv einsetzbar ist.

Um einen kleinen Überblick zu geben, was bei uns nicht richtig funktioniert:

  • Wir bekommen keine US-Dollar-Preise zu Shopware
  • Euro-Preise bekommen wir jetzt übertragen (als Gültigkeit muss am Preis 00.00.0000 eingetragen werden - wenn ein echtes Datum drin steht, geht es nicht)
  • Beim Import von Aufträgen fehlt die Anrede und das Anschreiben
  • Die Auftragsposition Porto kommt ohne Bezeichnung aus Xentral
  • Es wird an jedem Auftrag eine abweichende Lieferadresse angegeben, die aber identisch mit der Rechnungsadresse ist

Oh, ist ja blöd, dass das nicht rund läuft ​@tuge  . Wenn Anrede und Lieferadresse nicht richtig funktioniert, wäre für uns auch besonders ärgerlich, oder vermutlich für alle. 

Wir haben nur unseren “eigenen” Shopware 6 Shop, den wir dann früher oder später leider auch via der neuen Connect Schnittstelle an Xentral anbinden müssen. Momentan haben wir noch kein Update auf Shopware 6.6 gemacht, weil die Anbindung mit der alten / aktuellen Xentral-Schnittstelle nicht klappen soll. So oder so müssen wir also auf Connect updaten. Wir sind schon damit angefangen die Videos dazu zu schauen und die Doku durchzuarbeiten. Aber wenn ich das hier alles lese, sollte man mit dem Umstieg noch so lange warten, wie es eben geht und weitere Updates von Xentral abwarten und schauen, was sonst noch so hoch kommt, oder ​@Dennis Bernhardt ? Wir haben leider zu wenig Knowhow als auch Personal um lange Schnittstellentests durchzuführen. Wenn ihr das alte System abschaltet, sollte das neue System schon sauber laufen ... 

Leider haben wir auch Smarty-Code im Einsatz, so dass uns bspw. der Affiliate-Code auf dem Shopware eigenen Affiliate Programm mit der Bestellung beim Import an Xentral übermittelt wird und weitere individuelle Informationen ebenfalls, die über Zusatzfeder an der Bestellposition in Shopware erfasst werden. Mithilfe dieses Plugins:

https://store.shopware.com/de/tmms299227094335f/kundeneingaben-zusatzfelder-an-bestellpositionen.html

Wäre die Übermittlung der Zusatzinformationen mit Smarty Code an Xentral prinzipiell auch mit dem neuen Customizing der Schnittstelle möglich?
 


Moin ​@ibims ,

bei Connect ist fast alles möglich, solange die entsprechenden API Endpunkte vorhanden sind. 

Was bei der Auftragslage aktuell möglich ist, findest du hier beim Endpunkt 

Import sales order

 

posthttps://{xentralId}.xentral.biz/api/v1/salesOrders/actions/import

https://developer.xentral.com/reference/intro

 

Am besten wendest du dich mal an den Support. 


Hallo ​@ibims ,

du darfst dich gerne über info@digitalxl.de auch an uns wenden! Wir kennen uns mit Xentral Connect schon recht gut aus und wissen, was geht und was nicht. Auch hinsichtlich Customizings.

Viele Grüße,

Matthias von digitalXL


@ibims die Verwendung von SMARTY ist leider bei keiner Connect-Schnittstelle möglich. Die Funktion wird hier durch Customizings ersetzt. Diese können entweder über das Xentral Consulting oder über Agenturen vorgenommen werden.

 

VG


Moin ​@Dennis Bernhardt ,

wird es auch mal möglich sein  das selbst zu machen?

Ich möchte nicht bei jeder Änderung dafür zahlen müssen. 


@Max_P nach meinem aktuellen Informationsstand ist das nicht geplant.

Beste Grüße


Antworten