---
title: "Referenz zu Shopify-Flow-Triggern und -Aktionen"
description: "Jeder QuotWay-Flow-Trigger und jede Aktion, die Felder, die jeder trägt, und der jeweils nötige Tarif – die Referenz zum Bauen oder Prüfen eines Flow-Workflows."
url: "https://www.quotway.com/de/docs/integrations/shopify-flow-reference"
type: "documentation"
category: "integrations"
updated: "2026-09-30"
locale: "de"
source: "QuotWay - B2B Quote & Negotiation App for Shopify"
---

# Referenz zu Shopify-Flow-Triggern und -Aktionen

**Lesezeit:** 6 Minuten.
**Zuletzt aktualisiert:** 28. August 2026
**Für wen:** Alle, die einen Flow-Workflow gegen QuotWay bauen oder prüfen wollen, was QuotWay Flow bereitstellt, bevor sie sich festlegen.

Das ist die Referenz auf Feldebene. Wie Sie Ihren ersten Workflow bauen, steht unter [Shopify Flow](./shopify-flow.md).

QuotWay stellt **10 Trigger** und **3 Aktionen** bereit. Trigger erfordern mindestens den **Professional**-Tarif; Aktionen erfordern **Enterprise**.

---

## Trigger

Jeder Trigger greift aus einem Angebotsereignis und trägt einen flachen Satz Felder, die Sie in Flow-Bedingungen nutzen und an nachgelagerte Aktionen weitergeben können.

| Trigger | Greift, wenn |
| --- | --- |
| **Angebot gesendet** | Ein Käufer eine Angebotsanfrage sendet |
| **Angebot verschickt** | Sie dem Käufer ein bepreistes Angebot senden |
| **Angebot gegengeboten** | Eine der Seiten gegenbietet und damit eine neue Runde startet |
| **Angebot angenommen** | Der Käufer annimmt – ganz oder teilweise |
| **Angebot abgelehnt** | Der Käufer ablehnt |
| **Angebot abgelaufen** | Das Angebot sein Ablaufdatum überschreitet |
| **Angebot umgewandelt** | Das Angebot zu einem Shopify-Bestellentwurf wird |
| **Freigabe angefragt** | Eine Freigabekette startet, auf Ihrer oder auf Käuferseite |
| **Freigabe erteilt** | Ein Freigabeschritt oder eine Kette freigegeben wird |
| **Freigabe abgelehnt** | Ein Freigabeschritt oder eine Kette abgelehnt wird |

Die drei Freigabe-Trigger greifen für **beide** Ketten, auf Händler- und auf Käuferseite. Nutzen Sie das Feld **Art der Freigabe** (`MERCHANT` oder `BUYER`) in einer Flow-Bedingung, um sie zu unterscheiden, statt getrennte Trigger zu erwarten.

### Felder an jedem Trigger

| Feld | Typ | Hinweise |
| --- | --- | --- |
| **Angebots-ID** | Text | Die interne ID von QuotWay |
| **Angebotsnummer** | Text | Die menschenlesbare Referenz, z. B. `Q-1042` |
| **Admin-URL des Angebots** | Text | Deep Link direkt zum Angebot in Ihrem Admin – nützlich in einer Slack-Nachricht |
| **Status** | Text | Der Status des Angebots im Moment des Ereignisses |
| **Modus** | Text | Nach welchem Angebotsmodell das Angebot läuft |
| **Summe** | Zahl | Die Angebotssumme |
| **Währungscode** | Text | Die Währung des Angebots |
| **Art der handelnden Person** | Text | Wer das Ereignis ausgelöst hat – Händler, Käufer oder System |
| **Zeitpunkt** | Text | Zeitstempel nach ISO 8601 |
| **Kunden-ID** | Text | Die numerische Shopify-Kunden-ID oder **leer bei Angeboten von Gästen** |
| **Käufer-E-Mail** | E-Mail | Immer vorhanden, sodass eine nachgelagerte Aktion dem Käufer direkt mailen kann |

Zwei Hinweise, die beim Bauen von Bedingungen zählen:

- **Die Kunden-ID ist reiner Text, keine Kundenreferenz.** Angebotsanfragen von Gästen haben keine Shopify-Kundin und keinen Shopify-Kunden, und Shopify verlangt, dass jedes deklarierte Feld vorhanden ist – ein Referenzfeld darf nicht leer sein, ein Textfeld schon. Ein Trigger deckt daher sowohl Gast- als auch angemeldete Angebote ab. Zum Verzweigen nutzen Sie eine Flow-Bedingung auf *Kunden-ID ist nicht leer*.
- **Die Käufer-E-Mail ist immer gefüllt** (sie wird bei der Anfrage geprüft), was es sicher macht, eine E-Mail-Aktion direkt an jeden Trigger zu hängen – auch bei Gastanfragen, wo sie der einzige Käuferkontakt ist.

### Zusätzliche Felder an bestimmten Triggern

| Trigger | Zusätzliches Feld | Wert |
| --- | --- | --- |
| Angebot gegengeboten | **Rundennummer** | Um welche Verhandlungsrunde es geht |
| Angebot angenommen | **Art der Annahme** | `FULL` oder `PARTIAL` |
| Angebot angenommen | **Angenommene Summe** | Die angenommene Summe |
| Angebot umgewandelt | **Bestellentwurfs-ID** | Die GID des Bestellentwurfs |
| Freigabe angefragt / erteilt / abgelehnt | **Art der Freigabe** | `MERCHANT` oder `BUYER` |

> **Warum „Angebot umgewandelt“ eine Bestellentwurfs-ID trägt und keine Bestellreferenz.** Bei der Umwandlung existiert nur ein *Entwurf* – die echte Bestellung entsteht erst, wenn der Käufer den Checkout abschließt. Eine Bestellreferenz zu deklarieren, die es noch nicht gibt, ließe Shopify den Trigger ablehnen, deshalb reist die GID des Bestellentwurfs stattdessen in einem reinen Textfeld.

---

## Aktionen

Aktionen lassen einen Flow-Workflow auf ein Angebot zurückwirken. Alle drei erfordern den **Enterprise**-Tarif.

### Angebotsstatus ändern

Setzt ein Angebot auf einen neuen Status.

| Eingabe | Pflicht | Hinweise |
| --- | --- | --- |
| `quote_id` | Ja | Aus dem Feld **Angebots-ID** eines Triggers |
| `target_status` | Ja | Eines von `IN_REVIEW`, `DECLINED`, `EXPIRED` |
| `note` | Nein | Wird am Angebot festgehalten |

Die zulässigen Ziele sind bewusst eng – ein Angebot zur Prüfung wieder öffnen, es ablehnen oder ablaufen lassen. Status, die Arbeit einer Person darstellen (ein Angebot senden, im Namen des Käufers annehmen), lassen sich aus Flow nicht setzen.

### Angebot einem Teammitglied zuweisen

Leitet ein Angebot an ein Teammitglied.

| Eingabe | Pflicht | Hinweise |
| --- | --- | --- |
| `quote_id` | Ja | Aus einem Trigger |
| `staff_email` | Ja | Ohne Beachtung der Groß-/Kleinschreibung gegen Ihr QuotWay-Team abgeglichen |

### Angebotsbenachrichtigung senden

Postet eine Nachricht in den Angebotsverlauf und mailt dem Käufer.

| Eingabe | Pflicht | Hinweise |
| --- | --- | --- |
| `quote_id` | Ja | Aus einem Trigger |
| `message` | Ja | Der Nachrichtentext |

---

## Was Sie allein mit Triggern bauen können

Trigger gibt es ab Professional, die meisten nützlichen Workflows brauchen also kein Enterprise:

- **Angebot über $25.000 angenommen** → in einen Slack-Kanal posten, mit dem Admin-Deep-Link, die Kundin bzw. den Kunden taggen, eine Aufgabe anlegen.
- **Angebot von einer Kundin bzw. einem Kunden mit dem Tag `vip` gesendet** → die betreuende Person sofort benachrichtigen.
- **Freigabe abgelehnt** → der Vertriebsleitung die Angebotsnummer und Summe mailen.
- **Angebot abgelaufen** → die Kundin bzw. den Kunden einem Reaktivierungssegment hinzufügen.

Aktionen ergänzen die Möglichkeit zurückzuschreiben – ein Angebot wieder öffnen, neu zuweisen oder dem Käufer schreiben – aus einem Workflow heraus.

## Was Flow Ihnen nicht geben kann

Flow-Trigger tragen Felder auf Angebotsebene, keine Details auf **Positionsebene**. Braucht Ihr Workflow einzelne Positionen, Mengen oder Preise je Position – etwa um ein Angebot in ein ERP zu übertragen –, braucht das die [QuotWay-API](/docs/api) statt Flow: Sie liefert ein Angebot mit seinen Positionen, und [Webhooks](/docs/api/webhooks) benachrichtigen Ihr System, wenn sich ein Angebot ändert. Beides ist im Enterprise-Tarif verfügbar – auch während der 14-tägigen kostenlosen Testphase.

## Verwandte Artikel

- [Shopify Flow](./shopify-flow.md) – den ersten Workflow bauen und die Tarifgrenzen.
- [Genehmigungs-Workflows](../approvals/approval-workflows.md) – die Freigabeereignisse, die die drei Freigabe-Trigger auslösen.
- [Tarife, Testphase und Abrechnung](../billing/plans-trial-and-billing.md) – Professional für Trigger, Enterprise für Aktionen.
