Получить данные о незавершенном оформлении заказа

В рабочих процессах, для которых требуются данные о незавершенном оформлении заказа, вы можете использовать действие Получить данные о незавершенном оформлении заказа, чтобы извлечь из вашего магазина информацию о незавершенном оформлении заказа. Незавершенные оформления заказа — это сессии оформления заказа клиентами, которые были начаты, но не завершены.

Конфигурация

Поля

Действие Получить данные о незавершенном оформлении заказа содержит следующие поля:

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

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

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

created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

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

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

  • Список доступных фильтров для незавершенного оформления заказа

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

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

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

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

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

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

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

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

{% for single_checkout in getAbandonedCheckoutData %}
  * {{ single_checkout.email }} - {{ single_checkout.totalPrice }}
{% endfor %}

Триггеры

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

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

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