Daten zur Sitzung der Barzahlungsaufzeichnung abrufen

In Workflows, die Daten zu Sitzungen der Barzahlungsaufzeichnung erfordern, kannst du die Aktion Daten zur Sitzung der Barzahlungsaufzeichnung abrufen verwenden, um Informationen zu Sitzungen der Barzahlungsaufzeichnung von deinem POS Pro abzurufen. Sitzungen zur Aufzeichnung von Barzahlungen werden verwendet, um das Bargeld in den Kassen deines Shops nachzuverfolgen.

Konfiguration

Felder

Die Aktion Daten zur Sitzung der Barzahlungsaufzeichnung abrufen enthält die folgenden Felder.

Felder, die in den „Daten abrufen“-Aktionen verwendet werden.
FeldBeschreibung
Daten sortieren nachErforderlich. Die Parameter, nach denen die von der Suchanfrage zurückgegebenen Daten sortiert werden.
Maximale Anzahl an ErgebnissenErforderlich. Die maximale Anzahl von Ergebnissen, die von der ausgewählten Suchanfrage zurückgegeben werden können. Du kannst bis zu 100 auf einmal zurückgeben lassen.
AbfrageErforderlich. Wähle aus gängigen Abfragen aus oder wähle Erweitert aus, um deine eigene zu erstellen.

Abfrage-String

Dies ist eine Beispielabfrage, um Sitzungen zur Barzahlungsaufzeichnung abzurufen, die am letzten Tag geschlossen wurden:

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

Die Variable closing_time ist ein Filter, der für die CashTrackingSessions-Abfrage verfügbar ist und mehrmals oder in Kombination mit anderen Variablen verwendet werden kann. Die Liquid-Variable scheduledAt ist in Workflows verfügbar, die den Trigger „Geplante Zeit“ verwenden. Der Liquid-Tag date_minus ist ein spezieller Flow-Tag, mit dem du Zeit von einem Datum abziehen kannst.

Beim Abfragen von Daten ist es hilfreich, Folgendes zu wissen:

  • Liste der verfügbaren Filter für Sitzungen der Barzahlungsaufzeichnung

  • Abfragen müssen einer bestimmten Syntax folgen

  • Die Werte für Abfragefelder sind nicht immer dokumentiert. In einigen Fällen findest du die Werte in der API-Dokumentation. Alternativ kannst du die Feldwerte oft in den URLs im Adminbereich finden, wenn du filterst. Um zum Beispiel einige Abfragewerte für Bestellungen zu finden, filtere die Seite „Bestellungen“ im Adminbereich und überprüfe dann die URL.

  • Du kannst eine Abfrage in deinem Shop mit der Shopify GraphiQL App ausführen oder testen.

  • Achte darauf, was passiert, wenn deine Abfrage fehlschlägt. Oft gibt die API alle Ergebnisse zurück (anstatt keiner).

Zurückgegebene Daten

Alle Aktionen vom Typ Daten abrufen geben eine Liste von 0 bis 100 Ressourcen zurück. Je nach Anwendungsfall möchtest du diese Daten vielleicht auf verschiedene Weisen verwenden:

  • Wenn du jedes Listenelement einzeln bearbeiten musst, zum Beispiel um für jedes einen Tag hinzuzufügen, kannst du die Aktion Für jede:n verwenden.
  • Wenn du Daten aggregieren musst, zum Beispiel um zu zählen, wie viele Ergebnisse zurückgegeben wurden, kannst du die Aktionen Zählen oder Summe verwenden.
  • Wenn du die Liste ausgeben musst, um beispielsweise eine E-Mail mit allen Artikeln zu senden, dann kannst du die zurückgegebenen Daten direkt in nachfolgenden Aktionen verwenden.

Um in Schritten, die auf diese Aktion folgen, auf die zurückgegebenen Daten zuzugreifen, verwende die Variable mit dem Namen Daten zur Sitzung der Barzahlungsaufzeichnung abrufen. Dies ist eine Liste von Sitzungen zur Barzahlungsaufzeichnung. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Zum Beispiel kannst du die Liste der Sitzungen zur Barzahlungsaufzeichnung in einer Aktion Interne E-Mail senden wie folgt senden:

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

Trigger

Du kannst diese Aktion in jedem Workflow verwenden, einschließlich des Triggers Geplante Zeit. In einem Workflow, der den Trigger Geplante Zeit verwendet, startet der Workflow zu einer von dir festgelegten Zeit und nicht als Ergebnis eines Ereignisses. Da es kein bestimmtes Ereignis in deinem Shop oder von einer App gibt, das den Workflow startet, werden keine Daten automatisch einbezogen.

API-Referenz

Weitere Informationen über die in dieser Aktion verwendete API findest du in der CashTrackingSessions-Abfrage.