Connect-FAQs

Warum werden nicht alle Artikel von Xentral zu Shopify übertragen?

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:

Warum werden Eltern-Artikel bei der Artikelübertragung über die Connect-Schnittstelle mehrfach im Shop ohne SKU angelegt?

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

Warum schlägt die Artikelübertragung mit Fehlermeldungen "Failed Shopify Call: Option does not exist" oder"missing option value "xxx"" fehl?

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.

Woran liegt es, dass ein in Shopify archivierter Artikel plötzlich wieder als "Entwurf" markiert ist?

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:

Ich bekomme einen Fehler bei der Übertragung der custom fields / Freifelder zu Shopify bzw. Shopware bezüglich eines invalid values. Was ist das Problem?

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.

Welche Eigenschaften werden standardmäßig über Freifelder an Shopware 6 übertragen?

Standardmäßig können folgende Xentral Freifelder in Shopware 6 Eigenschaften übertragen werden:

Was geschieht mit Artikeleigenschaften, für die es keine Standardfelder gibt?

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.

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".

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:

Überprüfe außerdem:

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.

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?

Um eine Variante aus deinem Shop-Angebot zu entfernen, gehe bei der Variante in den Artikelstamm und aktiviere die Option Sperre aktiv.

Warum wird der reservierte Bestand in Shopify von allen Lägern abgezogen?

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.

Bei der Bestandsübertragung wird der falsche Bestand übermittelt. Reservierte Artikel werden doppelt abgezogen.

Wenn du in Xentral die Option Automatische Reservierung aktiviert hast, werden alle Artikel aus offenen Aufträgen automatisch reserviert. Prüfe in diesem Fall, ob du bei der Bestandsberechnung in der Connect Oberfläche die Schaltflächen für Reservierungen und Offene Bestellungen gesetzt hast. Ist dies der Fall, werden diese so reservierten Artikel doppelt vom verkaufbaren Bestand abgezogen. Setze den Auswahlschalter entweder bei Offene Aufträge beachten oder bei Reservierungen beachten.

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:

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.

Die Fehlermeldung "No productNumber for product "xxx"" erscheint auch nachdem ein fehlerhafter Artikel aus der Bestellung in Shopify entfernt wurde. Wie kann ich die in Shopify korrigierte Bestellung in Xentral importieren?

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.

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:

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:

Woher bekomme ich die Nummern für den Retourennummernpool in der OTTO Anbindung?

Erfrage die Nummern einfach direkt bei deinem Versanddienstleister, über den du die Retouren abwickeln möchtest.

Bei DHL kannst du den Retourennummernpool mit ein etwas Excel-Kenntnissen auch selbst generieren.

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?

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.

Ich stoße im Artikel über Details > Online-Shop Optionen einen Import / Export an, aber es werden keine Artikeldaten übertragen. Was kann der Grund sein?

Die Funktion im Artikel unter Details > Online-Shop Optionen ist nur für den alten Shopimporter in Verwendung. Wenn dein Shop/Marktplatz über die neue Connect-Schnittstelle an Xentral angebunden ist, erfolgt die Datenübertragung nach Aktivierung der Schnittstelle automatisch. Wenn du einzelne Daten manuell zum Austausch anstoßen möchtest, nutze das Journal in der Connect-Schnittstelle.

Weitere Details zum Journal findest du hier beim jeweiligen Shop/Marktplatz:

Shopify

WooCommerce

Shopware6

OTTO

Wie muss ich den Prozessstarter für Connect einrichten?

Die Connect-Schnittstelle verwendet den Prozessstarter nicht. Du musst hier keine spezifischen Einstellungen für Connect vornehmen.

Wie kann ich mein Amazon Irland (Amazon.ie) an Xentral anbinden?

Der Marktplatz Amazon.ie ist ein neues Feature von Amazon und wurde in der Classic Shop-Schnittstelle nicht berücksichtigt. Daher ist eine direkte Anbindung aktuell nicht vorhanden. Unser Entwicklungsteam arbeitet bereits an einer modernen Amazon-Schnittstelle über Xentral Connect, die sich zunächst auf den Auftragsimport konzentriert. Der Funktionsumfang der Schnittstelle wird anschließend schrittweise erweitert und weitere Marktplatz-Anbindungen ermöglichen. Du kannst dich unter diesem Link über den aktuellen Status informieren und dich bei Interesse in die Early Access Liste eintragen: https://roadmap.xentral.com/c/221-amazon-integration

Falls bereits Bestellungen aus Irland bei euch eingegangen sind, kannst du diese Aufträge manuell in Xentral anlegen. Bitte bedenke, dass du die Versandrückmeldung dann manuell in Amazon Seller Central setzen musst.

Wie erhalte ich Zugang zu Xentral Connect und zum Connect Backend?

Wir unterscheiden zwischen der Connect Anbindung und dem Connect Backend.

Die Connect Anbindung bietet eine Out-of-the-Box-Lösung, die keine besonderen technischen Kenntnisse erfordert und die allermeisten Anwendungsszenarien bestens abdeckt. Die Connect Anbindung steht allen Kunden innerhalb ihres Xentral zur Verfügung. Folge einfach dem Pfad Einstellungen > Verkaufen > Shops/Marktplätze.

Das Connect Backend wiederum ermöglicht die individuelle Erstellung und Anpassung von eigenen Workflows. Die Nutzung dieser Funktionalität erfordert erweiterte technische Kenntnisse, so dass der Zugang zur Connect-Instanz nur nach Schulung und Unterweisung zur Verfügung steht. Wenn du Interesse an der Nutzung individueller Workflows hast, wende dich an deinen Solution Consultant.

Ich erhalte beim Anlegen der Anbindung die Fehlermeldung “falsche Zugangsdaten”.

Bitte stelle sicher, dass du die richtigen Zugangsdaten in der Anbindung eingetragen hast und teste die Verbindung.

Warum kann ich keine Anbindung zu Shopify anlegen? Es geht nicht weiter…

Am besten nutze die Shopify Public App zur Anbindung. Dies setzt die erforderlichen Berechtigungen automatisch. Falls du dich für die Nutzung einer Custom App entschieden hast, überprüfe die Berechtigungen auf der Shopify-Seite und stelle sicher, dass ausreichende Rechte zugewiesen sind. Welche Berechtigungen benötigt werden, siehst du hier.

Wo erhalte ich weitere Informationen zu einer bestimmten Fehlermeldung in Connect?

Wir haben einige Meldungen und mögliche Maßnahmen auf dieser Seite zusammengestellt: Connect Fehlermeldungen und Abhilfe

Ich habe die Features in den Workflows auf Aktiv geschaltet, die Schnittstelle scheint aber keine Daten 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.

Meine Internetverbindung ist während der Migration ausgefallen. Was mache ich nun?

Mach dir keine Sorgen: Sobald die Internetverbindung wieder da ist, fährt die Migration an der Stelle fort, wo sie gestoppt hat.

Woher stammt die UUID für die Artikelzuordnung?

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.

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: