Перейти до основного вмісту

Інтеграція зі Swotzy

Якщо ви використовуєте Swotzy для керування відправленнями посилок, ви можете підключити його до Baltix. Коли клієнт обирає пункт видачі під час оформлення замовлення, Baltix автоматично оновить відповідне замовлення в Swotzy з правильним перевізником, послугою та пунктом видачі.

Режим PICKUP ONLY

Вкладка External Provider видима лише коли ваш додаток працює в режимі Pickup Only. Якщо ви не бачите цю вкладку, перейдіть до Settings > General і змініть режим додатку.

Передумови​

1. Акаунт Swotzy з доступом до API​

Створіть акаунт на Swotzy.

2. Отримайте ключ API Swotzy​

  1. Перейдіть до лівого бічного меню.
  2. Натисніть вкладку Integrations (1).
  3. Натисніть пункт меню API (2).

  1. Створіть новий ключ API.

  1. Збережіть (3) Public key і (4) Private key.
  2. Потім перейдіть до Підключення Swotzy

3. Встановіть вагу та розміри товарів у Shopify​

Обов'язково для кожного товару

Кожен варіант товару у вашому магазині Shopify повинен мати налаштовані вагу і розміри упаковки (довжина, ширина, висота). Baltix надсилає ці дані до Swotzy при оновленні замовлення — якщо вони відсутні, Swotzy може відхилити відправлення або використати неправильні значення за замовчуванням.

Щоб їх налаштувати:

  1. Перейдіть до Shopify admin > Products
  2. Відкрийте товар і прокрутіть до розділу Shipping
  3. Заповніть поля Weight, Length, Width і Height
  4. Повторіть для кожного варіанту товару

4. Увімкніть налаштування «Display store order ID on label»​

Важливе налаштування Swotzy

У вашій панелі керування Swotzy ви повинні увімкнути «Display store order ID on label» у налаштуваннях інтеграції. Baltix використовує номер замовлення Shopify для пошуку замовлень у Swotzy — без цього налаштування пошук не вдасться і дані пункту видачі не будуть передані.

Як увімкнути налаштування​

  1. Перейдіть до лівого бічного меню
  2. Натисніть вкладку Integrations (1)
  3. Натисніть пункт меню Stores (2)

Swotzy integration menu

  1. Натисніть кнопку Manage на вашому веб-сайті Shopify (3)

Manage shopify website

  1. Потім увімкніть Display store order ID on label

Enable settings

  1. Не забудьте зберегти, натиснувши кнопку Save внизу сторінки.

Save settings

Підключення Swotzy​

  1. Перейдіть до вкладки Settings інтеграцій Baltix.

  1. Потім External Provider (5).
  2. Введіть Public key з (3) у поле введення (6).
  3. Введіть Private key з (4) у поле введення (7).

  1. Натисніть Test connection, щоб перевірити дійсність облікових даних
  2. Натисніть Save

Після збереження поруч із заголовком з'явиться зелений значок Connected.

Обмеження тарифу доставки

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

Перегляньте Налаштування методу доставки, щоб налаштувати тарифи доставки

Щоб завершити налаштування, дотримуйтесь цих інструкцій:

Як це працює​

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

  1. Baltix отримує вебхук Shopify з даними замовлення
  2. Фоновий процес шукає відповідне замовлення в Swotzy (за номером замовлення або email клієнта)
  3. Процес оновлює замовлення Swotzy з:
    • Перевізником (Omniva, DPD, Latvijas Pasts тощо)
    • Типом послуги (PARCELSHOP)
    • Ідентифікатором вибраного пункту видачі
    • Номером телефону клієнта
    • Розмірами упаковки (з даних варіанту товару, якщо доступні)

Якщо замовлення Swotzy не знайдено одразу (затримка синхронізації), процес автоматично повторює спробу до 5 разів з експоненціальним відкладенням.

Статус синхронізації замовлення​

Кожне замовлення в Baltix відстежує статус передачі до Swotzy:

  • PENDING — Процес знаходиться в черзі або виконується
  • SUCCESS — Пункт видачі успішно передано до Swotzy
  • FAILED — Усі спроби не вдалися (перевірте повідомлення про помилку на сторінці деталей замовлення)

Ви можете вручну повторити невдалу передачу зі сторінки деталей замовлення.

Відключення Swotzy​

  1. Перейдіть до Settings > External Provider
  2. Натисніть Delete

Це видаляє збережені облікові дані. Замовлення, вже передані до Swotzy, не зачіпаються.

Усунення несправностей​

ПроблемаРішення
«Connection failed» при тестіДвічі перевірте публічний і приватний ключі. Переконайтеся, що немає зайвих пробілів.
Замовлення застрягло в PENDINGЗверніться до підтримки
Замовлення показує FAILEDВідкрийте деталі замовлення, щоб побачити помилку. Типова причина: замовлення ще не було створено в Swotzy, коли Baltix намагався його оновити. Не хвилюйтеся, Baltix повторює спроби до тих пір, поки замовлення не буде відредаговано
Замовлення Swotzy вже обробленоЯкщо замовлення вийшло зі стану «draft» у Swotzy до того, як Baltix встиг його оновити, Baltix позначає його як SUCCESS (жодних дій не потрібно).