Gegevens van kassaverkeersessie ophalen

In workflows waarvoor gegevens van kassaverkeersessies nodig zijn, kun je de actie Gegevens van kassaverkeersessie ophalen gebruiken om informatie over kassaverkeersessies op te halen uit je POS Pro. Kassaverkeersessies worden gebruikt om het contante geld in de kassa's van je winkel te volgen.

Op deze pagina

Configuratie

Velden

De actie Gegevens van kassaverkeersessie ophalen bevat de volgende velden.

Velden die worden gebruikt in de Gegevens ophalen-acties.
Veld	Beschrijving
Gegevens sorteren op	Vereist. De parameters waarmee de door de zoekterm geretourneerde gegevens worden gesorteerd.
Maximumaantal resultaten	Vereist. Het maximumaantal resultaten dat kan worden geretourneerd door de zoekterm die je selecteert. Je kunt er maximaal 100 per keer retourneren.
Zoekopdracht	Vereist. Kies uit veelvoorkomende zoekopdrachten of selecteer Geavanceerd om je eigen zoekopdracht aan te maken.

Zoekopdrachttekenreeks

Dit is een voorbeeld van een zoekopdracht om kassaverkeersessies op te halen die in de afgelopen dag zijn gesloten:

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

De variabele closing_time is een filter die beschikbaar is voor de CashTrackingSessions-query en kan meerdere keren worden gebruikt of worden gecombineerd met andere variabelen. De Liquid-variabele scheduledAt is beschikbaar in workflows die de trigger Geplande tijd gebruiken. De Liquid-tag date_minus is een speciale Flow-tag waarmee je tijd van een datum kunt aftrekken.

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

Lijst met beschikbare filters voor kassaverkeersessies
Zoekopdrachten moeten een bepaalde syntaxis volgen
De waarden van zoekopdrachtvelden zijn niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden in de API-documenten. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheerpaneel wanneer je filtert. Als je bijvoorbeeld waarden voor een bestellingszoekopdracht wilt vinden, filter je de pagina Bestellingen in het beheerpaneel en controleer je vervolgens de URL.
Je kunt een zoekopdracht uitvoeren of testen in je winkel met de Shopify GraphiQL-app.
Houd er rekening mee wat er gebeurt als je zoekopdracht mislukt. Vaak retourneert de API alle resultaten (in plaats van geen).

Geretourneerde gegevens

Alle Gegevens ophalen-acties retourneren een lijst van 0 tot 100 resources. Afhankelijk van je use-case wil je deze gegevens misschien op verschillende manieren gebruiken:

Als je elk lijstitem afzonderlijk wilt verwerken, bijvoorbeeld om aan elk lijstitem een tag toe te voegen, dan kun je de actie For each gebruiken.
Als je gegevens wilt verzamelen, bijvoorbeeld om te tellen hoeveel resultaten er zijn geretourneerd, dan kun je de acties Tellen of Optellen gebruiken.
Als je de lijst in de output wilt gebruiken, bijvoorbeeld om een e-mail met alle artikelen te sturen, kun je de geretourneerde gegevens rechtstreeks in vervolgacties gebruiken.

Om toegang te krijgen tot de geretourneerde gegevens in stappen die op deze actie volgen, gebruik je de variabele met de naam Gegevens van kassaverkeersessie ophalen. Dit is een lijst met kassaverkeersessies. Je kunt deze variabele in zowel voorwaarden als acties gebruiken. Je kunt bijvoorbeeld de lijst met kassaverkeersessies verzenden in een Interne e-mail verzenden-actie, zoals hier:

{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% 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 in plaats van naar aanleiding van een gebeurtenis. Omdat er geen specifieke gebeurtenis in je winkel of van een app is die de workflow start, worden er niet automatisch gegevens meegestuurd.

API-referentie

Zie de CashTrackingSessions-query voor meer informatie over de API die in deze actie wordt gebruikt.