Získať údaje o pokusoch o fakturáciu predplatného

V pracovných postupoch, ktoré vyžadujú údaje o pokusoch o fakturáciu predplatného, môžete pomocou akcie Získať údaje o pokusoch o fakturáciu predplatného získať informácie o objednávkach z vášho obchodu.

Konfigurácia

Polia

Akcia Získať údaje o pokusoch o fakturáciu predplatného obsahuje nasledujúce polia, ktoré sa používajú na vytvorenie dopytu:

Reťazec dopytu

Toto je príklad dopytu na získanie pokusov o fakturáciu predplatného, ktoré sa vytvorili za posledné tri dni:

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

Premenná created_at je filter dostupný v dopyte na pokus o fakturáciu predplatného a umožňuje vybrať konkrétne chybové hlásenie pre pokusy o fakturáciu predplatného.

Pri dopytovaní údajov je užitočné vedieť:

• Zoznam dostupných filtrov pre pokusy o fakturáciu predplatného
• Dopyty musia dodržiavať určitú syntax
• Hodnoty polí dopytov nie sú vždy zdokumentované. V niektorých prípadoch je možné hodnoty nájsť v dokumentácii k rozhraniu API. Prípadne môžete hodnoty polí často nájsť v adresách URL v administrátorskom paneli pri filtrovaní. Ak chcete napríklad nájsť hodnoty dopytu pre objednávky, vyfiltrujte stránku Objednávky v administrátorskom paneli a potom skontrolujte adresu URL.
• Dopyt môžete vo svojom obchode spustiť alebo otestovať pomocou aplikácie Shopify GraphiQL.
• Majte na pamäti, čo sa stane v prípade zlyhania dopytu. Rozhranie API často vráti všetky výsledky (namiesto žiadnych).

Vrátené údaje

Všetky akcie typu Získať údaje vracajú zoznam s 0 až 100 prostriedkami. V závislosti od vášho prípadu použitia môžete tieto údaje využiť rôznymi spôsobmi:

• Ak potrebujete spracovať každú položku zoznamu samostatne, napríklad ku každej pridať štítok, môžete použiť akciu Pre každé.
• Ak potrebujete agregovať údaje, napríklad zistiť počet vrátených výsledkov, môžete použiť akcie Počet alebo Súčet.
• Ak potrebujete vytvoriť výstup zoznamu, napríklad odoslať e-mail so všetkými položkami, vrátené údaje môžete použiť priamo v nasledujúcich akciách.

Ak chcete získať prístup k vráteným údajom v krokoch nasledujúcich po tejto akcii, použite premennú s názvom Získať údaje o pokusoch o fakturáciu predplatného, čo je zoznam pokusov o fakturáciu predplatného. Túto premennú môžete použiť v podmienkach aj akciách. Zoznam pokusov o fakturáciu predplatného môžete napríklad odoslať v akcii Odoslať interný e-mail takto:

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

Príklad

Napríklad spustenie pracovného postupu je naplánované na každú nedeľu o 9:00. Akcia Získať údaje o pokusoch o fakturáciu predplatného sa používa na zhromaždenie údajov o pokusoch o fakturáciu predplatného vytvorených za posledný týždeň. Ak obsahujú chybové hlásenie, odošlite e-mail s pokusmi o fakturáciu.

Referenčná príručka k rozhraniu API

• Zdroj pokusu o fakturáciu predplatného
• Filtre vyhľadávacieho dopytu pre pokusy o fakturáciu predplatného