Pobierz dane pozycji zapasów

W przepływach pracy wymagających danych o pozycjach zapasów można użyć akcji Pobierz dane pozycji zapasów w celu pobrania informacji o tych pozycjach z Twojego sklepu. Pozycje zapasów reprezentują rzeczywiste jednostki w magazynie, które są śledzone dla wariantów produktów.

Na tej stronie

Konfiguracja

Pola

Akcja Pobierz dane pozycji zapasów zawiera następujące pola:

Pola używane w akcjach Pobierz dane.
Pole	Opis
Sortuj dane według	Wymagane. Parametry, według których sortowane są dane zwracane przez zapytanie wyszukiwania.
Maksymalna liczba wyników	Wymagane. Maksymalna liczba wyników, które mogą zostać zwrócone przez wybrane zapytanie wyszukiwania. Jednocześnie można zwrócić do 100 wyników.
Zapytanie	Wymagane. Wybierz z typowych zapytań lub wybierz opcję Zaawansowane, aby utworzyć własne.

Ciąg znaków zapytania

Oto przykładowe zapytanie służące do pobierania śledzonych pozycji zapasów:

tracked:true

Zmienna tracked to filtr dostępny w zapytaniu o pozycje zapasów, którego można użyć wielokrotnie lub połączyć z innymi zmiennymi.

Podczas tworzenia zapytań o dane warto wiedzieć, że:

Lista dostępnych filtrów pozycji zapasów
Zapytania muszą być zgodne z określoną składnią
Wartości pól zapytań nie zawsze są udokumentowane. W niektórych przypadkach można je znaleźć, sprawdzając dokumentację API. Często wartości pól można też znaleźć w adresach URL w panelu administracyjnym podczas filtrowania. Na przykład, aby znaleźć niektóre wartości zapytań dla zamówień, pofiltruj stronę Zamówienia w panelu administracyjnym, a następnie sprawdź adres URL.
Możesz uruchomić lub przetestować zapytanie w swoim sklepie za pomocą aplikacji Shopify GraphiQL.
Należy pamiętać o tym, co się stanie w przypadku niepowodzenia zapytania. Często API zwraca wszystkie wyniki (zamiast żadnego).

Zwrócone dane

Wszystkie akcje Pobierz dane zwracają listę zawierającą od 0 do 100 zasobów. W zależności od przypadku użycia możesz wykorzystać te dane na różne sposoby:

Jeśli musisz przetwarzać każdą pozycję na liście indywidualnie, np. w celu dodania tagu do każdej z nich, możesz użyć akcji Dla każdego.
Jeśli musisz zagregować dane, np. policzyć zwrócone wyniki, możesz użyć akcji Zlicz lub Suma.
Jeśli chcesz wygenerować listę jako wynik, na przykład wysłać e-mail ze wszystkimi pozycjami, możesz użyć zwróconych danych bezpośrednio w kolejnych akcjach.

Aby uzyskać dostęp do zwróconych danych w krokach po tej akcji, użyj zmiennej o nazwie Get inventory item data, która jest listą pozycji zapasów. Możesz używać tej zmiennej zarówno w warunkach, jak i w akcjach. Możesz na przykład wysłać listę pozycji zapasów w akcji Send internal email, jak poniżej:

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

Wyzwalacze

Możesz użyć tej akcji w dowolnym przepływie pracy, włączając w to wyzwalacz Scheduled time. W przepływie pracy korzystającym z wyzwalacza Scheduled time przepływ pracy rozpoczyna się w określonym przez Ciebie czasie, a nie w wyniku zdarzenia. Ponieważ w sklepie lub z poziomu aplikacji nie ma konkretnego zdarzenia, które uruchamiałoby przepływ pracy, żadne dane nie są dołączane automatycznie.

Dokumentacja API

Aby uzyskać więcej informacji na temat API używanego w tej akcji, zobacz zapytanie Inventory items query.