Gegevens van factureringspoging voor abonnement ophalen
In workflows waarvoor gegevens van factureringspogingen voor abonnementen nodig zijn, kun je de actie Gegevens van factureringspoging voor abonnement ophalen gebruiken om bestelgegevens uit je winkel op te halen.
Configuratie
Velden
De actie Gegevens van factureringspoging voor abonnement ophalen bevat de volgende velden, die worden gebruikt om de query op te bouwen:
| Veld | Beschrijving |
|---|---|
| Gegevens sorteren op | Vereist. De parameters waarmee de gegevens die door de zoekopdracht worden geretourneerd, worden gesorteerd. |
| Maximumaantal resultaten | Vereist. Het maximumaantal resultaten dat kan worden geretourneerd door de geselecteerde zoekopdracht. Je kunt er maximaal 100 tegelijk retourneren. |
| Query | Vereist. Kies uit veelvoorkomende query's of selecteer Geavanceerd om je eigen query aan te maken. |
Querystring
Dit is een voorbeeldquery voor het ophalen van factureringspogingen voor abonnementen die in de afgelopen drie dagen zijn aangemaakt:
created_at:>'{{ createdAt | date_minus: "3 day" }}'De variabele created_at is een filter die beschikbaar is voor de query voor factureringspogingen voor abonnementen en kan worden gebruikt om specifieke foutmeldingen voor factureringspogingen voor abonnementen te selecteren.
Bij het opvragen van gegevens is het handig om het volgende te weten:
- Lijst met beschikbare filters voor factureringspogingen voor abonnementen
- Query's moeten een bepaalde syntaxis volgen
- De waarden van queryvelden zijn niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden in de API-documenten. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheerpaneel wanneer je filtert. Als je bijvoorbeeld een aantal querywaarden voor bestellingen wilt vinden, filter je de pagina Bestellingen in het beheerpaneel en controleer je 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. De API retourneert vaak alle resultaten (in plaats van geen).
Geretourneerde gegevens
Alle Get data-acties retourneren een lijst van 0 tot 100 resources. Afhankelijk van je use case kun je deze gegevens 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 For each gebruiken.
- Als je gegevens wilt aggregeren, bijvoorbeeld om te tellen hoeveel resultaten er zijn geretourneerd, kun je de acties Count of Sum gebruiken.
- Als je de lijst wilt uitvoeren, bijvoorbeeld om een e-mail te sturen met alle artikelen, kun je de geretourneerde gegevens rechtstreeks in de daaropvolgende acties gebruiken.
Om toegang te krijgen tot de geretourneerde gegevens in stappen die op deze actie volgen, gebruik je de variabele met de naam Gegevens van factureringspoging voor abonnement ophalen. Dit is een lijst met factureringspogingen voor abonnementen. Je kunt deze variabele gebruiken in zowel voorwaarden als acties. Je kunt de lijst met factureringspogingen voor abonnementen bijvoorbeeld als volgt verzenden in een Interne e-mail verzenden-actie:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}Voorbeeld
Een workflow is bijvoorbeeld zo ingesteld dat deze elke zondag om 9.00 uur wordt uitgevoerd. De actie Gegevens van factureringspoging voor abonnement ophalen wordt gebruikt om gegevens te verzamelen voor factureringspogingen voor abonnementen die in de afgelopen week zijn aangemaakt. Als deze een foutmelding bevatten, worden de factureringspogingen gemaild.