Get cash tracking session data

In Workflows, die Daten zu Sitzungen zur Aufzeichnung von Barzahlungen benötigen, kannst du die Aktion Get cash tracking session data verwenden, um Informationen zu Sitzungen zur Aufzeichnung von Barzahlungen von deinem POS Pro abzurufen. Mithilfe der Sitzungen zur Aufzeichnung von Barzahlungen lässt sich das Bargeld in den Kassen deines Shops aufzeichnen.

Hinweis

Diese Aktion ist eine Aktion vom Typ Daten abrufen. Mehr Informationen darüber, wie du diese Art von Aktion mit dem Trigger Geplanter Zeitpunkt und mit den Für-jeden-Schleifen verwendest, findest du in diesem Leitfaden.

Konfiguration

Felder

Die Aktion „Get cash tracking session data“ enthält die folgenden Felder.

Felder, die in Aktionen vom Typ "Daten abrufen" verwendet werden

Feld	Beschreibung
Daten sortieren nach	Erforderlich. Der Parameter, gemäß dem die von der Suchabfrage zurückgegebenen Daten sortiert werden.
Maximale Anzahl von Ergebnissen	Erforderlich. Die maximale Anzahl an Ergebnissen, die von der von dir ausgewählten Suchabfrage zurückgegeben werden können. Du kannst bis zu 100 Ergebnisse gleichzeitig zurückgeben.
Abfrage	Erforderlich. Wähle eine der üblichen Abfragen oder Erweitert aus, um deine eigene Abfrage zu erstellen.

Abfrage-String

Es folgt eine Beispielabfrage zum Abrufen von Cash tracking sessions, die innerhalb des letzten Tages geschlossen wurden:

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

Die Variable closing_time ist ein Filter, der für die Abfrage von Sitzungen zur Aufzeichnung von Barzahlungen verfügbar ist und mehrfach verwendet oder mit anderen Variablen kombiniert werden kann. Die Liquid-Variable scheduledAt ist für Workflows mit dem Trigger Geplanter Zeitpunkt verfügbar. Das Liquid-Tag date_minus ist ein spezielles Flow-Tag, mit dem du Zeit von einem Datum abziehen kannst.

Bei der Abfrage von Daten ist Folgendes hilfreich:

• Liste der verfügbaren Filter für Sitzungen zur Aufzeichnung von Barzahlungen

• Abfragen müssen einer bestimmten Syntax folgen.

• Abfragefeldwerte werden nicht immer dokumentiert. In einigen Fällen können die Werte in den API-Dokumenten ausfindig gemacht werden. Alternativ dazu findest du die Feldwerte häufig in den URLs im Adminbereich, wenn du Filter anwendest. Um zum Beispiel nach einigen Abfragewerten für Bestellungen zu suchen, filtere die Seite "Bestellungen" im Adminbereich und überprüfe anschließend die URL.

• Mit der Shopify GraphQL-App kannst du eine Abfrage in deinem Shop ausführen oder testen.

• Achte darauf, was passiert, wenn deine Abfrage einen Fehler verursacht. Häufig gibt die API dann alle Ergebnisse zurück (anstelle von keinen Ergebnissen).

Zurückgegebene Daten

Alle Aktionen vom Typ Daten abrufen geben eine Liste von 0 bis 100 Ressourcen zurück. Je nach Anwendungsfall kannst du diese Daten auf verschiedene Weise nutzen:

• Wenn du jedes Listenelement einzeln bearbeiten musst, z. B. um jedem Element ein Tag hinzuzufügen, kannst du die Aktion Für jeden verwenden.
• Wenn du Daten aggregieren musst, z. B. um zu zählen, wie viele Ergebnisse zurückgegeben wurden, kannst die Aktionen Anzahl oder Summe verwenden.
• Wenn du die Liste ausgeben musst, z. B. um eine E-Mail mit allen Elementen zu senden, kannst du die zurückgegebenen Daten direkt in den nachfolgenden Aktionen verwenden. wenn du in den Schritten, die auf diese Aktion folgen, auf die zurückgegebenen Daten zugreifen möchtest, verwende die Variable Get cash tracking session data, bei der es sich um eine Liste von Sitzungen zur Aufzeichnung von Barzahlungen handelt. Du kannst diese Variable sowohl in Bedingungen als auch für Aktionen verwenden. Du kannst zum Beispiel die Liste der Sitzungen zur Aufzeichnung von Barzahlungen in der Aktion Interne E-Mail senden wie folgt senden:

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

Hinweis

Wenn die Aktion Bestelldaten abrufen mehrfach in einem einzelnen Workflow verwendet wird, wird dem Variablennamen eine Zahl hinzugefügt. In einem Workflow, der die Aktion Bestelldaten abrufen zweimal verwendet, lautet die erste Variable für zurückgegebene Daten beispielsweise getOrderData und die zweite Variable getOrderData1. Dieser Name kann nicht angepasst werden.

Trigger

Du kannst diese Aktion in jedem beliebigen Workflow mit dem Trigger Geplanter Zeitpunkt verwenden. In einem Workflow, der den Trigger Geplanter Zeitpunkt verwendet, wird der Workflow nicht als Ergebnis eines Ereignisses gestartet, sondern zu einem von dir angegebenen Zeitpunkt. Da es kein bestimmtes Ereignis in deinem Shop oder von einer App gibt, das den Workflow startet, enthält dieser nicht automatisch Daten.

API-Referenz

Weitere Informationen über die in dieser Aktion verwendete API findest du in der Abfrage von Sitzungen zur Aufzeichnung von Barzahlungen.