Connect Fehlermeldungen und Abhilfe – Xentral help center

Tip

Wusstest du schon?

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 System Status

Im folgenden haben wir mögliche Fehlermeldungen der Connect-Schnittstelle, deren Ursachen und mögliche Abhilfemaßnahmen zusammengestellt:

Fehlermeldung	Kategorie	Shop/Marktplatz	Ursache	Abhilfe
Shipping method "xxx" not found	Aufträge	Alle	Kein korrektes Mapping für die Versandart "xxx" vorhanden.	Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Workflows > Aufträge Versandarten Zuordnung im Abschnitt Versandarten & Lieferbedingungen überprüfen. Auf richtige Schreibweise achten (Groß-/Kleinschreibung, Leerzeichen usw. beachten). Alle Spalten der Tabelle ausfüllen.
No billing address found	Aufträge	Alle	Keine Rechnungsadresse im Auftrag vorhanden.	Rechnungsadresse im Auftrag auf Shop-/Marktplatz-Seite ergänzen. Synchronisierung über Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Journal erneut anstoßen. Alternativ Customizing erstellen lassen, um die Lieferadresse automatisch als Rechnungsadresse zu übernehmen (z. B. im Fall von TikTok über Shopify).
Payment method "xxx" not found	Aufträge	Alle	Kein korrektes Mapping für die Zahlungsart "xxx" vorhanden.	Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Workflows > Aufträge Zahlungsarten Zuordnung im Abschnitt Zahlungsarten überprüfen. Auf richtige Schreibweise achten (Groß-/Kleinschreibung, Leerzeichen usw. beachten). Alle Spalten der Tabelle ausfüllen.
“xxx” is empty and no default configured	Aufträge	Alle	Zahlungsart, Versandart oder Sales Channel wurde nicht vom Shop/Marktplatz übertragen, und es wurde kein Standard konfiguriert.	Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Workflows > Aufträge Standardzahlungsart, Standardversandart bzw. Standardprojekt überprüfen.
Sales order already imported to Xentral	Aufträge	Alle	Ein Auftrag mit identischer Auftrags-ID befindet sich bereits im System und wird zur Vermeidung von Duplikaten nicht erneut importiert.	Vermutlich wurde der Import unbeabsichtigt noch einmal angestoßen und es ist keine weitere Maßnahme erforderlich.
No product with number "xxx" found	Aufträge	Alle	Der zu importierende Auftrag enthält mindestens einen Artikel, den es in Xentral noch nicht gibt. Ohne einen äquivalenten Artikel in Xentral kann der Auftrag nicht importiert werden.	Artikel in Xentral anlegen. Artikelnummer = Produktnummer / SKU in beiden System sicherstellen oder bei abweichenden Nummern Eintrag in Artikel Fremdnummern prüfen / ergänzen.
Customer could not be created. No name existent.	Aufträge	Alle	Die Anlage des Kunden während des Auftragsimports ist fehlgeschlagen, weil kein Kundenname gefunden werden konnte.	Kundennamen im Auftrag auf Shop-/Marktplatz-Seite ergänzen. Synchronisierung über Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Journal erneut anstoßen.
Customer could not be created. Address not complete.	Aufträge	Alle	Die Anlage des Kunden während des Auftragsimports ist fehlgeschlagen, weil die Adresse unvollständig ist. Es fehlt mind. eine Angabe zu Straße, Stadt oder Land.	Adressdaten im Auftrag auf Shop-/Marktplatz-Seite vervollständigen. Synchronisierung über Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Journal erneut anstoßen.
Product “xxx” was expected to be a discount product in master data, regular product found instead	Aufträge	Alle	Es wurde ein Artikel für Rabatte eingetragen, der kein Rabattartikel ist.	Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Workflows > Aufträge Artikelnummer für Rabatte im gleichnamigen Abschnitt überprüfen. Sicherstellen, dass die dort eingetragene Artikelnummer als Rabattartikel angelegt ist. Navigiere dazu im Artikelstamm auf den Reiter Details > Abschnitt Artikel Optionen. Stelle sicher, dass Artikel ist Rabatt aktiviert ist.
Product “xxx” is not a shipping costs item	Aufträge	Alle	Es wurde ein Artikel für Versandkosten eingetragen, der kein Portoartikel ist	Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Workflows > Aufträge Artikelnummer für Versandkosten im gleichnamigen Abschnitt überprüfen. Sicherstellen, dass die dort eingetragene Artikelnummer als Portoartikel angelegt ist. Navigiere dazu im Artikelstamm auf den Reiter Details > Abschnitt Artikel Optionen. Stelle sicher, dass Artikel ist Porto aktiviert ist.
Sales order (update) is older than 5 days. Manual import needed.	Aufträge	Alle	Der Auftrag konnte z. B. aufgrund von fehlenden Informationen oder Einstellungen nicht importiert werden. Der Import wird fünf Tage lang automatisch versucht, danach muss er manuell angestoßen werden.	Informationen im Auftrag auf Shop-/Marktplatz-Seite vervollständigen. Synchronisierung über Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Journal erneut anstoßen.
Failed Xentral call (Code 400): Request payload validation failed. (Field name should be a non-empty string.)	Aufträge	Alle	Adressdaten im Auftrag fehlen und der Auftrag kann deshalb nicht in Xentral nicht angelegt werden.	Sorge dafür, dass im Checkout/Shopify-Profil immer eine Rechnungsadresse mit allen Pflicht-Daten (Name, Vorname, Straße, PLZ, Ort, Land) vorhanden ist. Bei Shopify POS: Lege einen Standard‑Kunden (z. B. „Default“) an und hinterlege diesen in der Schnittstelle, damit immer ein Name vorhanden ist. Beachte bei Shopify: Auftragsdaten können nicht nachträglich geändert werden. Idealerweise wird der Auftrag in Shopify storniert und mit allen relevanten Adressdaten neu angelegt. Alternativ wird der Auftrag in Xentral manuell angelegt. Dann erfolgt jedoch keine Synchronisation des Auftragsstatus.
Project to "xxx" not found.	Aufträge	Shopify, Shopware 6	Kein korrektes Mapping für den Vertriebskanal "xxx" vorhanden	Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Workflows > Aufträge Sales Channel <> Projekt Zuordnung im Abschnitt Projektzuordnung überprüfen. Auf richtige Schreibweise achten (Groß-/Kleinschreibung, Leerzeichen usw. beachten). Alle Spalten der Tabelle ausfüllen.
No taxes configured	Aufträge	Shopify	Aus dem Shop/Marktplatz wird keine Steuerinformation übergeben	Einstellungen > Verkauf > Shops/Markplätze > Shopify > Workflows > Aufträge Besteuerung auf Shop-/Marktplatz-Seite einrichten. Befreiten Steuersatz bei fehlender Steuerinformation übertragen im Abschnitt Steuern aktivieren. Es wird dann automatisch ein Steuersatz von 0% gesetzt und kein Fehler ausgegeben.
Country "xxx" not found	Aufträge	Shopware 6	Kein korrektes Mapping für das Land "xxx" vorhanden.	Einstellungen > Verkauf > Shops/Markplätze > Shopware 6 > Workflows > Aufträge Länderzuordnung im gleichnamigen Abschnitt überprüfen. Auf richtige Schreibweise achten (Groß-/Kleinschreibung, Leerzeichen usw. beachten). Alle Spalten der Tabelle ausfüllen.
Sales order includes surcharges, but no default surcharge product is defined	Aufträge	WooCommerce	Kein Artikel für Zuschläge definiert.	Einstellungen > Verkauf > Shops/Markplätze > WooCommerce > Workflows > Aufträge Artikelnummer für Zuschläge im gleichnamigen Abschnitt überprüfen.
Product with id “xxx” can not be updated due to update strategy “only create”	Artikel	Alle	Die konfigurierte Update Strategie verhindert, dass der Artikel im Shop aktualisiert wird. Mit dieser Update Strategie werden nur neue Artikel angelegt, aber keine bestehenden Artikel aktualisiert.	Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Workflows > Artikel Update Strategie im gleichnamigen Abschnitt überprüfen.
Product with id "xxx" can not be created due to update strategy "only update"	Artikel	Alle	Die konfigurierte Update Strategie verhindert, dass der Artikel im Shop angelegt wird. Mit dieser Update Strategie werden nur bestehende Artikel aktualisiert, aber keine neuen Artikel angelegt	Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Workflows > Artikel Update Strategie im gleichnamigen Abschnitt überprüfen.
No product with productNumber "xxx" found in shop	Artikel	Alle	Preise und/oder Bestände können nur übertragen werden, wenn der jeweilige Artikel im Shop/Marktplatz angelegt ist.	Artikel im Shop/Marktplatz anlegen bzw. an den Shop/Marktplatz übertragen. Artikelnummer = Produktnummer/SKU in beiden Systemen sicherstellen oder bei abweichenden Nummern Eintrag in Artikel Fremdnummern prüfen / ergänzen.
Product "xxx" is non-existent parent product	Artikel	Shopify	Matrix-Produkte werden nicht eigenständig zu Shopify übertragen, sondern werden immer über die Variante angelegt. Die Fehlermeldung erscheint, wenn nur das Matrix-Produkt übertragen wird.	Einstellungen > Verkauf > Shops/Markplätze > Shopify > Journal Übertragung des Matrixproduktes über das Journal erneut anstoßen. Das Matrixprodukt wird damit erfasst und anschließend alle Varianten übertragen, die das Matrixprodukt selbst mit anlegen.
Parent “xxx” of product “xxx” not exported yet.	Artikel	Shopify	Matrixprodukte werden immer über die Variante in Shopify angelegt. Damit dies funktioniert, muss das Matrixprodukt aber zumindest einmal vorher erfasst worden sein, damit die nötigen Daten vorhanden sind, um es in Shopify anzulegen.	Einstellungen > Verkauf > Shops/Markplätze > Shopify > Journal Übertragung des Matrixproduktes über das Journal erneut anstoßen. Das Matrixprodukt wird damit erfasst und anschließend alle Varianten übertragen, die das Matrixprodukt selbst mit anlegen.
Parent “xxx” of product “xxx” is not in filter	Artikel	Shopify	Bei Matrixprodukten müssen sowohl das Matrixprodukt als auch die Variante im Artikelfilter sein.	Einstellungen > Verkauf > Shops/Markplätze > Shopify > Artikelzuordnung Filterkriterien überprüfen. Matrixprodukt in das Filterkriterium einschließen und Artikelzuordnung neu laden. Alternativ Matrixprodukt über die Schaltfläche Artikel synchronisieren im Artikelstamm > Onlineshop Optionen zum Artikelfilter hinzufügen.
Variant has too few options	Artikel	Shopify	Der Artikel hat in Xentral weniger Optionen als in Shopify. Bsp.: Der Artikel hat in Xentral nur die Option "Größe", während er in Shopify mit "Farbe" und "Größe" angelegt ist.	Übereinstimmende Optionen in beiden Systemen verwenden. Generell auf richtige Schreibweise achten (Groß-/Kleinschreibung, Leerzeichen usw. beachten)
Option value "xxx" does not exist [en-us] [en-us]	Artikel	Shopify	Artikel-Optionen haben in Xentral und in Shopify abweichende Namen. Bsp.: Die Größe hat in Xentral als Optionsnamen S, M, L, aber in Shopify 36, 38, 40.	Übereinstimmende Options-Namen in beiden Systemen verwenden. Auf richtige Schreibweise achten (Groß-/Kleinschreibung, Leerzeichen usw. beachten).
No price found for product "xxx"	Preise	Alle	Die Preisübertragung ist auf eine Kundengruppe eingeschränkt.	Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Workflows > Preise Feld Kunde bzw. Kundengruppe im Abschnitt Preisauswahl leeren, damit Einschränkung aufgehoben wird. Dann wird der Standardpreis übertragen.
No currency assignment	Preise	Shopware 6	Kein korrektes Mapping für die Währung vorhanden	Einstellungen > Verkauf > Shops/Markplätze > Shopware 6 > Workflows > Preise Währungszuordnung im gleichnamigen Abschnitt überprüfen. Auf richtige Schreibweise achten (Groß-/Kleinschreibung, Leerzeichen usw. beachten). Alle Spalten der Tabelle ausfüllen.
No location assignments found	Bestand	Shopify	Kein Mapping für die Lagerzuordnung vorhanden	Einstellungen > Verkauf > Shops/Markplätze > Shopify > Workflows > Bestand Lagerzuordnung im Abschnitt Lager überprüfen. Alle Spalten der Tabelle ausfüllen.
No fulfillment order found in Shopify	Auftragsstatus & Tracking	Shopify	Eine Fulfilment order ist notwendig, damit eine Lieferung in Shopify erstellt werden kann. Nachdem eine Bestellung in Shopify platziert wird, erstellt Shopify automatisch eine oder mehrere Fulfillment Orders basierend darauf, von welchen Locations die Produkte versendet werden sollen. Möglicherweise beeinflussen fehlende Scopes oder Plugins das Standardverhalten in Shopify.	Authentifizierung überprüfen, , ggf. neuen Token generieren unter Einstellungen > Verkauf > Shops/Markplätze > Shopify > Einstellungen (Zahnrad). Plugins, die den Auftrags- und Versandprozess in Shopify beeinflussen könnten, überprüfen.
No items to fulfill	Auftragsstatus & Tracking	Shopify	In der Shopify Fulfillment Order gibt es entweder keine Positionen oder alle Positionen wurden bereits als versendet markiert.	Keine weitere Maßnahme erforderlich. Die Bestellung sollte in Shopify bereits als versendet markiert sein.
Could not access “xxx”	Alle	Alle	Temporäre Unterbrechung / Verbindungsproblem führt zu Übertragungsabbruch	Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Journal Synchronisierung über das Journal erneut anstoßen. Bei bestehenden Problemen: Authentifizierung prüfen.
No suitable servers found	Alle	Alle	Temporäre Unterbrechung / Verbindungsproblem führt zu Übertragungsabbruch	Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Journal Synchronisierung über das Journal erneut anstoßen.
Connection timed out	Alle	Alle	Temporäre Unterbrechung / Verbindungsproblem führt zu Übertragungsabbruch	Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Journal Synchronisierung über das Journal erneut anstoßen.
Handshake failed	Alle	Alle	Temporäre Unterbrechung / Verbindungsproblem führt zu Übertragungsabbruch	Einstellungen > Verkauf > Shops/Markplätze > [Shop-/Marktplatzname] > Journal Synchronisierung über das Journal erneut anstoßen.

Tip

Related articles