Shopify-Bestellungen fehlen in Xentral: Den Import systematisch prüfen

Wenn eine Shopify-Bestellung in Xentral fehlt, sollte die erste Frage lauten: An welcher Stelle endet der erwartete Datenfluss? Die Bestellung kann außerhalb der Importauswahl liegen, noch nicht abgeholt oder bei der Verarbeitung fehlerhaft sein. Diese Situationen benötigen unterschiedliche Maßnahmen. Der folgende Ursachencheck gilt für den dokumentierten Shopify-Connector in Xentral Connect.

Eine konkrete Bestellung auswählen

Halte externe Bestellnummer, Erstellungszeitpunkt, Zahlungsstatus und Vertriebskanal fest. Suche in Xentral auch nach der externen Referenz, bevor du von einem fehlenden Auftrag ausgehst. Eine andere interne Nummer oder Projektzuordnung kann den Vorgang lediglich schwerer auffindbar machen.

Prüfe außerdem, ob nur ein Fall oder eine ganze Gruppe betroffen ist. Gemeinsamkeiten wie ein bestimmter Zahlungsstatus, ein zusätzlicher Vertriebskanal oder der Zeitpunkt des Produktivstarts helfen bei der Eingrenzung. Vermeide zunächst pauschale Neuimporte ganzer Zeiträume.

Gleiche die Konfiguration mit eurem Konzept für die Shopify-Xentral-Synchronisation ab. Bei fehlenden Artikelzuordnungen setzt die Korrektur am Artikelstamm und den Fremdnummern an.

Importbedingungen kontrollieren

Die aktuelle Workflow-Dokumentation nennt für den automatischen Auftragsimport mehrere Kriterien: Der Auftrag ist nicht älter als drei Tage, wurde nach der Live-Schaltung des Auftragsimports angelegt und besitzt beim Import den konfigurierten Zahlungsstatus sowie Vertriebskanal. Prüfe diese Punkte anhand des konkreten Falls.

• Ist der Auftragsworkflow aktiv?
• Liegt die Bestellung zeitlich nach seiner Aktivierung?
• Passt der aktuelle Zahlungsstatus zur Auswahl?
• Ist der richtige Vertriebskanal berücksichtigt?
• Fällt der Vorgang in das dokumentierte Zeitfenster?

Eine ältere Bestellung, die nicht automatisch übernommen wird, ist damit nicht automatisch ein Beleg für eine defekte Verbindung. Für Altbestände oder Sonderfälle muss der passende Übernahmeweg bewusst gewählt werden.

Connect und Xentral als zwei Prüfschritte betrachten

Das Journal beschreibt die Übernahme in zwei Schritten: Zunächst wird der Auftrag zu Connect geladen, anschließend nach Xentral importiert. Prüfe daher Status und Verlauf der Bestellung. Ein erfolgreicher erster Schritt kann mit einem Fehler im zweiten Schritt zusammenfallen.

Die Herstellerdokumentation nennt Hinweise im Journal, beispielsweise zu fehlenden Steuerangaben im Shop. Verwende die konkrete Meldung als Ausgangspunkt. Korrigiere den betreffenden Datensatz oder seine Zuordnung, statt ohne Diagnose globale Einstellungen zu ändern.

Manuelle Wiederholung kontrolliert ausführen

Im Auftrags-Journal kann eine Bestellnummer für einen manuellen Import angegeben werden. Für bereits vorhandene Aufträge beschreibt Xentral einen Schutz gegen erneuten Import. Verlasse dich bei parallelen Eingriffen trotzdem nicht auf eine allgemeine Annahme, dass keinerlei Dopplung entstehen könne.

Die Journal-Dokumentation nennt für den automatischen Austausch ein Intervall von 15 Minuten und empfiehlt, vor einem manuellen Anstoß zunächst ein Intervall abzuwarten. Prüfe bei abweichendem Verhalten die aktuelle Connector-Version und den Systemstatus. Lege denselben Vorgang nicht zusätzlich von Hand an, während die automatische Verarbeitung noch laufen könnte.

Nach dem Import fachlich prüfen

Ein sichtbarer Auftrag ist der erste Erfolg, aber noch keine vollständige Abnahme. Vergleiche Positionen, Beträge, Versandkosten, Rabatte sowie Zahlungs- und Versandart. Prüfe, ob er dem erwarteten Projekt zugeordnet und im vorgesehenen Prozess bearbeitbar ist.

Dokumentiere Ursache und Korrektur für ähnliche Fälle. Für eine Supportanfrage gehören Bestellreferenz, relevante Zeitpunkte, Status und Fehlermeldung zusammen. Zugangsdaten und unnötige Kundendetails sollten nicht Bestandteil einer frei zugänglichen Fehlerbeschreibung sein.

Eine Prüfreihenfolge mit klaren Entscheidungen

Arbeite den betroffenen Auftrag einmal von Shopify bis Xentral durch. Unsere Empfehlung: Notiere nach jedem Schritt das Ergebnis, bevor du etwas änderst. So bleibt erkennbar, ob die Korrektur die Ursache behoben hat oder der Auftrag nur zufällig währenddessen eingetroffen ist.

1. In Xentral vorhanden? Suche nach der externen Referenz und kontrolliere die Projektzuordnung. Bei einem vorhandenen Auftrag untersuchst du dessen Bearbeitungsstatus statt eines erneuten Imports.
2. Für den automatischen Import ausgewählt? Vergleiche Alter, Zeitpunkt der Live-Schaltung, Zahlungsstatus und Vertriebskanal mit den aktiven Workflow-Regeln.
3. In Connect angekommen? Öffne das Auftrags-Journal. Fehlt bereits der erste Übernahmeschritt, liegt die Prüfung vor dem Import nach Xentral.
4. Nach Xentral übernommen? Ist der Vorgang in Connect vorhanden, lies den Verlauf und den Hinweis zum zweiten Verarbeitungsschritt.
5. Nach Korrektur vollständig? Prüfe den importierten Auftrag gegen Shopify und nicht nur die verschwundene Fehlermeldung.

Die Journal-Anleitung beschreibt „Neu Laden“, „Verlauf anzeigen“ und das erneute Ausführen nach einer Korrektur. Die Workflow-Dokumentation erklärt die Kriterien der Importauswahl.

Musterfälle: dieselbe Beobachtung, unterschiedliche Ursache

Fall A – ältere Bestellung: Eine illustrative Bestellung stammt von vor fünf Tagen. Der Connector arbeitet ansonsten korrekt. Da die dokumentierte automatische Auswahl auf höchstens drei Tage alte Aufträge begrenzt ist, erklärt ein erfolgreicher Verbindungsstatus allein nicht, wie dieser Altfall übernommen wird. Prüfe einen gezielten manuellen Übernahmeweg und die bereits vorhandenen Referenzen.

Fall B – Zahlungsstatus passt nicht: Ein neuer Auftrag ist noch unbezahlt, während euer Workflow einen anderen Zahlungsstatus verlangt. Die fehlende Übernahme kann dann eurer Konfiguration entsprechen. Ändere die Auswahl erst, wenn fachlich entschieden ist, ob solche Bestellungen bereits in Xentral bearbeitet werden sollen.

Fall C – in Connect vorhanden, im ERP abgewiesen: Hier helfen weder ein neues Zeitfenster noch ein anderer Kanalfilter. Die konkrete Meldung im zweiten Schritt entscheidet, welche Daten oder Zuordnung zu korrigieren sind. Die Herstellerhilfe nennt fehlende Steuerangaben als mögliches Beispiel. Eine steuerliche Einstellung darf nicht bloß zur Unterdrückung einer Fehlermeldung verändert werden; kläre die korrekte Behandlung mit den zuständigen Personen.

Aktiver Workflow und produktive Schnittstelle sind zwei Schalter

Die Shopify-FAQ von Xentral beschreibt eine zweistufige Produktivschaltung: Zuerst werden die benötigten Workflows nach ihren Tests aktiviert, anschließend wird der Produktivmodus der Schnittstelle in den Einstellungen gestartet. Prüfe beide Zustände, wenn trotz aktiver einzelner Funktionen kein automatischer Austausch erfolgt.

Nutze eine solche Kontrolle nicht als Anlass, eine noch ungetestete Verbindung produktiv zu schalten. Gerade beim Wechsel von einer alten Anbindung muss klar sein, welche Lösung welchen Zeitraum verarbeitet. Halte den Übergabezeitpunkt im Go-live-Protokoll fest.

Was in eine hilfreiche Supportanfrage gehört

Übermittle die betroffene Bestellreferenz, den Zeitpunkt, den verwendeten Connector, den erwarteten Importweg und den letzten erfolgreichen Verarbeitungsschritt. Ergänze die bereinigte Fehlermeldung und bereits durchgeführte Maßnahmen. Beschreibe auch, ob weitere Bestellungen mit demselben Merkmal betroffen sind. So kann die Betreuung an einer konkreten Stelle ansetzen, statt dieselben allgemeinen Prüfungen erneut zu beginnen.

Nach der Korrektur prüfst du einen weiteren passenden Auftrag im regulären Lauf. Ein einmaliger manueller Import beweist noch nicht, dass die automatische Verarbeitung wieder funktioniert.

Quellen und fachlicher Stand

Herstellerdokumentation geprüft am 17. September 2026. Die Empfehlungen zur Projektorganisation sind redaktionelle Empfehlungen von CommerceOS.

• Xentral Hilfe: Shopify Connector: Workflows konfigurieren
• Xentral Hilfe: Shopify Connector: Journal