Помощь
Войти

Получение данных о сессиях отслеживания денежных средств

В рабочих процессах, для которых требуются данные о сессиях отслеживания денежных средств, можно использовать действие «Получение данных о сессиях отслеживания денежных средств», чтобы получить соответствующую информацию из POS Pro. Сессии отслеживания денежных средств используются для учёта наличных в кассах вашего магазина.

На этой странице

Настройка

Поля

Действие «Получение данных о сессиях отслеживания денежных средств» содержит следующие поля.

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

Строка запроса

Ниже приведен пример запроса для получения сессий отслеживания денежных средств, которые были закрыты за последний день:

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

Переменная closing_time — это фильтр, доступный в запросе CashTrackingSessions, и его можно использовать несколько раз или в сочетании с другими переменными. Переменная Liquid scheduledAt доступна в рабочих процессах, использующих триггер «Запланированное время». Тег Liquid date_minus — это специальный тег Flow, позволяющий вычитать время из даты.

При составлении запросов полезно знать следующее:

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

  • Запросы должны соответствовать определенному синтаксису

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

  • Вы можете запустить или протестировать запрос в своем магазине с помощью приложения Shopify GraphiQL.

  • Помните о том, что произойдет в случае сбоя запроса. Часто API возвращает все результаты (а не ни одного).

Возвращаемые данные

Все действия типа «Получение данных» возвращают список, содержащий от 0 до 100 ресурсов. В зависимости от вашего варианта использования, вы можете применять эти данные различными способами:

  • Если вам нужно обработать каждый элемент списка по отдельности, например добавить тег для каждого, вы можете использовать действие «Для каждого».
  • Если вам нужно агрегировать данные, например подсчитать количество возвращенных результатов, вы можете использовать действия «Подсчет» или «Сумма».
  • Если вам нужно вывести список, например отправить электронное письмо со всеми элементами, вы можете использовать возвращаемые данные непосредственно в последующих действиях.

Чтобы получить доступ к возвращаемым данным на последующих шагах, используйте переменную Get cash tracking session data, которая представляет собой список сессий отслеживания денежных средств. Эту переменную можно использовать как в условиях, так и в действиях. Например, вы можете отправить список сессий отслеживания денежных средств с помощью действия «Отправить внутреннее электронное письмо» следующим образом:

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

Триггеры

Это действие можно использовать в любом рабочем процессе, в том числе с триггером «Запланированное время». В рабочем процессе, использующем триггер «Запланированное время», запуск происходит в указанное вами время, а не в результате какого-либо события. Поскольку рабочий процесс запускается не из-за определенного события в вашем магазине или приложении, никакие данные не включаются автоматически.

Справочник по API

Для получения дополнительной информации об API, используемом в этом действии, см. запрос CashTrackingSessions.