Інтеграція служб доставки для інтернет-магазинів: Нова Пошта, Укрпошта, Meest і DHL
Інтеграція зі службами доставки — це підключення сайту, інтернет-магазину, CRM, ERP або складської системи до програмного інтерфейсу перевізника. Після такого підключення магазин може автоматично показувати доступні відділення й поштомати, розраховувати орієнтовну вартість доставки, створювати ТТН, друкувати етикетки, передавати дані про відправлення та оновлювати статус замовлення без ручного копіювання інформації.
Для українського e-commerce найчастіше потрібна інтеграція з Новою Поштою, Укрпоштою та Meest. Компаніям, які продають за кордон, додатково підключають міжнародні служби доставки: DHL, UPS, FedEx, Nova Post Europe та інших операторів. У цій статті я поясню, як працює інтеграція служб доставки для інтернет-магазинів, який спосіб підключення обрати та що потрібно перевірити перед запуском.
Що таке інтеграція зі службами доставки
Простими словами, інтеграція створює автоматичний канал обміну даними між вашим магазином і системою перевізника. Зазвичай такий обмін відбувається через API. Якщо ви хочете глибше розібратися в принципі роботи, рекомендую окремий матеріал Brainlab про те, що таке API та як воно з’єднує різні системи.
Без інтеграції менеджер отримує замовлення на сайті, відкриває кабінет перевізника та вручну переносить туди дані клієнта. Потім копіює номер ТТН назад у CRM або адмінпанель, стежить за статусом посилки й окремо повідомляє покупця. Коли замовлень мало, така схема здається прийнятною. Після зростання продажів вона перетворюється на постійне джерело помилок, затримок і зайвих операцій.
Після інтеграції замовлення та відправлення стають частинами одного процесу. Система вже знає, що купив клієнт, куди потрібно доставити товар, хто є відправником, яка вага посилки, спосіб оплати та сума післяплати. Розробнику потрібно правильно зіставити ці дані з полями API перевізника й передбачити нестандартні ситуації: зміну адреси, часткове повернення, відмову від отримання, кілька місць у відправленні або тимчасову недоступність зовнішнього сервісу.
Моя практична порада: не починайте інтеграцію з вибору плагіна. Спочатку визначте, де у вашій системі зберігається достовірна інформація про замовлення. Для одного магазину це може бути WooCommerce, для іншого — CRM, ERP або WMS. Саме ця система має бути головним джерелом даних для створення відправлення.
Які процеси автоматизує інтеграція служб доставки для інтернет-магазинів
Вибір способу доставки під час оформлення замовлення
Покупець бачить актуальний список міст, відділень, поштоматів або доступність адресної доставки. Замість звичайного текстового поля краще використовувати пошук із підказками та фільтрами. Це зменшує кількість помилок у назвах населених пунктів і не змушує менеджера уточнювати адресу телефоном.
Розрахунок вартості та орієнтовного строку
Магазин може передати перевізнику місто відправлення, місто отримання, вагу, габарити, тип послуги й оголошену вартість. У відповідь система отримує доступні тарифи та орієнтовний строк. Важливо показувати користувачу, що фінальна сума може змінитися після фактичного вимірювання відправлення або застосування умов договору.
Автоматичне створення ТТН
Дані одержувача та замовлення вже є в системі, тому менеджеру достатньо перевірити параметри й натиснути кнопку створення. Для масової обробки можна формувати ТТН пакетно, об’єднувати їх у реєстри та передавати на друк термопринтеру.
Друк етикеток і супровідних документів
Для внутрішніх відправлень зазвичай потрібна транспортна етикетка. Для міжнародних посилок можуть додаватися інвойси, митні декларації, опис вкладення та інші документи. Точний набір залежить від країни, перевізника, товарної категорії й умов договору.
Синхронізація статусів
Перевізники використовують власні набори статусів. У магазині їх краще привести до єдиної бізнес-логіки: «ТТН створено», «передано перевізнику», «у дорозі», «прибуло у відділення», «отримано», «відмова», «повернення». Тоді підключення другої або третьої служби доставки не ламає звіти й автоматизації.
Повідомлення клієнта
Після створення відправлення система може надіслати номер ТТН через email, SMS, Viber, Telegram або особистий кабінет. На сайтах із повторними покупками корисно показувати історію замовлень і доставки в особистому кабінеті користувача.
Аналітика логістики
Коли статуси й витрати зберігаються централізовано, бізнес може аналізувати частку повернень, середній час до відправлення, популярність перевізників, географію замовлень і проблемні етапи. Це вже не просто зручність для менеджера, а дані для управлінських рішень.
Нова Пошта, Укрпошта, Meest і DHL: що можна інтегрувати
| Служба доставки | Коли підходить | Що зазвичай інтегрують | На що звернути увагу |
|---|---|---|---|
| Нова Пошта / Nova Post | Продажі по Україні, доставка у відділення, поштомати, кур’єром, окремі міжнародні сценарії | Довідники населених пунктів і точок видачі, створення відправлень, розрахунок, друк етикеток, трекінг, повернення та переадресування | Правильно працювати з ваговими й габаритними параметрами, кешувати довідники, контролювати актуальність відділень |
| Укрпошта | Доставка по Україні та міжнародні поштові відправлення | Адресний класифікатор, пошук відділень та індексів, створення відправлень, ярлики, трекінг, міжнародні документи | Для повної інтеграції потрібні токени доступу й належно оформлена співпраця; міжнародні відправлення мають більше обов’язкових полів |
| Meest | Внутрішня та транскордонна доставка, e-commerce і робота з різними країнами | Вибір пунктів обслуговування, створення та оформлення відправлень, документи, статуси й трекінг | Функціональність і доступ до API можуть залежати від продукту, країни та комерційних умов |
| DHL Express | Термінова міжнародна доставка, експортні замовлення, глобальна логістика | Перевірка доступних сервісів, тарифи, орієнтовний час, створення відправлення, виклик кур’єра, етикетки, трекінг, митні дані | Потрібен активний бізнес-акаунт; особливу увагу слід приділити адресам, товарним описам, HS-кодам, валютам і митним документам |
Можливості конкретного API змінюються, тому перед розробкою потрібно перевіряти актуальну офіційну документацію: інтеграцію Нової Пошти, API Укрпошти, інтеграції Meest та MyDHL API.
Як працює інтеграція доставки: шлях одного замовлення
- Клієнт формує кошик. Сайт знає склад товарів, суму, приблизну вагу та габарити.
- Клієнт обирає країну й населений пункт. Система показує доступні служби та способи отримання.
- Сайт отримує точки видачі або тариф. Запит до API виконується безпосередньо чи через серверний модуль.
- Замовлення зберігається. Вибрана служба, відділення, адреса та інші параметри записуються разом із замовленням.
- Менеджер перевіряє дані. За потреби уточнює вагу, кількість місць, післяплату або тип пакування.
- Система створює відправлення. API повертає номер ТТН, етикетку та службову інформацію.
- ТТН прив’язується до замовлення. Номер доступний менеджеру, клієнту та іншим підключеним системам.
- Статуси оновлюються. Магазин отримує зміни через webhook, push-механізм або періодичні запити.
- Автоматизації реагують на статус. Наприклад, після отримання замовлення закривається угода, а після відмови запускається сценарій повернення.
На практиці найскладніша частина — не кнопка «Створити ТТН», а узгодження даних між усіма системами. Якщо сайт, CRM і склад по-різному зберігають номер телефону, адресу, вагу чи статус оплати, помилки з’являтимуться навіть за технічно правильної роботи API.
Як підключити доставку: плагін, CRM, ERP чи пряма API-інтеграція
1. Готовий плагін або модуль
Це оптимальний варіант для типового магазину на WooCommerce або OpenCart, якщо бізнес-процес не відрізняється від стандартного. Готовий модуль може додати вибір відділення, створення ТТН і базове відстеження. Для WordPress у нас є окрема інструкція про те, як підключити Нову Пошту до WooCommerce.
Переваги: швидший запуск і менший стартовий бюджет. Ризики: залежність від автора модуля, конфлікти після оновлення CMS, обмежена логіка та складність доопрацювання.
2. Інтеграція через CRM
Підходить, коли менеджери обробляють усі замовлення в CRM, а сайт лише передає туди нові заявки. У такій архітектурі ТТН створюється в CRM, а номер і статус повертаються на сайт. Якщо готова система не враховує процеси компанії, можна розглянути розробку індивідуальної CRM.
3. Інтеграція через ERP або WMS
Для магазинів із кількома складами, гуртовими продажами, резервуванням товару та складними правилами відвантаження джерелом даних часто стає ERP або WMS. Тоді створення відправлення запускається після комплектації, а не відразу після оформлення замовлення. Brainlab також виконує розробку ERP-систем під бізнес-процеси компанії.
4. Пряма інтеграція через API
Кастомна інтеграція потрібна для Laravel, власної CMS, маркетплейсу, B2B-порталу або нестандартної логіки. Вона дає повний контроль над чекаутом, статусами, ролями, журналом помилок, пакетною обробкою та взаємодією з іншими системами.
Вибір між готовою CMS і кастомним рішенням напряму впливає на інтеграції. Корисні порівняння є в наших матеріалах Laravel чи OpenCart та WooCommerce чи кастомна CMS.
5. Middleware — проміжний інтеграційний шар
Коли замовлення надходять із сайту, маркетплейсів і мобільного застосунку, а відвантаження виконують кілька складів, прямі зв’язки між кожною парою систем швидко стають некерованими. У такому разі ми створюємо проміжний сервіс, який приймає замовлення, нормалізує дані, працює з API перевізників і повертає єдині статуси всім каналам.
Як підключити Нову Пошту, Укрпошту, Meest або DHL: покроковий план
Крок 1. Описати реальний процес доставки
Потрібно зафіксувати, хто створює відправлення, коли воно формується, де зберігається вага, хто змінює статус, як працюють післяплата, повернення та часткове відвантаження. Без цього інтеграція автоматизує хаос, а не процес.
Крок 2. Обрати служби й сценарії
Не обмежуйтеся назвою перевізника. Для кожного потрібно визначити способи доставки: відділення, поштомат, адреса, кур’єр, міжнародне відправлення, самовивіз із партнерської точки. Також вирішіть, чи показувати всі служби кожному клієнту або фільтрувати їх за країною, містом, сумою, вагою й категорією товару.
Крок 3. Отримати доступ до API
Для Нової Пошти ключ зазвичай створюється в бізнес-кабінеті. Укрпошта надає токени після оформлення співпраці. Для Meest порядок доступу залежить від продукту та умов договору. Для MyDHL API компанії потрібен активний клієнтський акаунт DHL Express. Ключі не можна додавати у відкритий JavaScript-код або передавати стороннім особам без контролю доступу.
Крок 4. Підготувати карту даних
Ми зіставляємо поля магазину з полями перевізника: ПІБ, телефон, email, країна, місто, поштовий індекс, вулиця, номер будинку, відділення, вага, габарити, кількість місць, опис товару, оголошена вартість, післяплата, валюта й дані відправника.
Крок 5. Налаштувати чекаут
Форма оформлення має бути швидкою, зрозумілою та стійкою до помилок зовнішнього API. Списки відділень потрібно кешувати, пошук — оптимізувати, а користувачу показувати зрозуміле повідомлення, якщо служба тимчасово не відповідає. Інтеграція не повинна блокувати все замовлення через короткочасний збій перевізника.
Крок 6. Реалізувати кабінет менеджера
У замовленні мають бути доступні створення, повторна генерація, видалення або оновлення ТТН відповідно до можливостей оператора. Також потрібні друк етикетки, копіювання номера, журнал запитів, пояснення помилок і права доступу для різних ролей.
Крок 7. Нормалізувати статуси
Ми створюємо внутрішню таблицю відповідності між кодами перевізників і статусами магазину. Це дозволяє підключати автоматичні повідомлення, аналітику, повернення товару на склад і фінансові сценарії без прив’язки до формулювань конкретної служби.
Крок 8. Провести тестування
Перевіряються звичайні та проблемні сценарії: неправильний телефон, відсутнє відділення, нульова вага, кілька місць, післяплата, безготівкова оплата, міжнародна адреса, повторне натискання кнопки, таймаут API, повернення та зміна даних.
Крок 9. Запустити моніторинг
Після релізу потрібно відстежувати помилки, час відповіді API, кількість невдалих створень ТТН і розбіжності статусів. Для стабільної роботи інтеграцій після оновлень CMS і зовнішніх сервісів корисна технічна підтримка сайту.
Інтеграція з Новою Поштою для інтернет-магазину
Найпоширеніший базовий сценарій — показати покупцю міста, відділення та поштомати, зберегти вибрану точку в замовленні й дати менеджеру можливість створити експрес-накладну. Повніша інтеграція включає розрахунок вартості, адресну доставку, друк етикеток, реєстри, автоматичне оновлення статусів, повернення та переадресування.
На проєктах із великим каталогом важливо правильно передавати вагу й габарити. Якщо ці параметри відсутні в товарах, система може використовувати некоректні значення за замовчуванням. Тому перед запуском я рекомендую провести аудит карток товарів і правил пакування.
Ще одна типова задача — синхронізація довідників. Сайт не повинен завантажувати тисячі відділень під час кожного відкриття чекауту. Дані краще кешувати на сервері, оновлювати за розкладом і дозволяти швидкий пошук за містом, номером або адресою.
Інтеграція з Укрпоштою
API Укрпошти охоплює відправлення по Україні, міжнародні поштові відправлення, адресний класифікатор, пошук відділень та індексів і трекінг. Для повної інтеграції потрібно отримати параметри авторизації та використовувати їх лише на сервері.
Для українських адрес окрему увагу приділяємо індексам і класифікатору. Для міжнародної доставки додаються країна, повна латинська адреса, опис вкладення, вартість, валюта та митні відомості. Система має перевіряти обов’язкові поля до відправлення запиту, щоб менеджер одразу бачив, яких даних не вистачає.
Якщо магазин працює і з Новою Поштою, і з Укрпоштою, не варто створювати дві несумісні форми. Краще розробити єдиний компонент вибору доставки, який змінює поля залежно від обраного способу.
Інтеграція з Meest
Meest використовують для доставки по Україні та транскордонної логістики. Залежно від продукту й договору інтеграція може охоплювати вибір пункту обслуговування, створення відправлення, формування документації та відстеження.
Перед розробкою потрібно уточнити, з яким саме сервісом Meest працює бізнес, у яких країнах, хто є платником доставки та які типи відправлень використовуються. Назва групи одна, але технічний сценарій для внутрішньої посилки й міжнародного e-commerce може суттєво відрізнятися.
Інтеграція міжнародних служб доставки: DHL та інші оператори
Міжнародна доставка складніша за внутрішню не лише через більшу кількість полів. Тут з’являються митні правила, країни походження товарів, товарні описи, HS-коди, валюти, інвойси, податки, обмеження за категоріями та різні формати адрес.
MyDHL API дає змогу перевіряти доступність сервісів, отримувати орієнтовні тарифи й строки, створювати відправлення, формувати етикетки, замовляти забір кур’єром і відстежувати посилки. Для деяких сценаріїв доступний розрахунок орієнтовних мит і податків, але остаточні суми залежать від фактичних даних та митного оформлення.
Що потрібно додати в міжнародний чекаут
- вибір країни до показу способів доставки;
- валідацію поштового індексу та структури адреси;
- окремі поля для області, штату або провінції, якщо це потрібно країні;
- латинське написання імені та адреси;
- попередження про можливі податки й митні платежі;
- обмеження для товарів, які не можна відправляти конкретною службою;
- коректне округлення ваги, вартості та валютних значень.
Якщо магазин планує експорт, інтеграцію доставки краще закладати ще під час проєктування. У матеріалі про етапи створення сучасного інтернет-магазину ми пояснюємо, чому інтеграції потрібно враховувати до запуску, а не додавати в останній момент.
Технічні вимоги до надійної інтеграції
Серверне зберігання ключів
API-ключі, токени й облікові дані зберігаються в захищеному серверному середовищі. Їх не можна виводити у HTML, передавати в браузер або зберігати у відкритому репозиторії.
Кешування довідників
Міста, відділення й поштомати змінюються не щосекунди, тому їх доцільно синхронізувати за розкладом. Це прискорює чекаут і зменшує залежність від часу відповіді зовнішнього API.
Черги для фонових операцій
Масове створення ТТН, оновлення статусів і надсилання повідомлень краще виконувати через черги. Тоді короткий збій перевізника не блокує роботу менеджера, а невдале завдання можна повторити автоматично.
Ідемпотентність
Повторне натискання кнопки або повтор запиту після таймауту не повинні створювати дві однакові накладні. Для цього використовують внутрішні ідентифікатори операцій, перевірку вже створеної ТТН і блокування дублювання.
Журналювання
У логах потрібно зберігати час запиту, тип операції, результат і код помилки, але не дублювати зайві персональні дані. Зрозумілий журнал скорочує час діагностики, коли зовнішнє API змінює формат або повертає нестандартну відповідь.
Резервний сценарій
Користувач повинен мати змогу завершити замовлення, навіть якщо розрахунок доставки тимчасово недоступний. Наприклад, магазин може зберегти вибір служби без фінальної ціни та повідомити, що менеджер уточнить її після відновлення зв’язку.
Типові помилки під час інтеграції служб доставки
1. Уся логіка працює безпосередньо в чекауті
Якщо кожне поле запускає важкий зовнішній запит, оформлення стає повільним. Частину довідників потрібно кешувати, а запити — виконувати лише тоді, коли вони справді потрібні.
2. Відсутня єдина модель статусів
У результаті аналітика показує десятки схожих станів, а автоматичні листи працюють лише для одного перевізника. Статуси потрібно нормалізувати ще на етапі технічного завдання.
3. ТТН створюється до перевірки замовлення
Якщо відправлення генерується відразу після натискання «Замовити», система може створювати зайві накладні для неоплачених або помилкових замовлень. Момент створення має відповідати процесу магазину.
4. Вага та габарити не зберігаються в каталозі
Через це розрахунок стає приблизним, а менеджери щоразу виправляють відправлення вручну. Для товарів із нестандартним пакуванням потрібні окремі правила об’ємної ваги й кількості місць.
5. API-ключ доступний у браузері
Це створює ризик сторонніх запитів від імені магазину. Усі захищені операції мають проходити через backend.
6. Не враховані зміни API та оновлення модулів
Навіть стабільна інтеграція потребує підтримки. Перевізники додають поля, змінюють довідники та оновлюють правила. CMS і плагіни також змінюються, тому після апдейтів потрібні регресійні тести.
7. Немає сценарію повернення
Багато команд автоматизують лише відправлення. Але для e-commerce не менш важливо обробити відмову, повернення на склад, повторну відправку й коригування фінансового статусу.
Від чого залежать вартість і строки інтеграції
Однакова назва послуги може означати різний обсяг роботи. Додати список відділень у стандартний WooCommerce-магазин і побудувати двосторонню синхронізацію між кастомним сайтом, CRM, ERP, складом та чотирма перевізниками — це різні за складністю проєкти.
На оцінку впливають:
- платформа сайту та якість наявного коду;
- кількість служб і способів доставки;
- потреба в розрахунку тарифів і строків;
- створення ТТН, етикеток, реєстрів і митних документів;
- інтеграція з CRM, ERP, WMS, маркетплейсами та бухгалтерією;
- пакетна обробка, кілька складів і кілька юридичних осіб;
- міжнародні адреси, валюти й митні дані;
- необхідність доопрацювання чекауту та особистого кабінету;
- наявність технічного завдання, тестового середовища й доступів;
- вимоги до моніторингу, SLA та подальшої підтримки.
Для попередньої оцінки ми спочатку проводимо аудит і визначаємо мінімальний корисний сценарій. Часто бізнесу не потрібно реалізовувати всі можливості API в першій версії. Раціональніше запустити вибір доставки, створення ТТН і статуси, а потім додати реєстри, повернення, міжнародні документи та аналітику.
Як Brainlab реалізує інтеграцію служб доставки
У Brainlab ми розглядаємо доставку як частину всієї системи продажів, а не як окрему кнопку в адмінпанелі. Це особливо важливо для магазинів, які вже мають CRM, складський облік, маркетплейси або нестандартні правила відвантаження.
- Аудитуємо поточну архітектуру. Перевіряємо CMS, код, базу даних, модулі, CRM, ERP і спосіб обробки замовлень.
- Описуємо бізнес-сценарії. Визначаємо, які служби потрібні, хто створює ТТН, коли оновлюється статус і що відбувається при поверненні.
- Проєктуємо інтеграцію. Вибираємо готовий модуль, пряму API-інтеграцію або проміжний сервіс.
- Розробляємо й тестуємо. Перевіряємо звичайні, граничні та аварійні сценарії.
- Запускаємо поетапно. За потреби спочатку підключаємо одну службу або окремий канал продажів.
- Передаємо документацію. Команда клієнта отримує інструкції для менеджерів та опис технічних налаштувань.
- Підтримуємо після релізу. Стежимо за помилками, оновленнями API та стабільністю обміну.
Інтеграцію можна додати до чинного сайту або закласти в новий проєкт. Якщо ви плануєте повноцінний запуск, перегляньте послугу розробки інтернет-магазину під ключ. Для вже працюючого ресурсу підійде доопрацювання сайту з аудитом наявного коду.
Чекліст перед стартом інтеграції
- визначено всі служби, країни та способи доставки;
- зрозуміло, яка система є головним джерелом даних про замовлення;
- отримано бізнес-акаунти, договори, API-ключі або токени;
- у товарах є вага, габарити та інші необхідні логістичні параметри;
- описані правила післяплати, безкоштовної доставки й страхування;
- узгоджено момент створення ТТН;
- визначені внутрішні статуси замовлення та їх відповідність статусам перевізника;
- передбачені повернення, відмови, переадресування та повторні відправлення;
- є тестове середовище або план безпечного тестування;
- налаштовані логи, моніторинг і відповідальний за підтримку.
Часті запитання про інтеграцію служб доставки
Що таке інтеграція служб доставки для інтернет-магазинів?
Це автоматичний обмін даними між магазином, CRM або ERP та системою перевізника через API або готовий модуль. Інтеграція дає змогу вибирати спосіб доставки, створювати ТТН, друкувати документи й отримувати статуси без повторного ручного введення.
Як підключити Нову Пошту до інтернет-магазину?
Потрібно отримати API-доступ, встановити сумісний модуль або розробити пряме підключення, налаштувати дані відправника, вибір відділень, параметри посилки, створення ТТН і синхронізацію статусів. Перед запуском інтеграцію тестують на різних типах замовлень.
Чи можна підключити Нову Пошту, Укрпошту та Meest одночасно?
Так. Покупцю можна показувати кілька служб, а доступні варіанти фільтрувати за містом, країною, вагою, сумою кошика або товарною категорією. Для аналітики та автоматизації статуси різних перевізників бажано привести до єдиної моделі.
Чи можна інтегрувати доставку з уже готовим сайтом?
Так, але спочатку потрібно перевірити CMS, версію платформи, наявні модулі, структуру замовлень і якість коду. Для стандартного магазину може вистачити плагіна, а для нестандартної системи потрібна API-інтеграція або middleware.
Що краще: готовий плагін чи кастомна інтеграція?
Готовий плагін підходить для типового процесу й швидкого запуску. Кастомна інтеграція потрібна, якщо є кілька складів, CRM/ERP, специфічні правила ціни, пакетне створення ТТН, міжнародна логістика або особливий чекаут.
Чи обов’язково мати CRM?
Ні. Доставку можна інтегрувати безпосередньо із сайтом. CRM потрібна тоді, коли в ній менеджери обробляють замовлення, комунікують із клієнтами та контролюють статуси.
Як працює розрахунок вартості доставки?
Сайт передає перевізнику маршрут, вагу, габарити, тип послуги, оголошену вартість та інші параметри. API повертає доступний тариф або орієнтовну ціну. Фінальна вартість може відрізнятися після фактичного вимірювання й застосування договору.
Як підключити DHL та інші міжнародні служби доставки?
Потрібно укласти договір або створити бізнес-акаунт, отримати API-доступ, налаштувати міжнародні адреси, товарні описи, вагу, валюту, митні дані й документи. Для DHL Express доступ до MyDHL API надається активним клієнтам після перевірки облікового запису.
Що станеться, якщо API служби доставки тимчасово не працює?
Надійна інтеграція не повинна повністю блокувати замовлення. Система може використати кешовані довідники, зберегти вибір клієнта, повторити фонову операцію пізніше або передати задачу менеджеру. Помилка має бути зафіксована в журналі й показана користувачу зрозумілим повідомленням.
Від чого залежить вартість інтеграції?
Від платформи, якості наявного коду, кількості перевізників, глибини автоматизації, інтеграцій із CRM/ERP/WMS, міжнародних документів, кількості складів і вимог до підтримки. Точну оцінку можна дати після аудиту та опису бізнес-сценаріїв.
