Hjelp
Logg på

Hent data for faktureringsforsøk for abonnement

I arbeidsflyter som krever data om faktureringsforsøk for abonnement, kan du bruke handlingen Hent data for faktureringsforsøk for abonnement til å hente bestillingsinformasjon fra butikken din.

På denne siden

Konfigurasjon

Felt

Handlingen Hent data for faktureringsforsøk for abonnement inneholder følgende felt, som brukes til å bygge søket:

Felt som brukes i Hent data-handlinger.
FeltBeskrivelse
Sorter data etterObligatorisk. Parametrene dataene som returneres av søket skal sorteres etter.
Maksimalt antall resultaterObligatorisk. Det maksimale antallet resultater som kan returneres av søket du velger. Du kan returnere opptil 100 om gangen.
SøkObligatorisk. Velg mellom vanlige søk eller velg Avansert for å lage ditt eget.

Søkestreng

Dette er et eksempel på et søk for å hente faktureringsforsøk for abonnement som ble opprettet i løpet av de siste tre dagene:

created_at:>'{{ createdAt | date_minus: "3 day" }}'

Variabelen created_at er et filter som er tilgjengelig for søk etter faktureringsforsøk for abonnement og kan brukes til å velge bestemte feilmeldinger for faktureringsforsøk for abonnement.

Når du søker etter data, kan det være nyttig å vite om:

  • Liste over tilgjengelige filtre for faktureringsforsøk for abonnement
  • Spørringer må følge en bestemt syntaks
  • Spørringsfeltverdier er ikke alltid dokumentert. I noen tilfeller kan verdiene finnes ved å se i API-dokumentasjonen. Alternativt kan du ofte finne feltverdiene i URL-adressene i administratorpanelet når du filtrerer. For å finne noen spørringsverdier for bestillinger, kan du for eksempel filtrere Ordre-siden i administratorpanelet og deretter sjekke URL-adressen.
  • Du kan kjøre eller teste en spørring i butikken ved hjelp av Shopify GraphiQL-appen.
  • Vær oppmerksom på hva som skjer hvis spørringen mislykkes. Ofte vil API-et returnere alle resultater (i stedet for ingen).

Returnerte data

Alle Hent data-handlinger returnerer en liste med alt fra 0 til 100 ressurser. Avhengig av bruksområdet ditt, kan det hende du vil bruke disse dataene på ulike måter:

  • Hvis du må håndtere hvert listeelement individuelt, for eksempel for å legge til en tagg for hvert av dem, kan du bruke For hver-handlingen.
  • Hvis du må aggregere data, for eksempel for å telle hvor mange resultater som ble returnert, kan du bruke handlingene Tell eller Summer.
  • Hvis du trenger å sende listen som utdata, for eksempel i en e-post med alle varene, kan du bruke de returnerte dataene direkte i påfølgende handlinger.

For å få tilgang til de returnerte dataene i trinn som følger denne handlingen, kan du bruke variabelen Hent data om faktureringsforsøk for abonnement, som er en liste over faktureringsforsøk for abonnement. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over faktureringsforsøk for abonnement i en Send intern e-post-handling slik som dette:

{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
  {{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}

Eksempel

En arbeidsflyt er for eksempel planlagt å kjøre hver søndag kl. 09.00. Handlingen Hent data om faktureringsforsøk for abonnement brukes til å samle inn data for faktureringsforsøk for abonnement som er opprettet den siste uken. Hvis de inneholder en feilmelding, blir faktureringsforsøkene sendt på e-post.

API-referanse