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