Nouda toistuvan tilauksen laskutusyrityksen tiedot
Työnkuluissa, jotka edellyttävät toistuvien tilausten laskutusyritysten tietoja, voit käyttää Nouda toistuvan tilauksen laskutusyrityksen tiedot -toimintoa tilaustietojen noutamiseen kaupastasi.
Tällä sivulla
Määritys
Kentät
Nouda toistuvan tilauksen laskutusyrityksen tiedot -toiminto sisältää seuraavat kentät, joiden avulla kysely muodostetaan:
| Kenttä | Kuvaus |
|---|---|
| Lajittele tiedot | Pakollinen. Parametrit, joiden mukaan hakukyselyn palauttamat tiedot lajitellaan. |
| Tulosten enimmäismäärä | Pakollinen. Tulosten enimmäismäärä, jotka valitsemasi hakukysely voi palauttaa. Voit palauttaa kerralla enintään 100. |
| Kysely | Pakollinen. Valitse yleisistä kyselyistä tai valitse Laajennettu ja luo omasi. |
Kyselymerkkijono
Tämä on esimerkkikysely sellaisten toistuvien tilausten laskutusyritysten noutamiseksi, jotka on luotu kolmen viime päivän aikana:
created_at:>'{{ createdAt | date_minus: "3 day" }}'created_at-muuttuja on suodatin, joka on käytettävissä toistuvan tilauksen laskutusyrityksen kyselyssä, ja sitä voidaan käyttää valitsemaan tiettyjä virheilmoituksia toistuvan tilauksen laskutusyrityksille.
Kun teet tietokyselyitä, on hyvä tietää seuraavat asiat:
- Luettelo käytettävissä olevista toistuvien tilausten laskutusyritysten suodattimista
- Kyselyiden on noudatettava tiettyä syntaksia
- Kyselykenttien arvoja ei ole aina dokumentoitu. Joissakin tapauksissa arvot löytyvät API-dokumentaatiosta. Vaihtoehtoisesti voit usein löytää kenttien arvot ohjausnäkymän URL-osoitteista, kun käytät suodattimia. Jos haluat esimerkiksi löytää joitakin tilauskyselyn arvoja, suodata Tilaukset-sivua ohjausnäkymässä ja tarkista sitten URL-osoite.
- Voit suorittaa tai testata kyselyn kaupassasi käyttämällä Shopify GraphiQL -sovellusta.
- Ota huomioon, mitä tapahtuu, jos kyselysi epäonnistuu. Usein API palauttaa kaikki tulokset (ei yhtään).
Palautetut tiedot
Kaikki Nouda tiedot -toiminnot palauttavat luettelon, jossa on 0–100 resurssia. Käyttötapauksestasi riippuen saatat haluta käyttää näitä tietoja eri tavoin:
- Jos sinun on käsiteltävä jokaista luettelon kohdetta erikseen, esimerkiksi lisätäksesi tunnisteen jokaiselle, voit käyttää Jokaiselle-toimintoa.
- Jos sinun on koottava tietoja, esimerkiksi laskeaksesi palautettujen tulosten määrän, voit käyttää Laske- tai Summa-toimintoja.
- Jos sinun on käytettävä luetteloa tulosteena, esimerkiksi lähettääksesi sähköpostin, joka sisältää kaikki tuotteet, voit käyttää palautettuja tietoja suoraan seuraavissa toiminnoissa.
Pääset käsiksi palautettuihin tietoihin tätä toimintoa seuraavissa vaiheissa käyttämällä muuttujaa nimeltä Nouda toistuvan tilauksen laskutusyrityksen tiedot, joka on luettelo toistuvien tilausten laskutusyrityksistä. Voit käyttää tätä muuttujaa sekä ehdoissa että toiminnoissa. Voit esimerkiksi lähettää luettelon toistuvien tilausten laskutusyrityksistä Lähetä sisäinen sähköposti -toiminnolla seuraavasti:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}Esimerkki
Esimerkiksi työnkulku on ajoitettu suoritettavaksi joka sunnuntai klo 9.00. Nouda toistuvan tilauksen laskutusyrityksen tiedot -toiminnolla kerätään tiedot viime viikolla luoduista toistuvien tilausten laskutusyrityksistä. Jos niissä on virheilmoitus, laskutusyritykset lähetetään sähköpostitse.