Pobierz dane sesji śledzenia gotówki
W workflow, które wymagają danych o sesjach śledzenia gotówki, możesz użyć akcji Pobierz dane sesji śledzenia gotówki, aby pobrać informacje o sesjach śledzenia gotówki z systemu POS Pro. Sesje śledzenia gotówki służą do śledzenia gotówki w rejestrach sklepu.
Konfiguracja
Pola
Akcja Pobierz dane sesji śledzenia gotówki zawiera następujące pola.
| Pole | Opis |
|---|---|
| Sortuj dane według | Wymagane. Parametry, według których sortowane są dane zwrócone przez zapytanie wyszukiwania. |
| Maksymalna liczba wyników | Wymagane. Maksymalna liczba wyników, które mogą zostać zwrócone przez wybrane zapytanie wyszukiwania. Jednorazowo możesz zwrócić do 100 wyników. |
| Zapytanie | Wymagane. Wybierz jedno z typowych zapytań lub opcję Zaawansowane, aby utworzyć własne. |
Ciąg zapytania
To jest przykładowe zapytanie dotyczące pobierania sesji śledzenia gotówki zamkniętych w ciągu ostatniego dnia:
closing_time:<='{{ scheduledAt }}' AND closing_time:>'{{ scheduledAt | date_minus: "1 day" }}'Zmienna closing_time jest filtrem dostępnym w zapytaniu CashTrackingSessions i może być używana wielokrotnie lub łączona z innymi zmiennymi. Zmienna Liquid scheduledAt jest dostępna w workflow, które używają wyzwalacza Zaplanowany czas. Tag Liquid date_minus to specjalny tag Flow, który pozwala odjąć czas od daty.
Podczas wysyłania zapytań o dane warto wiedzieć:
Zapytania muszą być zgodne z określoną składnią
Wartości pól zapytań nie zawsze są udokumentowane. W niektórych przypadkach można je znaleźć w dokumentacji API. Alternatywnie, wartości pól często znajdują się w adresach URL w panelu administracyjnym po włączeniu filtrowania. Na przykład, aby znaleźć niektóre wartości zapytania dotyczącego zamówienia, przefiltruj stronę Zamówienia w panelu administracyjnym, a następnie sprawdź adres URL.
Możesz uruchomić lub przetestować zapytanie w swoim sklepie za pomocą aplikacji Shopify GraphiQL.
Pamiętaj, co się stanie w przypadku niepowodzenia zapytania. API często zwróci wszystkie wyniki (zamiast żadnych).
Zwrócone dane
Wszystkie akcje typu Pobierz dane zwracają listę zawierającą od 0 do 100 zasobów. W zależności od przypadku użycia możesz wykorzystać te dane na różne sposoby:
- Jeśli chcesz obsłużyć każdy element listy indywidualnie, na przykład dodać tag do każdego z nich, możesz użyć akcji Dla każdego.
- Jeśli chcesz agregować dane, na przykład policzyć, ile wyników zwrócono, możesz użyć akcji Licz lub Sumuj.
- Jeśli chcesz wykorzystać listę jako dane wyjściowe, na przykład w e-mailu zawierającym wszystkie pozycje, możesz użyć zwróconych danych bezpośrednio w kolejnych akcjach.
Aby uzyskać dostęp do zwróconych danych w krokach następujących po tej akcji, użyj zmiennej o nazwie Get cash tracking session data, która jest listą sesji śledzenia gotówki. Możesz używać tej zmiennej zarówno w warunkach, jak i akcjach. Na przykład możesz wysłać listę sesji śledzenia gotówki w akcji Wyślij wewnętrzną wiadomość e-mail w następujący sposób:
{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}Wyzwalacze
Możesz użyć tej akcji w dowolnym workflow, w tym z wyzwalaczem Zaplanowany czas. W workflow, który używa wyzwalacza Zaplanowany czas, workflow uruchamia się w określonym przez Ciebie czasie, a nie w wyniku zdarzenia. Ponieważ żadne konkretne zdarzenie w sklepie lub w aplikacji nie uruchamia workflow, dane nie są automatycznie dołączane.
Materiały referencyjne API
Więcej informacji o API użytym w tej akcji można znaleźć w zapytaniu CashTrackingSessions.