Повернення оновлено
Тригер Повернення оновлено запускає робочий процес, коли у вашому магазині змінюється одне або кілька полів повернення, його позицій чи замовлень на повернення. Ви вибираєте потрібні поля повернення, і робочий процес запускається, лише коли змінюється одне з них, наприклад коли змінюється статус повернення або додається комісія за повернення на склад.
Щоб запускати робочий процес, коли повернення досягає певного етапу, можна також використовувати тригер для цього етапу, наприклад Надіслано запит на повернення, Повернення схвалено або Повернення закрито.
На цій сторінці
Поля, доступні для відстеження
Для тригера Повернення оновлено потрібно вибрати принаймні одне поле для відстеження. Можна вибрати до п’яти полів. Коли змінюється будь-яке з вибраних полів, запускається робочий процес. Зміни в полях, які ви не вибрали, не запускають робочий процес.
Докладні відомості про поля, які можна відстежувати, наведено в таблиці нижче.
| Тип поля | Поля |
|---|---|
| Повернення | 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, видалення позиції із замовлення на повернення також запускає робочий процес.
Вибір полів, зміни яких запускають робочий процес
Виберіть поля, зміни в яких запускають робочий процес.
Кроки:
- У редакторі робочого процесу натисніть тригер Повернення оновлено.
- У розділі Вибір полів повернення натисніть Вибрати поля.
- У діалоговому вікні Додати поле для відстеження знайдіть потрібне поле за допомогою пошуку або перегляду списку, а потім виберіть його.
- Необов’язково: повторіть кроки 2 й 3, щоб відстежувати до п’яти полів.
Поля
Тригер Повернення оновлено містить наведені нижче поля, які можна використовувати в умовах і діях, а також для отримання даних у робочому процесі. Поля Повернення та Магазин доступні завжди. Інші поля доступні, лише коли ви відстежуєте пов’язане поле. Наприклад, поле Замовлення на повернення доступне, коли ви відстежуєте поле замовлення на повернення, як-от reverseFulfillmentOrders.status.
| Поле | Опис |
|---|---|
| Повернення | Повернення, яке було оновлено. |
| Магазин | Магазин, у якому оновлено повернення. |
| Позиція повернення | Позиція повернення, яку змінено. Поле порожнє, якщо позицію видалено з повернення. Доступне, якщо ви відстежуєте поле returnLineItems.quantity або поле комісії за повернення на склад. |
| Позиція обміну | Позиція обміну, яку додано. Поле порожнє, якщо позицію обміну видалено. Доступне, якщо ви відстежуєте поле exchangeLineItems. |
| Замовлення на повернення | Замовлення на повернення, у якому відбулися зміни. Доступне, коли ви відстежуєте поле замовлення на повернення. |
Якщо ви відстежуєте поля різних типів, поля Позиція повернення, Позиція обміну та Замовлення на повернення можуть бути порожніми під час запуску робочого процесу. Наприклад, якщо ви відстежуєте і status, і returnLineItems.quantity, поле Позиція повернення буде порожнім, коли змінюється лише статус. Поля Позиція повернення та Позиція обміну можуть бути порожніми, навіть якщо ви відстежуєте лише поля відповідного типу. Перш ніж використовувати одне з цих полів у дії, додайте умову, яка перевіряє, чи має поле значення.
Тригер Повернення оновлено надає лише поточні значення полів повернення та його позицій. Попередні значення змінених полів недоступні в робочому процесі. Наприклад, якщо ви відстежуєте поле status, в умові або дії можна використовувати поточний статус повернення, але не статус до зміни.
Дії
Цей тригер надає об’єкт повернення, тому дає змогу використовувати будь-яку дію, для якої потрібне повернення. Крім того, об’єкт повернення містить замовлення, тож тригер можна використовувати з будь-якими діями для замовлень, зокрема:
- Додати позицію замовлення
- Додати теги замовлення
- Архівувати замовлення
- Скасувати замовлення
- Списання платежу
- Призупинити замовлення на виконання
- Позначити замовлення як оплачене
Замовлення надають доступ до інших даних, зокрема про клієнта, тому цей тригер можна використовувати з діями для клієнтів. Серед них:
- Додати теги клієнта
- Видалити метаполе клієнта
- Видалити теги клієнта
- Оновити метаполе клієнта
- Оновити примітку про клієнта
Замовлення також містять списки даних, наприклад позицій. За допомогою дії Для кожного можна перебрати елементи цих списків і виконати дії з кожним із них. Наприклад, можна перебрати позиції й додати тег до кожного товару.
Тестування тригера «Повернення оновлено»
Щоб протестувати робочий процес, який запускається цим тригером, увімкніть його, а потім у панелі адміністрування Shopify змініть у поверненні одне з полів, які відстежує робочий процес. Наприклад, створіть повернення, а потім обробіть його або закрийте.
Відомості про API
Тригер Повернення оновлено дає змогу виконувати дії з об’єктом Return у GraphQL API. Цей тригер відповідає дії update для теми Return у довіднику Shopify Events з фільтруванням за полями, які ви вибрали для відстеження.