Reso aggiornato
Il trigger Reso aggiornato avvia un flusso di lavoro quando nel negozio cambiano uno o più campi di un reso, delle sue voci o dei suoi ordini di evasione stornati. Scegli i campi del reso che ti interessano e il flusso di lavoro viene eseguito solo quando uno di questi campi cambia, ad esempio quando cambia lo stato del reso o viene aggiunta una commissione di riassortimento.
Per avviare un flusso di lavoro quando un reso raggiunge una fase specifica, puoi anche usare un trigger per quella fase, come Reso richiesto, Reso approvato o Reso chiuso.
In questa pagina
Campi disponibili per il monitoraggio
Il trigger Reso aggiornato richiede di selezionare almeno un campo da monitorare. Puoi selezionare fino a cinque campi. Quando uno dei campi selezionati cambia, viene eseguito il flusso di lavoro. Le modifiche ai campi che non hai selezionato non avviano il flusso di lavoro.
Consulta la tabella seguente per maggiori informazioni sui campi che puoi monitorare.
| Tipo di campo | Campi |
|---|---|
| Reso | closedAt, decline, requestApprovedAt, status |
| Voci del reso | returnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity |
| Voci del cambio | exchangeLineItems |
| Spese per il reso | returnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney |
| Ordini di evasione stornati | reverseFulfillmentOrders, reverseFulfillmentOrders.lineItems, reverseFulfillmentOrders.status |
Un campo il cui nome termina con amountSet contiene un importo espresso in due valute. Quando monitori questo campo, una modifica a uno dei due importi avvia il flusso di lavoro. Per monitorare solo uno degli importi, seleziona il sottocampo shopMoney per l’importo nella valuta del negozio oppure il sottocampo presentmentMoney per l’importo nella valuta del cliente.
Alcuni campi avviano il flusso di lavoro anche quando un articolo viene aggiunto al reso o rimosso dal reso:
- Se monitori un campo del gruppo Voci del reso, l’aggiunta o la rimozione di una voce dal reso avvia il flusso di lavoro.
- Se monitori un campo relativo alla commissione di riassortimento, come
returnLineItems.restockingFee.percentage, l’aggiunta o la rimozione di una commissione di riassortimento per una voce avvia il flusso di lavoro. - Se monitori il campo
exchangeLineItems, l’aggiunta o la rimozione di un articolo di cambio dal reso avvia il flusso di lavoro. - Se monitori un campo nel gruppo Spese per il reso, l’aggiunta o la rimozione di una spesa per il reso avvia il flusso di lavoro.
- Se monitori un campo nel gruppo Ordini di evasione stornati, l’aggiunta di un ordine di evasione stornato al reso avvia il flusso di lavoro. Se monitori il campo
reverseFulfillmentOrderso il camporeverseFulfillmentOrders.lineItems, anche la rimozione di una voce da un ordine di evasione stornato avvia il flusso di lavoro.
Seleziona i campi che avviano il flusso di lavoro
Seleziona i campi le cui modifiche avviano il flusso di lavoro.
Passaggi:
- Nell’editor del flusso di lavoro, clicca sul trigger Reso aggiornato.
- Nella sezione Seleziona campi del reso, clicca su Seleziona campi.
- Nella finestra di dialogo Aggiungi campo da monitorare, cerca il campo da monitorare o individualo sfogliando l’elenco, quindi selezionalo.
- Facoltativo: ripeti i passaggi 2 e 3 per monitorare fino a cinque campi.
Campi
Il trigger Reso aggiornato contiene i seguenti campi, che possono essere usati nelle condizioni e nelle azioni e per ottenere dati nel flusso di lavoro. I campi Reso e Negozio sono sempre disponibili. Gli altri campi sono disponibili solo quando monitori un campo correlato. Ad esempio, il campo Ordine di evasione stornato è disponibile quando monitori un campo relativo a un ordine di evasione stornato, come reverseFulfillmentOrders.status.
| Campo | Descrizione |
|---|---|
| Reso | Il reso che è stato aggiornato. |
| Negozio | Il negozio in cui è stato aggiornato il reso. |
| Voce del reso | La voce del reso modificata. Il campo è vuoto quando è stata rimossa una voce dal reso. Disponibile quando monitori returnLineItems.quantity o un campo relativo alla commissione di riassortimento. |
| Voce del cambio | La voce del cambio aggiunta. Il campo è vuoto quando è stata rimossa una voce del cambio. Disponibile quando monitori il campo exchangeLineItems. |
| Ordine di evasione stornato | L’ordine di evasione stornato che è stato modificato. Disponibile quando monitori un campo relativo a un ordine di evasione stornato. |
Se monitori campi di tipi diversi, i campi Voce del reso, Voce del cambio e Ordine di evasione stornato possono essere vuoti quando viene eseguito il flusso di lavoro. Ad esempio, se monitori sia status sia returnLineItems.quantity, il campo Voce del reso è vuoto quando cambia solo lo stato. I campi Voce del reso e Voce del cambio possono essere vuoti anche quando monitori solo campi del rispettivo tipo. Prima di usare uno di questi campi in un’azione, aggiungi una condizione che verifichi che il campo contenga un valore.
Il trigger Reso aggiornato fornisce solo i valori attuali del reso e delle sue voci. I valori precedenti dei campi modificati non sono disponibili nel flusso di lavoro. Ad esempio, se monitori il campo status, puoi usare lo stato attuale del reso in una condizione o in un’azione, ma non puoi usare lo stato precedente alla modifica.
Azioni
Questo trigger fornisce un oggetto reso, quindi consente di usare qualsiasi azione che richieda un reso. Inoltre, poiché l’oggetto reso include un ordine, il trigger può essere usato con qualsiasi azione relativa agli ordini, tra cui:
- Aggiungi voce all’ordine
- Aggiungi tag all’ordine
- Archivia ordine
- Annulla ordine
- Acquisisci pagamento
- Sospendi ordine di evasione
- Segna ordine come pagato
Gli ordini consentono di accedere ad altri dati, come quelli del cliente, quindi il trigger può essere usato con le azioni relative ai clienti, tra cui:
- Aggiungi tag al cliente
- Rimuovi metafield del cliente
- Rimuovi tag del cliente
- Aggiorna metafield del cliente
- Aggiorna nota cliente
Gli ordini contengono anche elenchi di dati, come le voci. Con un’azione Per ogni, puoi scorrere questi elenchi ed eseguire azioni su ciascun elemento. Ad esempio, puoi scorrere le voci e aggiungere un tag a ciascun prodotto.
Test del trigger Reso aggiornato
Per testare un flusso di lavoro che si avvia con questo trigger, attiva il flusso di lavoro, quindi modifica uno dei campi monitorati in un reso nel pannello di controllo Shopify. Ad esempio, crea un reso, quindi elabora il reso o chiudi il reso.
Dettagli API
Il trigger Reso aggiornato consente di eseguire azioni con l’oggetto Return dell’API GraphQL. Questo trigger corrisponde all’azione update dell’argomento Return nella documentazione di riferimento di Shopify Events, filtrata in base ai campi che scegli di monitorare.