Повернення оновлено

Тригер Повернення оновлено запускає робочий процес, коли у вашому магазині змінюється одне або кілька полів повернення, його позицій чи замовлень на повернення. Ви вибираєте потрібні поля повернення, і робочий процес запускається, лише коли змінюється одне з них, наприклад коли змінюється статус повернення або додається комісія за повернення на склад.

Щоб запускати робочий процес, коли повернення досягає певного етапу, можна також використовувати тригер для цього етапу, наприклад Надіслано запит на повернення, Повернення схвалено або Повернення закрито.

Поля, доступні для відстеження

Для тригера Повернення оновлено потрібно вибрати принаймні одне поле для відстеження. Можна вибрати до п’яти полів. Коли змінюється будь-яке з вибраних полів, запускається робочий процес. Зміни в полях, які ви не вибрали, не запускають робочий процес.

Докладні відомості про поля, які можна відстежувати, наведено в таблиці нижче.

Поля, які можна відстежувати за допомогою тригера «Повернення оновлено».
Тип поляПоля
ПоверненняclosedAt, decline, requestApprovedAt, status
Позиції поверненняreturnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity
Позиції обмінуexchangeLineItems
Плата за зворотну доставкуreturnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney
Замовлення на поверненняreverseFulfillmentOrders, reverseFulfillmentOrders.lineItems, reverseFulfillmentOrders.status

Поле, назва якого закінчується на amountSet, містить суму у двох валютах. Якщо ви відстежуєте це поле, зміна суми в будь-якій із валют запускає робочий процес. Щоб відстежувати лише одну із сум, виберіть вкладене поле shopMoney для суми у валюті магазину або presentmentMoney для суми у валюті клієнта.

Відстеження деяких полів також запускає робочий процес, коли одиницю додають до повернення або видаляють із нього:

  • Якщо ви відстежуєте поле в групі Позиції повернення, додавання позиції до повернення або її видалення з повернення запускає робочий процес.
  • Якщо ви відстежуєте поле комісії за повернення на склад, як-от returnLineItems.restockingFee.percentage, додавання такої комісії до позиції або її видалення запускає робочий процес.
  • Якщо ви відстежуєте поле exchangeLineItems, додавання одиниці для обміну до повернення або її видалення з повернення запускає робочий процес.
  • Якщо ви відстежуєте поле в групі Плата за зворотну доставку, додавання або видалення плати за зворотну доставку запускає робочий процес.
  • Якщо ви відстежуєте поле в групі Замовлення на повернення, додавання замовлення на повернення до повернення запускає робочий процес. Якщо ви відстежуєте поле reverseFulfillmentOrders або reverseFulfillmentOrders.lineItems, видалення позиції із замовлення на повернення також запускає робочий процес.

Вибір полів, зміни яких запускають робочий процес

Виберіть поля, зміни в яких запускають робочий процес.

Кроки:

  1. У редакторі робочого процесу натисніть тригер Повернення оновлено.
  2. У розділі Вибір полів повернення натисніть Вибрати поля.
  3. У діалоговому вікні Додати поле для відстеження знайдіть потрібне поле за допомогою пошуку або перегляду списку, а потім виберіть його.
  4. Необов’язково: повторіть кроки 2 й 3, щоб відстежувати до п’яти полів.

Поля

Тригер Повернення оновлено містить наведені нижче поля, які можна використовувати в умовах і діях, а також для отримання даних у робочому процесі. Поля Повернення та Магазин доступні завжди. Інші поля доступні, лише коли ви відстежуєте пов’язане поле. Наприклад, поле Замовлення на повернення доступне, коли ви відстежуєте поле замовлення на повернення, як-от reverseFulfillmentOrders.status.

Поля тригера «Повернення оновлено».
ПолеОпис
ПоверненняПовернення, яке було оновлено.
МагазинМагазин, у якому оновлено повернення.
Позиція поверненняПозиція повернення, яку змінено. Поле порожнє, якщо позицію видалено з повернення. Доступне, якщо ви відстежуєте поле returnLineItems.quantity або поле комісії за повернення на склад.
Позиція обмінуПозиція обміну, яку додано. Поле порожнє, якщо позицію обміну видалено. Доступне, якщо ви відстежуєте поле exchangeLineItems.
Замовлення на поверненняЗамовлення на повернення, у якому відбулися зміни. Доступне, коли ви відстежуєте поле замовлення на повернення.

Якщо ви відстежуєте поля різних типів, поля Позиція повернення, Позиція обміну та Замовлення на повернення можуть бути порожніми під час запуску робочого процесу. Наприклад, якщо ви відстежуєте і status, і returnLineItems.quantity, поле Позиція повернення буде порожнім, коли змінюється лише статус. Поля Позиція повернення та Позиція обміну можуть бути порожніми, навіть якщо ви відстежуєте лише поля відповідного типу. Перш ніж використовувати одне з цих полів у дії, додайте умову, яка перевіряє, чи має поле значення.

Тригер Повернення оновлено надає лише поточні значення полів повернення та його позицій. Попередні значення змінених полів недоступні в робочому процесі. Наприклад, якщо ви відстежуєте поле status, в умові або дії можна використовувати поточний статус повернення, але не статус до зміни.

Дії

Цей тригер надає об’єкт повернення, тому дає змогу використовувати будь-яку дію, для якої потрібне повернення. Крім того, об’єкт повернення містить замовлення, тож тригер можна використовувати з будь-якими діями для замовлень, зокрема:

Замовлення надають доступ до інших даних, зокрема про клієнта, тому цей тригер можна використовувати з діями для клієнтів. Серед них:

Замовлення також містять списки даних, наприклад позицій. За допомогою дії Для кожного можна перебрати елементи цих списків і виконати дії з кожним із них. Наприклад, можна перебрати позиції й додати тег до кожного товару.

Тестування тригера «Повернення оновлено»

Щоб протестувати робочий процес, який запускається цим тригером, увімкніть його, а потім у панелі адміністрування Shopify змініть у поверненні одне з полів, які відстежує робочий процес. Наприклад, створіть повернення, а потім обробіть його або закрийте.

Відомості про API

Тригер Повернення оновлено дає змогу виконувати дії з об’єктом Return у GraphQL API. Цей тригер відповідає дії update для теми Return у довіднику Shopify Events з фільтруванням за полями, які ви вибрали для відстеження.