Get cash tracking session data

In workflows waarvoor cash tracking session data nodig is, kun je de actie Get cash tracking session data gebruiken om cash tracking sessions uit je POS Pro op te halen. Cash tracking sessions wordt gebruikt om het contante geld in de registers van je winkel te volgen.

Opmerking

Dit is een actie van het type Gegevens ophalen. Meer informatie over hoe je dit type actie gebruikt met de trigger Gepland tijdstip en Voor elk-loops vind je in deze gids.

Configuratie

Velden

De actie Get cash tracking session data bevat de volgende velden.

Velden die worden gebruikt in de acties Gegevens ophalen.

Veld	Beschrijving
Gegevens sorteren op	Vereist. De parameters die bepalen hoe de gegevens die door de zoekquery zijn opgehaald gesorteerd worden.
Maximaal aantal resultaten	Vereist. Het maximumaantal resultaten dat kan worden geretourneerd door de zoekquery die je selecteert. Je kunt er maximaal 100 tegelijk retourneren.
Query	Vereist. Kies uit veelgebruikte query's of selecteer Geavanceerd om een eigen query te maken.

Tekenreeks query

Dit is een voorbeeldquery voor het verkrijgen van cash tracking sessions die werden gesloten in de laatste dag:

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

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

Bij het opvragen van gegevens is het volgende handig om te weten:

• Lijst met beschikbare cash tracking session filters

• Query's moeten een bepaalde syntaxis volgen.

• Queryveldwaarden worden niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden door naar de API-documentatie te kijken. Je kunt ook vaak de veldwaarden in de URL's in het Shopify-beheercentrum vinden wanneer je filtert. Als je bijvoorbeeld enkele querywaarden voor bestellingen wilt zoeken, filter je de pagina Bestellingen in het Shopify-beheercentrum en controleer je de URL.

• Je kunt een zoekopdracht uitvoeren of testen in je winkel met behulp van de Shopify GraphiQL-app.

• Let op wat er gebeurt als de query mislukt. Vaak retourneert de API alle resultaten (in plaats van geen resultaten).

Geretourneerde gegevens

Alle acties Gegevens ophalen retourneren een lijst met tussen de 0 en 100 bronnen. Afhankelijk van waarvoor de lijst bedoeld is, kun je deze gegevens op verschillende manieren gebruiken:

• Als je elk artikel in de lijst afzonderlijk wilt verwerken, bijvoorbeeld om een tag voor elk toe te voegen, kun je de actie Voor elk gebruiken.
• Als je gegevens wilt verzamelen, zoals het aantal geretourneerde resultaten, kun je de actie Aantal of Som gebruiken.
• Als je de lijst wilt exporteren, bijvoorbeeld voor het verzenden van een e-mail met alle artikelen, kun je geretourneerde gegevens rechtstreeks in vervolgacties gebruiken. Om toegang te krijgen tot de geretourneerde gegevens in stappen die volgen op deze actie, gebruik je de variabele Get cash tracking session data, die een lijst is van cash tracking sessions. Je kunt deze variabele zowel in voorwaarden als in acties gebruiken. Je kunt de lijst met cash tracking sessions bijvoorbeeld als volgt verzenden in een actie Interne e-mail verzenden:

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

Opmerking

Als een actie Gegevens ophalen meerdere keren in een workflow wordt gebruikt, wordt er een cijfer toegevoegd aan de naam van de variabele. Bijvoorbeeld in een workflow waarin de actie Bestelgegevens ophalen twee keer wordt uitgevoerd, is de eerste variabele voor geretourneerde gegevens getOrderData en de tweede getOrderData1. Je kunt deze naam niet aanpassen.

Triggers

Je kunt deze actie in elke workflow gebruiken, waaronder de triggerGeplande tijd. In een workflow met de trigger Geplande tijd begint de workflow op een tijd die je hebt opgegeven in plaats van als reactie op een gebeurtenis. Gegevens worden niet automatisch opgenomen omdat er geen specifieke gebeurtenis in je winkel of een app is waardoor de workflow start.

API-referentie

Voor meer informatie over de API die in deze actie wordt gebruikt, zie de CashTrackingSessions query.