> ## 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.

# Déclencheurs et actions Shopify Flow pour la modification des commandes

> Tous les déclencheurs et actions Shopify Flow ajoutés par Revize, les tags de commande qu'il écrit, et des exemples de workflows : taguer les commandes modifiées, prévenir l'entrepôt, relancer les clients avant la fin des modifications et fermer les modifications au début de la préparation.

Revize est une application Shopify de modification des commandes après le checkout. Elle ajoute ses propres déclencheurs et actions à [Shopify Flow](https://apps.shopify.com/flow), pour que ta boutique réagisse quand un client modifie une commande, et pour que ton entrepôt ou d'autres applications puissent ouvrir ou fermer les modifications.

> [!NOTE]
>
> Dans Shopify Flow, clique sur **Select a trigger** (ou **Add action**) et recherche **Revize**. Shopify Flow est disponible sur tous les forfaits Shopify.

## Déclencheurs

Chaque déclencheur lance un workflow et transmet la commande, pour que les étapes suivantes puissent lire ses tags, ses articles et son client.

### Modifications du client

| Déclencheur | S'exécute quand |
| - | - |
| **Order edited** | une commande est modifiée, y compris les changements de produit et de code promo |
| **Shipping address updated** | un client met à jour l'adresse de livraison |
| **Shipping method updated** | un client met à jour le mode de livraison |
| **Email address updated** | un client met à jour l'e-mail |
| **Phone number updated** | un client met à jour le téléphone |
| **Delivery date updated** | un client met à jour la date de livraison |
| **Custom note added** | un client ajoute une note personnalisée |
| **Order cancelled** | un client annule une commande |
| **Support ticket created** | un client crée un ticket de support |
| **Tax invoice generated** | un client génère une facture |
| **Upsell accepted** | un client accepte un upsell Revize et l'article est ajouté. Transmet le titre de l'offre, le produit, la variante, la quantité, le montant, la devise et l'endroit où il a été accepté (`thank_you`, `order_status`, `checkout` ou `other`). |

### Fenêtre de modification et paiement

| Déclencheur | S'exécute quand | Champs utiles |
| - | - | - |
| **Edit window closing soon** | un délai défini avant la fermeture de la fenêtre de modification de la commande | `editDeadline`, `editDeadlineDisplay`, `hoursRemaining`, `hoursBeforeClose`, `orderStatusUrl` |
| **Edit window closed** | la fenêtre de modification de la commande se ferme | `closedAt`, `editDeadline`, `paymentCaptureEnabled` |
| **Edit window changed** | Revize publie un changement de la fenêtre | `changeType` (`reopened`, `extended`, `shortened`, `until_fulfillment`), `editDeadline`, `previousDeadline`, `source` (`staff`, `merchant`, `flow`, `automatic`), `reason` |
| **Payment captured** | Revize capture le paiement et confirme que la commande est payée | `capturedAmount`, `currencyCode`, `capturedAt` |
| **Payment capture failed** | une tentative de capture échoue | `reason` (`capture_declined`, `authorization_expired`, `outcome_unknown`, `retries_exhausted`), `remainingAmount`, `attemptNumber`, `willRetry` |
| **Unpaid edits reversed** | Revize annule des modifications impayées, ou l'annulation échoue | `outcome` (`reversed`, `failed`), `refundPending`, `remainingBalance` |

> [!NOTE]
>
> **Edit window closing soon** s'exécute aux heures de rappel que tu choisis dans Revize sous **Settings → General → Reminder before editing closes** (jusqu'à 3, Pro). Chaque rappel s'exécute une fois par commande, et à nouveau si le délai change.

## Actions

| Action | Ce qu'elle fait |
| - | - |
| **Close editing now** | Ferme les modifications de la commande et lance les vérifications normales de paiement et de fulfillment. **Reason** facultatif, affiché dans l'historique de la fenêtre de modification. |
| **Extend editing** | Ajoute des **Hours** (un nombre entier de 1 à 4319) à une fenêtre ouverte qui a un délai fixe. |
| **Reopen editing** | Ouvre les modifications pour le nombre d'**Hours** demandé quand la commande est éligible. |
| **Keep editing open until fulfillment** | Garde les modifications ouvertes jusqu'au traitement de la commande, quand la commande est éligible. |
| **Refund outstanding balance** | Rembourse ce que le client a payé en trop, par exemple après qu'une modification a baissé le total. |
| **Refund outstanding balance and report the result** | Le même remboursement, mais attend qu'il soit terminé et renvoie le résultat à ton workflow. |

> [!NOTE]
>
> **Reopen editing ignore les commandes qu'il ne doit pas toucher :** commandes déjà traitées ou partiellement traitées, déjà libérées vers le fulfillment ou portant le tag de libération, annulées, restreintes par des tags, ou avec un changement de paiement en attente. Les remboursements suivent ton [réglage de remboursement](https://docs.revize.app/fr/setup/payments-and-refunds.md) : **Original payment method** ou **Store credit**. Si rien n'est dû, ou si les remboursements sont sur **No refunds**, rien n'est remboursé.

## Tags écrits par Revize

Utilise-les comme conditions dans Flow, dans ton 3PL ou dans tes rapports.

| Tag | Ajouté quand |
| - | - |
| `revize:order_released` (ou ton tag de libération personnalisé) | les modifications se ferment, si **Add release tag** est activé |
| `revize:upsell` | une modification a augmenté la valeur de la commande |
| `revize:upsell_offer` | un client a accepté une offre d'upsell |
| `revize:order_downgraded` | une modification a baissé la valeur de la commande |
| `revize:reverse_unpaid` | Revize a annulé des modifications impayées |
| `revize:order_cancelled` | la commande a été annulée via Revize |
| `revize:withdrawal_requested` | un client a envoyé une demande de [rétractation UE](https://docs.revize.app/fr/features/eu-withdrawal.md) |

Le [moteur de règles](https://docs.revize.app/fr/setup/rules-engine.md) (Pro) peut aussi ajouter tes propres tags à la fermeture du délai de modification d'une commande, avec son action **Tag orders**.

## Exemples de workflows

> [accordion] Fermer les modifications quand l'entrepôt commence la préparation
>
> **Déclencheur :** le déclencheur Flow de ton WMS, ou **Order tags added** de Shopify quand le WMS écrit un tag comme `picked`.
>
> **Action :** **Close editing now** de Revize, avec le motif `Picking started`.
>
> Le client ne peut plus changer une commande que ton équipe emballe déjà. L'alternative par tag seulement : ajoute le même tag dans **Settings → Order editing → Editing restrictions → Order tags** dans Revize. Voir [Holds pour 3PL et entrepôt](https://docs.revize.app/fr/guides/3pl-warehouse-holds.md).

> [accordion] Relancer les clients avant la fin des modifications
>
> **Déclencheur :** **Edit window closing soon**.
>
> **Condition (facultative) :** `hoursBeforeClose` est égal au rappel voulu, si tu en as défini plusieurs.
>
> **Action :** envoie un e-mail ou un SMS depuis ton outil d'e-mailing avec `editDeadlineDisplay` et le lien `orderStatusUrl`, pour que le client puisse encore corriger une taille ou une adresse. Pour Klaviyo, voir le [guide Klaviyo](https://docs.revize.app/fr/integrations/klaviyo.md).

> [accordion] Prévenir l'équipe quand une commande modifiée a une nouvelle adresse
>
> **Déclencheur :** **Shipping address updated**.
>
> **Action :** ajoute un tag de commande comme `address-changed` ou publie dans Slack, pour que l'équipe revérifie les commandes déjà imprimées.

> [accordion] Faire un suivi quand une capture de paiement échoue
>
> **Déclencheur :** **Payment capture failed**.
>
> **Condition :** `willRetry` vaut false.
>
> **Action :** tague la commande `capture-failed` et préviens ta boîte finance. Revize t'envoie aussi un e-mail quand il arrête de réessayer.

## Bon à savoir

* **Les déclencheurs envoient chaque événement une fois**, une fois la modification terminée. Conçois des workflows qui restent sûrs si un événement manque, par exemple en vérifiant aussi les tags.
* **Les tags tardifs comptent.** Revize attend jusqu'à une minute après le checkout que Flow écrive des tags ou des métachamps avant de choisir une règle de modification : les tags Flow posés au checkout peuvent donc piloter les [règles](https://docs.revize.app/fr/setup/rules-engine.md).
* **L'orthographe compte.** La comparaison des tags ignore la casse, pas l'orthographe : un tag écrit par Flow doit être orthographié exactement comme le tag dans Revize.

## Voir aussi

* [Intégrations](https://docs.revize.app/fr/integrations/index.md) : 3PL, ERP et plateformes d'intégration
* [Klaviyo](https://docs.revize.app/fr/integrations/klaviyo.md) : envoyer des e-mails depuis les déclencheurs Revize
* [Moteur de règles](https://docs.revize.app/fr/setup/rules-engine.md) : délais, holds et tags par commande
* [Holds pour 3PL et entrepôt](https://docs.revize.app/fr/guides/3pl-warehouse-holds.md)


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