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.

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.

A „Visszavétel frissítve” kiváltóval figyelhető mezők.
MezőtípusMezők
VisszavételclosedAt, decline, requestApprovedAt, status
Visszavételi sorelemekreturnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity
Csere sorelemeiexchangeLineItems
Visszaküldési szállítási díjakreturnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney
Visszaküldési rendelésekreverseFulfillmentOrders, 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.percentage mező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 exchangeLineItems mező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 reverseFulfillmentOrders vagy a reverseFulfillmentOrders.lineItems mező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:

  1. A munkafolyamat-szerkesztőben kattintson a „Visszavétel frissítve” kiváltóra.
  2. A „Visszavételi mezők kiválasztása” szakaszban kattintson a „Mezők kiválasztása” gombra.
  3. 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.
  4. 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.

A „Visszavétel frissítve” kiváltó mezői.
MezőLeírás
VisszavételA frissített visszavétel.
ÜzletAz üzlet, ahol a visszavételt frissítették.
Visszavételi sorelemA 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.
CseresorelemA hozzáadott cseresorelem. Üres, ha eltávolítottak egy cseresorelemet. Az exchangeLineItems mező figyelésekor érhető el.
Visszaküldési rendelésA 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:

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:

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.