Головна → Інтеграції → Додаткові можливості для інтеграції → Інтеграція з поштовим сервісом - Укрпошта

Інтеграція з поштовим сервісом - Укрпошта

В цій статті ми розглянемо можливість створювати посилки через поштовий сервіс Укрпошта
Написано Oleksandr Pankov
Оновлено 1 день тому

Як налаштувати інтеграцію з Укрпоштою для автоматизації відправлень

Оптимізуйте логістичні процеси у вашій компанії, поєднавши NetHunt CRM із сервісом Укрпошта. Ця інтеграція дозволяє автоматично створювати ТТН.

У цій статті ми розберемо, які дані необхідні для роботи та як працює автоматизація.

💡Зверніть увагу: Укрпошта та NetHunt надає клієнтам приємні можливості та легкі ціни для такої інтеграції.
Ви можете звернутись до нас на чат підтримки. або написати нам листа на пошту support@nethunt.com, та отримати ваш унікальний токен для особистих знижок.

Як працює інтеграція

Взаємодія з Укрпоштою на технічному рівні базується на передачі унікальних ідентифікаторів (ID). Для створення одного відправлення система має оперувати чотирма сутностями:

  1. Відправник (ваші дані).

  2. Адреса відправника, або адреса відділення (звідки їде посилка).

  3. Отримувач (дані клієнта).

  4. Адреса отримувача (куди їде посилка).

💡Зверніть увагу: Ви можете переглянути API документацію Укрпошти За цим посиланням

Підготовка даних у NetHunt CRM

Для успішного формування відправлення переконайтеся, що у вашій системі налаштовані відповідні поля.​

Дані про отримувача:

  • Тип: приватна особа або бізнес.

  • Контакти: ПІП, номер телефону, email.

  • Для бізнесу: код ЄДРПОУ або РНОКПП.

Дані про адресу:

  • Поштовий індекс (обов'язково).

  • Область, місто, вулиця та номер будинку.

Параметри відправлення:

  • Тип доставки: Стандарт, Експрес або Документи.

  • Тип відправлення: Відділення - Адреса або Відділення - Відділення, Адреса - Відділення.

  • Габарити: вага, довжина, висота.

  • Цінність: оголошена вартість та короткий опис вмісту.

Технічні поля для фіксації:

  • ID відправлення.

  • ID адреси отримувача.

  • ID отримувача.

  • Штрихкод.

  • Вартість відправлення.

Налаштування автоматизації

Ви можете налаштувати автоматизацію так, щоб ТТН створювалася автоматично при переході угоди на певний етап (наприклад, «Готово до відправки», або поле чекбокс "відправити").

Як це працює:

  1. Перевірка адреси: Система надсилає дані про адресу отримувача до Укрпошти. Якщо адреса вже існує - повертається її ID, якщо ні - створюється нова.

  2. Створення отримувача: На основі контактних даних створюється профіль отримувача в системі.

  3. Формування відправлення: CRM передає всі параметри (габарити, тип доставки) та генерує ТТН.

Переглянемо таку автоматизацію більш детально:

  • Нашим тригером буде чекбокс, значення змінено на заповнене.

  • Додаємо API виклик.

Додайте деталі API виклику, щоб "Зареєструвати адресу", де:

  1. Виберіть тип запиту - POST

  2. ​URL - це вебхук, взятий із програмного забезпечення, до якого ви хочете надіслати інформацію, а саме з Укрпошти, для реєстрації адреси:

    https://www.ukrposhta.ua/ecom/0.0.1/addresses

  3. JSON - дані для надсилання за допомогою формату даних JavaScript Object Notation.

    {
     "postcode": "макрос",  //проставляємо макросами з полів картки клієнта
     "region": "макрос",  //проставляємо макросами з полів картки клієнта
     "city": макрос",  //проставляємо макросами з полів картки клієнта
     "street": "макрос",  //проставляємо макросами з полів картки клієнта
     "houseNumber": "макрос",  //проставляємо макросами з полів картки клієнта
     "description": "макрос"  //проставляємо макросами з полів картки клієнта
    }

  4. ​Заголовки - Accept, application/json.

💡Зверніть увагу: При створенні адреси буде виконуватись перевірка наявності цієї адреси. Якщо адреси в базі не існує – API буде повертати помилку: "code":"UPE01002","message".
Ви можете додатково перевірити наявність адреси - за цим посиланням, або подайте заявку на додавання адреси в Особистому кабінеті - за цим посиланням.

  • Робимо тестовий запит, щоб отримати відповідь і додаємо дію оновити запис та проставляємо "ID" в поле "Ukrposhta Recipient Address ID":

  • Після того, як ви успішно зареєстрували адресу, створюємо отримувача.

Додайте деталі API виклику, щоб "Створити отримувача", де:

  1. Виберіть тип запиту - POST

  2. ​URL - це вебхук, взятий із програмного забезпечення, до якого ви хочете надіслати інформацію, а саме з Укрпошти, щоб створити отримувача:

    https://www.ukrposhta.ua/ecom/0.0.1/clients?token=ba5378df-0000-0000-0000-d222fa60aa68

  3. JSON - дані для надсилання за допомогою формату даних JavaScript Object Notation.

    {
     "type": "макрос",  //проставляємо макросами з полів картки клієнта
     "firstName": "макрос",  //проставляємо макросами з полів картки клієнта
     "middleName": "макрос",  //проставляємо макросами з полів картки клієнта
     "lastName": "макрос",  //проставляємо макросами з полів картки клієнта
     "phoneNumber": "макрос",  //проставляємо макросами з полів картки клієнта
     "email": "макрос",  //проставляємо макросами з полів картки клієнта
     "addressId": макрос   //проставляємо макросами з полів картки клієнта
    }

  4. ​Заголовки - Accept, application/json.

  • Робимо тестовий запит з цим API викликом, щоб отримати "Uuid". Далі додаємо дію оновити запис:

  • На цьому етапі ми вже маємо всю інформацію для того, щоб створити ТТН накладну виконуємо наступні дії.

Додайте деталі API виклику, щоб "Створити відправлення", де:

  • Виберіть тип запиту - POST

  • ​URL - це вебхук, взятий із програмного забезпечення, до якого ви хочете надіслати інформацію, а саме з Укрпошти, щоб створити відправлення:

    https://www.ukrposhta.ua/ecom/0.0.1/shipments?token=ba5378df-0000-0000-0000-d222fa60aa68

  • JSON - дані для надсилання за допомогою формату даних JavaScript Object Notation.

    {
     "sender": {
     "uuid": "55ad3d9b-0000-0000-0000-b1f33d892ded" //uuid відправника
     },
     "recipient": {
     "uuid": "макрос"  //проставляємо макросами з полів картки клієнта
     },
     "type": "макрос",  //проставляємо макросами з полів картки клієнта
     "deliveryType": "макрос",  //проставляємо макросами з полів картки клієнта
     "recipientAddressId": макрос,  //проставляємо макросами з полів картки клієнта
     "returnAddressId": 0000000,  //вказуємо id адрес повернення
     "description": "макрос",  //проставляємо макросами з полів картки клієнта
     "parcels": [
     {
     "name": "Parcel",
     "weight": макрос,  //проставляємо макросами з полів картки клієнта
     "length": макрос,  //проставляємо макросами з полів картки клієнта
     "width": макрос,  //проставляємо макросами з полів картки клієнта
     "height": макрос,  //проставляємо макросами з полів картки клієнта
     "declaredPrice": макрос,  //проставляємо макросами з полів картки клієнта
     "description": "макрос"  //проставляємо макросами з полів картки клієнта
     }
     ]
    }

  • ​Заголовки - Accept, application/json.

  • Далі додаємо оновити запис та робимо наступні кроки: Знімаємо чекбокс з тригера, якщо це поле етап можемо змінити на "ТТН створена", фіксуємо uuid відправлення, номер ТТН і вартість відправлення, беремо з останнього API виклику.

​Загальний вид автоматизації після налаштувань:

Що ми отримали

Після спрацювання автоматизації в картку угоди NetHunt CRM автоматично підтягнуться:

  • Штрихкод (номер ТТН) для відстеження.

  • Вартість доставки, розрахована за тарифами Укрпошти

Не знайшли відповідей, які шукали? Пишіть нам у чат підтримки прямо з CRM!А також доєднуйтесь до спільноти однодумців в нашому телеграм каналі.

Чи була наша стаття корисною?
close-image
full-image