E-commerce 6 хв читання

Як автоматизувати статуси замовлень між e-shop, складом і перевізником через n8n

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

Як автоматизувати статуси замовлень між e-shop, складом і перевізником через n8n
Автор: Maksym Kamenchuk, Nexflow — Banská Bystrica Опубліковано Оновлено

Подію в e-shop можна використати як тригер. E-shop надсилає вебхук (сповіщення про подію на задану адресу) до n8n, workflow викликає систему складу або перевізника через HTTP-запит, а з відповіді обробляє дані, наприклад номер відправлення.

WooCommerce має для цього власні вебхуки та статуси замовлень. Shoptet має статуси замовлень зі статусними e-mail і доповнення для автоматичного перемикання статусів. Помилки в n8n перехоплює окремий workflow, який надсилає вам сповіщення.

З чого складається ланцюжок замовлення

З погляду клієнта це одне замовлення. Технічно це три системи, які мають однаково знати про нього: e-shop, склад і перевізник. Ручна робота виникає там, де хтось переписує дані між ними.

  1. Клієнт створює замовлення, і e-shop призначає йому статус.
  2. E-shop надсилає сповіщення до n8n.
  3. n8n передає замовлення на склад.
  4. n8n створює відправлення в перевізника й отримує номер відправлення.
  5. Номер відправлення зберігається там, де він вам потрібен, а статус замовлення оновлюється.
  6. Клієнт отримує повідомлення про відправлення.

Конкретні API складу, перевізника й e-shop відрізняються. Принцип той самий: надішліть дані, отримайте відповідь, збережіть її. Чи можна записати дані назад у замовлення і як саме, залежить від API конкретного e-shop. Точний вигляд запитів завжди потрібно дізнаватися з документації провайдера.

Статуси замовлень у WooCommerce і Shoptet

Спершу треба знати, які статуси має e-shop, бо саме до них прив'язується workflow. У WooCommerce кожне замовлення має статус, що визначає, на якому етапі оплати, виконання, скасування чи повернення коштів воно перебуває.

Статус у WooCommerceЩо означає за документацією
Pending paymentзамовлення прийняте, оплата ще не відбулася
Processingоплату отримано, залишки зменшено, замовлення чекає на виконання
On holdочікує підтвердження оплати, залишки зменшено
Completedзамовлення виконано, жодних подальших дій не потрібно
Failedоплата не вдалася або була відхилена
Cancelledскасовано адміністратором або клієнтом
Refundedвартість замовлення повністю повернено після оплати

Раджу для складу відстежувати статус Processing, тобто оплачено й очікує виконання. Згідно з документацією WooCommerce у ньому вже зменшуються залишки.

Shoptet має системні статуси Vybavená (виконана), Vybavuje sa (виконується), Nevybavená (не виконана) і Stornovaná (скасована), які не можна видалити. Нове замовлення отримує статус, позначений як типовий. До статусу можна прив'язати й статусний e-mail, що надсилається під час зміни, та документи, які створюються під час переходу. Подробиці є в підтримці Shoptet.

Якщо Shoptet уже надсилає статусний e-mail під час зміни статусу, не додавайте в n8n друге повідомлення з таким самим змістом. Клієнт отримав би два.

Як замовлення запускає workflow в n8n

WooCommerce може надсилати автоматичні сповіщення про події на вибрану вами адресу. Для замовлень це теми order.created, order.updated і order.deleted, як зазначає документація REST API. Яка тема перехоплює зміну статусу, перевірте під час налаштування вебхука на тестовому замовленні.

В n8n цю адресу створює вузол Webhook. Це вузол-тригер, який може запустити workflow. Він має дві адреси: тестову, що реєструється під час ручного очікування тестової події, і продуктивну, що реєструється після публікації workflow.

Докладніше про підключення Shoptet пишу в статті Shoptet a n8n: prepojenie cez API a webhooky, про WooCommerce — у статті Automatizácia e-shopu cez n8n.

Передання на склад і створення відправлення

Комунікацію зі складом і перевізником забезпечує вузол HTTP Request. За документацією n8n через нього можна звертатися до будь-якого застосунку чи сервісу з REST API. Доступні методи: DELETE, GET, HEAD, OPTIONS, PATCH, POST і PUT.

  1. Передання на склад: POST з даними про замовлення на адресу складської системи.
  2. Створення відправлення: POST на API перевізника з адресою та параметрами посилки.
  3. Обробка відповіді: з відповіді перевізника workflow вибирає номер відправлення.
  4. Збереження даних: принцип той самий, номер надсилається наступним запитом туди, де він вам потрібен. Як саме, залежить від API вашого e-shop.
  5. Сповіщення клієнта: повідомлення з номером відправлення.

Якщо ви використовуєте Balíkobot або інший підтримуваний сервіс, доповнення Shoptet для автоматизації замовлень може підключатися через API-ключі та створювати правила навіть із даних відстеження відправлень. Для простого випадку цього може вистачити без власного workflow.

Очікування перевізника: де роблять помилку

Природно уявити workflow, яке створює відправлення, засинає й прокидається, коли перевізник надсилає зміну статусу. Проте за дискусією в спільноті n8n вузол Wait під час очікування вебхука не має фіксованої адреси, яку можна було б задати. Під час роботи він генерує власну адресу для кожного запуску, доступну як {{$execution.resumeUrl}}.

Пояснення з тієї самої дискусії: адреса містить ідентифікатор конкретного запущеного виконання, і n8n має знати, яке виконання відновити. Тому перевізникові нема що вказати як одну фіксовану адресу.

Раджу розділити це. Одне workflow створює відправлення й записує його номер. Друге має вузол Webhook із фіксованим шляхом, який ви вказуєте перевізникові, і під час кожної отриманої зміни статусу знаходить замовлення та обробляє його. Це той самий підхід, що пропонує й згадана дискусія.

Помилки та збої

WooCommerce автоматично вимикає вебхук після понад п'яти поспіль невдалих доставок. Невдачею вважається кожна відповідь, інша ніж 2xx, 301 або 302, тобто й 4xx та 5xx. За моїм міркуванням це означає: якщо n8n під час тривалого збою не відповідає, нові замовлення можуть перестати надходити до workflow, а ніхто цього не помітить.

В n8n для кожного workflow можна налаштувати workflow для помилок. Воно запускається, коли виконання завершується невдачею, і може надіслати e-mail або повідомлення в Slack. Починатися воно має вузлом Error Trigger.

Раджу час від часу перевіряти в адмінці WooCommerce, чи вебхук досі активний. Workflow для помилок — інструмент n8n, тому, за моїм міркуванням, воно не покриє вимкнення вебхука на боці e-shop.

Коли це не окупається

Як думати про окупність, описує стаття Ako vypočítať návratnosť automatizácie. Вартість моєї роботи починається від 390 €; подробиці — у статті Koľko stojí AI automatizácia.

Часті запитання

Як n8n дізнається, що замовлення змінилося?

WooCommerce може надіслати вебхук на адресу вузла Webhook в n8n; для замовлень є теми order.created, order.updated і order.deleted. Яка з них підходить для зміни статусу, перевірте на тестовому замовленні. Для Shoptet процедуру описано в статті про підключення через API та вебхуки.

Чи можу я бути певен, що жодне замовлення не загубиться?

Ні, без контролю. WooCommerce вимикає вебхук після понад п'яти поспіль невдалих доставок. Тому раджу налаштувати workflow для помилок в n8n і час від часу перевіряти, чи вебхук активний.

Чи можна чекати на відповідь перевізника вузлом Wait?

За дискусією в спільноті n8n вузол Wait генерує для кожного запуску нову адресу відновлення, тож не має фіксованої адреси, яку можна було б указати перевізникові. Та сама дискусія пропонує окреме workflow з вузлом Webhook і фіксованим шляхом.

Чи захищений вебхук в n8n?

Вузол Webhook підтримує Basic auth, Header auth і JWT auth. Крім того, WooCommerce може підписати тіло запиту секретним ключем через HMAC-SHA256, щоб одержувач перевірив справжність.

Чи вистачить для статусів у Shoptet доповнення замість n8n?

Для простих правил може вистачити. За описом доповнення воно перевіряє замовлення приблизно кожні 5–10 хвилин і перемикає статуси за правилами. За нього сплачується підключальний платіж і кредити.

Джерела

Пов’язані послуги

ПослугаАвтоматизація магазину Послугаn8n автоматизація

Пов’язані статті

E-commerceShoptet і n8n: інтеграція через API та вебхуки E-commerceАвтоматизація e-shop через n8n: вебхуки WooCommerce ОкупністьЯк розрахувати окупність автоматизації + калькулятор

Хочете знати, чи це окупиться у вашому e-shop?

Опишіть, який e-shop, склад і перевізника ви використовуєте. Разом з'ясуємо, що можна пов'язати, а що краще лишити вручну.

Хочу безкоштовну консультацію →