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

# Shopify-Flow-Trigger und -Aktionen für die Bestellbearbeitung

> Alle Shopify-Flow-Trigger und -Aktionen von Revize, die Bestell-Tags, die Revize setzt, und Beispiel-Workflows: bearbeitete Bestellungen taggen, das Lager informieren, Kunden vor dem Ende des Bearbeitens erinnern und das Bearbeiten beim Start des Pickens beenden.

Revize ist eine Shopify-App für die Bearbeitung von Bestellungen nach dem Checkout. Sie fügt [Shopify Flow](https://apps.shopify.com/flow) eigene Trigger und Aktionen hinzu, damit dein Shop reagieren kann, wenn ein Kunde eine Bestellung bearbeitet, und damit dein Lager oder andere Apps das Bearbeiten öffnen oder schließen können.

> [!NOTE]
>
> Klicke in Shopify Flow auf **Select a trigger** (oder **Add action**) und suche nach **Revize**. Shopify Flow ist in allen Shopify-Tarifen verfügbar.

## Trigger

Jeder Trigger startet einen Workflow und übergibt die Bestellung, damit spätere Schritte ihre Tags, Positionen und den Kunden lesen können.

### Änderungen durch Kunden

| Trigger | Läuft, wenn |
| - | - |
| **Order edited** | eine Bestellung bearbeitet wird, auch bei Produktänderungen und Änderungen am Rabattcode |
| **Shipping address updated** | ein Kunde die Lieferadresse ändert |
| **Shipping method updated** | ein Kunde die Versandart ändert |
| **Email address updated** | ein Kunde die E-Mail-Adresse ändert |
| **Phone number updated** | ein Kunde die Telefonnummer ändert |
| **Delivery date updated** | ein Kunde das Lieferdatum ändert |
| **Custom note added** | ein Kunde eine eigene Notiz hinzufügt |
| **Order cancelled** | ein Kunde eine Bestellung storniert |
| **Support ticket created** | ein Kunde ein Support-Ticket erstellt |
| **Tax invoice generated** | ein Kunde eine Steuerrechnung erstellt |
| **Upsell accepted** | ein Kunde ein Revize-Upsell annimmt und der Artikel hinzugefügt ist. Übergibt Angebotstitel, Produkt, Variante, Menge, Betrag, Währung und wo es angenommen wurde (`thank_you`, `order_status`, `checkout` oder `other`). |

### Bearbeitungsfenster und Zahlung

| Trigger | Läuft, wenn | Nützliche Felder |
| - | - | - |
| **Edit window closing soon** | eine festgelegte Zeit vor dem Ende des Bearbeitungsfensters | `editDeadline`, `editDeadlineDisplay`, `hoursRemaining`, `hoursBeforeClose`, `orderStatusUrl` |
| **Edit window closed** | das Bearbeitungsfenster der Bestellung endet | `closedAt`, `editDeadline`, `paymentCaptureEnabled` |
| **Edit window changed** | Revize eine Änderung am Fenster veröffentlicht | `changeType` (`reopened`, `extended`, `shortened`, `until_fulfillment`), `editDeadline`, `previousDeadline`, `source` (`staff`, `merchant`, `flow`, `automatic`), `reason` |
| **Payment captured** | Revize die Zahlung erfasst und bestätigt, dass die Bestellung bezahlt ist | `capturedAmount`, `currencyCode`, `capturedAt` |
| **Payment capture failed** | ein Erfassungsversuch fehlschlägt | `reason` (`capture_declined`, `authorization_expired`, `outcome_unknown`, `retries_exhausted`), `remainingAmount`, `attemptNumber`, `willRetry` |
| **Unpaid edits reversed** | Revize unbezahlte Änderungen zurücknimmt oder das Zurücknehmen fehlschlägt | `outcome` (`reversed`, `failed`), `refundPending`, `remainingBalance` |

> [!NOTE]
>
> **Edit window closing soon** läuft zu den Erinnerungszeiten, die du in Revize unter **Settings → General → Reminder before editing closes** festlegst (bis zu 3, Pro). Jede Zeit läuft einmal pro Bestellung und erneut, wenn sich die Frist verschiebt.

## Aktionen

| Aktion | Was sie tut |
| - | - |
| **Close editing now** | Beendet das Bearbeiten der Bestellung und führt die normalen Zahlungs- und Fulfillment-Prüfungen aus. Optionaler **Reason**, der im Verlauf des Bearbeitungsfensters erscheint. |
| **Extend editing** | Fügt einem offenen Fenster mit fester Frist **Hours** hinzu (eine ganze Zahl von 1 bis 4319). |
| **Reopen editing** | Öffnet das Bearbeiten für die angegebenen **Hours**, wenn die Bestellung berechtigt ist. |
| **Keep editing open until fulfillment** | Hält das Bearbeiten offen, bis die Bestellung erfüllt ist, wenn die Bestellung berechtigt ist. |
| **Refund outstanding balance** | Erstattet, was der Kunde zu viel bezahlt hat, zum Beispiel nachdem eine Änderung den Gesamtbetrag gesenkt hat. |
| **Refund outstanding balance and report the result** | Dieselbe Erstattung, wartet aber, bis sie abgeschlossen ist, und gibt das Ergebnis an deinen Workflow zurück. |

> [!NOTE]
>
> **Reopen editing überspringt Bestellungen, die es nicht anfassen soll:** Bestellungen, die schon erfüllt oder teilweise erfüllt sind, schon ans Fulfillment freigegeben sind oder das Release-Tag tragen, storniert sind, durch Tags gesperrt sind oder bei denen noch eine Zahlungsänderung aussteht. Erstattungen folgen deiner [Erstattungseinstellung](https://docs.revize.app/de/setup/payments-and-refunds.md): **Original payment method** oder **Store credit**. Ist nichts offen oder sind Erstattungen auf **No refunds** gestellt, wird nichts erstattet.

## Tags, die Revize setzt

Nutze sie als Bedingungen in Flow, in deinem 3PL oder in Berichten.

| Tag | Gesetzt, wenn |
| - | - |
| `revize:order_released` (oder dein eigenes Release-Tag) | das Bearbeiten endet, wenn **Add release tag** aktiv ist |
| `revize:upsell` | eine Änderung den Bestellwert erhöht hat |
| `revize:upsell_offer` | ein Kunde ein Upsell-Angebot angenommen hat |
| `revize:order_downgraded` | eine Änderung den Bestellwert gesenkt hat |
| `revize:reverse_unpaid` | Revize unbezahlte Änderungen zurückgenommen hat |
| `revize:order_cancelled` | die Bestellung über Revize storniert wurde |
| `revize:withdrawal_requested` | ein Kunde einen [EU-Widerruf](https://docs.revize.app/de/features/eu-withdrawal.md) eingereicht hat |

Die [Regel-Engine](https://docs.revize.app/de/setup/rules-engine.md) (Pro) kann mit ihrer Aktion **Tag orders** außerdem eigene Tags setzen, wenn die Bearbeitungsfrist einer Bestellung endet.

## Beispiel-Workflows

> [accordion] Bearbeiten beenden, wenn das Lager mit dem Picken beginnt
>
> **Trigger:** der eigene Flow-Trigger deines WMS oder der Shopify-Trigger **Order tags added**, wenn das WMS ein Tag wie `picked` schreibt.
>
> **Aktion:** Revize **Close editing now** mit dem Grund `Picking started`.
>
> Der Kunde kann keine Bestellung mehr ändern, die dein Team schon packt. Die Alternative nur mit Tag: Füge dasselbe Tag in Revize unter **Settings → Order editing → Editing restrictions → Order tags** hinzu. Siehe [3PL- und Lager-Holds](https://docs.revize.app/de/guides/3pl-warehouse-holds.md).

> [accordion] Kunden vor dem Ende des Bearbeitens erinnern
>
> **Trigger:** **Edit window closing soon**.
>
> **Bedingung (optional):** `hoursBeforeClose` entspricht der gewünschten Erinnerung, wenn du mehrere festgelegt hast.
>
> **Aktion:** Sende eine E-Mail oder SMS aus deiner E-Mail-App mit `editDeadlineDisplay` und dem Link `orderStatusUrl`, damit der Kunde Größe oder Adresse noch korrigieren kann. Für Klaviyo siehe den [Klaviyo-Leitfaden](https://docs.revize.app/de/integrations/klaviyo.md).

> [accordion] Das Team informieren, wenn eine bearbeitete Bestellung eine neue Adresse hat
>
> **Trigger:** **Shipping address updated**.
>
> **Aktion:** Füge ein Bestell-Tag wie `address-changed` hinzu oder poste in Slack, damit das Team Bestellungen prüft, die schon gedruckt wurden.

> [accordion] Nachfassen, wenn eine Zahlungserfassung fehlschlägt
>
> **Trigger:** **Payment capture failed**.
>
> **Bedingung:** `willRetry` ist false.
>
> **Aktion:** Tagge die Bestellung mit `capture-failed` und benachrichtige dein Finanzpostfach. Revize schickt dir außerdem eine E-Mail, wenn es keine weiteren Versuche macht.

## Gut zu wissen

* **Trigger senden jedes Ereignis einmal**, nachdem die Änderung abgeschlossen ist. Baue Workflows so, dass sie auch funktionieren, wenn ein Ereignis fehlt, zum Beispiel indem sie zusätzlich Tags prüfen.
* **Späte Tags zählen trotzdem.** Revize wartet nach dem Checkout bis zu einer Minute, bis Flow Tags oder Metafelder geschrieben hat, bevor es eine Bearbeitungsregel wählt. Flow-Tags aus dem Checkout können also [Regeln](https://docs.revize.app/de/setup/rules-engine.md) steuern.
* **Die Schreibweise zählt.** Beim Tag-Abgleich spielt Groß- und Kleinschreibung keine Rolle, die Schreibweise aber schon: Ein von Flow gesetztes Tag muss genau so geschrieben sein wie das Tag in Revize.

## Verwandte Seiten

* [Integrationen](https://docs.revize.app/de/integrations/index.md): 3PLs, ERPs und Integrationsplattformen
* [Klaviyo](https://docs.revize.app/de/integrations/klaviyo.md): E-Mails über Revize-Trigger senden
* [Regel-Engine](https://docs.revize.app/de/setup/rules-engine.md): Fristen, Holds und Tags pro Bestellung
* [3PL- und Lager-Holds](https://docs.revize.app/de/guides/3pl-warehouse-holds.md)


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