Preluare date despre încercarea de facturare a abonamentului
În fluxurile de lucru care necesită date despre încercarea de facturare a abonamentului, puteți utiliza acțiunea Preluare date despre încercarea de facturare a abonamentului pentru a recupera informații despre comenzi din magazinul dvs.
Pe această pagină
Configurare
Câmpuri
Acțiunea Preluare date despre încercarea de facturare a abonamentului conține următoarele câmpuri, care sunt utilizate pentru a construi interogarea:
| Câmp | Descriere |
|---|---|
| Sortare date după | Obligatoriu. Parametrii după care sunt sortate datele returnate de interogarea de căutare. |
| Număr maxim de rezultate | Obligatoriu. Numărul maxim de rezultate care pot fi returnate de interogarea de căutare pe care o selectați. Puteți returna până la 100 de rezultate odată. |
| Interogare | Obligatoriu. Alegeți dintre interogările comune sau selectați Avansat pentru a vă crea propria interogare. |
Șir de interogare
Acesta este un exemplu de interogare pentru obținerea încercărilor de facturare a abonamentelor care au fost create în ultimele trei zile:
created_at:>'{{ createdAt | date_minus: "3 day" }}'Variabila created_at este un filtru disponibil în interogarea pentru încercarea de facturare a abonamentului și poate fi utilizată pentru a selecta un mesaj de eroare specific pentru încercările de facturare a abonamentelor.
Când interogați date, este util să știți:
- Lista filtrelor disponibile pentru încercarea de facturare a abonamentului
- Interogările trebuie să respecte o anumită sintaxă
- Valorile câmpurilor de interogare nu sunt întotdeauna documentate. În unele cazuri, valorile pot fi găsite consultând documentația API. Alternativ, puteți găsi adesea valorile câmpurilor în adresele URL din panoul de administrare atunci când filtrați. De exemplu, pentru a găsi unele valori de interogare pentru comenzi, filtrați pagina Comenzi din panoul de administrare, apoi verificați adresa URL.
- Puteți rula sau testa o interogare în magazinul dvs. utilizând aplicația Shopify GraphiQL.
- Fiți atenți la ce se întâmplă dacă interogarea dvs. eșuează. Adesea, API-ul va returna toate rezultatele (în loc de niciunul).
Date returnate
Toate acțiunile Obținere date returnează o listă de la 0 la 100 de resurse. În funcție de cazul dvs. de utilizare, este posibil să doriți să utilizați aceste date în diverse moduri:
- Dacă trebuie să gestionați individual fiecare articol din listă, de exemplu, pentru a adăuga o etichetă pentru fiecare, atunci puteți utiliza acțiunea Pentru fiecare.
- Dacă trebuie să agregați date, cum ar fi să numărați câte rezultate au fost returnate, puteți utiliza acțiunile Numărare sau Sumă.
- Dacă trebuie să redați lista ca rezultat, de exemplu, să trimiteți un e-mail cu toate articolele, puteți utiliza datele returnate direct în acțiunile ulterioare.
Pentru a accesa datele returnate în pașii care urmează acestei acțiuni, utilizați variabila denumită Obținere date despre încercarea de facturare a abonamentului, care este o listă de încercări de facturare a abonamentelor. Puteți utiliza această variabilă atât în condiții, cât și în acțiuni. De exemplu, puteți trimite lista de încercări de facturare a abonamentelor într-o acțiune Trimitere e-mail intern, astfel:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}Exemplu
De exemplu, un flux de lucru este programat să ruleze în fiecare duminică la ora 9:00. Acțiunea Obținere date despre încercarea de facturare a abonamentului este utilizată pentru a colecta date pentru încercările de facturare a abonamentelor create în ultima săptămână. Dacă acestea au un mesaj de eroare, atunci încercările de facturare sunt trimise prin e-mail.