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