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.
Op deze pagina
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.
| Veldtype | Velden |
|---|---|
| Retour | closedAt, decline, requestApprovedAt, status |
| Retourorderregels | returnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity |
| Omruilorderregels | exchangeLineItems |
| Kosten retourzending | returnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney |
| Retourbestellingen | reverseFulfillmentOrders, 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
exchangeLineItemsvolgt, 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
reverseFulfillmentOrdersofreverseFulfillmentOrders.lineItemsvolgt, 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:
- Klik in de workflow-editor op de trigger Retour bijgewerkt.
- Klik in de sectie Retourvelden selecteren op Velden selecteren.
- Zoek in het dialoogvenster Te volgen veld toevoegen naar het veld dat je wilt volgen of blader ernaartoe en selecteer het.
- 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.
| Veld | Beschrijving |
|---|---|
| Retour | De retour die is bijgewerkt. |
| Winkel | De winkel waarin de retour is bijgewerkt. |
| Retourorderregel | De gewijzigde retourorderregel. Leeg wanneer een orderregel uit de retour is verwijderd. Beschikbaar wanneer je returnLineItems.quantity of een veld voor herbevoorradingskosten bewaakt. |
| Ruilorderregel | De toegevoegde ruilorderregel. Leeg wanneer een ruilorderregel is verwijderd. Beschikbaar wanneer je het veld exchangeLineItems bewaakt. |
| Retourbestelling | De 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:
- Orderregel toevoegen
- Bestellingstags toevoegen
- Bestelling archiveren
- Bestelling annuleren
- Betaling vastleggen
- Fulfilmentbestelling in de wacht zetten
- Bestelling als betaald markeren
Via bestellingen heb je toegang tot andere gegevens, zoals klantgegevens, zodat je ook klantacties kunt gebruiken. Dit zijn onder andere:
- Klanttags toevoegen
- Klantmetaveld verwijderen
- Klanttags verwijderen
- Klantmetaveld bijwerken
- Opmerking over klant bijwerken
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.