Uaktualniono zwrot

Wyzwalacz Uaktualniono zwrot uruchamia przepływ pracy, gdy w sklepie zmieni się co najmniej jedno pole zwrotu, jego pozycji pojedynczych lub procesów odwrotnej realizacji. Wybierasz istotne pola zwrotu, a przepływ pracy uruchamia się tylko wtedy, gdy jedno z nich się zmieni, na przykład po zmianie statusu zwrotu lub dodaniu opłaty za zwrot do magazynu.

Aby uruchomić przepływ pracy, gdy zwrot osiągnie określony etap, możesz też użyć wyzwalacza dla tego etapu, takiego jak Zgłoszono zwrot, Zatwierdzono zwrot lub Zamknięto zwrot.

Pola dostępne do monitorowania

Wyzwalacz Uaktualniono zwrot wymaga wybrania co najmniej jednego pola do monitorowania. Możesz wybrać maksymalnie pięć pól. Zmiana dowolnego z wybranych pól uruchamia przepływ pracy. Zmiany w niewybranych polach nie uruchamiają przepływu pracy.

Zapoznaj się z poniższą tabelą, aby dowiedzieć się więcej o polach, które możesz monitorować.

Pola, które możesz monitorować za pomocą wyzwalacza „Uaktualniono zwrot”.
Typ polaPola
ZwrotclosedAt, decline, requestApprovedAt, status
Pozycje pojedyncze zwrotureturnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity
Pozycje pojedyncze wymianyexchangeLineItems
Opłaty za zwrotreturnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney
Procesy odwrotnej realizacjireverseFulfillmentOrders, reverseFulfillmentOrders.lineItems, reverseFulfillmentOrders.status

Pole o nazwie kończącej się na amountSet zawiera kwotę w dwóch walutach. Gdy monitorujesz to pole, zmiana dowolnej z tych kwot uruchamia przepływ pracy. Aby monitorować tylko jedną z kwot, wybierz jego pole shopMoney dla kwoty w walucie sklepu lub pole presentmentMoney dla kwoty w walucie klienta.

Niektóre pola uruchamiają przepływ pracy również wtedy, gdy pozycja zostanie dodana do zwrotu lub z niego usunięta:

  • Jeśli monitorujesz pole w grupie Pozycje pojedyncze zwrotu, dodanie pozycji pojedynczej do zwrotu lub jej usunięcie ze zwrotu uruchamia przepływ pracy.
  • Jeśli monitorujesz pole opłaty za zwrot do magazynu, np. returnLineItems.restockingFee.percentage, dodanie tej opłaty do pozycji pojedynczej lub jej usunięcie uruchamia przepływ pracy.
  • Jeśli monitorujesz pole exchangeLineItems, dodanie pozycji wymiany do zwrotu lub usunięcie jej ze zwrotu uruchamia przepływ pracy.
  • Jeśli monitorujesz pole w grupie Opłaty za zwrot, dodanie lub usunięcie opłaty za zwrot uruchamia przepływ pracy.
  • Jeśli monitorujesz pole w grupie Procesy odwrotnej realizacji, dodanie procesu odwrotnej realizacji do zwrotu uruchamia przepływ pracy. Jeśli monitorujesz pole reverseFulfillmentOrders lub reverseFulfillmentOrders.lineItems, usunięcie pozycji pojedynczej z procesu odwrotnej realizacji również uruchamia przepływ pracy.

Wybierz pola, których zmiany uruchamiają przepływ pracy

Wybierz pola, których zmiana uruchamia przepływ pracy.

Kroki:

  1. W edytorze przepływu pracy kliknij wyzwalacz Uaktualniono zwrot.
  2. W sekcji Wybierz pola zwrotu kliknij Wybierz pola.
  3. W oknie dialogowym Dodaj pole do monitorowania wyszukaj pole, które chcesz monitorować, lub znajdź je na liście, a następnie je wybierz.
  4. Opcjonalnie: powtórz kroki 2 i 3, aby monitorować maksymalnie pięć pól.

Pola

Wyzwalacz Uaktualniono zwrot zawiera poniższe pola, których można używać w warunkach i działaniach oraz do pobierania danych w przepływie pracy. Pola Zwrot i Sklep są zawsze dostępne. Pozostałe pola są dostępne tylko wtedy, gdy monitorujesz powiązane pole. Na przykład pole Proces odwrotnej realizacji jest dostępne, gdy monitorujesz pole procesu odwrotnej realizacji, takie jak reverseFulfillmentOrders.status.

Pola w wyzwalaczu „Uaktualniono zwrot”.
PoleOpis
ZwrotZwrot, który został uaktualniony.
SklepSklep, w którym uaktualniono zwrot.
Pozycja pojedyncza zwrotuPozycja pojedyncza zwrotu, która uległa zmianie. Pole jest puste, gdy usunięto pozycję pojedynczą ze zwrotu. Jest dostępne, gdy monitorujesz pole returnLineItems.quantity lub pole opłaty za zwrot do magazynu.
Pozycja pojedyncza wymianyDodana pozycja pojedyncza wymiany. Pole jest puste, gdy usunięto pozycję pojedynczą wymiany. Jest dostępne, gdy monitorujesz pole exchangeLineItems.
Proces odwrotnej realizacjiProces odwrotnej realizacji, który uległ zmianie. Pole jest dostępne, gdy monitorujesz pole procesu odwrotnej realizacji.

Jeśli monitorujesz pola różnych typów, pola Pozycja pojedyncza zwrotu, Pozycja pojedyncza wymiany i Proces odwrotnej realizacji mogą być puste podczas wykonywania przepływu pracy. Jeśli na przykład monitorujesz zarówno pole status, jak i returnLineItems.quantity, pole Pozycja pojedyncza zwrotu jest puste, gdy zmienia się tylko status. Pola Pozycja pojedyncza zwrotu i Pozycja pojedyncza wymiany mogą być puste nawet wtedy, gdy monitorujesz wyłącznie pola danego typu. Zanim użyjesz jednego z tych pól w działaniu, dodaj warunek sprawdzający, czy pole ma wartość.

Wyzwalacz Uaktualniono zwrot udostępnia tylko bieżące wartości pól zwrotu i jego pozycji pojedynczych. Poprzednie wartości zmienionych pól nie są dostępne w przepływie pracy. Jeśli na przykład monitorujesz pole status, możesz użyć bieżącego statusu zwrotu w warunku lub działaniu, ale nie możesz użyć statusu sprzed zmiany.

Działania

Ten wyzwalacz udostępnia obiekt zwrotu, dzięki czemu możesz używać dowolnego działania, które wymaga zwrotu. Ponieważ obiekt zwrotu zawiera również zamówienie, wyzwalacza można też używać z dowolnymi działaniami dotyczącymi zamówień, w tym:

Zamówienia zapewniają dostęp do innych danych, takich jak dane klienta, więc wyzwalacz może być też używany z działaniami dotyczącymi klientów. Należą do nich:

Zamówienia zawierają też listy danych, takich jak pozycje pojedyncze. Za pomocą działania Dla każdego możesz przechodzić kolejno przez elementy tych list i wykonywać działania na każdym z nich. Na przykład możesz przejść przez pozycje pojedyncze i dodać tag do każdego produktu.

Testowanie wyzwalacza „Uaktualniono zwrot”

Aby przetestować przepływ pracy uruchamiany przez ten wyzwalacz, włącz go, a następnie w panelu administracyjnym Shopify zmień w zwrocie jedno z pól monitorowanych przez przepływ pracy. Na przykład utwórz zwrot, a następnie przetwórz go lub zamknij.

Szczegóły API

Wyzwalacz Uaktualniono zwrot umożliwia wykonywanie działań na obiekcie Return w API GraphQL. Ten wyzwalacz odpowiada działaniu update dla tematu Return w dokumentacji systemu Shopify Events, z filtrowaniem według pól wybranych do monitorowania.