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

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

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

Поля

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

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

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

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_variant in GetProductVariantData %}
* {{ single_variant.name }}
{% endfor %}

Триггеры

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

Детали API

• Ресурс варианта товара
• Фильтры запроса вариантов товара

Шаблоны

Добавление бесплатного товара (со скидкой 100%) в новые заказы

Этот шаблон добавляет бесплатный товар в новые заказы, если он есть в наличии. Шаблон проверяет товарные запасы, применяет 100%-ю скидку и обновляет заказ, не уведомляя клиента. Эта автоматизация полезна в следующих случаях: (1) для повышения удовлетворённости клиентов за счёт добавления в заказ бесплатного товара-сюрприза; (2) для продвижения новых или малоизвестных товаров путём их добавления в заказы в качестве бесплатных образцов; (3) для оптимизации рекламных акций за счёт автоматического добавления бесплатных товаров и скидок на них. Посмотреть шаблон

Отправка еженедельной сводки по электронной почте со списком вариантов с низким запасом

Этот рабочий процесс выполняется по расписанию (например, раз в неделю). Он получает список вариантов товаров с низким запасом, подсчитывает результаты и отправляет сводку по электронной почте с названиями вариантов и ссылкой на страницу варианта в панели администратора. Посмотреть шаблон