Помощ
Влизане

Извличане на данни за артикул в наличност

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

На тази страница

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

Полета

Действието Извличане на данни за артикул в наличност съдържа следните полета:

Полета, използвани в действията за извличане на данни.
ПолеОписание
Сортиране на данните поЗадължително. Параметрите, по които се сортират данните, върнати от заявката за търсене.
Максимален брой резултатиЗадължително. Максималният брой резултати, които могат да бъдат върнати от избраната от Вас заявка за търсене. Можете да върнете до 100 наведнъж.
ЗаявкаЗадължително. Изберете от често срещаните заявки или изберете Разширени, за да създадете своя собствена.

Низ на заявката

Това е примерна заявка за извличане на проследявани артикули в наличност:

tracked:true

Променливата tracked е филтър, наличен в заявката за артикули в наличност, и може да се използва многократно или да се комбинира с други променливи.

Когато извличате данни чрез заявки, е полезно да знаете следното:

  • Списък с налични филтри за артикули в наличност

  • Заявките трябва да следват определен синтаксис

  • Стойностите на полетата на заявката не винаги са документирани. В някои случаи стойностите могат да бъдат намерени, като прегледате документацията на API. Алтернативно, често можете да намерите стойностите на полетата в URL адресите в администраторския панел, когато филтрирате. Например, за да намерите някои стойности на заявка за поръчка, филтрирайте страницата „Поръчки“ в администраторския панел и след това проверете URL адреса.

  • Можете да изпълните или тествате заявка във Вашия магазин, като използвате приложението Shopify GraphiQL.

  • Имайте предвид какво се случва, ако заявката Ви е неуспешна. Често API връща всички резултати (вместо нито един).

Върнати данни

Всички действия от типа Извличане на данни връщат списък с от 0 до 100 ресурса. В зависимост от Вашия случай на употреба, може да искате да използвате тези данни по различни начини:

  • Ако трябва да обработите всеки елемент от списъка поотделно, например за да добавите таг за всеки от тях, можете да използвате действието За всеки.
  • Ако трябва да агрегирате данни, например да преброите колко резултата са върнати, можете да използвате действията Брой или Сума.
  • Ако е необходимо да изведете списъка, като например да изпратите имейл с всички артикули, тогава можете да използвате върнатите данни директно в последващи действия.

За достъп до върнатите данни в стъпките, които следват това действие, използвайте променливата с име Get inventory item data, която представлява списък с артикули в наличност. Можете да използвате тази променлива както в условия, така и в действия. Например, можете да изпратите списъка с артикули в наличност чрез действие Send internal email по подобен начин:

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

Тригери

Можете да използвате това действие във всеки работен процес, включително и в тригера Scheduled time. В работен процес, който използва тригера Scheduled time, работният процес стартира в определено от Вас време, а не в резултат на събитие. Тъй като няма конкретно събитие във Вашия магазин или от приложение, което да стартира работния процес, няма автоматично включени данни.

Справка за API

За повече информация относно API, използван в това действие, вижте заявката за артикули в наличност.