Hämta data om distributionsorder

Du kan använda åtgärden Hämta data om distributionsorder för att hämta information om distributionsorder från din butik.

Konfiguration

Fält

Åtgärden Hämta data om distributionsorder innehåller följande fält, som används för att skapa sökfrågan:

Fält som används i Hämta data-åtgärder.
FältBeskrivning
Sortera data efterObligatoriskt. De parametrar som data från sökfrågan sorteras efter.
Maximalt antal resultatObligatoriskt. Det maximala antalet resultat som kan returneras av den sökfråga du väljer. Du kan returnera upp till 100 åt gången.
SökfrågaObligatoriskt. Välj bland vanliga sökfrågor eller välj Avancerat för att skapa en egen.

Sökfrågesträng

Det här är ett exempel på en sökfråga för att hämta distributionsordrar som för närvarande är i vänteläge:

status:ON_HOLD

Variabeln status är ett filter som är tillgängligt för sökfrågan för distributionsordrar och kan användas flera gånger eller kombineras med andra variabler.

När du söker efter data är det bra att känna till:

  • Lista över tillgängliga filter för distributionsorder
  • Sökfrågor måste följa en viss syntax
  • Värden för sökfrågefält är inte alltid dokumenterade. I vissa fall kan värdena hittas genom att titta i API-dokumenten. Alternativt kan du ofta hitta fältvärdena i URL:erna i din adminpanel när du filtrerar. Om du till exempel vill hitta några sökfrågevärden för Order kan du filtrera sidan Ordrar i din adminpanel och sedan kontrollera URL:en.
  • Du kan köra eller testa en sökfråga i din butik med hjälp av Shopify GraphiQL-appen.
  • Tänk på vad som händer om din sökfråga misslyckas. API:et returnerar ofta alla resultat (istället för inga).

Returnerade data

Alla Hämta data-åtgärder returnerar en lista med allt från 0 till 100 resurser. Beroende på ditt användningsfall kan du vilja använda dessa data på olika sätt:

  • Om du behöver hantera varje artikel i listan individuellt, till exempel för att lägga till en tagg för varje, kan du använda åtgärden För varje.
  • Om du behöver aggregera data, till exempel räkna hur många resultat som returnerades, kan du använda åtgärderna Räkna eller Summera.
  • Om du behöver mata ut listan, till exempel för att skicka ett e-postmeddelande med alla artiklarna, kan du använda den returnerade datan direkt i efterföljande åtgärder.

För att komma åt returnerade data i steg som följer den här åtgärden, använd variabeln med namnet Hämta distributionsorderdata, som är en lista över distributionsordrar. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka listan med distributionsordrar i åtgärden Skicka internt e-postmeddelande så här:

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

Utlösare

Du kan använda den här åtgärden i alla arbetsflöden, inklusive utlösaren Schemalagd tid. I ett arbetsflöde som använder utlösaren Schemalagd tid startar arbetsflödet vid en tidpunkt som du har angett, snarare än som ett resultat av en händelse. Eftersom det inte finns någon specifik händelse i din butik eller från en app som startar arbetsflödet inkluderas inga data automatiskt.

API-detaljer

Mallar

Skicka daglig e-postsammanfattning med lista över distributionsordrar som är i vänteläge

Varje dag kommer det här arbetsflödet att söka efter alla distributionsordrar som är i vänteläge (upp till 100 åt gången). Det kommer att skicka en e-postsammanfattning med ordernamnet och tilldelad distributionsplats. Visa mall