Як налаштувати інтеграцію з Укрпоштою для автоматизації відправлень
Оптимізуйте логістичні процеси у вашій компанії, поєднавши NetHunt CRM із сервісом Укрпошта. Ця інтеграція дозволяє автоматично створювати ТТН.
У цій статті ми розберемо, які дані необхідні для роботи та як працює автоматизація.
💡Зверніть увагу: Укрпошта та NetHunt надає клієнтам приємні можливості та легкі ціни для такої інтеграції.
Ви можете звернутись до нас на чат підтримки. або написати нам листа на пошту support@nethunt.com, та отримати ваш унікальний токен для особистих знижок.
Як працює інтеграція
Взаємодія з Укрпоштою на технічному рівні базується на передачі унікальних ідентифікаторів (ID). Для створення одного відправлення система має оперувати чотирма сутностями:
Відправник (ваші дані).
Адреса відправника, або адреса відділення (звідки їде посилка).
Отримувач (дані клієнта).
Адреса отримувача (куди їде посилка).
Підготовка даних у NetHunt CRM
Для успішного формування відправлення переконайтеся, що у вашій системі налаштовані відповідні поля.
Дані про отримувача:
Тип: приватна особа або бізнес.
Контакти: ПІП, номер телефону, email.
Для бізнесу: код ЄДРПОУ або РНОКПП.
Дані про адресу:
Поштовий індекс (обов'язково).
Область, місто, вулиця та номер будинку.
Параметри відправлення:
Тип доставки: Стандарт, Експрес або Документи.
Тип відправлення: Відділення - Адреса або Відділення - Відділення, Адреса - Відділення.
Габарити: вага, довжина, висота.
Цінність: оголошена вартість та короткий опис вмісту.
Технічні поля для фіксації:
ID відправлення.
ID адреси отримувача.
ID отримувача.
Штрихкод.
Вартість відправлення.
Налаштування автоматизації
Ви можете налаштувати автоматизацію так, щоб ТТН створювалася автоматично при переході угоди на певний етап (наприклад, «Готово до відправки», або поле чекбокс "відправити").
Як це працює:
Перевірка адреси: Система надсилає дані про адресу отримувача до Укрпошти. Якщо адреса вже існує - повертається її ID, якщо ні - створюється нова.
Створення отримувача: На основі контактних даних створюється профіль отримувача в системі.
Формування відправлення: CRM передає всі параметри (габарити, тип доставки) та генерує ТТН.
Переглянемо таку автоматизацію більш детально:
Нашим тригером буде чекбокс, значення змінено на заповнене.
Додаємо API виклик.
Додайте деталі API виклику, щоб "Зареєструвати адресу", де:
Виберіть тип запиту - POST
URL - це вебхук, взятий із програмного забезпечення, до якого ви хочете надіслати інформацію, а саме з Укрпошти, для реєстрації адреси:
https://www.ukrposhta.ua/ecom/0.0.1/addresses
JSON - дані для надсилання за допомогою формату даних JavaScript Object Notation.
{
"postcode": "макрос", //проставляємо макросами з полів картки клієнта
"region": "макрос", //проставляємо макросами з полів картки клієнта
"city": макрос", //проставляємо макросами з полів картки клієнта
"street": "макрос", //проставляємо макросами з полів картки клієнта
"houseNumber": "макрос", //проставляємо макросами з полів картки клієнта
"description": "макрос" //проставляємо макросами з полів картки клієнта
}Заголовки - Accept, application/json.
Робимо тестовий запит, щоб отримати відповідь і додаємо дію оновити запис та проставляємо "ID" в поле "Ukrposhta Recipient Address ID":
Після того, як ви успішно зареєстрували адресу, створюємо отримувача.
Додайте деталі API виклику, щоб "Створити отримувача", де:
Виберіть тип запиту - POST
URL - це вебхук, взятий із програмного забезпечення, до якого ви хочете надіслати інформацію, а саме з Укрпошти, щоб створити отримувача:
https://www.ukrposhta.ua/ecom/0.0.1/clients?token=ba5378df-0000-0000-0000-d222fa60aa68
JSON - дані для надсилання за допомогою формату даних JavaScript Object Notation.
{
"type": "макрос", //проставляємо макросами з полів картки клієнта
"firstName": "макрос", //проставляємо макросами з полів картки клієнта
"middleName": "макрос", //проставляємо макросами з полів картки клієнта
"lastName": "макрос", //проставляємо макросами з полів картки клієнта
"phoneNumber": "макрос", //проставляємо макросами з полів картки клієнта
"email": "макрос", //проставляємо макросами з полів картки клієнта
"addressId": макрос //проставляємо макросами з полів картки клієнта
}Заголовки - 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 автоматично підтягнуться:
Штрихкод (номер ТТН) для відстеження.
Вартість доставки, розрахована за тарифами Укрпошти
Якщо ви бажаєте вже мати таку можливість і при цьому не вивчати JSON та API, наші колеги можуть це виконати за вас. Забронюйте зустріч зі спеціалістами нашого відділу впровадження за цим посиланням.
Не знайшли відповідей, які шукали? Пишіть нам у чат підтримки прямо з CRM!
А також доєднуйтесь до спільноти однодумців в нашому телеграм каналі.