Trigger del metacampo "Bozza d'ordine"
Avvia un workflow Shopify Flow quando cambia un metacampo di una bozza d'ordine e ottieni il valore precedente e quello nuovo.
Un team di vendita gestisce i preventivi come bozze d'ordine e ne registra lo stato nel metacampo Stato del preventivo (custom.quote_status) della bozza d'ordine. Quando un preventivo passa allo stato approved, occorre informare la persona incaricata di emettere la fattura.
In questa pagina viene illustrato come avviare un workflow Shopify Flow ogni volta che un metacampo di una bozza d'ordine subisce una modifica, utilizzando Workflow Trigger Extensions. I passaggi sono gli stessi per ogni metacampo di questo tipo di risorsa; nell’esempio viene utilizzato lo stato del preventivo (custom.quote_status).
Cosa vi serve
- Una definizione di metacampo. La crei nella Sua area di amministrazione di Shopify alla voce Impostazioni > Metacampi e metaoggetti > Bozze d'ordine. Un metacampo privo di definizione non può essere monitorato.
- L'autorizzazione Bozza d'ordine Data Access. Concedetela nella pagina Autorizzazioni dell'app; consultate Autorizzazioni e accesso ai dati.
1. Monitorare il metacampo
- Apra la sezione Trigger dei metacampi nell'app e faccia clic su Aggiungi trigger.
- Selezioni il tipo di risorsa Bozza d'ordine.
- Selezioni il metacampo, in questo caso Stato del preventivo. È possibile selezionarne più di uno alla volta oppure utilizzare l’opzione Seleziona tutto.
- Fare clic su Aggiungi trigger.
Per monitorare tutti i metacampi di questo tipo di risorsa, compresi quelli che creerete in seguito, selezionate Tutti i metacampi anziché spuntare i singoli campi, quindi fate clic su Monitora tutti i metacampi.

Il nuovo trigger visualizza il messaggio Inizializzazione mentre l’app legge il valore corrente del metacampo presente nelle Suoi bozze d'ordine esistenti, per poi passare allo stato Attivo. È proprio grazie a quella prima lettura che la primissima modifica viene già fornita con il valore precedente corretto.
Se il metacampo non è presente nell'elenco, faccia clic su Aggiorna metacampo nella pagina "Trigger dei metacampi": l'app memorizza l'elenco delle definizioni per un'ora.
2. Cosa riceve il workflow
Ogni modifica attiva il trigger Metacampo Update in Shopify Flow con i seguenti valori:
| Variabile | Valore |
|---|---|
resourceType |
DRAFTORDER |
resourceId |
L'ID della bozza d'ordine, ad esempio gid://shopify/DraftOrder/1234567890 |
metafieldKey |
Spazio dei nomi e chiave, in questo caso custom.quote_status |
metafield.value |
Il nuovo valore |
metafield.previousValue |
Il valore precedente alla modifica; vuoto quando il metacampo è stato impostato per la prima volta |
metafield.type |
Il tipo del metacampo, ad esempio single_line_text_field |
3. Creare il workflow
- In Shopify Flow, crei un workflow e selezioni il trigger Aggiornamento metacampo delle estensioni Workflow Trigger Extensions.
- Aggiunga una condizione:
resourceTypeè uguale aDRAFTORDER. L'aggiornamento del metacampo viene avviato per ogni tipo di risorsa che monitora, pertanto questa condizione limita il workflow alle bozze d'ordine. Qualora monitori diversi metacampi di questo tipo, aggiunga come secondo criterio chemetafieldKeysia uguale acustom.quote_status. - Aggiunga l'azione desiderata. Nell'esempio viene inviata un'e-mail interna contenente il valore precedente e quello nuovo.

Si parta dall'esempio
- Scarichi il file
.flowallegato in fondo a questa pagina. - Nella dashboard di Shopify, apra Shopify Flow, faccia clic su Importa e selezioni il file.
- Apra la fase Invia e-mail interna e inserisca il destinatario. Il file non contiene alcun indirizzo, intenzionalmente.
- Attivi il workflow.
Lo renda suo
- Aggiunga una condizione su
metafield.valueaffinché si attivi solo in caso diapproved. - Contrassegnare la bozza d'ordine: aggiungere l’azione Aggiungi tag di ordine alla bozza d'ordine e inserire
{{resourceId}}nel campo relativo all’ordine della bozza d'ordine. - Invii le modifiche al Suo CRM tramite la funzione Invia richiesta HTTP.
Con quale rapidità reagisce
Shopify invia una notifica all'app quando viene salvata una bozza d'ordine, pertanto il workflow si avvia solitamente nel giro di pochi secondi.
Altro
- Trigger dei metacampi: come funzionano i trigger dei metacampi, per ogni tipo di risorsa.
- Cronologia degli eventi e risoluzione dei problemi: visualizza tutti gli eventi inviati dall'app, con il valore precedente e quello nuovo.
