Voorraadartikelgegevens ophalen

In workflows waarvoor voorraadartikelgegevens zijn vereist, kun je de actie Voorraadartikelgegevens ophalen gebruiken om gegevens over het voorraadartikel uit je winkel op te halen. Voorraadartikelen vertegenwoordigen de daadwerkelijke voorraadeenheden die worden bijgehouden voor productvarianten.

Configuratie

Velden

De actie Voorraadartikelgegevens ophalen bevat de volgende velden:

Query-tekenreeks

Dit is een voorbeeldquery om voorraadartikelen op te halen die worden bijgehouden:

tracked:true

De variabele tracked is een filter dat beschikbaar is in de Inventory items-query en kan meerdere keren worden gebruikt of worden gecombineerd met andere variabelen.

Bij het opvragen van gegevens is het handig om het volgende te weten:

• Lijst met beschikbare voorraadartikelfilters

• Query's moeten een bepaalde syntaxis volgen

• Waarden van queryvelden zijn niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden in de API-documentatie. Daarnaast vind je de veldwaarden vaak in de URL's in het beheer wanneer je filtert. Als je bijvoorbeeld een aantal waarden voor een bestellingsquery wilt vinden, filter je de pagina Bestellingen in het beheer en bekijk je de URL.

• Je kunt een query in je winkel uitvoeren of testen met behulp van de Shopify GraphiQL-app.

• Let goed op wat er gebeurt als je query mislukt. Vaak retourneert de API alle resultaten (in plaats van geen).

Geretourneerde gegevens

Alle Gegevens ophalen-acties retourneren een lijst met 0 tot 100 bronnen. Afhankelijk van je usecase kun je deze gegevens op verschillende manieren gebruiken:

• Als je elk lijstitem afzonderlijk wilt behandelen, bijvoorbeeld om overal een tag aan toe te voegen, kun je de actie For each gebruiken.
• Als je gegevens moet verzamelen, zoals het tellen van het aantal geretourneerde resultaten, kun je de acties Count of Sum gebruiken.
• Als je de lijst als output wilt gebruiken, bijvoorbeeld om een e-mail met alle artikelen te verzenden, kun je de geretourneerde gegevens rechtstreeks gebruiken in de daaropvolgende acties.

Gebruik de variabele Voorraadartikelgegevens ophalen, een lijst met voorraadartikelen, om de geretourneerde gegevens te openen in de stappen na deze actie. Je kunt deze variabele in zowel voorwaarden als acties gebruiken. Je kunt bijvoorbeeld de lijst met voorraadartikelen in een actie van het type Interne e-mail verzenden verzenden, zoals in dit voorbeeld:

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

Triggers

Je kunt deze actie in elke workflow gebruiken, inclusief bij de trigger Geplande tijd. In een workflow die de trigger Geplande tijd gebruikt, start de workflow op een tijdstip dat je hebt opgegeven, en niet als resultaat van een gebeurtenis. Omdat er geen specifieke gebeurtenis in je winkel of van een app is die de workflow start, worden er niet automatisch gegevens opgenomen.

API-referentie

Bekijk de Inventory items-query voor meer informatie over de API die in deze actie wordt gebruikt.