Retur oppdatert
Utløseren Retur oppdatert starter en arbeidsflyt når ett eller flere felt i en retur, returens poster eller returprosesser endres i butikken. Du velger hvilke returfelt som er relevante, og arbeidsflyten kjøres bare når et av disse feltene endres. Det kan for eksempel være når returens status endres eller en avgift for påfylling legges til.
For å starte en arbeidsflyt når en retur når et bestemt trinn, kan du også bruke en utløser for det trinnet, for eksempel Retur forespurt, Retur godkjent eller Retur lukket.
På denne siden
Felter som kan overvåkes
Utløseren Retur oppdatert krever at du velger minst ett felt som skal overvåkes. Du kan velge opptil fem felt. Når et av de valgte feltene endres, kjøres arbeidsflyten. Endringer i felt du ikke har valgt, starter ikke arbeidsflyten.
Se tabellen nedenfor for å finne ut mer om feltene du kan overvåke.
| Felttype | Felt |
|---|---|
| Retur | closedAt, decline, requestApprovedAt, status |
| Returposter | returnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity |
| Bytteposter | exchangeLineItems |
| Returfrakt | returnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney |
| Returprosesser | reverseFulfillmentOrders, reverseFulfillmentOrders.lineItems, reverseFulfillmentOrders.status |
Et felt med et navn som slutter på amountSet, inneholder et beløp i to valutaer. Når du overvåker feltet, starter arbeidsflyten hvis et av beløpene endres. Hvis du bare vil overvåke ett av beløpene, velger du underfeltet shopMoney for beløpet i butikkens valuta eller underfeltet presentmentMoney for beløpet i kundens valuta.
Noen felt starter også arbeidsflyten når en vare legges til i eller fjernes fra returen:
- Hvis du overvåker et felt i gruppen Returposter, starter arbeidsflyten når en post legges til eller fjernes fra returen.
- Hvis du overvåker et felt for avgift for påfylling, for eksempel
returnLineItems.restockingFee.percentage, starter arbeidsflyten når en slik avgift legges til eller fjernes fra en post. - Hvis du overvåker feltet
exchangeLineItems, starter arbeidsflyten når en byttevare legges til i eller fjernes fra returen. - Hvis du overvåker et felt i gruppen Returfrakt, starter arbeidsflyten når returfrakt legges til eller fjernes.
- Hvis du overvåker et felt i gruppen Returprosesser, starter arbeidsflyten når en returprosess legges til i returen. Hvis du overvåker feltet
reverseFulfillmentOrderseller feltetreverseFulfillmentOrders.lineItems, starter arbeidsflyten også når en post fjernes fra en returprosess.
Velg feltene som starter arbeidsflyten
Velg feltene som starter arbeidsflyten når de endres.
Trinn:
- Klikk på utløseren Retur oppdatert i arbeidsflytredigereren.
- I seksjonen Velg returfelt klikker du på Velg felt.
- I dialogboksen Legg til felt som skal overvåkes søker du etter eller blar deg frem til feltet du vil overvåke. Velg deretter feltet.
- Valgfritt: Gjenta trinn 2 og 3 for å overvåke opptil fem felt.
Felt
Utløseren Retur oppdatert inneholder følgende felt, som kan brukes i betingelser og handlinger og til å hente data i arbeidsflyten. Feltene Retur og Butikk er alltid tilgjengelige. De andre feltene er bare tilgjengelige når du overvåker et relatert felt. Feltet Returprosess er for eksempel tilgjengelig når du overvåker et felt for en returprosess, som reverseFulfillmentOrders.status.
| Felt | Beskrivelse |
|---|---|
| Retur | Returen som ble oppdatert. |
| Butikk | Butikken der returen ble oppdatert. |
| Returpost | Returposten som ble endret. Tom når en post ble fjernet fra returen. Tilgjengelig når du overvåker returnLineItems.quantity eller et felt for avgift for påfylling. |
| Byttepost | Bytteposten som ble lagt til. Tom når en byttepost ble fjernet. Tilgjengelig når du overvåker feltet exchangeLineItems. |
| Returprosess | Returprosessen som ble endret. Tilgjengelig når du overvåker et felt for en returprosess. |
Hvis du overvåker felt av ulike typer, kan feltene Returpost, Byttepost og Returprosess være tomme når arbeidsflyten kjøres. Hvis du for eksempel overvåker både status og returnLineItems.quantity, er feltet Returpost tomt når bare statusen endres. Feltene Returpost og Byttepost kan være tomme selv om du bare overvåker felt av samme type. Før du bruker et av disse feltene i en handling, må du legge til en betingelse som kontrollerer at feltet har en verdi.
Utløseren Retur oppdatert gir bare tilgang til de gjeldende verdiene for returen og postene i den. De tidligere verdiene i feltene som ble endret, er ikke tilgjengelige i arbeidsflyten. Hvis du for eksempel overvåker feltet status, kan du bruke returens gjeldende status i en betingelse eller handling, men ikke statusen før endringen.
Handlinger
Denne utløseren gir tilgang til et returobjekt, slik at du kan bruke alle handlinger som krever en retur. Returobjektet inneholder også en bestilling, så utløseren kan brukes med alle bestillingshandlinger, inkludert:
- Legg til bestillingspost
- Legg til bestillingstagger
- Arkiver bestilling
- Kanseller bestilling
- Gjennomfør betaling
- Sett distribusjonsbestilling på vent
- Merk bestilling som betalt
Bestillinger gir tilgang til andre data, for eksempel kundeinformasjon, så utløseren kan også brukes med kundehandlinger. Dette omfatter:
- Legg til kundetagger
- Fjern kundemetafelt
- Fjern kundetagger
- Oppdater kundemetafelt
- Oppdater kundemerknad
Bestillinger inneholder også datalister, for eksempel poster. Med en For hver-handling kan du gå gjennom disse listene og utføre handlinger på hvert element. Du kan for eksempel gå gjennom postene og legge til en tagg på hvert produkt.
Testing av utløseren Retur oppdatert
For å teste en arbeidsflyt som starter med denne utløseren, aktiverer du arbeidsflyten og endrer deretter et av feltene arbeidsflyten overvåker i en retur i Shopify-administratoren. Du kan for eksempel opprette en retur og deretter behandle returen eller lukke returen.
API-informasjon
Utløseren Retur oppdatert gjør det mulig å utføre handlinger med Return-objektet i GraphQL API. Denne utløseren tilsvarer update-handlingen for Return-emnet i referansen for Shopify Events, filtrert etter feltene du velger å overvåke.