Der Auftrag bleibt liegen, obwohl der Shopify-Flow-Workflow eingeschaltet ist.
Schnellste Lösung: Öffnen Sie zuerst das Ausführungsprotokoll, prüfen Sie Trigger, durchlaufene Schritte und Fehlermeldung und korrigieren Sie dann gezielt. Starten Sie einen alten Lauf nicht erneut, bevor Sie mögliche doppelte Aktionen geprüft haben.
Dieser Leitfaden ist für Sie, wenn ein Workflow Bestellungen, Produkte oder Kundenvorgänge nicht wie erwartet verarbeitet.
Er passt auch, wenn ein Lauf festzustecken scheint oder wiederholt fehlschlägt.
Als Shop-Verantwortliche erhalten Sie außerdem eine klare Struktur für Belege und Übergaben.
Erst den sichtbaren Fehler von seiner Ursache trennen
Ein aktivierter Workflow belegt zunächst nur, dass die Aktivierung erfolgt ist. Er beweist nicht, dass das erwartete Ereignis eingetreten ist, dass der richtige Workflow dieses Ereignis verarbeitet hat oder dass eine Bedingung erfüllt war. Bevor Sie Einstellungen ändern, ordnen Sie den Fehler einer beobachtbaren Stelle zu: kein passender Lauf, abgeschlossener Lauf ohne erwartete Aktion, fehlgeschlagener Schritt oder auffällige Verzögerung.
Die Shopify-Flow-Ausführungsprotokolle zeigen Läufe und deren Ablauf. Öffnen Sie in Shopify Flow den Bereich zur Überwachung und wählen Sie den passenden Lauf, um die enthaltenen Schritte und Details zu prüfen. Die offizielle Anleitung zur Überwachung von Workflow-Läufen beschreibt, welche Informationen dafür verfügbar sind. Notieren Sie zunächst den Workflow-Namen, den betroffenen Auftrag oder das Produkt und den ungefähren Ereigniszeitpunkt. Damit vermeiden Sie, einen ähnlich benannten Lauf mit dem gesuchten Vorgang zu verwechseln.
Wo finden Sie die konkrete Fehlermeldung? Öffnen Sie den passenden Lauf und anschließend den Schritt, an dem der Ablauf nicht weiterging oder einen Fehler meldet. Halten Sie den Wortlaut fest, statt ihn nur als „Flow kaputt“ zusammenzufassen. Die offizielle Shopify-Anleitung zur Fehlerbehebung bei Flow führt typische Fehlerstellen und Prüfungen auf. Die Meldung ist dabei ein Hinweis auf den betroffenen Schritt, aber nicht automatisch ein Beweis für die Ursache im gesamten Shop.
Prüfen Sie außerdem, ob die aktuelle Workflow-Version der Version entspricht, die zum fraglichen Zeitpunkt aktiv war. Änderungen können das Verhalten eines Workflows beeinflussen. Die Dokumentation zur Versionsgeschichte hilft Ihnen, Änderungen zeitlich einzuordnen. Wenn mehrere Personen den Workflow bearbeiten, vergleichen Sie die Änderungshistorie mit dem Zeitpunkt, an dem die Abweichung erstmals auffiel.
Fehlerbild und nächste Prüfung
Nutzen Sie die Tabelle als Entscheidungshilfe. Sie ersetzt nicht die Prüfung des konkreten Laufs; sie verhindert aber, dass Sie bei jedem Fehler dieselbe Maßnahme ausprobieren.
| Beobachtetes Fehlerbild | Zuerst prüfen | Nächste sinnvolle Maßnahme |
|---|---|---|
| Kein passender Lauf sichtbar | Ereignis, Trigger, Zielobjekt und Zeitraum | Mit Auftrags- oder Produktkennung erneut suchen; Trigger und Ereigniszuordnung prüfen |
| Lauf abgeschlossen, Aktion fehlt | Bedingung, Pfad und Werte der Schritte | Vergleichen, ob die Bedingung tatsächlich erfüllt war |
| Ein bestimmter Schritt meldet einen Fehler | Fehlermeldung, Eingabedaten und verwendete Verbindung | Eingabe oder Verbindung korrigieren; bei vorübergehendem Fehler die Wiederholung prüfen |
| Lauf wirkt verzögert oder wiederholt sich | Wiederkehrende Fehlerstelle, externe Antwort und Ablaufstruktur | Weitere Auswirkungen begrenzen und erst danach über Änderung oder Wiederholung entscheiden |
Die Aufteilung folgt den Informationen, die Shopify für die Laufüberwachung und Fehlerbehebung beschreibt. Die tatsächlichen Status, Schrittangaben und verfügbaren Aktionen hängen vom konkreten Lauf und der aktuellen Flow-Oberfläche ab. Verlassen Sie sich deshalb nicht auf eine selbst erstellte Fehlerliste, wenn die Details des betroffenen Laufs eine andere Ursache zeigen.
Kein Lauf: Ereignis, Trigger und Version abgleichen
Was prüfen Sie, wenn der Workflow gar nicht ausgelöst wurde? Suchen Sie zuerst nach dem konkreten Ereignis und dem Zielobjekt, statt nur zu kontrollieren, ob der Schalter des Workflows auf aktiv steht. Prüfen Sie danach, ob der Trigger zu dem Vorgang passt, den Sie erwarten. Die Shopify-Erklärung zu Flow-Triggern beschreibt, dass ein Trigger festlegt, welches Ereignis einen Workflow startet.
Gehen Sie in dieser Reihenfolge vor:
- Zielobjekt festlegen. Notieren Sie die Bestell-, Produkt- oder Kundenkennung, die Sie im Admin-Bereich wiederfinden können. Maskieren Sie persönliche Daten in Notizen und Screenshots.
- Ereignis beschreiben. Halten Sie fest, was tatsächlich geschah: etwa eine Bestellung wurde angelegt oder ein Produktstatus geändert. Eine erwartete Folgeaktion ist kein Beleg dafür, dass der passende Trigger ausgelöst wurde.
- Zeitraum eingrenzen. Suchen Sie um den Zeitpunkt des Ereignisses herum. Wenn mehrere Vorgänge ähnlich aussehen, prüfen Sie sie einzeln anhand ihrer Kennungen.
- Trigger und Zielobjekt vergleichen. Ein Workflow für ein anderes Ereignis oder einen anderen Objekttyp verarbeitet den Vorgang nicht automatisch, nur weil er aktiviert ist.
- Version prüfen. Vergleichen Sie, welche Workflow-Version zum Ereigniszeitpunkt maßgeblich war, und ob danach Änderungen vorgenommen wurden.
Ein häufiger Praxisfall: Eine Bestellung wird vom Team als „nicht bearbeitet“ gemeldet, doch im Laufprotokoll findet sich kein zugehöriger Eintrag. In dieser Lage bringt es wenig, die Bedingung oder eine spätere Aktion zu ändern. Klären Sie zunächst, ob das erwartete Ereignis überhaupt dem Trigger entspricht und ob Sie nach dem richtigen Auftrag und Zeitraum suchen. Erst wenn ein passender Lauf vorliegt, lohnt sich die Analyse seiner Bedingungen und Schritte.
Wenn Sie den Lauf nicht finden, erstellen Sie eine knappe Belegnotiz: gesuchtes Objekt, Ereignis, Zeitpunkt und geprüfte Version. So kann die nächste Person dieselbe Suche nachvollziehen, ohne unkontrolliert Einstellungen zu ändern.
Lauf abgeschlossen, aber die erwartete Aktion fehlt
Ein Status „abgeschlossen“ und eine fachlich gewünschte Aktion sind nicht dasselbe. Ein Workflow kann seine Schritte durchlaufen, während ein Bedingungspfad nicht ausgewählt wird. Öffnen Sie im Lauf die Pfade und Schrittwerte und vergleichen Sie diese mit den tatsächlichen Daten des Zielobjekts.
Die Dokumentation zu Bedingungen in Shopify Flow beschreibt den Vergleich von Werten und die Verknüpfung von Bedingungen. Prüfen Sie insbesondere:
- Vergleichswert: Stimmen Wert und Schreibweise mit den Daten überein, die im Lauf angezeigt werden?
- Variablen: Greift die Bedingung auf das Feld zu, das für dieses Ereignis tatsächlich verfügbar ist?
- Kombination: Sollen alle Bedingungen gelten oder genügt eine davon? Prüfen Sie die Verknüpfung mit AND beziehungsweise OR.
- Pfad: Hat der Lauf den erwarteten Zweig erreicht, oder wurde ein anderer Pfad gewählt?
- Zeitpunkt der Daten: Waren die benötigten Informationen beim Ereignis bereits vorhanden?
Warum ist „abgeschlossen“ kein Beweis dafür, dass die Bedingung erfüllt war? Der Laufstatus beschreibt den Ablauf, nicht automatisch das fachliche Ergebnis Ihrer Regel. Vergleichen Sie deshalb die im Lauf sichtbaren Werte mit einer konkreten Bestellung oder einem Produkt. Die Shopify-Hinweise zum Testen eines Workflows erklären die verfügbaren Testmöglichkeiten und deren Grenzen. Ein Testlauf ersetzt nicht die Prüfung des realen Vorgangs mit seinen tatsächlichen Daten.
Für einen belastbaren Vergleich können Sie eine ähnliche, unkritische Bestellung oder ein geeignetes Testobjekt verwenden, sofern Ihr Shop und die Workflow-Konfiguration das zulassen. Dokumentieren Sie, welcher Wert erwartet wurde und welcher im Lauf tatsächlich angezeigt wird. Veröffentlichen Sie keine Screenshots mit Kundennamen, E-Mail-Adressen, vollständigen Bestelldaten oder Zugangsdaten. Schwärzen Sie diese Angaben vor einer Weitergabe vollständig.
Fehler an einer Aktion oder in einem externen Schritt
Zeigt der Lauf eine Fehlermeldung an einem bestimmten Schritt, beginnen Sie genau dort. Prüfen Sie, ob die Aktion die erwarteten Eingabedaten erhalten hat und ob die verwendete Verbindung verfügbar ist. Bei einer Aktion mit externem Dienst muss außerdem unterschieden werden, ob die Antwort des Dienstes vorübergehend fehlschlug oder ob die Anfrage wegen einer falschen Konfiguration beziehungsweise unpassenden Daten scheiterte.
Die von Shopify bereitgestellte Fehlerbehebungsanleitung sollte Ihre erste Referenz für den angezeigten Fehler sein. Ergänzend erläutern die Hinweise zur Workflow-Optimierung Aspekte, die bei umfangreichen Abläufen und wiederholten Prüfungen relevant werden können. Verändern Sie nicht mehrere Schritte gleichzeitig: Sonst lässt sich bei einem erfolgreichen oder weiterhin fehlerhaften Lauf kaum erkennen, welche Änderung den Ausschlag gab.
Achtung: Eine Fehlermeldung an einer Aktion beweist nicht, dass der Browser, die Region oder ein verwendeter Remote-Computer die Ursache ist. Ordnen Sie den Fehler zunächst dem angezeigten Flow-Schritt und dessen Daten oder Verbindung zu.
Bei Schleifen und größeren Datensammlungen prüfen Sie, ob der Ablauf unnötig viele Elemente abfragt oder wiederholt dieselbe Arbeit ausführt. Eine solche Struktur kann einen Lauf belasten; daraus folgt jedoch nicht automatisch, dass jede Verzögerung durch eine Schleife verursacht wird. Vergleichen Sie die konkrete Fehlermeldung, den Schritt und die betroffenen Daten mit den offiziellen Hinweisen, bevor Sie den Workflow umbauen.
Verzögerung, Wiederholung und mögliche Nebenwirkungen
Was tun, wenn ein Lauf weiterläuft oder wiederholt fehlschlägt? Prüfen Sie zunächst, ob immer derselbe Schritt betroffen ist und ob die Fehlermeldung gleich bleibt. Erfassen Sie Status, betroffene Aktion und Wiederholungsmuster. Shopify beschreibt in den Informationen zur Überwachung, wie Sie Läufe nachvollziehen; die jeweils verfügbaren Details im konkreten Lauf sind entscheidend.
Unterscheiden Sie zwischen zwei Fehlerarten:
- Möglicherweise vorübergehender Fehler: etwa eine kurzzeitige Antwortstörung bei einer externen Abhängigkeit. Prüfen Sie, ob der Fehler erneut auftritt und ob der betroffene Schritt grundsätzlich korrekt konfiguriert ist.
- Wahrscheinlich korrekturbedürftiger Fehler: etwa ein fehlender Eingabewert, ein falscher Vergleich oder eine nicht passende Verbindung. Beheben Sie zuerst die Ursache, statt denselben ungeänderten Ablauf immer wieder anzustoßen.
Wenn sich ein Fehler auf mehrere Vorgänge auswirken könnte, stoppen Sie zunächst die Ausweitung der Folgen, soweit das mit Ihren Shop-Prozessen vereinbar ist. Kontrollieren Sie, ob nachgelagerte Aktionen bereits ausgeführt wurden: etwa Benachrichtigungen, Tags oder Änderungen an Aufträgen. Eine Wiederholung kann dieselbe Aktion erneut auslösen. Entscheiden Sie daher nicht allein anhand des Status, sondern anhand der erfolgreich abgeschlossenen Schritte und der möglichen Nebenwirkungen.
Historische Läufe nach einer Korrektur
Kann ein zuvor fehlgeschlagener Lauf nach der Reparatur wiederholt werden? Prüfen Sie vor dem erneuten Ausführen, an welcher Stelle der ursprüngliche Lauf stoppte und welche Aktionen bereits erfolgreich waren. Die Shopify-Anleitung zur manuellen Wiederholung beschreibt die dafür vorgesehene Funktion und ihre Voraussetzungen. Ob ein konkreter Lauf wiederholbar ist, müssen Sie anhand der aktuellen Oberfläche und der zugehörigen Details feststellen.
Nutzen Sie diese Entscheidungsfolge:
- Fehlerursache behoben? Wenn Eingabe, Bedingung oder Verbindung unverändert problematisch ist, wird eine Wiederholung voraussichtlich nicht weiterhelfen.
- Teilweise ausgeführte Aktionen geprüft? Wenn vor dem Fehler bereits eine Benachrichtigung oder Änderung stattgefunden hat, bewerten Sie das Risiko einer doppelten Aktion.
- Ergebnis fachlich kontrollierbar? Wenn ein erneuter Lauf nachvollziehbar geprüft werden kann und keine unvertretbare Doppelverarbeitung droht, kann die dokumentierte manuelle Wiederholung passen.
- Wiederholung nicht sicher? Bearbeiten Sie den Vorgang gegebenenfalls manuell oder lösen Sie nur den passenden Prozess erneut aus, nachdem Sie die Folgen geprüft haben.
- Vorgang dokumentiert? Notieren Sie Korrektur, Entscheidung, zuständige Person und Ergebnis, damit das Team nicht denselben Auftrag nochmals bearbeitet.
Eine Wiederholung ist keine allgemeine Reparatur. Sie ist eine gezielte Operation an einem konkreten Lauf. Wenn Sie nicht feststellen können, welche Aktionen bereits abgeschlossen wurden, behandeln Sie den Vorgang zuerst als möglichen Duplikatfall und klären Sie die Auswirkungen mit den zuständigen Personen.
Übergabe und Beweissicherung über Zeitzonen hinweg
Für eine teamübergreifende Übergabe reichen „Flow geht nicht“ oder ein unkommentierter Screenshot nicht. Halten Sie mindestens diese Angaben fest:
- Workflow-Name und geprüfte Version
- Kennung des betroffenen Objekts, möglichst ohne unnötige Kundendaten
- Ereigniszeitpunkt und angezeigter Laufstatus
- Fehlerstelle und genaue Fehlermeldung
- Bereits vorgenommene Änderung
- Entscheidung zu Wiederholung, manueller Bearbeitung oder weiterer Prüfung
- Verantwortliche Person für den nächsten Schritt
Bewahren Sie die Angaben in einem für Ihr Team freigegebenen Dokumentationssystem auf. Beachten Sie dabei Ihre Datenschutzvorgaben und die DSGVO: Kundendaten, Bestellinformationen, Zugangsdaten und Tokens gehören nicht ungeschwärzt in allgemein zugängliche Screenshots oder Übergaben. Wenn ein Screenshot nötig ist, zeigen Sie nur den relevanten Schritt und entfernen Sie nicht benötigte personenbezogene Informationen.
Ein gemeinsam erreichbarer Mac-Arbeitsplatz kann für ein verteiltes Team als optionale Umgebung für den Zugang zum Shop-Admin und die Übergabe dienen. Er führt Shopify Flow aber nicht aus und repariert keine falsche Bedingung, fehlende Eingabe oder fehlerhafte Verbindung. Wenn Sie unterschiedliche Arbeitsweisen abwägen, finden Sie auf der KVMNODE-Übersicht zu Remote-Mac-Umgebungen Informationen zum Angebot. Für Teams, die gezielt eine US-Umgebung vergleichen möchten, gibt es außerdem die Seite zum Remote Mac in US-Ost. Prüfen Sie vor einer Entscheidung, ob ein solcher Zugriff tatsächlich ein Teamproblem löst oder ob eine saubere Flow-Dokumentation genügt.
Nächster Schritt: korrigieren, erneut ausführen oder manuell bearbeiten
Wenn Sie den Shopify-Flow-Workflow-Fehler anhand des Laufs eingegrenzt haben, wählen Sie die Maßnahme nach dem Befund: fehlendes Ereignis erfordert eine Trigger- und Objektprüfung; ein nicht erreichter Pfad verlangt einen Vergleich der Bedingungen; ein Fehler an einer Aktion verlangt die Prüfung ihrer Eingaben und Abhängigkeiten. Wiederholen Sie einen historischen Lauf erst, wenn Sie die bereits ausgeführten Aktionen und mögliche Doppelwirkungen geprüft haben.
Ein gemeinsam genutzter Remote-Mac kann gegenüber dem Zugriff über private Geräte Übergaben erleichtern, bringt aber auch eine zusätzliche Umgebung mit, die verwaltet und datenschutzgerecht genutzt werden muss. Eine lokale Arbeitsweise vermeidet diese zusätzliche Umgebung, kann bei wechselnden Geräten und Zuständigkeiten jedoch die Nachvollziehbarkeit erschweren. Weder ein lokaler noch ein gemieteter Mac verändert das Ausführungsergebnis von Shopify Flow. Wenn Ihr Team wirklich einen über Zeitzonen hinweg zugänglichen Mac für Admin-Arbeit und Übergaben benötigt, vergleichen Sie die passende Umgebung bei KVMNODE; für die Fehlerbehebung selbst bleiben Laufdetails, Konfiguration und kontrollierte Wiederholung maßgeblich.