Tagastust uuendati
Käivitaja Tagastust uuendati käivitab töövoo, kui sinu poes muutub üks või mitu tagastuse, selle reaüksuste või tagastustellimuste välja. Valid ise olulised tagastuse väljad ja töövoog käivitub ainult siis, kui mõni neist muutub, näiteks tagastuse oleku muutumisel või laovarude taastamise tasu lisamisel.
Töövoo käivitamiseks siis, kui tagastus jõuab kindlasse etappi, saad kasutada ka selle etapi käivitajat, näiteks Tagastust taotleti, Tagastus kinnitati või Tagastus suleti.
Sellel lehel
Jälgimiseks saadaolevad väljad
Käivitaja Tagastust uuendati kasutamiseks pead valima vähemalt ühe jälgitava välja. Saad valida kuni viis välja. Töövoog käivitub, kui mõni valitud väljadest muutub. Valimata väljade muutused töövoogu ei käivita.
Lisateavet jälgitavate väljade kohta leiad järgmisest tabelist.
| Välja tüüp | Väljad |
|---|---|
| Tagastus | closedAt, decline, requestApprovedAt, status |
| Tagastuse reaüksused | returnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity |
| Vahetuse reaüksused | exchangeLineItems |
| Tagastuse saatekulud | returnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney |
| Tagastustellimused | reverseFulfillmentOrders, reverseFulfillmentOrders.lineItems, reverseFulfillmentOrders.status |
Väli, mille nime lõpus on amountSet, sisaldab summat kahes valuutas. Kui jälgid seda välja, käivitab töövoo kummagi summa muutus. Ainult ühe summa jälgimiseks vali selle välja alamväli shopMoney, et jälgida summat poe valuutas, või alamväli presentmentMoney, et jälgida summat kliendi valuutas.
Mõne välja jälgimisel käivitub töövoog ka üksuse lisamisel tagastusele või tagastusest eemaldamisel:
- Kui jälgid rühmas Tagastuse reaüksused mõnd välja, käivitub töövoog reaüksuse lisamisel tagastusele või eemaldamisel tagastusest.
- Kui jälgid laovarude taastamise tasu välja, näiteks
returnLineItems.restockingFee.percentage, käivitub töövoog siis, kui reaüksusele lisatakse laovarude taastamise tasu või see eemaldatakse. - Kui jälgid välja
exchangeLineItems, käivitub töövoog vahetusüksuse lisamisel tagastusele või tagastusest eemaldamisel. - Kui jälgid välja rühmas Tagastuse saatekulud, käivitub töövoog tagastuse saatekulu lisamisel või eemaldamisel.
- Kui jälgid välja rühmas Tagastustellimused, käivitub töövoog tagastusele tagastustellimuse lisamisel. Kui jälgid välja
reverseFulfillmentOrdersvõireverseFulfillmentOrders.lineItems, käivitub töövoog ka reaüksuse eemaldamisel tagastustellimusest.
Vali väljad, mille muutumisel töövoog käivitub
Vali väljad, mille muutumisel töövoog käivitub.
Sammud:
- Klõpsa töövooredaktoris käivitajal Tagastus uuendatud.
- Klõpsa jaotises Vali tagastuse väljad nuppu Vali väljad.
- Otsi dialoogiaknas Lisa jälgitav väli välja, mida soovid jälgida, või leia see sirvides ning vali see.
- Valikuline: korda 2. ja 3. sammu, et jälgida kuni viit välja.
Väljad
Käivitaja Tagastust uuendati sisaldab järgmisi välju, mida saab kasutada tingimustes ja toimingutes ning töövoos andmete hankimiseks. Väljad Tagastus ja Pood on alati saadaval. Muud väljad on saadaval ainult siis, kui jälgid nendega seotud välja. Näiteks väli Tagastustellimus on saadaval, kui jälgid tagastustellimuse välja, näiteks reverseFulfillmentOrders.status.
| Väli | Kirjeldus |
|---|---|
| Tagastus | Tagastus, mida uuendati. |
| Pood | Pood, kus tagastust uuendati. |
| Tagastuse reaüksus | Muutunud tagastuse reaüksus. Tühi, kui reaüksus eemaldati tagastusest. Saadaval, kui jälgid välja returnLineItems.quantity või mõnd laovarude taastamise tasu välja. |
| Vahetuse reaüksus | Lisatud vahetuse reaüksus. Tühi, kui vahetuse reaüksus eemaldati. Saadaval, kui jälgid välja exchangeLineItems. |
| Tagastustellimus | Tagastustellimus, mis muutus. Saadaval, kui jälgid tagastustellimuse välja. |
Kui jälgid eri tüüpi välju, võivad väljad Tagastuse reaüksus, Vahetuse reaüksus ja Tagastustellimus töövoo käivitumisel tühjad olla. Näiteks kui jälgid nii välja status kui ka välja returnLineItems.quantity, on väli Tagastuse reaüksus tühi, kui muutub ainult olek. Väljad Tagastuse reaüksus ja Vahetuse reaüksus võivad tühjad olla ka siis, kui jälgid ainult nende tüübile vastavaid välju. Enne nende väljade kasutamist toimingus lisa tingimus, mis kontrollib, kas väljal on väärtus.
Käivitaja Tagastust uuendati annab ainult tagastuse ja selle reaüksuste praegused väärtused. Muutunud väljade varasemad väärtused pole töövoos saadaval. Näiteks kui jälgid välja status, saad tingimuses või toimingus kasutada tagastuse praegust olekut, kuid mitte muutmiseelset olekut.
Toimingud
See käivitaja annab tagastusobjekti, seega saad kasutada kõiki toiminguid, mis nõuavad tagastust. Kuna tagastusobjekt sisaldab ka tellimust, saab käivitajat kasutada kõigi tellimusega seotud toimingutega, sealhulgas:
- Lisa tellimuse reaüksus
- Lisa tellimuse sildid
- Arhiveeri tellimus
- Tühista tellimus
- Hõiva makse
- Pane täitmistellimus ootele
- Märgi tellimus tasutuks
Tellimuste kaudu pääsed ligi ka muudele andmetele, näiteks kliendiandmetele, seega saab käivitajat kasutada ka kliendiga seotud toimingutega. Nende hulka kuuluvad:
- Lisa kliendi sildid
- Eemalda kliendi metaväli
- Eemalda kliendi sildid
- Uuenda kliendi metavälja
- Uuenda kliendi märget
Tellimused sisaldavad ka andmeloendeid, näiteks reaüksuste loendit. Toiminguga Iga üksuse puhul saad need loendid läbi käia ja iga üksusega toiminguid teha. Näiteks saad reaüksused läbi käia ja lisada igale tootele sildi.
Käivitaja „Tagastust uuendati“ testimine
Selle käivitajaga algava töövoo testimiseks lülita töövoog sisse ja muuda seejärel Shopify administraatoris tagastuse üht välja, mida töövoog jälgib. Näiteks loo tagastus ja seejärel töötle tagastust või sule tagastus.
API üksikasjad
Käivitaja Tagastust uuendati võimaldab teha toiminguid GraphQL API objektiga Return. See käivitaja vastab Shopify Events teatmikus kirjeldatud teema Return toimingule update, mille puhul arvestatakse ainult jälgimiseks valitud välju.