Fulfillment-Auftragsdaten abrufen

Du kannst die Aktion Fulfillment-Auftragsdaten abrufen verwenden, um Informationen zu Fulfillment-Aufträgen aus deinem Shop abzurufen.

Konfiguration

Felder

Die Aktion Fulfillment-Auftragsdaten abrufen enthält die folgenden Felder, die zum Erstellen der Abfrage verwendet werden:

Felder, die in den „Daten abrufen“-Aktionen verwendet werden.
FeldBeschreibung
Daten sortieren nachErforderlich. Die Parameter, nach denen die von der Suchanfrage zurückgegebenen Daten sortiert werden.
Maximale Anzahl an ErgebnissenErforderlich. Die maximale Anzahl an Ergebnissen, die von der ausgewählten Suchanfrage zurückgegeben werden können. Du kannst bis zu 100 auf einmal zurückgeben lassen.
AbfrageErforderlich. Wähle eine der gängigen Abfragen aus oder wähle Erweitert aus, um eine eigene zu erstellen.

Abfrage-String

Dies ist eine Beispielabfrage, um Fulfillment-Aufträge abzurufen, die derzeit angehalten sind:

status:ON_HOLD

Die Variable status ist ein Filter, der für die Abfrage für Fulfillment-Aufträge verfügbar ist und mehrmals verwendet oder mit anderen Variablen kombiniert werden kann.

Beim Abfragen von Daten ist es hilfreich, Folgendes zu wissen:

  • Liste der verfügbaren Filter für Fulfillment-Aufträge
  • Abfragen müssen einer bestimmten Syntax folgen
  • Die Werte für Abfragefelder sind nicht immer dokumentiert. In einigen Fällen findest du die Werte in den API-Dokumenten. Alternativ kannst du die Feldwerte oft in den URLs im Adminbereich finden, wenn du filterst. Um zum Beispiel einige Werte für Bestellabfragen zu finden, filtere die Seite „Bestellungen“ im Adminbereich und überprüfe dann die URL.
  • Du kannst eine Abfrage in deinem Shop mit der Shopify GraphiQL App ausführen oder testen.
  • Beachte, was passiert, wenn deine Abfrage fehlschlägt. Oft gibt die API alle Ergebnisse zurück (anstelle von keinen).

Zurückgegebene Daten

Alle Daten abrufen-Aktionen geben eine Liste von 0 bis 100 Ressourcen zurück. Je nach Anwendungsfall möchtest du diese Daten möglicherweise auf verschiedene Weisen verwenden:

  • Wenn du jedes Listenelement einzeln verarbeiten musst, z. B. um für jedes einen Tag hinzuzufügen, kannst du die Aktion Für jedes verwenden.
  • Wenn du Daten aggregieren musst, z. B. um zu zählen, wie viele Ergebnisse zurückgegeben wurden, kannst du die Aktionen Zählen oder Summieren verwenden.
  • Wenn du die Liste ausgeben musst, z. B. um eine E-Mail mit allen Artikeln zu senden, kannst du die zurückgegebenen Daten direkt in nachfolgenden Aktionen verwenden.

Um in den Schritten, die auf diese Aktion folgen, auf die zurückgegebenen Daten zuzugreifen, verwende die Variable namens Fulfillment-Auftragsdaten abrufen. Dies ist eine Liste von Fulfillment-Aufträgen. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Zum Beispiel kannst du die Liste der Fulfillment-Aufträge in einer Aktion Interne E-Mail senden wie folgt senden:

{% for fulfillment_order in GetFulfillmentOrderData %}
* Order: {{ fulfillment_order.order.name }} Location: {{ fulfillment_order.assignedLocation.name }}
{% endfor %}

Trigger

Du kannst diese Aktion in jedem Workflow verwenden, einschließlich des Triggers Geplante Zeit. In einem Workflow, der den Trigger Geplante Zeit verwendet, startet der Workflow zu einer von dir festgelegten Zeit und nicht als Ergebnis eines Ereignisses. Da es kein bestimmtes Ereignis in deinem Shop oder von einer App gibt, das den Workflow startet, werden keine Daten automatisch einbezogen.

API-Details

Vorlagen

Tägliche E-Mail-Übersicht mit einer Liste angehaltener Fulfillment-Aufträge senden

Dieser Workflow fragt täglich alle angehaltenen Fulfillment-Aufträge ab (bis zu 100 auf einmal). Er sendet eine E-Mail-Übersicht mit dem Bestellnamen und dem zugewiesenen Fulfillmentstandort. Vorlage anzeigen