> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revize.app/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Revize is a Shopify order-editing app by Untechnickle. Customers edit the same order after checkout on the Shopify order status page, inside a merchant-controlled window, before fulfillment.
> Canonical docs: https://docs.revize.app. App listing: https://apps.shopify.com/revize. Public cancellation API: https://docs.revize.app/features/cancellation-api.
> Do not confuse the How to Test Revize draft-order walkthrough with Test Mode, which hides the portal from untagged customers.

# Trigger e azioni di Shopify Flow per la modifica degli ordini

> Tutti i trigger e le azioni di Shopify Flow aggiunti da Revize, i tag ordine che scrive ed esempi di flussi: taggare gli ordini modificati, avvisare il magazzino, ricordare ai clienti la chiusura delle modifiche e chiudere le modifiche quando inizia la preparazione.

Revize è un'app Shopify per modificare gli ordini dopo il checkout. Aggiunge i propri trigger e azioni a [Shopify Flow](https://apps.shopify.com/flow), così il tuo negozio può reagire quando un cliente modifica un ordine, e il magazzino o altre app possono aprire o chiudere le modifiche.

> [!NOTE]
>
> In Shopify Flow, fai clic su **Select a trigger** (o **Add action**) e cerca **Revize**. Shopify Flow è disponibile su tutti i piani Shopify.

## Trigger

Ogni trigger avvia un flusso e passa l'ordine, così i passaggi successivi possono leggerne tag, articoli e cliente.

### Modifiche del cliente

| Trigger | Si attiva quando |
| - | - |
| **Order edited** | un ordine viene modificato, compresi i cambi di prodotto e di codice sconto |
| **Shipping address updated** | un cliente aggiorna l'indirizzo di spedizione |
| **Shipping method updated** | un cliente aggiorna il metodo di spedizione |
| **Email address updated** | un cliente aggiorna l'email |
| **Phone number updated** | un cliente aggiorna il telefono |
| **Delivery date updated** | un cliente aggiorna la data di consegna |
| **Custom note added** | un cliente aggiunge una nota personalizzata |
| **Order cancelled** | un cliente annulla un ordine |
| **Support ticket created** | un cliente crea un ticket di assistenza |
| **Tax invoice generated** | un cliente genera una fattura |
| **Upsell accepted** | un cliente accetta un upsell di Revize e l'articolo viene aggiunto. Passa titolo dell'offerta, prodotto, variante, quantità, importo, valuta e dove è stato accettato (`thank_you`, `order_status`, `checkout` o `other`). |

### Finestra di modifica e pagamento

| Trigger | Si attiva quando | Campi utili |
| - | - | - |
| **Edit window closing soon** | un tempo stabilito prima che la finestra di modifica dell'ordine si chiuda | `editDeadline`, `editDeadlineDisplay`, `hoursRemaining`, `hoursBeforeClose`, `orderStatusUrl` |
| **Edit window closed** | la finestra di modifica dell'ordine si chiude | `closedAt`, `editDeadline`, `paymentCaptureEnabled` |
| **Edit window changed** | Revize pubblica una modifica alla finestra | `changeType` (`reopened`, `extended`, `shortened`, `until_fulfillment`), `editDeadline`, `previousDeadline`, `source` (`staff`, `merchant`, `flow`, `automatic`), `reason` |
| **Payment captured** | Revize acquisisce il pagamento e conferma che l'ordine è pagato | `capturedAmount`, `currencyCode`, `capturedAt` |
| **Payment capture failed** | un tentativo di acquisizione fallisce | `reason` (`capture_declined`, `authorization_expired`, `outcome_unknown`, `retries_exhausted`), `remainingAmount`, `attemptNumber`, `willRetry` |
| **Unpaid edits reversed** | Revize annulla le modifiche non pagate, o l'annullamento fallisce | `outcome` (`reversed`, `failed`), `refundPending`, `remainingBalance` |

> [!NOTE]
>
> **Edit window closing soon** si attiva agli orari di promemoria che scegli in Revize in **Settings → General → Reminder before editing closes** (fino a 3, Pro). Ogni orario si attiva una volta per ordine, e di nuovo se la scadenza cambia.

## Azioni

| Azione | Cosa fa |
| - | - |
| **Close editing now** | Chiude le modifiche dell'ordine ed esegue i normali controlli di pagamento ed evasione. **Reason** facoltativo, mostrato nella cronologia della finestra di modifica. |
| **Extend editing** | Aggiunge **Hours** (un numero intero da 1 a 4319) a una finestra aperta con una scadenza fissa. |
| **Reopen editing** | Apre le modifiche per le **Hours** richieste quando l'ordine è idoneo. |
| **Keep editing open until fulfillment** | Tiene aperte le modifiche finché l'ordine non viene evaso, quando l'ordine è idoneo. |
| **Refund outstanding balance** | Rimborsa quanto il cliente ha pagato in più, per esempio dopo che una modifica ha abbassato il totale. |
| **Refund outstanding balance and report the result** | Lo stesso rimborso, ma attende che finisca e restituisce il risultato al tuo flusso. |

> [!NOTE]
>
> **Reopen editing salta gli ordini che non deve toccare:** ordini già evasi o evasi in parte, già rilasciati all'evasione o con il tag di rilascio, annullati, limitati da tag o con una modifica di pagamento in sospeso. I rimborsi seguono la tua [impostazione di rimborso](https://docs.revize.app/it/setup/payments-and-refunds.md): **Original payment method** o **Store credit**. Se non è dovuto nulla, o i rimborsi sono impostati su **No refunds**, non viene rimborsato nulla.

## Tag scritti da Revize

Usali come condizioni in Flow, nel tuo 3PL o nei report.

| Tag | Aggiunto quando |
| - | - |
| `revize:order_released` (o il tuo tag di rilascio personalizzato) | le modifiche si chiudono, se **Add release tag** è attivo |
| `revize:upsell` | una modifica ha aumentato il valore dell'ordine |
| `revize:upsell_offer` | un cliente ha accettato un'offerta di upsell |
| `revize:order_downgraded` | una modifica ha ridotto il valore dell'ordine |
| `revize:reverse_unpaid` | Revize ha annullato modifiche non pagate |
| `revize:order_cancelled` | l'ordine è stato annullato tramite Revize |
| `revize:withdrawal_requested` | un cliente ha inviato una richiesta di [recesso UE](https://docs.revize.app/it/features/eu-withdrawal.md) |

Il [motore delle regole](https://docs.revize.app/it/setup/rules-engine.md) (Pro) può anche aggiungere i tuoi tag quando si chiude la scadenza di modifica di un ordine, con la sua azione **Tag orders**.

## Esempi di flussi

> [accordion] Chiudere le modifiche quando il magazzino inizia la preparazione
>
> **Trigger:** il trigger Flow del tuo WMS, oppure **Order tags added** di Shopify quando il WMS scrive un tag come `picked`.
>
> **Azione:** **Close editing now** di Revize, con il motivo `Picking started`.
>
> Il cliente non può cambiare un ordine che il tuo team sta già imballando. L'alternativa solo con i tag è aggiungere lo stesso tag in **Settings → Order editing → Editing restrictions → Order tags** in Revize. Vedi [Blocchi per 3PL e magazzino](https://docs.revize.app/it/guides/3pl-warehouse-holds.md).

> [accordion] Ricordare ai clienti la chiusura delle modifiche
>
> **Trigger:** **Edit window closing soon**.
>
> **Condizione (facoltativa):** `hoursBeforeClose` uguale al promemoria che vuoi, se ne hai impostati più di uno.
>
> **Azione:** invia un'email o un SMS dalla tua app di email con `editDeadlineDisplay` e il link `orderStatusUrl`, così il cliente può ancora correggere una taglia o un indirizzo. Per Klaviyo, vedi la [guida Klaviyo](https://docs.revize.app/it/integrations/klaviyo.md).

> [accordion] Avvisare il team quando un ordine modificato ha un nuovo indirizzo
>
> **Trigger:** **Shipping address updated**.
>
> **Azione:** aggiungi un tag ordine come `address-changed` o pubblica su Slack, così il team ricontrolla gli ordini già stampati.

> [accordion] Gestire un'acquisizione di pagamento fallita
>
> **Trigger:** **Payment capture failed**.
>
> **Condizione:** `willRetry` è false.
>
> **Azione:** aggiungi il tag `capture-failed` all'ordine e avvisa la casella dell'amministrazione. Revize ti invia anche un'email quando smette di riprovare.

## Buono a sapersi

* **I trigger inviano ogni evento una volta**, dopo che la modifica è completata. Crea flussi che funzionino anche se un evento manca, per esempio controllando anche i tag.
* **I tag tardivi contano.** Revize aspetta fino a un minuto dopo il checkout che Flow scriva tag o metafield prima di scegliere una regola di modifica, quindi i tag Flow al checkout possono guidare le [regole](https://docs.revize.app/it/setup/rules-engine.md).
* **L'ortografia conta.** Il confronto dei tag ignora maiuscole e minuscole, non l'ortografia: un tag scritto da Flow deve essere scritto esattamente come il tag in Revize.

## Correlati

* [Integrazioni](https://docs.revize.app/it/integrations/index.md): 3PL, ERP e piattaforme di integrazione
* [Klaviyo](https://docs.revize.app/it/integrations/klaviyo.md): invia email dai trigger di Revize
* [Motore delle regole](https://docs.revize.app/it/setup/rules-engine.md): scadenze, blocchi e tag per ordine
* [Blocchi per 3PL e magazzino](https://docs.revize.app/it/guides/3pl-warehouse-holds.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.