Recupera dati delle bozze di ordini

Nei flussi di lavoro che utilizzano i dati delle bozze di ordini, puoi utilizzare l'azione Recupera dati delle bozze di ordini per recuperare le informazioni sulle bozze di ordini dal tuo negozio.

Configurazione

Campi

L'azione Recupera dati delle bozze di ordini contiene i seguenti campi, che vengono utilizzati per creare la query:

Campi utilizzati nelle azioni Recupera dati.
CampoDescrizione
Ordina dati perObbligatorio. I parametri in base ai quali vengono ordinati i dati restituiti dalla query di ricerca.
Numero massimo di risultatiObbligatorio. Il numero massimo di risultati che possono essere restituiti dalla query di ricerca selezionata. Puoi restituirne fino a 100 alla volta.
QueryObbligatorio. Scegli tra le query comuni o seleziona Avanzate per crearne una personalizzata.

Stringa di query

Questo è un esempio di query per ottenere le bozze di ordini aggiornate nell'ultimo giorno:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

La variabile updated_at è un filtro disponibile nella query sulle bozze di ordini e può essere utilizzata più volte o combinata con altre variabili. La variabile Liquid scheduledAt è disponibile nei flussi di lavoro che utilizzano il trigger Ora pianificata. Il tag Liquid date_minus è un tag speciale di Flow che ti consente di sottrarre del tempo da una data.

Quando esegui una query sui dati, è utile sapere quanto segue:

  • Elenco dei filtri disponibili per gli ordini
  • 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 dell'API. In alternativa, puoi spesso trovare i valori dei campi negli URL nel pannello di controllo Shopify quando applichi un filtro. Ad esempio, per trovare alcuni valori di query per gli ordini, filtra la pagina Ordini nel pannello di controllo Shopify, quindi controlla l'URL.
  • Puoi eseguire o testare una query nel tuo negozio utilizzando l'app Shopify GraphiQL.
  • Presta attenzione a cosa succede se la query non va a buon fine. Spesso, l'API restituirà tutti i risultati (anziché nessuno).

Dati restituiti

Tutte le azioni Recupera dati restituiscono un elenco da 0 a 100 risorse. A seconda del tuo caso d'uso, potresti voler 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 il numero di risultati restituiti, puoi utilizzare le azioni Conteggio o Somma.
  • Se devi utilizzare l'elenco, 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 Get draft order data, che è un elenco di bozze di ordini. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco di bozze di ordini in un'azione Invia email interna in questo modo:

{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}

Trigger

Puoi utilizzare questa azione in qualsiasi flusso di lavoro, incluso il trigger Ora pianificata. In un flusso di lavoro che utilizza il trigger Ora pianificata, il flusso di lavoro si avvia a un orario da te specificato, anziché in seguito a un evento. Poiché non c'è un evento specifico nel tuo negozio o da un'app che avvia il flusso di lavoro, non vengono inclusi dati automaticamente.

Dettagli API

Modelli

Invia notifica giornaliera con tutte le bozze di ordini aperte

Ogni giorno, recupera le bozze di ordini aperte, le conta e invia un messaggio su Slack. Utilizza il trigger Ora pianificata e le azioni Recupera bozze di ordini e Conteggio. Visualizza modello