Hent data om kassesporingssessioner

I workflows, der kræver data om kassesporingssessioner, kan du bruge handlingen Hent data om kassesporingssessioner til at hente oplysninger om kassesporingssessioner fra din POS Pro. Kassesporingssessioner bruges til at spore kontanterne i din butiks kasseapparater.

På denne side

Konfiguration

Felter

Handlingen Hent data om kassesporingssessioner indeholder følgende felter.

Felter, der bruges i Hent data-handlinger.
Felt	Beskrivelse
Sortér data efter	Kræves. Parametrene, der bruges til at sortere de data, som søgeforespørgslen returnerer.
Maksimalt antal resultater	Kræves. Det maksimale antal resultater, der kan returneres af den søgeforespørgsel, du vælger. Du kan returnere op til 100 ad gangen.
Forespørgsel	Kræves. Vælg mellem almindelige forespørgsler, eller vælg Avanceret for at oprette din egen.

Forespørgselsstreng

Dette er et eksempel på en forespørgsel til at hente kassesporingssessioner, der blev lukket inden for det seneste døgn:

closing_time:<='{{ scheduledAt }}' AND closing_time:>'{{ scheduledAt | date_minus: "1 day" }}'

Variablen closing_time er et filter, der er tilgængeligt i CashTrackingSessions-forespørgslen, og kan bruges flere gange eller kombineres med andre variabler. Liquid-variablen scheduledAt er tilgængelig i workflows, der bruger udløseren Planlagt tidspunkt. Liquid-tagget date_minus er et særligt Flow-tag, som du kan bruge til at trække tid fra en dato.

Når du forespørger om data, er det nyttigt at vide:

Liste over tilgængelige filtre til kassesporingssessioner
Forespørgsler skal følge en bestemt syntaks
Værdierne for forespørgselsfelter er ikke altid dokumenteret. I nogle tilfælde kan værdierne findes ved at kigge i API-dokumentationen. Alternativt kan du ofte finde feltværdierne i webadresserne i administratorpanelet, når du filtrerer. Hvis du f.eks. vil finde nogle værdier for Ordre-forespørgsler, kan du filtrere på siden Ordrer i administratorpanelet og derefter tjekke webadressen.
Du kan køre eller teste en forespørgsel i din butik ved hjælp af Shopify GraphiQL-appen.
Vær opmærksom på, hvad der sker, hvis din forespørgsel mislykkes. API'en returnerer ofte alle resultater (i stedet for ingen).

Returnerede data

Alle Hent data-handlinger returnerer en liste med mellem 0 og 100 ressourcer. Afhængigt af dit anvendelsesformål kan du bruge disse data på forskellige måder:

Hvis du har brug for at håndtere hvert listeelement individuelt, f.eks. for at tilføje et tag til hvert af dem, kan du bruge handlingen For each.
Hvis du har brug for at samle data, f.eks. tælle hvor mange resultater der blev returneret, kan du bruge handlingerne Tæl eller Sum.
Hvis du har brug for at udsende listen, f.eks. sende en mail med alle varerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.

Hvis du vil have adgang til de returnerede data i trin, der følger efter denne handling, skal du bruge variablen med navnet Hent data om kassesporingssessioner, som er en liste over kassesporingssessioner. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over kassesporingssessioner i en Send intern mail-handling som denne:

{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}

Udløsere

Du kan bruge denne handling i ethvert workflow, herunder udløseren Planlagt tidspunkt. I et workflow, der bruger udløseren Planlagt tidspunkt, starter workflowet på et tidspunkt, du har angivet, i stedet for som et resultat af en hændelse. Da der ikke er nogen specifik hændelse i din butik eller fra en app, der starter workflowet, medtages der ikke automatisk nogen data.

API-reference

Du kan få mere at vide om den API, der bruges i denne handling, under CashTrackingSessions-forespørgslen.