Завдяки базовій інтеграції з Укрпоштою ви зможете:
Прив’язати наявне відправлення за його номером до замовлення в RO App
Налаштувати автоматичну зміну статусу замовлення відповідно до статусу ТТН
Відстежувати статус ТТН у замовленні та таблиці замовлень (RO App буде оновлювати статус відправлення кожних 30 хвилин)
Додавати номер ТТН у шаблони документів та сповіщень
Крок 1. Як налаштувати інтеграцію з Укрпошта?
1. Перейдіть на сторінку “Налаштування > Інтеграції” в розділ “Логістика”. Знайдіть інтеграцію з Укрпошта та натисніть кнопку “Налаштувати”.
2. Поставте галочку “Інтеграцію ввімкнено”.
3. В центрі інтеграції потрібно додати акаунт натиснувши на кнопку “+ Акаунт” та заповнити обов’язкові поля та обравши локацію. Можна підключити лише один акаунт.
Назва - довільна назва інтеграції, яка використовується для зручної ідентифікації підключення в системі, особливо якщо інтеграцій кілька.
Локація - локація, до якої буде прив’язана інтеграція з Укрпоштою та для якої використовуватимуться дані відправлень і відстеження.
Наступні поля ви заповнюєте даними, які отримуєте на електронну пошту після підписання договору з Укрпоштою як ФОП чи фізична особа:
Authorisation bearer - токен користувача, від імені якого виконується підключення та взаємодія з API Укрпошти.
User Token - унікальний токен доступу, що використовується для авторизації запитів до сервісів Укрпошти та обміну даними.
Status Tracking Token - токен, який застосовується для отримання та автоматичного оновлення статусів поштових відправлень.
Натисніть Завантажити дані, щоб додати акаунт до інтеграції.
Щоб змінити акаунт, який використовується в інтеграції з Укрпоштою, спочатку необхідно видалити поточний. Перед видаленням акаунту необхідно видалити всі накладні, прив’язані до замовлень, які були створені або пов’язані з цим акаунтом в інтеграції. Лише після очищення замовлень від таких накладних акаунт можна видалити. Після цього перейдіть у налаштування інтеграції, двічі натисніть на потрібний акаунт, у його профілі оберіть кнопку Видалити та підтвердьте дію. Після видалення ви зможете додати новий акаунт для інтеграції.
Крок 2. Налаштування автоматичної зміни статусів замовлень відповідно до статусів ТТН
Перейдіть у вікно налаштування інтеграції з Укрпоштою. У полі “Статус відправлення” виберіть потрібний статус ТТН.
У полі “Статус замовлення” виберіть відповідний статус для замовлення в RO App. Нагадуємо, що ви можете створити нові статуси на сторінці “Налаштування > Статуси > Замовлення”.
Зверніть увагу, що для одного статуса ТТН можна встановити тільки один статус замовлення.
В кінці обов’язково збережіть налаштування.
Важливо: якщо ви налаштували автоматичну зміну статусів, то під час такої зміни будуть ігноруватись можливі налаштування статусів, наприклад, обов’язкове створення коментаря/платежу або правила переходу між статусами.
Автоматична зміна статусів замовлень підтримується лише для ТТН по Україні. Для міжнародних відправлень доступна тільки прив’язка накладної до замовлення, при цьому в накладній відображається обмежений набір інформації без автоматичного оновлення статусів.
Крок 3. Збереження інтеграції
Після додавання акаунту та налаштування статусів перевірте, що активовано чекбокс “Інтеграція увімкнена”, після чого обов’язково натисніть кнопку Зберегти.
Після збереження налаштувань інтеграція буде активована та повністю готова до використання в роботі.
За допомогою інтеграції ви можете прив’язувати накладні до замовлення з автоматичним оновленням статусів, а також додавання ТТН до шаблонів документів групи “Замовлення” та сповіщень.
Теги: укрпошта, укрпошта, ukrposhta, укрпочта