Kortingsgegevens ophalen

In workflows waarvoor kortingsgegevens nodig zijn, kun je de actie Kortingsgegevens ophalen gebruiken om kortingsinformatie uit je winkel op te halen.

Let op

Dit is een type actie Gegevens ophalen. Raadpleeg Planningen, gegevens ophalen en herhalende workflows in Shopify Flow voor meer informatie over hoe je dit type actie gebruikt met de trigger Geplande tijd en lussen van het type Voor elke.

Configuratie

Velden

De actie Kortingsgegevens ophalen bevat de volgende velden, die worden gebruikt om de query op te bouwen:

Velden die worden gebruikt in de acties 'Gegevens ophalen'.

Veld	Beschrijving
Gegevens sorteren op	Vereist. De parameters waarop de gegevens die door de zoekopdracht worden geretourneerd, worden gesorteerd.
Maximumaantal resultaten	Vereist. Het maximale aantal resultaten dat kan worden geretourneerd door de zoekopdracht die je selecteert. Je kunt er maximaal 100 per keer retourneren.
Query	Vereist. Kies uit veelvoorkomende query's of selecteer Geavanceerd om er zelf een aan te maken.

Query-tekenreeks

Dit is een voorbeeld van een query om actieve kortingen die een code gebruiken op te halen:

method:code AND status:active

De variabelen method en status zijn filters die beschikbaar zijn in de Kortingsknooppuntquery en kunnen meerdere keren worden gebruikt of worden gecombineerd met andere variabelen.

Wanneer je gegevens opvraagt, is het handig om het volgende te weten:

• Lijst met beschikbare kortingsfilters.
• Query's moeten een bepaalde syntaxis volgen
• Queryveldwaarden zijn niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden door in de API-documenten te kijken. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheerpaneel wanneer je filtert. Om bijvoorbeeld querywaarden voor bestellingen te vinden, filter je de pagina Bestellingen in het beheerpaneel en controleer je vervolgens de URL.
• Je kunt een query in je winkel uitvoeren of testen met de Shopify GraphiQL-app.
• Houd er rekening mee 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 van 0 tot 100 resources. Afhankelijk van je gebruiksscenario wil je deze gegevens misschien op verschillende manieren gebruiken:

• Als je elk lijstitem afzonderlijk wilt verwerken, bijvoorbeeld om voor elk item een tag toe te voegen, kun je de actie Voor elke gebruiken.
• Als je gegevens wilt aggregeren, bijvoorbeeld om te tellen hoeveel resultaten er zijn geretourneerd, kun je de acties Tellen of Som gebruiken.
• Als je de lijst nodig hebt, bijvoorbeeld om een e-mail met alle artikelen te sturen, dan kun je de geretourneerde gegevens rechtstreeks in vervolgacties gebruiken.

Gebruik de variabele met de naam Kortingsgegevens ophalen in stappen die op deze actie volgen om toegang te krijgen tot de geretourneerde gegevens. Dit is een lijst met kortingen. Je kunt deze variabele gebruiken in zowel voorwaarden als acties. Je kunt bijvoorbeeld de lijst met automatische appkortingen verzenden in een Interne e-mail verzenden-actie, zoals hier:

{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
*  {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}

Let op

Als een Gegevens ophalen-actie meerdere keren in één workflow wordt gebruikt, wordt er een nummer aan de naam van de variabele toegevoegd. In een workflow die bijvoorbeeld de actie Bestelgegevens ophalen twee keer gebruikt, is de eerste variabele voor geretourneerde gegevens getOrderData en de tweede getOrderData1. Deze naam kan niet worden aangepast.

Triggers

Je kunt deze actie in elke workflow gebruiken, inclusief de Geplande tijd-trigger. In een workflow die de Geplande tijd-trigger gebruikt, start de workflow op een door jou opgegeven tijd in plaats van als gevolg van een gebeurtenis. Omdat er geen specifieke gebeurtenis in je winkel of vanuit een app is die de workflow start, worden er niet automatisch gegevens opgenomen.

API-gegevens

• Kortingsresource
• Queryfilters voor kortingen

Templates

Wekelijks e-mailoverzicht van actieve kortingen die een code gebruiken

Verzendt een overzicht per e-mail van actieve kortingen die een code gebruiken. De workflow wordt elke maandag om 9.00 uur uitgevoerd. Je kunt de workflow aanpassen en de timing, de manier waarop je het overzicht ontvangt, het type kortingen dat je wilt opnemen en de modus wijzigen. Template bekijken