Отримати дані про сеанс відстеження готівки

У робочих процесах, які потребують даних про сеанс відстеження готівки, ви можете скористатися дією Отримати дані про сеанс відстеження готівки, щоб отримати інформацію про сеанс із вашого POS Pro. Сеанси відстеження готівки використовуються для відстеження готівки в касах вашого магазину.

Налаштування

Поля

Дія Отримати дані сеансу відстеження готівки містить такі поля.

Поля, що використовуються в діях отримання даних.
ПолеОпис
Сортувати дані заОбов'язкове поле. Параметри, за якими сортуються дані, повернені пошуковим запитом.
Максимальна кількість результатівОбов'язкове поле. Максимальна кількість результатів, які може повернути вибраний пошуковий запит. Одночасно можна повернути до 100 результатів.
ЗапитОбов'язкове поле. Виберіть один зі стандартних запитів або натисніть Додатково, щоб створити власний.

Рядок запиту

Це приклад запиту для отримання сеансів відстеження готівки, закритих за останній день:

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

Змінна closing_time — це фільтр, доступний для запиту CashTrackingSessions, який можна використовувати кілька разів або поєднувати з іншими змінними. Змінна Liquid scheduledAt доступна в робочих процесах, де використовується тригер запланованого часу. Тег Liquid date_minus — це спеціальний тег Shopify Flow, який дає змогу відняти час від дати.

Під час запиту даних корисно знати таке:

  • Список доступних фільтрів сеансів відстеження готівки

  • Запити мають відповідати певному синтаксису

  • Значення полів запиту не завжди задокументовані. У деяких випадках значення можна знайти в документації API. Крім того, значення полів часто можна знайти в URL-адресах у панелі адміністрування під час фільтрування. Наприклад, щоб знайти деякі значення запиту для замовлень, відфільтруйте сторінку «Замовлення» в панелі адміністрування, а потім перевірте URL-адресу.

  • Ви можете виконати або протестувати запит у своєму магазині за допомогою застосунку Shopify GraphiQL.

  • Зверніть увагу на те, що станеться в разі помилки запиту. Часто API повертає всі результати (а не жодного).

Повернені дані

Усі дії Отримати дані повертають список, що містить від 0 до 100 ресурсів. Залежно від вашого сценарію ці дані можна використовувати по-різному:

  • Якщо вам потрібно обробити кожну одиницю списку окремо (наприклад, додати тег для кожної), ви можете використати дію Для кожного.
  • Якщо потрібно агрегувати дані (наприклад, підрахувати кількість повернених результатів), можна використати дії Підрахувати або Сума.
  • Якщо потрібно вивести список (наприклад, надіслати електронний лист з усіма одиницями), ви можете використовувати повернені дані безпосередньо в наступних діях.

Щоб отримати доступ до повернених даних на етапах, які виконуються після цієї дії, використовуйте змінну Отримати дані сеансу відстеження готівки, яка містить список сеансів відстеження готівки. Цю змінну можна використовувати як в умовах, так і в діях. Наприклад, ви можете надіслати список сеансів відстеження готівки за допомогою дії Надіслати внутрішній електронний лист у такий спосіб:

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

Тригери

Ви можете використовувати цю дію в будь-якому робочому процесі, зокрема з тригером Запланований час. У робочому процесі з тригером Запланований час робочий процес починається в указаний вами час, а не внаслідок події. Оскільки у вашому магазині чи застосунку немає конкретної події, яка запускає робочий процес, жодні дані не включаються автоматично.

Довідник API

Детальнішу інформацію про API, що використовується в цій дії, див. в описі запиту CashTrackingSessions.