Ottenimento dei dati del tentativo di fatturazione dell'abbonamento
Nei flussi di lavoro che richiedono i dati dei tentativi di fatturazione dell'abbonamento, puoi utilizzare l'azione Get subscription billing attempt data (Ottieni i dati del tentativo di fatturazione dell'abbonamento) per recuperare le informazioni sull'ordine dal tuo negozio.
Su questa pagina
Configurazione
Campi
L'azione Get subscription billing attempt data (Ottieni i dati del tentativo di fatturazione dell'abbonamento) contiene i seguenti campi, utilizzati per creare la query:
| Campo | Descrizione |
|---|---|
| Sort data by (Ordina dati per) | Obbligatorio. I parametri secondo i quali vengono ordinati i dati restituiti dalla query di ricerca. |
| Maximum number of results (Numero massimo di risultati) | Obbligatorio. Il numero massimo di risultati che possono essere restituiti dalla query di ricerca selezionata. Possono esserne restituiti fino a 100 alla volta. |
| Query | Obbligatorio. Scegli tra le query più comuni o seleziona Advanced (Avanzato) per crearne di nuove. |
Stringa di query
Questa è una query di esempio per ottenere 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 un messaggio di errore specifico per i tentativi di fatturazione dell'abbonamento.
Quando si eseguono query sui dati, è utile conoscere quanto segue:
- Elenco dei filtri dei tentativi di fatturazione degli abbonamenti disponibili - Le query devono seguire una determinata sintassi.
- I nomi dei campi di query per tutte le query sono disponibili nella documentazione per sviluppatori relativa all'oggetto QueryRoot.
- I valori dei campi di query non sono sempre documentati. In alcuni casi, si possono trovare consultando i documenti API. In alternativa, spesso puoi trovare i valori dei campi negli URL nel pannello di controllo quando applichi filtri. Ad esempio, per trovare alcuni valori di query degli ordini, filtra la pagina Ordini nel pannello di controllo e verifica l'URL.
- Puoi eseguire o provare una query nel tuo negozio utilizzando l'app GraphiQL di Shopify.
- Presta attenzione a cosa succede se la query non va a buon fine. Spesso l'API restituisce tutti i risultati (anziché nessuno).
Dati restituiti
Tutte le azioni Get data (Ottieni dati) restituiscono un elenco contenente da 0 a 100 risorse. A seconda del tuo caso d'uso, potresti utilizzare questi dati in diversi modi:
- Se devi gestire singolarmente ogni voce di elenco, ad esempio per aggiungere un tag per ogni voce, puoi utilizzare l'azione For each (Per ogni).
- Se devi aggregare i dati, ad esempio contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Count (Conta) o Sum (Somma).
- Se hai bisogno di generare l'elenco, ad esempio per inviare un'email con tutte le voci, puoi utilizzare i dati restituiti direttamente nelle azioni successive.
Per accedere ai dati restituiti nei passaggi che seguono questa azione, utilizza la variabile denominata Get subscription billing attempt data (Ottieni i dati del tentativo di fatturazione dell'abbonamento), che è una lista dei 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 Send internal email (Invia email interna) in questo modo:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}Esempio
Ad esempio, un flusso di lavoro è programmato per l'esecuzione ogni domenica alle 9:00. L'azione Get subscription billing attempt data (Ottieni i dati del tentativo di fatturazione dell'abbonamento) viene utilizzata per raccogliere i dati relativi ai tentativi di fatturazione dell'abbonamento creati nell'ultima settimana. Se viene visualizzato un messaggio di errore, invia un'email con i tentativi di fatturazione.