Помощь
Войти

Получить данные о позиции товарных запасов

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

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

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

Поля

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

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

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

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

tracked:true

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

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

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

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

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

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

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

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

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

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

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

{% for single_inventory_item in getInventoryItemData %}
  * SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}

Триггеры

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

Справочник API

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