Gegevens van fulfilmentbestellingen ophalen

Je kunt de actie Gegevens van fulfilmentbestellingen ophalen gebruiken om fulfilmentbestelling-informatie op te halen uit je winkel.

Configuratie

Velden

De actie Gegevens van fulfilmentbestellingen ophalen bevat de volgende velden, die worden gebruikt om de query op te bouwen:

Velden die worden gebruikt in de Gegevens ophalen-acties.
VeldBeschrijving
Gegevens sorteren opVereist. De parameters waarop de gegevens die de zoekopdracht retourneert, worden gesorteerd.
Maximum aantal resultatenVereist. Het maximum aantal resultaten dat kan worden geretourneerd door de geselecteerde zoekopdracht. Je kunt er maximaal 100 tegelijk retourneren.
QueryVereist. Kies uit veelvoorkomende query's of selecteer Geavanceerd om je eigen query aan te maken.

Querytekenreeks

Dit is een voorbeeldquery voor het ophalen van fulfillment-bestellingen die momenteel zijn gepauzeerd:

status:ON_HOLD

De status-variabele is een filter die beschikbaar is voor de query voor fulfillment-bestellingen en kan meerdere keren worden gebruikt of worden gecombineerd met andere variabelen.

Wanneer je gegevens opvraagt met een query, is het handig om het volgende te weten:

  • Lijst met beschikbare filters voor fulfillment-bestellingen
  • Query's moeten een bepaalde syntaxis volgen
  • De waarden van queryvelden zijn niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden in de API-documentatie. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheerpaneel wanneer je filtert. Om bijvoorbeeld bepaalde waarden voor een bestellingquery te vinden, filter je de pagina Bestellingen in het beheerpaneel en controleer je de URL.
  • Je kunt een query in je winkel uitvoeren of testen met de Shopify GraphiQL-app.
  • Let op wat er gebeurt als je query mislukt. Vaak retourneert de API alle resultaten (in plaats van geen).

Geretourneerde gegevens

Alle acties van het type Gegevens ophalen retourneren een lijst van 0 tot 100 resources. Afhankelijk van je gebruiksscenario kun je deze gegevens op verschillende manieren gebruiken:

  • Als je elk lijstitem afzonderlijk moet verwerken, bijvoorbeeld om aan elk item een tag toe te voegen, kun je de actie Voor elke gebruiken.
  • Als je gegevens wilt aggregeren, bijvoorbeeld om te tellen hoeveel resultaten er zijn geretourneerd, kun je de acties Tellen of Optellen gebruiken.
  • Als je de lijst wilt uitvoeren, bijvoorbeeld om een e-mail met alle artikelen te verzenden, kun je de geretourneerde gegevens rechtstreeks in de vervolgacties gebruiken.

Gebruik de variabele met de naam Gegevens van fulfillment-bestellingen ophalen (een lijst met fulfillment-bestellingen) om in de stappen na deze actie toegang te krijgen tot de geretourneerde gegevens. Je kunt deze variabele gebruiken in zowel voorwaarden als acties. Je kunt bijvoorbeeld de lijst met fulfillment-bestellingen verzenden in een actie van het type Interne e-mail verzenden, zoals hieronder:

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

Triggers

Je kunt deze actie in elke workflow gebruiken, inclusief de trigger Geplande tijd. In een workflow die de trigger Geplande tijd gebruikt, start de workflow op een door jou opgegeven tijdstip en niet als gevolg van een gebeurtenis. Omdat er geen specifieke gebeurtenis in je winkel of vanuit een app is die de workflow start, worden er niet automatisch gegevens meegestuurd.

API-gegevens

Templates

Dagelijks een e-mailoverzicht verzenden met een lijst van gepauzeerde fulfillment-bestellingen

Deze workflow zoekt elke dag naar alle fulfillment-bestellingen die zijn gepauzeerd (maximaal 100 tegelijk). Er wordt een e-mailoverzicht verzonden met de bestelnaam en de toegewezen fulfilmentlocatie. Template bekijken