Інтеграція Нової Пошти в інтернет-магазин дозволяє: клієнту — знайти найближче відділення за своєю адресою проживання і побачити вартість доставки прямо при оформленні. Вам — автоматично генерувати ТТН і відстежувати посилки без входу в кабінет НП. Підключення займає 2–5 днів розробки після отримання API-ключа.
1. До і після інтеграції: що змінюється в роботі магазину
Коротка відповідь: Без інтеграції — ручна робота на кожне замовлення: ввести адресу, вибрати відділення, створити ТТН, скопіювати трекінг клієнту. З інтеграцією — все це відбувається автоматично. При 30 замовленнях на день економія — від 2 годин щодня.
Найкращий спосіб пояснити цінність інтеграції — показати конкретно що змінюється. Ось порівняння для магазину з 20–30 замовленнями на день:
| Операція | Без інтеграції | З інтеграцією API |
|---|---|---|
| Клієнт обирає відділення | Вводить номер відділення вручну або дзвонить дізнатись | Вводить свою адресу — магазин сам знаходить найближчі відділення на карті |
| Вартість доставки | Клієнт дізнається тільки після дзвінка або при отриманні | Розраховується автоматично при оформленні — клієнт бачить суму одразу |
| Створення ТТН | Менеджер входить в кабінет НП і вводить дані кожного замовлення вручну | ТТН генерується автоматично при підтвердженні замовлення |
| Друк ТТН | Окрема операція в кабінеті НП для кожного замовлення | Масовий друк одним кліком прямо з адмін-панелі магазину |
| Трекінг-номер клієнту | Копіюється вручну і надсилається через Telegram або email | Автоматично відправляється клієнту після генерації ТТН |
| Відстеження статусу | Клієнт дзвонить або менеджер перевіряє вручну на сайті НП | Статус оновлюється в особистому кабінеті клієнта автоматично |
| Помилки в адресі | Часто — через ручне введення | Мінімальні — адреса обирається зі списку підтверджених відділень НП |
Наша думка
Ми бачили магазини де менеджер витрачав половину робочого дня тільки на роботу з Новою Поштою — ручне створення ТТН, відповіді на "де моя посилка", виправлення помилок в адресах. Після інтеграції той самий менеджер обробляв вдвічі більше замовлень за той самий час. Інтеграція доставки — одна з найшвидших і найочевидніших інвестицій в операційну ефективність магазину.
2. Що таке API-ключ Нової Пошти і де його взяти
Коротка відповідь: API-ключ — це унікальний ідентифікатор який дозволяє вашому магазину автоматично спілкуватись з системою Нової Пошти. Отримати його можна в особистому кабінеті my.novaposhta.ua за 5 хвилин — і передати розробнику. Код чи технічні знання для цього не потрібні.
Більшість підприємців не розуміють що таке API-ключ і чому він потрібен. Через це виникають затримки: розробник чекає ключ, підприємець не знає де його взяти. Ось просте пояснення.
Аналогія без технічних термінів
Уявіть що API-ключ — це корпоративна картка доступу. Коли ваш магазин хоче створити ТТН або дізнатись список відділень — він показує цю картку серверу Нової Пошти. Сервер бачить картку, розпізнає що це ваш магазин і виконує запит. Без картки — відмова. Чужа картка — теж відмова. Тільки ваша картка дає доступ до вашого кабінету НП через магазин.
Як отримати API-ключ Нової Пошти — покроково
- Зареєструйтесь або увійдіть в особистий кабінет на my.novaposhta.ua
- Перейдіть у розділ: Налаштування → API 2.0
- Натисніть кнопку "Створити новий ключ"
- Скопіюйте згенерований ключ і збережіть у безпечному місці
- Передайте ключ розробнику для налаштування інтеграції
Весь процес займає 5 хвилин. Офіційна документація API: api.novaposhta.ua — там розробник знайде всі технічні деталі.
Важливо: безпека ключа
- Не публікуйте ключ у відкритому доступі — якщо ключ потрапить до зловмисника, він зможе створювати ТТН від вашого імені
- Не надсилайте у незахищених каналах — краще через захищений месенджер або поділіться доступом через кабінет НП
- Якщо ключ скомпрометований — видаліть його в кабінеті і створіть новий, це займає хвилину
Наша думка
При підключенні доставки ми завжди просимо клієнта самостійно згенерувати API-ключ в своєму кабінеті НП — і передати нам тільки ключ, без логіну і пароля від кабінету. Це безпечніше: ключ можна видалити і замінити в будь-який момент, а якщо дати логін/пароль — доступ значно ширший. Після завершення інтеграції рекомендуємо перевірити що ключ активний і що тестові запити проходять успішно.
3. Нова Пошта API: що дає і як працює пошук відділення за адресою
Коротка відповідь: API Нової Пошти дає магазину доступ до бази всіх відділень України, розрахунку вартості і термінів доставки, генерації ТТН і відстеження статусу посилки. Ключова зручність для клієнта — пошук найближчого відділення за адресою проживання: він не має знати номер відділення.
Нова Пошта — лідер логістичного ринку України і обов'язкова інтеграція для будь-якого інтернет-магазину. API 2.0 надає повний набір інструментів для автоматизації всіх процесів доставки.
Що конкретно вміє API Нової Пошти
- База відділень і поштоматів. Повний список всіх відділень по всіх містах України з адресами, графіком роботи і координатами. Оновлюється в реальному часі — нові відділення з'являються в базі одразу після відкриття.
- Пошук відділення за адресою проживання клієнта. Клієнт вводить свою адресу — магазин автоматично знаходить 3–5 найближчих відділень і відображає їх на карті. Це ключова зручність: клієнт не має знати номер відділення, він просто вводить де живе.
- Автоматичний розрахунок вартості доставки. На основі міста відправника, міста і відділення одержувача, ваги і габаритів посилки — API повертає точну вартість доставки. Клієнт бачить її при оформленні, без сюрпризів.
- Розрахунок термінів доставки. Скільки днів займе доставка між конкретними містами — API повертає точний термін.
- Генерація ТТН (експрес-накладної). Після підтвердження замовлення магазин автоматично створює ТТН з усіма даними замовника. Без входу в кабінет НП, без ручного введення.
- Масовий друк ТТН. Прямо з адмін-панелі магазину — всі ТТН за день одним кліком.
- Відстеження статусу посилки. Магазин отримує актуальний статус кожної посилки і відображає його клієнту в особистому кабінеті.
- Накладений платіж. Налаштування суми накладеного платежу при створенні ТТН — без додаткових дій.
Як працює пошук відділення за адресою: детальніше
Це функція яку ми реалізували і яка суттєво покращує досвід клієнта при оформленні замовлення. Ось як це виглядає:
- Клієнт вводить своє місто і вулицю у поле "Адреса доставки"
- Магазин відправляє запит до API НП з координатами введеної адреси
- API повертає список найближчих відділень відсортованих за відстанню
- Клієнт бачить карту з відділеннями і обирає зручне одним кліком
- При виборі відділення — одразу розраховується вартість і термін доставки
Результат: клієнт більше не гуглить "адреса відділення Нової Пошти" і не телефонує в магазин щоб дізнатись де найближче відділення. Все відбувається в інтерфейсі магазину за 30 секунд.
Що потрібно для інтеграції
- API-ключ з особистого кабінету my.novaposhta.ua (розділ Налаштування → API 2.0)
- Дані відправника: місто і адреса складу або магазину звідки відправляєте
- Стандартні параметри посилки: середня вага і габарити для автоматичного розрахунку
- 2–5 днів розробки залежно від складності інтеграції
Наша думка
Найцінніша функція яку ми реалізуємо при інтеграції НП — це саме пошук відділення за адресою проживання. Клієнт не знає номери відділень — він знає де живе. Коли магазин сам знаходить найближче відділення і показує його на карті — це знімає тертя при оформленні і реально підвищує конверсію. Ми бачили магазини де після цього поліпшення кількість незавершених оформлень зменшилась на 15–20%.
4. Укрпошта: коли варто підключати
Коротка відповідь: Укрпошта — другий за охопленням перевізник в Україні. Варто підключати якщо ваші клієнти є в маленьких містах і селах де немає Нової Пошти, або якщо ваша аудиторія — люди похилого віку які звикли до Укрпошти. API підключається аналогічно до НП.
Коли Укрпошта обов'язкова
- Маленькі міста і села. Нова Пошта є майже скрізь — але є населені пункти де є тільки Укрпошта. Якщо ваша аудиторія розкидана по всій Україні — без Укрпошти ви відрізаєте частину потенційних клієнтів.
- Аудиторія 50+. Люди похилого віку часто звикли до Укрпошти і відчувають дискомфорт від незнайомих сервісів. Для магазинів з такою аудиторією (ліки, товари для здоров'я, дачний інвентар) Укрпошта — важлива опція.
- Книги і некомерційні відправлення. Укрпошта має спеціальні тарифи для книг і друкованих видань — нижчі ніж у НП.
Коли Укрпошта не потрібна
- Якщо ваша аудиторія — міські жителі до 45 років
- Якщо 95%+ замовлень вже обробляються через НП без скарг
- Якщо ваш товар крупний або важкий — тарифи Укрпошти для важких відправлень вищі
API Укрпошти
Укрпошта має офіційне API для інтеграції з інтернет-магазинами. Функціонал аналогічний до НП: пошук відділень, розрахунок вартості, генерація накладних, відстеження. Документація і реєстрація для отримання доступу — на developers.ukrposhta.ua. Термін підключення — від 2 до 7 днів після реєстрації.
Наша думка
Ми підключаємо Укрпошту як другий варіант доставки — коли клієнт запитує або коли аналіз аудиторії показує що є попит. Для більшості міських магазинів з молодою аудиторією Укрпошта не критична. Але для магазинів з аудиторією по всій Україні або для специфічних ніш — варто закласти її в план з самого початку.
5. Justin: альтернатива з пунктами видачі в Сільпо і поштоматами
Коротка відповідь: Justin — українська служба доставки від Fozzy Group з мережею відділень і пунктів видачі в супермаркетах Сільпо. Мінімальний тариф від 25 грн. Підходить для магазинів чия аудиторія часто робить покупки в Сільпо або для тих хто хоче дати клієнту додаткову опцію доставки.
Головна перевага Justin: отримання в Сільпо
Justin має унікальну пропозицію — отримання посилок в супермаркетах Сільпо. Клієнт замовляє товар і забирає його наступного разу коли йде в магазин за продуктами. Для певних аудиторій (молоді мами, зайняті міські жителі) — це реально зручніше ніж їхати у відділення.
Переваги Justin
- Пункти видачі в магазинах Сільпо — зручно для постійних покупців мережі
- Мінімальний тариф від 25 грн за посилку вагою до 0,5 кг в межах міста
- API для інтеграції з магазином — вибір відділення, трекінг, генерація накладних
- Доступний для ФОП і юридичних осіб за договором
- Понад 500 великих компаній вже підключені: Prom, Rozetka, Фокстрот, Епіцентр
Обмеження Justin
- Менша мережа відділень ніж у Нової Пошти — в маленьких містах може не бути зовсім
- Адресна доставка ("адреса — адреса") доступна тільки за укладеним договором з персональним менеджером
- API менш розвинуте ніж у НП — менше методів і функцій
- Менш відомий бренд — частина клієнтів може не довіряти незнайомому перевізнику
Як підключити
Для бізнес-інтеграції потрібно укласти договір з Justin. Після цього надається доступ до API і персональний менеджер. Детальна інформація для бізнес-клієнтів — на justin.ua у розділі "Бізнесу".
Наша думка
Justin — хороша додаткова опція для магазинів де аудиторія перетинається з покупцями Сільпо. Але як єдину службу доставки ми не рекомендуємо — покриття менше ніж у НП і клієнти не завжди знають цей бренд. Оптимально: Нова Пошта як основна і Justin як додаткова опція для тих хто хоче забрати в Сільпо.
6. Порівняння: 3 служби доставки по 8 критеріях
Коротка відповідь: Нова Пошта — обов'язкова для всіх. Укрпошта — якщо є клієнти в малих містах або аудиторія 50+. Justin — якщо аудиторія перетинається з покупцями Сільпо або потрібна додаткова опція. Більшість магазинів стартують з НП і додають інші служби за запитом клієнтів.
| Критерій | Нова Пошта | Укрпошта | Justin |
|---|---|---|---|
| Охоплення по Україні | Максимальне — є скрізь ✅ | Широке — включно з селами ✅ | Середнє — переважно міста |
| Мінімальний тариф | Від ~40–60 грн | Від ~25–35 грн ✅ | Від 25 грн ✅ |
| Швидкість доставки | 1–2 дні ✅ | 2–5 днів | 1–3 дні |
| API для інтеграції | Повноцінне, добре задокументоване ✅ | Є, базовий функціонал | Є, менший функціонал |
| Пошук відділення за адресою | ✅ Повноцінний | Частково | ✅ Є |
| Накладений платіж | ✅ | ✅ | ✅ |
| Унікальні пункти видачі | Відділення і поштомати | Поштові відділення | Відділення + Сільпо ✅ |
| Довіра клієнтів | Найвища ✅ | Висока (особливо 50+) | Середня — бренд менш відомий |
Яку службу підключати першою
Відповідь однозначна: Нова Пошта — завжди першою і завжди обов'язково. Це стандарт ринку. Клієнт який не бачить НП при оформленні — часто закриває магазин і йде до конкурента.
Другу службу підключайте коли:
- Клієнти пишуть "а чи можна доставити в Укрпошту?" — сигнал що аудиторія потребує
- Аналітика показує що значна частина замовників з маленьких міст
- Хочете запропонувати більше варіантів і знизити кількість незавершених оформлень
Наша думка
Ми завжди починаємо з Нової Пошти — це must-have. Укрпошту і Justin підключаємо за запитом клієнта або коли аналіз аудиторії показує реальну потребу. Підключення двох-трьох служб одночасно при старті — не обов'язково. Краще зробити одну інтеграцію бездоганно ніж три кое-як.
7. Трекінг посилок в особистому кабінеті клієнта
Коротка відповідь: Трекінг в особистому кабінеті — це коли клієнт заходить на ваш сайт і бачить актуальний статус своєї посилки без пошуку на сайті НП. Це знижує кількість дзвінків "де моя посилка" на 40–60% і підвищує довіру до магазину.
Питання "де моя посилка?" — одне з найчастіших запитів до підтримки будь-якого магазину. Кожен такий дзвінок або повідомлення — витрата часу менеджера на операцію яку клієнт міг би виконати самостійно за 10 секунд.
Як виглядає трекінг в особистому кабінеті
Після інтеграції клієнт заходить у свій особистий кабінет на вашому сайті і бачить:
- Список своїх замовлень з поточним статусом кожного
- Номер ТТН — автоматично прив'язаний до замовлення після генерації
- Актуальний статус посилки — "Прийнято від відправника", "В дорозі", "Прибуло до відділення", "Видано" — оновлюється автоматично через API НП
- Пряме посилання на відстеження на сайті Нової Пошти — якщо клієнт хоче детальніше
Автоматичні сповіщення про статус
Додатково до кабінету можна налаштувати автоматичні сповіщення при зміні статусу:
- Email або SMS коли посилка прибула до відділення — клієнт знає що можна їхати забирати
- Push-сповіщення якщо у магазину є мобільна версія або PWA
- Telegram або Viber — якщо клієнт залишив контакт месенджера
Що відбувається без трекінгу
Без трекінгу в кабінеті клієнт змушений: шукати ТТН у листах або повідомленнях, заходити на сайт НП і вводити номер вручну, або дзвонити в магазин. Частина клієнтів не знаходить трекінг і пише в підтримку — навіть якщо посилка давно на відділенні. Це і є ті 40–60% звернень які зникають після впровадження трекінгу в кабінеті.
Наша думка
Трекінг в особистому кабінеті — не розкіш а базовий стандарт сучасного магазину. Клієнт який може самостійно перевірити статус посилки — менше тривожиться, менше пише в підтримку і більш лояльний до магазину. Ми завжди реалізуємо трекінг разом з основною інтеграцією НП — окремо це не додає багато роботи але суттєво впливає на досвід клієнта.
8. Типові помилки при інтеграції доставки і як їх уникнути
Коротка відповідь: Найчастіші помилки: неправильна вага посилки в налаштуваннях (клієнт бачить одну вартість, НП рахує іншу), API-ключ з обмеженими правами, відсутність обробки помилок API (магазин падає коли сервер НП недоступний), і забутий тест накладеного платежу.
Помилка 1: Неправильна вага і габарити в налаштуваннях
Що відбувається: в налаштуваннях інтеграції вказана середня вага посилки 0,5 кг — але реальні товари важать 1–3 кг. Клієнт бачить при оформленні вартість для 0,5 кг, а НП рахує реальну вагу при відправці. Клієнт отримує несподіваний рахунок або магазин доплачує різницю з власної кишені.
Рішення: вказувати реальну вагу для кожного товару в картці або налаштувати автоматичний розрахунок на основі ваги товарів у замовленні.
Помилка 2: API-ключ без потрібних прав
Що відбувається: деякі функції API НП (наприклад генерація ТТН) потребують щоб в кабінеті НП були підтверджені відправники і налаштовані реквізити. Якщо цього немає — API повертає помилку при спробі створити ТТН навіть якщо ключ правильний.
Рішення: перед інтеграцією перевірити що в кабінеті НП повністю заповнений профіль відправника і підтверджені дані компанії.
Помилка 3: Відсутність обробки помилок API
Що відбувається: сервер НП тимчасово недоступний (технічні роботи, навантаження) — і магазин при оформленні замовлення показує клієнту порожню сторінку або повідомлення про помилку. Клієнт думає що магазин зламаний і закриває вкладку.
Рішення: коректна обробка помилок API — якщо НП недоступна, магазин показує форму з ручним введенням адреси або повідомлення "спробуйте через кілька хвилин" замість технічної помилки.
Помилка 4: Не протестований накладений платіж
Що відбувається: магазин запустився, перші замовлення з накладеним платежем оформлені — але при отриманні клієнт дізнається що сума накладеного платежу неправильна (або взагалі не вказана). Конфлікт, повернення, негативний відгук.
Рішення: обов'язково протестувати повний цикл замовлення з накладеним платежем до запуску — перевірити що сума правильно передається в ТТН.
Помилка 5: Не оновлюється база відділень
Що відбувається: база відділень НП завантажується одноразово при розробці і не оновлюється. НП відкриває нові відділення і закриває старі. Через рік клієнти намагаються вибрати відділення яке вже не існує або не бачать нового зручного відділення поруч.
Рішення: налаштувати автоматичне оновлення бази відділень через API — наприклад щоночі або раз на тиждень.
Помилка 6: Ігнорування тестового середовища API
Що відбувається: розробник одразу тестує на бойовому API — і при помилках створюються реальні ТТН які потрібно скасовувати. Це плутанина і зайва робота.
Рішення: API НП має тестове середовище — використовуйте його для розробки і налагодження перед переходом на бойовий режим.
Наша думка
Більшість цих помилок ми бачили у клієнтів що приходили до нас з вже підключеною але погано налаштованою інтеграцією НП. Найболючіша — неправильна вага, бо клієнт вже оформив і розраховує на одну вартість доставки. Наш стандарт: перед здачею завжди перевіряємо повний цикл з реальними даними — від вибору відділення до генерації ТТН і трекінгу. Якщо хоч один крок не спрацював — не здаємо поки не виправили.
9. Як ми реалізуємо доставку в WebCraft
Коротка відповідь: Ми інтегруємо Нову Пошту через офіційний API 2.0 з ключами клієнта. Реалізуємо пошук відділення за адресою проживання, автоматичний розрахунок вартості, генерацію ТТН і трекінг в особистому кабінеті. Перед здачею — повне тестування всіх сценаріїв.
Ось як виглядає процес підключення доставки з нашого боку — крок за кроком:
Крок 1: Ви отримуєте API-ключ
Ми надсилаємо інструкцію: зайдіть у my.novaposhta.ua → Налаштування → API 2.0 → Створити новий ключ. Ключ передаєте нам через захищений канал. Займає 5 хвилин.
Крок 2: Налаштовуємо параметри відправника
Вказуємо місто і адресу звідки відправляєте товари. На основі цього API буде розраховувати вартість і терміни доставки для кожного замовника.
Крок 3: Реалізуємо пошук відділення за адресою
Клієнт вводить свою адресу проживання — магазин запитує API НП і повертає список найближчих відділень на карті. Клієнт обирає зручне одним кліком. Одразу розраховується вартість і термін доставки.
Крок 4: Автоматична генерація ТТН
При підтвердженні замовлення менеджером — ТТН генерується автоматично. Трекінг-номер прив'язується до замовлення і відправляється клієнту на email або SMS.
Крок 5: Трекінг в особистому кабінеті
Клієнт бачить актуальний статус посилки в своєму кабінеті на вашому сайті. Статус оновлюється автоматично через API НП — без будь-яких дій менеджера.
Крок 6: Повне тестування перед здачею
Тестуємо всі сценарії: вибір відділення → розрахунок вартості → оформлення замовлення → генерація ТТН → трекінг. Перевіряємо накладений платіж, перевіряємо мобільну версію. Тільки після успішного тесту всіх сценаріїв здаємо роботу.
Є питання або хочете підключити доставку до вашого магазину? Напишіть нам у Telegram.
Часті запитання
Скільки часу займає інтеграція Нової Пошти?
Базова інтеграція (вибір відділення, розрахунок вартості, генерація ТТН) — 2–3 дні розробки. З трекінгом в особистому кабінеті і автоматичними сповіщеннями — 3–5 днів. Якщо паралельно підключаємо Укрпошту або Justin — ще 1–2 дні на кожну. Термін залежить від складності поточного магазину і наявності особистого кабінету клієнта.
Чи може клієнт замовити адресну доставку (кур'єром додому)?
Так, Нова Пошта підтримує адресну доставку через API. Клієнт вводить адресу — кур'єр привозить додому. Вартість вища ніж відділення-відділення. Цю опцію можна увімкнути як додатковий спосіб доставки при оформленні.
Що відбувається якщо API Нової Пошти тимчасово недоступне?
При правильно реалізованій інтеграції — магазин показує клієнту зрозуміле повідомлення і пропонує ввести адресу вручну або спробувати пізніше. Магазин не "падає" і не показує технічну помилку. Це питання якості реалізації — завжди уточнюйте у розробника як обробляються помилки API.
Чи можна підключити доставку до вже існуючого магазину?
Так, інтеграцію можна додати до будь-якого існуючого магазину незалежно від платформи. Потрібен доступ до коду магазину і API-ключ НП. Термін — аналогічний новій розробці. Якщо магазин на конструкторі (Хорошоп, WordPress) — можливості інтеграції обмежені платформою.
Як клієнт дізнається трекінг-номер якщо немає особистого кабінету?
При оформленні замовлення — автоматично відправляється email або SMS з номером ТТН і посиланням на відстеження. Клієнту не потрібен кабінет щоб відстежити посилку — достатньо отриманого повідомлення. Особистий кабінет додає зручність але не є обов'язковим для базового трекінгу.
Інтегруємо доставку під ключ → WebCraft