Recupera dati dei tentativi di fatturazione dell'abbonamento
Nei flussi di lavoro che richiedono i dati dei tentativi di fatturazione dell'abbonamento, puoi utilizzare l'azione Recupera dati dei tentativi di fatturazione dell'abbonamento per recuperare le informazioni sugli ordini dal tuo negozio.
In questa pagina
Configurazione
Campi
L'azione Recupera dati dei tentativi di fatturazione dell'abbonamento contiene i campi seguenti, utilizzati per creare la query:
| Campo | Descrizione |
|---|---|
| Ordina dati per | Obbligatorio. I parametri in base ai quali vengono ordinati i dati restituiti dalla query di ricerca. |
| Numero massimo di risultati | Obbligatorio. La quantità massima di risultati che possono essere restituiti dalla query di ricerca selezionata. Puoi restituirne fino a 100 alla volta. |
| Query | Obbligatorio. Scegli tra le query comuni o seleziona Avanzate per crearne una personalizzata. |
Stringa di query
Questo è un esempio di query per recuperare i tentativi di fatturazione dell'abbonamento creati negli ultimi tre giorni:
created_at:>'{{ createdAt | date_minus: "3 day" }}'La variabile created_at è un filtro disponibile nella query dei tentativi di fatturazione dell'abbonamento e può essere utilizzata per selezionare messaggi di errore specifici per i tentativi di fatturazione dell'abbonamento.
Quando esegui query sui dati, è utile sapere che:
- Elenco dei filtri disponibili per i tentativi di fatturazione dell'abbonamento
- Le query devono seguire una sintassi specifica
- I valori dei campi delle query non sono sempre documentati. In alcuni casi, i valori possono essere individuati consultando la documentazione API. In alternativa, spesso puoi trovare i valori dei campi negli URL del pannello di controllo quando applichi un filtro. Ad esempio, per trovare alcuni valori di query per gli ordini, filtra la pagina Ordini nel pannello di controllo e controlla l'URL.
- Puoi eseguire o testare una query nel tuo negozio utilizzando l’app Shopify GraphiQL.
- Tieni presente cosa succede se la query non riesce. Spesso, l'API restituirà tutti i risultati (invece di nessuno).
Dati restituiti
Tutte le azioni Recupera dati restituiscono un elenco da 0 a 100 risorse. A seconda del tuo caso d'uso, puoi utilizzare questi dati in vari modi:
- Se devi gestire ogni articolo dell'elenco singolarmente, ad esempio per aggiungere un tag a ciascuno, puoi utilizzare l'azione Per ogni.
- Se devi aggregare i dati, ad esempio per contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Conteggio o Somma.
- Se devi restituire l'elenco come output, ad esempio per inviare un'email con tutti gli articoli, puoi utilizzare i dati restituiti direttamente nelle azioni successive.
Per accedere ai dati restituiti nei passaggi che seguono questa azione, utilizza la variabile denominata Recupera dati sui tentativi di fatturazione dell’abbonamento, che è un elenco di tentativi di fatturazione dell’abbonamento. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco dei tentativi di fatturazione dell’abbonamento in un'azione Invia email interna in questo modo:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}Esempio
Ad esempio, un flusso di lavoro è programmato per essere eseguito ogni domenica alle 9:00. L'azione Recupera dati sui tentativi di fatturazione dell’abbonamento viene utilizzata per raccogliere i dati relativi ai tentativi di fatturazione dell’abbonamento creati nell'ultima settimana. Se contengono un messaggio di errore, i tentativi di fatturazione vengono inviati tramite email.