Retour bijgewerkt

De trigger Retour bijgewerkt start een workflow wanneer in je winkel een of meer velden van een retour, de bijbehorende orderregels of retourbestellingen veranderen. Je kiest welke retourvelden belangrijk zijn. De workflow wordt alleen uitgevoerd wanneer een van die velden verandert, bijvoorbeeld wanneer de retourstatus verandert of herbevoorradingskosten worden toegevoegd.

Om een workflow te starten wanneer een retour een bepaalde fase bereikt, kun je ook een trigger voor die fase gebruiken, zoals Retour aangevraagd, Retour goedgekeurd of Retour gesloten.

Velden die je kunt bewaken

Voor de trigger Retour bijgewerkt moet je minstens één veld selecteren om te volgen. Je kunt maximaal vijf velden selecteren. Zodra een van de geselecteerde velden verandert, wordt de workflow uitgevoerd. Wijzigingen in velden die je niet hebt geselecteerd, starten de workflow niet.

Bekijk de volgende tabel voor meer informatie over de velden die je kunt volgen.

Velden die je kunt volgen met de trigger Retour bijgewerkt.
VeldtypeVelden
RetourclosedAt, decline, requestApprovedAt, status
RetourorderregelsreturnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity
OmruilorderregelsexchangeLineItems
Kosten retourzendingreturnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney
RetourbestellingenreverseFulfillmentOrders, reverseFulfillmentOrders.lineItems, reverseFulfillmentOrders.status

Een veld waarvan de naam eindigt op amountSet bevat een bedrag in twee valuta's. Als je dit veld volgt, wordt de workflow gestart zodra een van beide bedragen verandert. Wil je maar één van de bedragen volgen? Selecteer dan het onderliggende veld shopMoney voor het bedrag in je winkelvaluta of presentmentMoney voor het bedrag in de valuta van de klant.

Sommige velden starten de workflow ook wanneer een artikel aan de retour wordt toegevoegd of eruit wordt verwijderd:

  • Als je een veld in de groep Retourorderregels bewaakt, wordt de workflow gestart wanneer een orderregel aan de retour wordt toegevoegd of eruit wordt verwijderd.
  • Als je een veld voor herbevoorradingskosten bewaakt, zoals returnLineItems.restockingFee.percentage, wordt de workflow gestart wanneer herbevoorradingskosten aan een orderregel worden toegevoegd of ervan worden verwijderd.
  • Als je het veld exchangeLineItems volgt, wordt de workflow gestart wanneer een omruilartikel aan de retour wordt toegevoegd of eruit wordt verwijderd.
  • Als je een veld in de groep Kosten retourzending volgt, wordt de workflow gestart wanneer kosten voor een retourzending worden toegevoegd of verwijderd.
  • Als je een veld in de groep Retourbestellingen volgt, wordt de workflow gestart wanneer een retourbestelling aan de retour wordt toegevoegd. Als je het veld reverseFulfillmentOrders of reverseFulfillmentOrders.lineItems volgt, wordt de workflow ook gestart wanneer een orderregel uit een retourbestelling wordt verwijderd.

Velden selecteren die de workflow starten

Selecteer de velden die bij een wijziging de workflow starten.

Stappen:

  1. Klik in de workflow-editor op de trigger Retour bijgewerkt.
  2. Klik in de sectie Retourvelden selecteren op Velden selecteren.
  3. Zoek in het dialoogvenster Te volgen veld toevoegen naar het veld dat je wilt volgen of blader ernaartoe en selecteer het.
  4. Optioneel: herhaal stap 2 en 3 om maximaal vijf velden te volgen.

Velden

De trigger Retour bijgewerkt bevat de volgende velden. Je kunt ze gebruiken in voorwaarden en acties en om gegevens op te halen in de workflow. De velden Retour en Winkel zijn altijd beschikbaar. De andere velden zijn alleen beschikbaar als je een gerelateerd veld volgt. Het veld Retourbestelling is bijvoorbeeld beschikbaar als je een veld van een retourbestelling volgt, zoals reverseFulfillmentOrders.status.

Velden in de trigger Retour bijgewerkt.
VeldBeschrijving
RetourDe retour die is bijgewerkt.
WinkelDe winkel waarin de retour is bijgewerkt.
RetourorderregelDe gewijzigde retourorderregel. Leeg wanneer een orderregel uit de retour is verwijderd. Beschikbaar wanneer je returnLineItems.quantity of een veld voor herbevoorradingskosten bewaakt.
RuilorderregelDe toegevoegde ruilorderregel. Leeg wanneer een ruilorderregel is verwijderd. Beschikbaar wanneer je het veld exchangeLineItems bewaakt.
RetourbestellingDe retourbestelling die is gewijzigd. Beschikbaar wanneer je een veld van een retourbestelling volgt.

Als je velden van verschillende typen volgt, kunnen de velden Retourorderregel, Omruilorderregel en Retourbestelling leeg zijn wanneer de workflow wordt uitgevoerd. Als je bijvoorbeeld zowel status als returnLineItems.quantity volgt, is het veld Retourorderregel leeg wanneer alleen de status verandert. De velden Retourorderregel en Omruilorderregel kunnen zelfs leeg zijn als je alleen velden van hun eigen type volgt. Voeg voordat je een van deze velden in een actie gebruikt een voorwaarde toe die controleert of het veld een waarde heeft.

De trigger Retour bijgewerkt levert alleen de huidige waarden van de retour en de bijbehorende orderregels. De vorige waarden van de gewijzigde velden zijn niet beschikbaar in de workflow. Als je bijvoorbeeld het veld status volgt, kun je de huidige retourstatus in een voorwaarde of actie gebruiken, maar niet de status van vóór de wijziging.

Acties

Deze trigger levert een retourobject, zodat je elke actie kunt gebruiken waarvoor een retour nodig is. Omdat het retourobject ook een bestelling bevat, kun je de trigger bovendien gebruiken met alle bestelacties, waaronder:

Via bestellingen heb je toegang tot andere gegevens, zoals klantgegevens, zodat je ook klantacties kunt gebruiken. Dit zijn onder andere:

Bestellingen bevatten ook lijsten met gegevens, zoals orderregels. Met een actie Voor elk kun je deze lijsten doorlopen en acties uitvoeren voor elk artikel. Je kunt bijvoorbeeld de orderregels doorlopen en een tag aan elk product toevoegen.

De trigger Retour bijgewerkt testen

Om een workflow te testen die met deze trigger begint, activeer je de workflow en wijzig je daarna in het Shopify-beheercentrum een van de retourvelden die de workflow volgt. Je kunt bijvoorbeeld een retour aanmaken en vervolgens de retour verwerken of de retour sluiten.

API-gegevens

Met de trigger Retour bijgewerkt kun je acties uitvoeren met het Return-object van de GraphQL API. Deze trigger komt overeen met de actie update van het Return-onderwerp in de referentiedocumentatie voor Shopify Events, gefilterd op de velden die je wilt volgen.