Rückgabe aktualisiert
Der Trigger „Rückgabe aktualisiert“ startet einen Workflow, wenn sich in deinem Shop ein oder mehrere Felder einer Rückgabe, ihrer Positionen oder ihrer Fulfillment-Aufträge für Rückgaben ändern. Du wählst aus, welche Rückgabefelder relevant sind. Der Workflow wird nur ausgeführt, wenn sich eines dieser Felder ändert, etwa wenn sich der Rückgabestatus ändert oder eine Wiedereinlagerungsgebühr hinzugefügt wird.
Damit ein Workflow startet, wenn eine Rückgabe eine bestimmte Phase erreicht, kannst du auch einen Trigger für diese Phase verwenden, etwa „Rückgabe angefordert“, „Rückgabe genehmigt“ oder „Rückgabe geschlossen“.
Auf dieser Seite
Überwachbare Felder
Für den Trigger „Rückgabe aktualisiert“ musst du mindestens ein Feld zur Überwachung auswählen. Du kannst bis zu fünf Felder auswählen. Sobald sich eines der ausgewählten Felder ändert, wird der Workflow ausgeführt. Änderungen an nicht ausgewählten Feldern starten den Workflow nicht.
In der folgenden Tabelle findest du weitere Informationen zu den Feldern, die du überwachen kannst.
| Feldtyp | Felder |
|---|---|
| Rückgabe | closedAt, decline, requestApprovedAt, status |
| Rückgabepositionen | returnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity |
| Warenumtauschpositionen | exchangeLineItems |
| Rückgabe-Versandgebühren | returnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney |
| Fulfillment-Aufträge für Rückgaben | reverseFulfillmentOrders, reverseFulfillmentOrders.lineItems, reverseFulfillmentOrders.status |
Ein Feld, dessen Name auf amountSet endet, enthält einen Betrag in zwei Währungen. Wenn du das Feld überwachst, startet der Workflow, sobald sich einer der beiden Beträge ändert. Um nur einen der Beträge zu überwachen, wähle das Unterfeld shopMoney für den Betrag in der Währung deines Shops oder das Unterfeld presentmentMoney für den Betrag in der Währung deiner Kundschaft aus.
Bei einigen Feldern startet der Workflow auch, wenn der Rückgabe ein Artikel hinzugefügt oder ein Artikel aus der Rückgabe entfernt wird:
- Wenn du ein Feld in der Gruppe „Rückgabepositionen“ überwachst, wird der Workflow gestartet, sobald eine Position zur Rückgabe hinzugefügt oder daraus entfernt wird.
- Wenn du ein Feld für die Wiedereinlagerungsgebühr wie
returnLineItems.restockingFee.percentageüberwachst, startet der Workflow, sobald bei einer Position eine Wiedereinlagerungsgebühr hinzugefügt oder entfernt wird. - Wenn du das Feld
exchangeLineItemsüberwachst, startet der Workflow, sobald der Rückgabe ein Warenumtauschartikel hinzugefügt oder ein Warenumtauschartikel aus der Rückgabe entfernt wird. - Wenn du ein Feld in der Gruppe „Rückgabe-Versandgebühren“ überwachst, startet der Workflow, sobald eine Rückgabe-Versandgebühr hinzugefügt oder entfernt wird.
- Wenn du ein Feld in der Gruppe „Fulfillment-Aufträge für Rückgaben“ überwachst, startet der Workflow, sobald der Rückgabe ein Fulfillment-Auftrag für Rückgabe hinzugefügt wird. Wenn du das Feld
reverseFulfillmentOrdersoderreverseFulfillmentOrders.lineItemsüberwachst, startet der Workflow auch, wenn eine Position aus einem Fulfillment-Auftrag für Rückgabe entfernt wird.
Felder auswählen, die den Workflow starten
Wähle die Felder aus, bei deren Änderung der Workflow gestartet wird.
Schritte:
- Klicke im Workflow-Editor auf den Trigger „Rückgabe aktualisiert“.
- Klicke im Abschnitt „Rückgabefelder auswählen“ auf „Felder auswählen“.
- Suche im Dialog „Feld zur Überwachung hinzufügen“ nach dem Feld, das du überwachen möchtest, oder navigiere dorthin. Wähle es anschließend aus.
- Optional: Wiederhole die Schritte 2 und 3, um bis zu fünf Felder zu überwachen.
Felder
Der Trigger „Rückgabe aktualisiert“ enthält die folgenden Felder. Du kannst sie in Bedingungen und Aktionen verwenden und damit Daten im Workflow abrufen. Die Felder „Rückgabe“ und „Shop“ sind immer verfügbar. Die anderen Felder sind nur verfügbar, wenn du ein zugehöriges Feld überwachst. Beispielsweise ist das Feld „Fulfillment-Auftrag für Rückgabe“ verfügbar, wenn du ein Feld eines Fulfillment-Auftrags für Rückgabe überwachst, etwa reverseFulfillmentOrders.status.
| Feld | Beschreibung |
|---|---|
| Rückgabe | Die Rückgabe, die aktualisiert wurde. |
| Shop | Der Shop, in dem die Rückgabe aktualisiert wurde. |
| Rückgabeposition | Die Rückgabeposition, die sich geändert hat. Leer, wenn eine Position aus der Rückgabe entfernt wurde. Verfügbar, wenn du returnLineItems.quantity oder ein Feld für die Wiedereinlagerungsgebühr überwachst. |
| Warenumtauschposition | Die Warenumtauschposition, die hinzugefügt wurde. Leer, wenn eine Warenumtauschposition entfernt wurde. Verfügbar, wenn du das Feld exchangeLineItems überwachst. |
| Fulfillment-Auftrag für Rückgabe | Der Fulfillment-Auftrag für Rückgabe, der geändert wurde. Verfügbar, wenn du ein Feld eines Fulfillment-Auftrags für Rückgabe überwachst. |
Wenn du Felder unterschiedlicher Typen überwachst, können die Felder „Rückgabeposition“, „Warenumtauschposition“ und „Fulfillment-Auftrag für Rückgabe“ beim Ausführen des Workflows leer sein. Wenn du beispielsweise sowohl status als auch returnLineItems.quantity überwachst, ist das Feld „Rückgabeposition“ leer, wenn sich nur der Status ändert. Die Felder „Rückgabeposition“ und „Warenumtauschposition“ können auch dann leer sein, wenn du nur Felder ihres jeweiligen Typs überwachst. Bevor du eines dieser Felder in einer Aktion verwendest, füge eine Bedingung hinzu, die prüft, ob das Feld einen Wert enthält.
Der Trigger „Rückgabe aktualisiert“ stellt nur die aktuellen Werte der Rückgabe und ihrer Positionen bereit. Die vorherigen Werte der geänderten Felder sind im Workflow nicht verfügbar. Wenn du beispielsweise das Feld status überwachst, kannst du den aktuellen Rückgabestatus in einer Bedingung oder Aktion verwenden, aber nicht den Status vor der Änderung.
Aktionen
Dieser Trigger stellt ein Rückgabeobjekt bereit. Damit kannst du jede Aktion verwenden, die eine Rückgabe erfordert. Da das Rückgabeobjekt auch eine Bestellung enthält, lässt sich der Trigger außerdem mit allen Bestellaktionen verwenden, darunter:
- Bestellposition hinzufügen
- Bestell-Tags hinzufügen
- Bestellung archivieren
- Bestellung stornieren
- Zahlung erfassen
- Fulfillment-Auftrag anhalten
- Bestellung als bezahlt markieren
Über Bestellungen kannst du auf weitere Daten zugreifen, etwa auf Daten zur Kundschaft. Daher lässt sich der Trigger auch mit Aktionen für Kund:innen verwenden. Dazu gehören:
- Tags zu Kund:innen hinzufügen
- Metafeld für Kund:innen entfernen
- Tags von Kund:innen entfernen
- Metafeld für Kund:innen aktualisieren
- Kundenhinweis aktualisieren
Bestellungen enthalten auch Datenlisten, zum Beispiel mit Positionen. Mit einer Aktion „Für jedes“ kannst du diese Listen in einer Schleife durchlaufen und für jedes Element Aktionen ausführen. Beispielsweise kannst du die Positionen durchlaufen und jedem Produkt ein Tag hinzufügen.
Trigger „Rückgabe aktualisiert“ testen
Um einen Workflow zu testen, der mit diesem Trigger startet, aktiviere den Workflow und ändere anschließend im Shopify-Adminbereich eines der überwachten Felder einer Rückgabe. Erstelle beispielsweise eine Rückgabe und bearbeite sie anschließend oder schließe sie.
API-Details
Mit dem Trigger „Rückgabe aktualisiert“ lassen sich Aktionen mit dem Objekt „Return“ der GraphQL API ausführen. Dieser Trigger entspricht der Aktion update des Themas „Return“ in der Referenz zu Shopify Events, gefiltert nach den Feldern, die du zur Überwachung auswählst.