Trigger del metacampo "Azienda"

Trigger del metacampo "Azienda"

Copia pagina

Avvia un workflow Shopify Flow quando cambia un metacampo di un'azienda B2B, come il limite di credito, e ricevi il valore precedente e quello nuovo.

Un grossista registra il credito concordato per ciascun cliente B2B nel metacampo aziendale Limite di credito (custom.credit_limit). Quando il reparto finanziario lo aumenta o lo riduce, il responsabile del cliente deve esserne informato prima dell’ordine successivo.

In questa pagina viene illustrato come avviare un workflow Shopify Flow ogni volta che un metacampo di un’azienda subisce una modifica, utilizzando Workflow Trigger Extensions. I passaggi sono gli stessi per ogni metacampo di questo tipo di risorsa; nell’esempio viene utilizzato il Limite di credito (custom.credit_limit).

Cosa vi serve

  • Una definizione di metacampo. La crei nella Sua area di amministrazione di Shopify alla voce Impostazioni > Metacampi e metaoggetti > Aziende. Un metacampo privo di definizione non può essere monitorato.
  • L'autorizzazione Accesso ai dati relativi alle aziende e alle loro sedi (B2B). La si concede nella pagina Autorizzazioni dell'app; si veda Autorizzazioni e accesso ai dati.
  • Le aziende fanno parte del segmento B2B su Shopify. Il tipo di risorsa è utile solo in un negozio che dispone di aziende.

1. Monitorare il metacampo

  1. Apra la sezione Trigger dei metacampi nell'app e faccia clic su Aggiungi trigger.
  2. Selezioni il tipo di risorsa Azienda.
  3. Selezioni il metacampo, in questo caso Limite di credito. È possibile selezionarne diversi contemporaneamente oppure utilizzare l’opzione Seleziona tutto.
  4. 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 quelli singoli, quindi fate clic su Monitora tutti i metacampi.

La finestra di dialogo “Aggiungi trigger metafield” con il tipo di risorsa “Azienda” e il metacampo “Limite di credito” (custom.credit_limit) selezionato
Tipo di risorsa: Azienda, con il metacampo selezionato. L’opzione “Tutti i metacampi” tiene invece traccia di tutti i metacampi del tipo.

Il nuovo trigger mostra il messaggio Inizializzazione mentre l’app legge il valore corrente del metacampo relativo alle vostre aziende esistenti, per poi passare allo stato Attivo. È proprio grazie a questa prima lettura che la primissima modifica giunge già con il corretto valore precedente.

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 COMPANY
resourceId L'ID dell'azienda, ad esempio gid://shopify/Company/1234567890
metafieldKey Spazio dei nomi e chiave, in questo caso custom.credit_limit
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

  1. In Shopify Flow, crei un workflow e selezioni il trigger Aggiornamento metacampo delle estensioni Workflow Trigger Extensions.
  2. Aggiunga una condizione: resourceType è uguale a COMPANY. L'aggiornamento dei metacampi viene avviato per ogni tipo di risorsa che monitora, pertanto questa condizione limita il workflow alle aziende. Qualora monitori diversi metacampi di questo tipo, aggiunga come secondo criterio che metafieldKey sia uguale a custom.credit_limit.
  3. Aggiunga l'azione desiderata. Nell'esempio viene inviata un'e-mail interna contenente il valore precedente e quello nuovo.
Il workflow di esempio in Shopify Flow: Aggiornamento del metacampo, una condizione relativa al tipo di risorsa AZIENDA e invio di un’e-mail interna
Esempio di workflow: il trigger, la condizione relativa al tipo di risorsa e un’azione.

Si parta dall'esempio

  1. Scarichi il file .flow allegato in fondo a questa pagina.
  2. Nella dashboard di Shopify, apra Shopify Flow, faccia clic su Importa e selezioni il file.
  3. Apra la fase Invia e-mail interna e inserisca il destinatario. Il file non contiene alcun indirizzo, intenzionalmente.
  4. Attivi il workflow.

Lo renda suo

  • Confronti metafield.previousValue con metafield.value per distinguere un aumento da una riduzione.
  • Invii il nuovo limite al Suo sistema ERP tramite la funzione Invia richiesta HTTP.
  • Aggiunga una condizione relativa a metafieldKey quando effettua il monitoraggio di diversi metacampi aziendali.

Con quale rapidità reagisce

Shopify invia una notifica all’app quando viene salvata un’azienda. Nel caso di una modifica che riguarda esclusivamente un metacampo, talvolta non viene inviata alcuna notifica; pertanto, l’app verifica lo stato delle vostre aziende circa una volta al minuto. Il workflow dovrebbe avviarsi nel giro di pochi secondi e, al più tardi, entro uno o due minuti.

Altro