Wenn eine Übertragung fehlschlägt, zeigt dir das Import/Export-Journal eine Fehlermeldung an. In der folgenden Tabelle findest du häufige Fehlermeldungen, ihre Ursachen und die passende Abhilfe.
Tipp
Du kannst dich per E-Mail über den Status des Auftragsimports benachrichtigen lassen. Richte dafür auf der Seite Systemstatus unter Alarms verwalten > Alarm erstellen ein Abo ein. Du wählst deine Integrationen, die Häufigkeit und ob du bei Warnungen und/oder Fehlern benachrichtigt wirst. Siehe Artikel Systemstatus.
So liest du die Tabelle
Die Pfade in der Spalte Abhilfe sind verkürzt:
Workflows > Aufträge steht für Einstellungen > Integrationen > Zahnrad deiner Integration > Tab Workflows > Bereich Aufträge. Entsprechendes gilt für Workflows > Produkte, Workflows > Preise und Workflows > Bestände.
Grundeinstellungen und Artikelzuordnung stehen für die gleichnamigen Unter-Tabs im Tab Konfiguration deiner Integration.
Journal steht für Automatisierung > Journal. „Erneut anstoßen“ bedeutet: Datensatz im Journal suchen und die Übertragung neu anstoßen.
Fehlermeldungen
Fehlermeldung | Kategorie | Verkaufskanal | Ursache | Abhilfe |
Shipping method "xxx" not found | Aufträge | Alle | Für die Versandart "xxx" fehlt eine korrekte Zuordnung. | Workflows > Aufträge: Im Abschnitt Versandarten & Lieferbedingungen die Versandarten Zuordnung prüfen. Auf exakte Schreibweise achten (Groß-/Kleinschreibung, Leerzeichen) und alle Spalten der Tabelle ausfüllen. |
Payment method "xxx" not found | Aufträge | Alle | Für die Zahlungsart "xxx" fehlt eine korrekte Zuordnung. | Workflows > Aufträge: Im Abschnitt Zahlungsarten die Zahlungsarten Zuordnung prüfen. Auf exakte Schreibweise achten und alle Spalten ausfüllen. |
"xxx" is empty and no default configured | Aufträge | Alle | Der Verkaufskanal hat keine Zahlungsart, Versandart oder keinen Sales Channel übertragen, und es ist kein Standard hinterlegt. | Workflows > Aufträge: Standardzahlungsart, Standardversandart bzw. Standardprojekt prüfen. |
No billing address found | Aufträge | Alle | Im Auftrag fehlt die Rechnungsadresse. |
|
Customer could not be created. No name existent. | Aufträge | Alle | Beim Auftragsimport konnte Xentral den Kunden nicht anlegen, weil kein Kundenname vorhanden ist. |
|
Customer could not be created. Address not complete. | Aufträge | Alle | Die Adresse ist unvollständig, es fehlt mindestens Straße, Ort oder Land. |
|
Failed Xentral call (Code 400): Request payload validation failed. (Field name should be a non-empty string.) | Aufträge | Alle | Im Auftrag fehlen Adressdaten, deshalb kann Xentral den Auftrag nicht anlegen. | Sicherstellen, dass im Verkaufskanal immer eine Rechnungsadresse mit allen Pflichtangaben vorhanden ist (Name, Vorname, Straße, PLZ, Ort, Land). Bei Shopify POS einen Default-Kunden anlegen und in der Integration hinterlegen. Bei Shopify lassen sich Auftragsdaten nachträglich nicht ändern: Auftrag in Shopify stornieren und vollständig neu anlegen oder in Xentral manuell anlegen (dann ohne Synchronisation des Auftragsstatus). |
Sales order already imported to Xentral | Aufträge | Alle | Ein Auftrag mit derselben Auftrags-ID ist bereits in Xentral. Xentral importiert ihn nicht erneut, damit keine Duplikate entstehen. | Keine Maßnahme nötig. Vermutlich wurde der Import versehentlich noch einmal angestoßen. |
No product with number "xxx" found | Aufträge | Alle | Der Auftrag enthält mindestens einen Artikel, den es in Xentral noch nicht gibt. | Artikel in Xentral anlegen. Sicherstellen, dass die Artikelnummer der SKU im Verkaufskanal entspricht, sonst Fremdnummer prüfen oder ergänzen. Danach im Journal erneut anstoßen. |
Product "xxx" was expected to be a discount product in master data, regular product found instead | Aufträge | Alle | Als Rabattartikel ist ein Artikel eingetragen, der kein Rabattartikel ist. | Workflows > Aufträge: Artikelnummer im Abschnitt Rabatte prüfen. Im Artikel unter Details > Artikel Optionen die Option Artikel ist Rabatt aktivieren. |
Product "xxx" is not a shipping costs item | Aufträge | Alle | Als Versandkostenartikel ist ein Artikel eingetragen, der kein Portoartikel ist. | Workflows > Aufträge: Artikelnummer im Abschnitt Versandkosten prüfen. Im Artikel unter Details > Artikel Optionen die Option Artikel ist Porto aktivieren. |
Sales order (update) is older than 5 days. Manual import needed. | Aufträge | Alle | Der Auftrag konnte z. B. wegen fehlender Angaben oder Einstellungen nicht importiert werden. Xentral versucht den Import fünf Tage lang automatisch, danach nur noch manuell. |
|
Delta status could not be updated. No data entry found… | Aufträge | Alle | Zeitliche Verzögerung bei der Rückmeldung am Ende der Übertragung. Der Auftrag ist in der Regel bereits importiert. | Keine Maßnahme nötig. Bei Unsicherheit den Auftrag in Xentral prüfen. |
Project to "xxx" not found. | Aufträge | Shopify, Shopware 6 | Für den Vertriebskanal "xxx" fehlt eine korrekte Zuordnung zu einem Projekt. | Workflows > Aufträge: Im Abschnitt Projektzuordnung die Zuordnung Sales Channel zu Projekt prüfen. Auf exakte Schreibweise achten und alle Spalten ausfüllen. |
Project to 'gid://shopify/Publication/…' not found | Aufträge | Shopify | Der Verkaufskanal (Sales Channel) des Shopify-Auftrags ist keinem Xentral-Projekt zugeordnet. | Workflows > Aufträge: Sales Channel einem Projekt zuordnen. Danach im Journal erneut anstoßen. |
No taxes configured | Aufträge | Shopify | Der Verkaufskanal überträgt keine Steuerinformation. | Besteuerung im Verkaufskanal einrichten. Alternativ unter Workflows > Aufträge im Abschnitt Steuern die Option Befreiten Steuersatz bei fehlender Steuerinformation übertragen aktivieren. Xentral setzt dann 0 % Steuer und gibt keinen Fehler aus. |
Country "xxx" not found | Aufträge | Shopware 6 | Für das Land "xxx" fehlt eine korrekte Zuordnung. | Workflows > Aufträge: Länderzuordnung prüfen. Auf exakte Schreibweise achten und alle Spalten ausfüllen. |
Sales order includes surcharges, but no default surcharge product is defined | Aufträge | WooCommerce | Für Zuschläge ist kein Artikel hinterlegt. | Workflows > Aufträge: Artikelnummer im Abschnitt Zuschläge prüfen. |
Product with id "xxx" can not be updated due to update strategy "only create" | Artikel | Alle | Die eingestellte Update Strategie legt nur neue Artikel an und aktualisiert keine bestehenden. | Workflows > Produkte: Update Strategie prüfen. |
Product with id "xxx" can not be created due to update strategy "only update" | Artikel | Alle | Die eingestellte Update Strategie aktualisiert nur bestehende Artikel und legt keine neuen an. | Workflows > Produkte: Update Strategie prüfen. |
No product with productNumber "xxx" found in shop | Artikel | Alle | Preise und Bestände lassen sich nur übertragen, wenn der Artikel im Verkaufskanal angelegt ist. | Artikel im Verkaufskanal anlegen bzw. dorthin übertragen. Sicherstellen, dass Artikelnummer und SKU übereinstimmen, sonst Fremdnummer prüfen oder ergänzen. Prüfen, ob der Artikel überhaupt im Artikelfilter sein soll. Siehe Artikel Artikelfilter: Regeln für alle Integrationen |
Product "xxx" is non-existent parent product | Artikel | Shopify | Matrixprodukte überträgt Xentral nicht einzeln zu Shopify, sondern immer über die Varianten. Die Meldung erscheint, wenn nur das Matrixprodukt übertragen wird. | Matrixprodukt im Journal erneut anstoßen. Xentral erfasst es und überträgt anschließend alle Varianten. |
Parent "xxx" of product "xxx" not exported yet. | Artikel | Shopify | Das Matrixprodukt muss mindestens einmal erfasst sein, bevor Xentral die Varianten in Shopify anlegen kann. | Matrixprodukt im Journal erneut anstoßen. |
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. | Artikelzuordnung: Filter so anpassen, dass das Matrixprodukt eingeschlossen ist. Alternativ im Matrixprodukt unter Details > Online-Shop Optionen auf Artikel synchronisieren klicken. |
Variant has too few options | Artikel | Shopify | Der Artikel hat in Xentral weniger Optionen als in Shopify, z. B. nur "Größe" statt "Farbe" und "Größe". | In beiden Systemen dieselben Optionen verwenden. Auf exakte Schreibweise achten. |
Option value "xxx" does not exist | Artikel | Shopify | Die Optionswerte heißen in Xentral und Shopify unterschiedlich, z. B. S, M, L in Xentral und 36, 38, 40 in Shopify. | In beiden Systemen dieselben Optionswerte verwenden. Auf exakte Schreibweise achten. |
No price found for product "xxx" | Preise | Alle | Die Preisübertragung ist auf eine Kundengruppe eingeschränkt. | Workflows > Preise: Im Abschnitt Preisauswahl das Feld Kunde bzw. Kundengruppe leeren. Xentral überträgt dann den Standardpreis. |
No currency assignment | Preise | Shopware 6 | Für die Währung fehlt eine korrekte Zuordnung. | Workflows > Preise: Währungszuordnung prüfen. Auf exakte Schreibweise achten und alle Spalten ausfüllen. |
No location assignments found | Bestand | Shopify | Für die Lager fehlt eine Zuordnung. | Workflows > Bestände: Im Abschnitt Lager die Lager Zuordnung prüfen und alle Spalten ausfüllen. |
No fulfillment order found in Shopify | Auftragsstatus & Tracking | Shopify | Shopify braucht eine Fulfillment Order, um eine Lieferung anzulegen. Fehlende Berechtigungen oder Plug-ins können das Standardverhalten von Shopify beeinflussen. | Zugangsdaten unter Grundeinstellungen prüfen und ggf. einen neuen Token erzeugen. Plug-ins in Shopify prüfen, die den Auftrags- und Versandprozess beeinflussen. |
No items to fulfill | Auftragsstatus & Tracking | Shopify | Die Fulfillment Order enthält keine Positionen, oder alle Positionen sind bereits als versendet markiert. | Keine Maßnahme nötig. Die Bestellung sollte in Shopify bereits als versendet markiert sein. |
Could not access "xxx" | Alle | Alle | Eine vorübergehende Verbindungsstörung hat die Übertragung abgebrochen. | Im Journal erneut anstoßen. Wenn der Fehler bleibt, Zugangsdaten unter Grundeinstellungen prüfen. |
No suitable servers found | Alle | Alle | Eine vorübergehende Verbindungsstörung hat die Übertragung abgebrochen. | Im Journal erneut anstoßen. |
Connection timed out | Alle | Alle | Eine vorübergehende Verbindungsstörung hat die Übertragung abgebrochen. | Im Journal erneut anstoßen. |
Handshake failed | Alle | Alle | Eine vorübergehende Verbindungsstörung hat die Übertragung abgebrochen. | Im Journal erneut anstoßen. |
There were some errors in data bulk write | Alle | Alle | Ein vorübergehender Schreibfehler in der Datenbank. Der Datensatz ist meist schon verarbeitet. | Betroffenen Auftrag oder Artikel im Journal erneut anstoßen. |
SQLSTATE: Integrity constraint violation: 1062 Duplicate entry | Alle | Alle | Konflikt mit einem doppelten Eintrag in der Datenbank, z. B. bei Labels oder einer fehlerhaften Artikelstruktur. | Daten auf Duplikate prüfen und bereinigen, danach im Journal erneut anstoßen. |
