Получение данных о заказе
В рабочих процессах, для которых требуются данные о заказе, можно использовать действие «Получить данные о заказе», чтобы извлечь информацию о заказах из вашего магазина.
На этой странице
Конфигурация
Поля
Действие «Получить данные о заказе» содержит следующие поля, которые используются для создания запроса:
| Поле | Описание |
|---|---|
| Сортировать данные по | Обязательно. Параметры, по которым сортируются данные, возвращаемые поисковым запросом. |
| Максимальное количество результатов | Обязательно. Максимальное количество результатов, которое может вернуть выбранный вами поисковый запрос. За один раз можно вернуть до 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 GetOrderData %}
* {{ single_order.name }}
{% endfor %}Триггеры
Это действие можно использовать в любом рабочем процессе, включая триггер «По расписанию». В рабочем процессе, использующем триггер «По расписанию», запуск происходит в указанное вами время, а не в результате какого-либо события. Поскольку запуск рабочего процесса не вызван конкретным событием в вашем магазине или приложении, никакие данные не включаются автоматически.
Сведения об API
Шаблоны
Отмена заказов для клиентов, часто совершающих возвраты
Отменяет заказы клиентов, которые за последние шесть месяцев возвращали товары пять или более раз. Он получает данные о заказах, подсчитывает возвраты и отменяет текущий заказ, производя возврат платежа и возврат товаров на склад. Этот шаблон можно использовать, чтобы сократить убытки от клиентов, которые постоянно возвращают товары, оптимизировать управление заказами за счёт упреждающей обработки потенциальных возвратов и поддерживать рентабельность, препятствуя чрезмерным возвратам. Посмотреть шаблон
Отмена заказов, если клиент разместил более 5 заказов сегодня
Отменяет заказы, если клиент размещает более пяти заказов в течение одного дня. Он проверяет количество заказов, размещённых клиентом за последние 24 часа, и отменяет любые заказы сверх этого лимита, помечая клиента тегом для выявления потенциального мошенничества. Посмотреть шаблон
Удержание заказов к выполнению для клиентов с возвратами платежей
Когда заказ готов к выполнению, рабочий процесс извлекает все заказы того же клиента за последние 60 дней, по которым был произведён возврат платежа. Если такие заказы существуют, он удерживает выполнение каждого отправления и отправляет внутреннее электронное письмо для уведомления ваших операционных служб. Посмотреть шаблон
Удержание выполнения заказов, если клиент разместил несколько заказов за 24 часа
Проверка, разместил ли клиент несколько заказов в течение 24 часов. Если да, то выполнение заказов удерживается, а доставка консолидируется. Посмотреть шаблон
Удержание заказов, если клиент разместил более 1 заказа за последние 24 часа
При создании заказа проверяется, размещал ли клиент другие заказы за последние 24 часа. Если да, все заказы переводятся в статус «на удержании». Посмотреть шаблон
Отправка уведомления, если объём заказов за последний час составил менее 10
Отправка контрольного уведомления о заказах. Каждый час извлекается до 10 созданных заказов и подсчитывается их количество. Если заказов меньше 10, отправляется уведомление по электронной почте. Используются шаги «Запланированное время», «Получить данные о заказе» и «Подсчёт». Просмотреть шаблон
Отправка по электронной почте сводки по всем заказам, размещённым в интернет-магазине за последний день
Каждый день рабочий процесс получает заказы за последний день и отправляет по электронной почте сводку по заказам, размещённым в интернет-магазине. Просмотреть шаблон
Отправка по электронной почте сводки по всем невыполненным заказам старше 2 дней
Ежедневное получение сводки по всем вашим невыполненным заказам старше 2 дней с использованием планирования, получения данных о заказах, подсчёта и суммирования. Просмотреть шаблон
Маркировка тегами и отправка ежедневной сводки по заказам с просроченным выполнением
Каждый день рабочий процесс маркирует тегами и отправляет по электронной почте ежедневную сводку с общим количеством и стоимостью в долларах всех заказов, по которым не была соблюдена гарантия доставки в течение 2 дней. Просмотреть шаблон
Маркировка тегами клиентов с возвратами платежей
Каждый час этот рабочий процесс получает заказы с возвратами платежей и добавляет тег соответствующему клиенту. Используются триггер по расписанию, действие для получения данных о заказе и цикл последовательной обработки элементов. Просмотреть шаблон
Маркировка тегами невыполненных заказов старше 2 дней
Каждый день рабочий процесс получает все невыполненные заказы старше 2 дней и добавляет к ним тег. Просмотреть шаблон
Использование тегов для сегментации клиентов на основе их заказов за последние 6 месяцев
При создании нового заказа рабочий процесс получает общую сумму и количество заказов клиента за последние 6 месяцев, а затем добавляет ему теги. Используются действия «Получить данные о заказе», «Подсчёт» и «Суммирование». Просмотреть шаблон