Recupera dati della sessione di tracciamento dei contanti
Nei flussi di lavoro che richiedono i dati della sessione di tracciamento dei contanti, puoi utilizzare l'azione Recupera dati della sessione di tracciamento dei contanti per recuperare le informazioni sulla sessione di tracciamento dei contanti dal tuo POS Pro. Le sessioni di tracciamento dei contanti vengono utilizzate per tracciare i contanti nei registri di cassa del tuo negozio.
In questa pagina
Configurazione
Campi
L'azione Recupera dati della sessione di tracciamento dei contanti contiene i seguenti campi.
| 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 restituire fino a 100 risultati 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 ottenere le sessioni di tracciamento dei contanti chiuse nell'ultimo giorno:
closing_time:<='{{ scheduledAt }}' AND closing_time:>'{{ scheduledAt | date_minus: "1 day" }}'La variabile closing_time è un filtro disponibile nella query CashTrackingSessions e può essere utilizzata più volte o combinata con altre variabili. La variabile Liquid scheduledAt è disponibile sui flussi di lavoro che hanno utilizzato il trigger Orario pianificato. Il tag Liquid date_minus è uno speciale tag di Flow che ti consente di sottrarre del tempo da una data.
Quando esegui una query sui dati, è utile sapere che:
Elenco dei filtri disponibili per la sessione di tracciamento dei contanti
Le query devono seguire una determinata sintassi
I valori dei campi di query non sono sempre documentati. In alcuni casi, i valori si possono trovare consultando la documentazione API. In alternativa, spesso puoi trovare i valori dei campi negli URL nel pannello di controllo quando applichi un filtro. Ad esempio, per trovare alcuni valori della query Ordine, filtra la pagina Ordini nel pannello di controllo, quindi 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, potresti voler utilizzare questi dati in vari modi:
- Se devi gestire ogni articolo dell'elenco singolarmente, ad esempio per aggiungere un tag per ciascuno, puoi utilizzare l'azione Per ciascuno.
- Se devi aggregare i dati, ad esempio per contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Conteggio o Somma.
- Se devi generare 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 Get cash tracking session data, che è un elenco di sessioni di tracciamento dei contanti. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco delle sessioni di tracciamento dei contanti in un'azione Invia email interna in questo modo:
{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}Trigger
Puoi utilizzare questa azione in qualsiasi flusso di lavoro, incluso il trigger Orario pianificato. In un flusso di lavoro che utilizza il trigger Orario pianificato, 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 avvii il flusso di lavoro, non ci sono dati inclusi automaticamente.
Riferimento API
Per maggiori informazioni sull'API utilizzata in questa azione, consulta la query CashTrackingSessions.