Visszavétel frissítve
A „Visszavétel frissítve” kiváltó elindít egy munkafolyamatot, ha az üzletében egy visszavétel, annak sorelemei vagy visszaküldési rendelései egy vagy több mezője megváltozik. Ön választja ki, hogy a visszavétel mely mezői fontosak. A munkafolyamat csak akkor fut le, ha ezek valamelyike megváltozik, például módosul a visszavétel állapota, vagy visszárukezelési díjat adnak hozzá.
Ha akkor szeretne elindítani egy munkafolyamatot, amikor a visszavétel egy adott szakaszba lép, az adott szakaszhoz tartozó kiváltót is használhatja, például a „Visszavételi kérelem érkezett”, a „Visszavétel jóváhagyva” vagy a „Visszavétel lezárva” kiváltót.
Az oldal tartalma
Figyelhető mezők
A „Visszavétel frissítve” kiváltóhoz legalább egy figyelendő mezőt ki kell választania. Legfeljebb öt mezőt választhat ki. Ha bármelyik kiválasztott mező megváltozik, a munkafolyamat lefut. A ki nem választott mezők változásai nem indítják el a munkafolyamatot.
A figyelhető mezőkről az alábbi táblázatban talál további információt.
| Mezőtípus | Mezők |
|---|---|
| Visszavétel | closedAt, decline, requestApprovedAt, status |
| Visszavételi sorelemek | returnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity |
| Csere sorelemei | exchangeLineItems |
| Visszaküldési szállítási díjak | returnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney |
| Visszaküldési rendelések | reverseFulfillmentOrders, reverseFulfillmentOrders.lineItems, reverseFulfillmentOrders.status |
Az amountSet végződésű mezők ugyanazt az összeget két valutában tartalmazzák. Ha ilyen mezőt figyel, bármelyik összeg változása elindítja a munkafolyamatot. Ha csak az egyik összeget szeretné figyelni, válassza a mező shopMoney almezőjét az üzlet valutájában megadott összeghez, vagy a presentmentMoney almezőjét a vásárló valutájában megadott összeghez.
Egyes mezők figyelésekor akkor is elindul a munkafolyamat, ha egy tételt hozzáadnak a visszavételhez, vagy eltávolítanak belőle:
- Ha a „Visszavételi sorelemek” csoport valamelyik mezőjét figyeli, a munkafolyamat akkor indul el, amikor egy sorelemet hozzáadnak a visszavételhez vagy eltávolítanak belőle.
- Ha visszárukezelési díjhoz kapcsolódó mezőt figyel, például a
returnLineItems.restockingFee.percentagemezőt, akkor a munkafolyamat a visszárukezelési díj sorelemhez való hozzáadásakor vagy onnan való eltávolításakor indul el. - Ha az
exchangeLineItemsmezőt figyeli, akkor egy cseretétel hozzáadása a visszavételhez vagy eltávolítása a visszavételből elindítja a munkafolyamatot. - Ha a „Visszaküldési szállítási díjak” csoport valamelyik mezőjét figyeli, akkor egy visszaküldési szállítási díj hozzáadása vagy eltávolítása elindítja a munkafolyamatot.
- Ha a „Visszaküldési rendelések” csoport valamelyik mezőjét figyeli, akkor egy visszaküldési rendelés hozzáadása a visszavételhez elindítja a munkafolyamatot. Ha a
reverseFulfillmentOrdersvagy areverseFulfillmentOrders.lineItemsmezőt figyeli, akkor egy sorelem eltávolítása a visszaküldési rendelésből szintén elindítja a munkafolyamatot.
A munkafolyamatot elindító mezők kiválasztása
Válassza ki azokat a mezőket, amelyek változásakor elindul a munkafolyamat.
Lépések:
- A munkafolyamat-szerkesztőben kattintson a „Visszavétel frissítve” kiváltóra.
- A „Visszavételi mezők kiválasztása” szakaszban kattintson a „Mezők kiválasztása” gombra.
- A „Figyelendő mező hozzáadása” párbeszédpanelen kereséssel vagy böngészéssel keresse meg a figyelni kívánt mezőt, majd válassza ki.
- Nem kötelező: Ismételje meg a 2. és a 3. lépést további mezők figyeléséhez. Legfeljebb öt mezőt figyelhet.
Mezők
A „Visszavétel frissítve” kiváltó az alábbi mezőket tartalmazza. Ezek feltételekben és műveletekben használhatók, valamint adatok kérhetők le velük a munkafolyamatban. A „Visszavétel” és az „Üzlet” mező mindig elérhető. A többi mező csak akkor érhető el, ha egy kapcsolódó mezőt figyel. A „Visszaküldési rendelés” mező például akkor érhető el, ha egy visszaküldési rendeléshez tartozó mezőt, például a reverseFulfillmentOrders.status mezőt figyeli.
| Mező | Leírás |
|---|---|
| Visszavétel | A frissített visszavétel. |
| Üzlet | Az üzlet, ahol a visszavételt frissítették. |
| Visszavételi sorelem | A módosult visszavételi sorelem. Üres, ha egy sorelemet eltávolítottak a visszavételből. Akkor érhető el, ha a returnLineItems.quantity mezőt vagy a visszárukezelési díj valamelyik mezőjét figyeli. |
| Cseresorelem | A hozzáadott cseresorelem. Üres, ha eltávolítottak egy cseresorelemet. Az exchangeLineItems mező figyelésekor érhető el. |
| Visszaküldési rendelés | A megváltozott visszaküldési rendelés. Akkor érhető el, ha egy visszaküldési rendeléshez tartozó mezőt figyel. |
Ha különböző típusú mezőket figyel, akkor a „Visszavételi sorelem”, a „Csere soreleme” és a „Visszaküldési rendelés” mező üres lehet a munkafolyamat futásakor. Ha például a status és a returnLineItems.quantity mezőt is figyeli, akkor a „Visszavételi sorelem” mező üres, ha csak az állapot változik. A „Visszavételi sorelem” és a „Csere soreleme” mező akkor is üres lehet, ha csak az adott típushoz tartozó mezőket figyel. Mielőtt e mezők valamelyikét egy műveletben használná, adjon hozzá egy feltételt, amely ellenőrzi, hogy a mezőnek van-e értéke.
A „Visszavétel frissítve” kiváltó csak a visszavétel és a hozzá tartozó sorelemek aktuális értékeit biztosítja. A megváltozott mezők korábbi értékei nem érhetők el a munkafolyamatban. Ha például a status mezőt figyeli, akkor a visszavétel aktuális állapotát használhatja egy feltételben vagy műveletben, a változás előtti állapotát azonban nem.
Műveletek
Ez a kiváltó egy visszavételi objektumot biztosít, így minden olyan művelet használható vele, amelyhez visszavétel szükséges. Mivel a visszavételi objektum egy rendelést is tartalmaz, a kiváltó bármely rendelési művelettel is használható, például az alábbiakkal:
- Rendelési sorelem hozzáadása
- Rendelési címkék hozzáadása
- Rendelés archiválása
- Rendelés lemondása
- Fizetésbegyűjtés
- Rendelésteljesítés felfüggesztése
- Rendelés megjelölése kifizetettként
A rendeléseken keresztül más adatok, például a vásárló adatai is elérhetők, így a kiváltó a vásárlókhoz kapcsolódó műveletekkel is használható. Ilyenek például:
- Vásárlói címkék hozzáadása
- Vásárlói metamező eltávolítása
- Vásárlói címkék eltávolítása
- Vásárlói metamező frissítése
- Vásárlói megjegyzés frissítése
A rendelések listákba rendezett adatokat, például sorelemeket is tartalmaznak. A „Minden elemre” művelettel végighaladhat ezeken a listákon, és minden elemen műveleteket végezhet. Például végighaladhat a sorelemeken, és minden termékhez hozzáadhat egy címkét.
A „Visszavétel frissítve” kiváltó tesztelése
Az ezzel a kiváltóval induló munkafolyamat teszteléséhez kapcsolja be a munkafolyamatot, majd a Shopify adminisztrációs felületén módosítsa egy visszavétel valamelyik olyan mezőjét, amelyet a munkafolyamat figyel. Például hozzon létre egy visszavételt, majd dolgozza fel vagy zárja le.
API-részletek
A „Visszavétel frissítve” kiváltóval műveletek végezhetők a GraphQL API Return objektumán. Ez a kiváltó a Shopify Events referenciájában szereplő Return témakör update műveletének felel meg, a figyelésre kiválasztott mezőkre szűrve.