Hämta data för kontantspårningssession
I arbetsflöden som kräver data för kontantspårningssessioner kan du använda åtgärden Hämta data för kontantspårningssession för att hämta information om kontantspårningssessioner från ditt POS Pro. Kontantspårningssessioner används för att spåra kontanter i din butiks kassor.
På den här sidan
Konfiguration
Fält
Åtgärden Hämta data för kontantspårningssession innehåller följande fält.
| Fält | Beskrivning |
|---|---|
| Sortera data efter | Obligatoriskt. De parametrar som de data som returneras av sökfrågan sorteras efter. |
| Maximalt antal resultat | Obligatoriskt. Det maximala antalet resultat som kan returneras av den sökfråga du väljer. Du kan returnera upp till 100 åt gången. |
| Fråga | Obligatoriskt. Välj bland vanliga frågor eller välj Avancerat för att skapa en egen. |
Frågesträng
Det här är ett exempel på en fråga för att hämta kontantspårningssessioner som stängdes under den senaste dagen:
closing_time:<='{{ scheduledAt }}' AND closing_time:>'{{ scheduledAt | date_minus: "1 day" }}'closing_time-variabeln är ett filter som är tillgängligt för CashTrackingSessions-frågan och kan användas flera gånger eller kombineras med andra variabler. Liquid-variabeln scheduledAt är tillgänglig för arbetsflöden som använder utlösaren Schemalagd tid. Liquid-taggen date_minus är en speciell Flow-tagg som gör att du kan subtrahera tid från ett datum.
När du gör dataförfrågningar är det bra att veta:
Frågor måste följa en viss syntax
Frågefältsvärden ä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 adminpanelen när du filtrerar. Om du till exempel vill hitta några frågevärden för Order kan du filtrera sidan Ordrar i adminpanelen och sedan kontrollera URL:en.
Du kan köra eller testa en fråga i din butik med hjälp av Shopify GraphiQL-appen.
Var medveten om vad som händer om din fråga misslyckas. Ofta returnerar API:et alla resultat (istället för inga).
Returnerade data
Alla Hämta data-åtgärder returnerar en lista med 0 till 100 resurser. Beroende på ditt användningsfall kanske du vill 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 för att 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 returnerad data direkt i efterföljande åtgärder.
För att komma åt returnerade data i steg som följer efter den här åtgärden använder du variabeln med namnet Hämta data för kontantspårningssession, som är en lista över kontantspårningssessioner. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka listan över kontantspårningssessioner i en Skicka internt e-postmeddelande-åtgärd så här:
{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}Utlösare
Du kan använda den här åtgärden i valfritt arbetsflöde, 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-referens
Mer information om det API som används i den här åtgärden finns i CashTrackingSessions-frågan.