Помощь
Войти

Получение данных о черновике заказа

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

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

Настройка

Поля

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

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

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

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

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

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

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

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

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

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

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

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

{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}

Триггеры

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

Сведения об API

Шаблоны

Ежедневное уведомление со всеми открытыми черновиками заказов

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