Hae tilauksen laskutusyritystiedot
Työnkuluissa, jotka edellyttävät tilausten laskutusyritystietoja, voit käyttää Hae tilauksen laskutusyritystietoja -toimintoa tilaustietojen noutamiseen kaupastasi.
Tällä sivulla
Määrittäminen
Kentät
Hanki tilausten laskutusyritysten tiedot -toiminto sisältää seuraavat kentät, joita käytetään kyselyn luomiseen:
| Kenttä | Oikeuksien kuvaus |
|---|---|
| Tietojen lajitteluperuste | Vaaditaan. Parametrit, joiden mukaan hakukyselyn palauttamat tiedot lajitellaan. |
| Tulosten enimmäismäärä | Tarvitaan. Hakukyselyn palauttamien tulosten suurin mahdollinen määrä. Voit palauttaa kerrallaan enintään 100. |
| Kysely | Tarvitaan. Valitse yleisistä kyselyistä tai valitse Lisäasetukset luodaksesi oman. |
Kyselyn merkkijono
Tällä esimerkkikyselyllä saadaan viimeisen kolmen päivän aikana luodut tilauksen laskutusyritykset:
created_at:>'{{ createdAt | date_minus: "3 day" }}'created_at-muuttuja on tilauksen laskutusyrityskyselyssä käytettävissä oleva suodatin, ja sitä voidaan käyttää tietyn virheilmoituksen valitsemiseen tilauksen laskutusyrityksille.
Seuraavat asiat on hyvä tietää tietokyselyä luotaessa:
- Luettelo käytettävissä olevista tilauksen laskutusyritysten suodattimista - Kyselyjen on noudatettava tiettyä syntaksia
- Kaikkien kyselyjen kenttien nimet löytyvät QueryRoot objects -kehittäjädokumentaatiosta.
- Kyselykenttien arvoja ei ole aina dokumentoitu. Joissain tapauksissa arvot löytyvät API-dokumenteista. Vaihtoehtoisesti voit usein löytää kentän arvot Adminin URL-osoitteista, kun suodatat. Jos esimerkiksi haluat löytää tilauskyselyn arvoja, suodata Tilaukset-sivu ylläpitäjässä ja tarkista sitten URL-osoite.
- Voit suorittaa tai testata kyselyä kaupassasi Shopify GraphiQL -sovelluksen avulla.
- Ole tietoinen siitä, mitä tapahtuu, jos kysely epäonnistuu. Usein API palauttaa kaikki tulokset (sen sijaan, että se ei palauttaisi yhtään).
Palautetut tiedot
Kaikki Hae tietoja -toiminnot palauttavat luettelon, jonka koko on 0-100 resurssia. Käyttötapauksestasi riippuen saatat haluta käyttää näitä tietoja eri tavoilla:
- Jos sinun täytyy käsitellä kutakin luettelon kohtaa erikseen, kuten lisätä kullekin tunnisteen, voit käyttää For each-toimintoa.
- Jos sinun täytyy yhdistellä tietoja, kuten laskea, kuinka monta tulosta palautettiin, voit käyttää Laske- tai Summa-toimintoja.
- Jos sinun täytyy tulostaa luettelo, kuten lähettää kaikki kohdat sisältävä sähköpostiviesti, voit käyttää palautettuja tietoja suoraan tätä toimintoa seuraavissa toiminnoissa.
Jotta voit käyttää palautettuja tietoja tätä toimintoa seuraavissa vaiheissa, käytä Hanki tilaussopimusten tietoja -muuttujaa, joka on tilaussopimusten luettelo. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää tilausten laskutusyritysten luettelon Lähetä sisäinen sähköposti ‑toiminnossa näin:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}Esimerkki
Työnkulku on esimerkiksi ajastettu suoritettavaksi joka sunnuntai klo 9.00. Hae tilauksen laskutusyrityksen tiedot -toimintoa käytetään tietojen keräämiseen edellisen viikon aikana luotujen tilausten laskutusyrityksistä. Jos niissä on virheilmoitus, lähetä laskutusyritykset sähköpostitse.