До змісту
Tvorum.
E-commerce11 хв читання

Інтеграція Нової Пошти з сайтом: як це працює і що налаштувати

Як сайт отримує актуальні відділення й поштомати, рахує доставку, створює ТТН і стежить за статусами посилок. Розбираємо API Нової Пошти простими словами, способи оплати під час отримання, типові помилки та чеклист запуску.

АвторРедакція Tvorum
Опубліковано:
Поділитися
Інтеграція Нової Пошти з сайтом: як це працює і що налаштувати
Зміст статті (10)
  1. Що змінюється після інтеграції
  2. З чого складається інтеграція: 4 частини
  3. 1. Довідник міст, відділень і поштоматів
  4. 2. Розрахунок вартості і строку доставки
  5. 3. Створення ТТН і друк маркувань
  6. 4. Відстеження статусів і повідомлення
  7. Як влаштоване API Нової Пошти простими словами
  8. Скільки коштує доставка для покупця
  9. Оплата під час отримання: накладений платіж, «Контроль оплати» чи передоплата
  10. Варіанти реалізації і їхня вартість
  11. Як має виглядати вибір доставки в кошику
  12. 10 типових помилок
  13. Чеклист запуску інтеграції
  14. Висновок

Інтеграція Нової Пошти з сайтом — це підключення магазину до API Нової Пошти: покупець у кошику вибирає місто й відділення або поштомат з актуального довідника і бачить вартість доставки, а менеджер створює експрес-накладну (ТТН) в один клік і більше не переписує дані вручну. Статуси посилок оновлюються автоматично, а клієнт отримує номер ТТН у месенджері чи на email. Для підключення потрібен кабінет Нової Пошти і безкоштовний API-ключ; на готових платформах це модуль, на власному сайті — кілька днів роботи розробника.

Розберемо, з чого складається інтеграція, як вона працює технічно, які є варіанти оплати під час отримання, скільки це коштує і де найчастіше помиляються.

Що змінюється після інтеграції

ПроцесБез інтеграціїЗ інтеграцією
Вибір відділенняПокупець вписує «Київ, відділення на Хрещатику» вручнуВибір зі списку з пошуком, номером і адресою
Вартість доставки«Уточнить менеджер»Розраховується в кошику до оформлення
Створення ТТНМенеджер копіює дані в кабінет НП, 2–4 хв на замовленняОдин клік або автоматично після оплати
Номер ТТН клієнтуВручну, якщо не забулиАвтоматично в SMS, Viber, Telegram чи email
СтатусиПеревірка вручну по кожній посилціАвтоматичне оновлення кожні кілька годин
ВідмовиПомічаєте, коли посилка вже повертаєтьсяМенеджер отримує завдання одразу після відмови

Для магазину з 20–30 замовленнями на день лише створення ТТН вручну забирає годину-півтори робочого часу щодня. Плюс помилки в прізвищах, телефонах і номерах відділень, через які посилки «зависають».

З чого складається інтеграція: 4 частини

1. Довідник міст, відділень і поштоматів

Сайт отримує через API актуальний перелік населених пунктів і точок видачі. Мережа Нової Пошти постійно змінюється: відкриваються нові відділення і поштомати, деякі закриваються чи переїжджають. Тому довідник потрібно оновлювати автоматично щодня, а не завантажити один раз під час запуску.

У кошику це виглядає так: покупець починає вводити назву міста, отримує підказки, обирає тип доставки (відділення, поштомат чи курʼєр) і бачить список точок з пошуком за номером або вулицею. Ідеально — ще й на карті.

2. Розрахунок вартості і строку доставки

API дозволяє розрахувати вартість доставки за маршрутом, вагою, габаритами й оголошеною вартістю, а також орієнтовну дату доставки. Щоб розрахунок був точним, у кожного товару мають бути заповнені вага і габарити в упаковці. Без цього сайт покаже покупцю одну суму, а у відділенні з вас візьмуть іншу.

3. Створення ТТН і друк маркувань

З адмінки сайту чи CRM менеджер натискає «Створити ТТН» — і всі дані підтягуються із замовлення: отримувач, телефон, місто, відділення, вага, кількість місць, опис вмісту, оголошена вартість, сума накладеного платежу, хто платить за доставку. Можна створювати накладні пакетно — для всіх замовлень дня — і друкувати маркування на термопринтері.

4. Відстеження статусів і повідомлення

Сайт або CRM регулярно запитує статуси за номерами ТТН і змінює статус замовлення: «Відправлено», «Прибуло у відділення», «Отримано», «Відмова». На кожну подію можна налаштувати повідомлення покупцю і завдання менеджеру — наприклад, нагадування клієнту, якщо посилка лежить у відділенні третій день.

Як влаштоване API Нової Пошти простими словами

API Нової Пошти — це набір запитів у форматі JSON до сервера api.novaposhta.ua. Кожен запит містить ваш API-ключ, назву моделі і метод. Ключ генерується в особистому або бізнес-кабінеті Нової Пошти в налаштуваннях безпеки; доступ до API безкоштовний.

Модель APIЩо робитьДе використовується
AddressПошук населених пунктів, вулиць, відділень і поштоматів (методи на кшталт searchSettlements, getWarehouses)Поле вибору доставки в кошику
InternetDocumentСтворення, редагування і видалення ТТН, розрахунок вартості (getDocumentPrice) і дати доставкиАдмінка, CRM, автоматизація після оплати
TrackingDocumentСтатуси посилок за номерами ТТН (getStatusDocuments), пакетноОновлення статусів, повідомлення
Counterparty, ContactPersonДані відправника і отримувачівСтворення ТТН від імені вашої компанії

Для базових функцій — довідники, розрахунок вартості, створення ТТН — достатньо зареєстрованого кабінету. Для безготівкових розрахунків з Новою Поштою і послуги «Контроль оплати» потрібен договір як для бізнес-клієнта.

Важливо з безпеки: API-ключ дає право створювати накладні від імені вашої компанії. Він має зберігатися лише на сервері, а не в коді сторінки, який бачить будь-який відвідувач. Більше про захист магазину — у статті про безпеку сайту.

Скільки коштує доставка для покупця

Станом на 2026 рік (після оновлення тарифів Нової Пошти 13 квітня) базові ціни на посилки між відділеннями такі:

ПосилкаУ межах містаПо Україні
До 2 кг≈ 70 грн≈ 90 грн
До 10 кг≈ 115 грн≈ 135 грн
Доставка в поштомат+ ≈ 10 грн за місце+ ≈ 10 грн за місце
Доставка в село+ ≈ 30 грн+ ≈ 30 грн

Тарифи регулярно переглядаються, тому сайт має рахувати вартість через API, а не за таблицею, яку хтось колись вписав вручну.

Кілька практичних порад:

  • Покажіть вартість доставки до останнього кроку — несподівані витрати на фінальному етапі є однією з найчастіших причин покинутих кошиків.
  • Поріг безкоштовної доставки ставте трохи вище за середній чек (наприклад, на 15–25%): це мотивує додати ще один товар.
  • Для дрібних товарів пропонуйте поштомат першим — він дешевший для вас і зручніший для покупця, який отримує посилку в будь-який час.

Оплата під час отримання: накладений платіж, «Контроль оплати» чи передоплата

СпосібЯк працюєПлюсиМінуси
Накладений платіж (грошовий переказ)Покупець платить у відділенні, гроші надходять відправнику переказомЗвично для покупців, підвищує довіру до нового магазинуКомісія за переказ, ризик відмов і зворотної доставки
«Контроль оплати»Послуга для бізнес-клієнтів за договором: гроші за товар зараховуються на ваш поточний рахунокГроші одразу на рахунку, простіше облік, комісія зазвичай нижча за звичайний переказПотрібен договір з Новою Поштою
Передоплата онлайнПокупець платить карткою, Apple Pay чи Google Pay на сайтіНемає відмов і касових розривівЧастина покупців не довіряє новим магазинам
Часткова передоплата100–200 грн онлайн, решта — під час отриманняРізко скорочує «несерйозні» замовленняЩе один крок для покупця

Точні комісії залежать від тарифу і договору — перевіряйте актуальний прайс Нової Пошти. Окреме питання — фіскальні чеки: чи потрібен ваш власний ПРРО, коли покупець платить через Нову Пошту, залежить від схеми розрахунку і податкового статусу. Уточніть це в бухгалтера до запуску, а не після першої перевірки.

Порахуйте ціну відмов. Якщо магазин відправляє 300 посилок на місяць з накладеним платежем і 10% покупців не забирають їх, це 30 повернень. За тарифом близько 90 грн в один бік ви втрачаєте приблизно 5 400 грн щомісяця лише на доставці — без урахування часу менеджера і заморожених товарів. Саме тому магазини поступово переводять покупців на онлайн-оплату: як обрати провайдера, ми розібрали в матеріалі про онлайн-оплату на сайті.

Варіанти реалізації і їхня вартість

ВаріантЯк підключаєтьсяСкільки часуНюанси
Horoshop, Prom та інші SaaSВбудований модуль: вставити API-ключ і налаштувати1–2 годиниМожливості обмежені модулем платформи
WooCommerce, OpenCartБезкоштовні або платні плагіниВід кількох годин до 1–2 днівЯкість плагінів різна, потрібні оновлення
Через CRM (KeyCRM, SalesDrive та ін.)Сайт передає замовлення в CRM, ТТН створюється там1–2 дні разом з інтеграцією CRMНайзручніше для команди з кількох менеджерів
Власна розробкаПрямо через API під ваш процес1–3 дніБудь-яка логіка: автоТТН після оплати, кілька складів

Якщо замовлень більше 10–15 на день, створювати ТТН зручніше не в адмінці сайту, а в CRM, де менеджер бачить усю історію клієнта. Як вибрати CRM, ми розповіли в статті про CRM для малого бізнесу.

Укрпошта, Meest і інші служби підключаються за тим самим принципом. Показувати покупцю 2–3 варіанти доставки варто, якщо ваша аудиторія — у невеликих населених пунктах або ви продаєте легкі товари, для яких різниця в тарифах відчутна.

Як має виглядати вибір доставки в кошику

  • Поле міста з підказками після 2–3 введених літер і пріоритетом великих міст.
  • Перемикач «Відділення / Поштомат / Курʼєр» з ціною біля кожного варіанта.
  • Список точок з пошуком за номером і вулицею; на мобільному — повноекранний вибір, а не випадний список на 300 позицій.
  • Графік роботи відділення поруч з адресою.
  • Поштомати, які не приймають ваші габарити, не показуються взагалі.
  • Для повторних покупців — збережене останнє відділення.
  • Імʼя та прізвище отримувача окремими полями, телефон з маскою +380 — так менше помилок під час видачі посилки.

10 типових помилок

  1. Відділення вводиться текстом вручну — неминучі помилки, неіснуючі номери відділень і посилки, що «зависають» на складі.
  2. Довідник не оновлюється — покупці обирають відділення, які вже закриті.
  3. Не заповнені вага і габарити товарів — розрахунок вартості не збігається з реальністю.
  4. Плутанина з тим, хто платить за доставку і переказ — конфлікти у відділенні.
  5. Номер ТТН не надсилається покупцю — дзвінки «де моя посилка» забирають час менеджерів.
  6. Ніхто не стежить за відмовами — посилка повертається, і ви платите доставку двічі.
  7. API-ключ у коді сторінки — будь-хто може створювати накладні від вашого імені.
  8. Немає поштоматів — частина покупців обирає конкурента з зручнішою доставкою.
  9. Безкоштовна доставка без розрахунку маржі — на дешевих товарах вона зʼїдає весь прибуток.
  10. Інтеграція «зламалась» тихо — після зміни в API замовлення перестають передаватися, а помічають це через тиждень. Потрібен моніторинг і сповіщення про помилки.

Чеклист запуску інтеграції

  • Зареєстровано бізнес-кабінет Нової Пошти, підписано договір, якщо потрібен «Контроль оплати».
  • API-ключ згенеровано і збережено лише на сервері.
  • Довідник міст, відділень і поштоматів оновлюється автоматично щодня.
  • У всіх товарів заповнені вага і габарити в упаковці.
  • Вартість доставки показується в кошику до підтвердження замовлення.
  • Визначено, хто платить за доставку і за переказ, і це написано на сайті.
  • ТТН створюється з адмінки чи CRM в один клік або автоматично після оплати.
  • Покупець автоматично отримує номер ТТН.
  • Статуси посилок оновлюються самі, відмови потрапляють менеджеру як завдання.
  • Налаштовано сповіщення про помилки інтеграції.
  • Зроблено 3–5 тестових відправлень: відділення, поштомат, курʼєр, накладений платіж.
  • На сторінці «Доставка і оплата» описано строки, вартість і умови повернення.

Висновок

Добре зроблена інтеграція Нової Пошти — це не просто список відділень у кошику. Це точний розрахунок доставки до оформлення, ТТН без ручного копіювання, автоматичні статуси і контроль відмов. Вона економить години роботи менеджерів, зменшує кількість помилок і повернень, а покупцю дає відчуття, що магазин працює чітко.

Інтеграція Нової Пошти входить у наші пакети інтернет-магазину під ключ уже з базового «Старту» — 29 900 грн із запуском за 7–10 днів; ціна і строк фіксуються в договорі. Якщо ще обираєте, на чому запускатися, почніть з порівняння платформ для інтернет-магазину або порахуйте бюджет у калькуляторі — команда Tvorum відповість на заявку протягом 15 хвилин.

Усі статті
Поділитися

Редакція Tvorum

Пишемо про те, з чим працюємо щодня: сайти, SEO, реклама й конверсія. Простою мовою, з цифрами та прикладами — щоб ви могли застосувати це у своєму бізнесі.

FAQ

Часті питання

Чи потрібен договір з Новою Поштою, щоб підключити API?

Для довідників, розрахунку вартості і створення ТТН достатньо зареєстрованого кабінету і API-ключа. Договір потрібен для безготівкових розрахунків з Новою Поштою і послуги «Контроль оплати», коли гроші за товар надходять на ваш рахунок.

Скільки коштує API Нової Пошти?

Доступ до API безкоштовний. Ви платите лише за доставку і додаткові послуги за тарифами Нової Пошти, а також за роботу з налаштування інтеграції на сайті.

Чи можна створювати ТТН автоматично, без менеджера?

Так. Наприклад, після успішної онлайн-оплати сайт сам створює накладну, а менеджер лише друкує маркування і пакує товар. Для замовлень з накладеним платежем зазвичай залишають ручне підтвердження, щоб відсіяти несерйозні замовлення.

Як показати покупцю вартість доставки ще до оформлення?

Сайт рахує її через API за маршрутом, вагою і габаритами кошика одразу після вибору міста і типу доставки. Для цього в товарах мають бути заповнені вага і розміри в упаковці.

Чи можна підключити одночасно Нову Пошту, Укрпошту і Meest?

Так, кожна служба має власне API. Покупець бачить кілька варіантів із цінами і строками і обирає зручний. Головне — не перевантажувати кошик: 2–3 варіанти доставки зазвичай достатньо.

Що робити з відмовами від посилок з накладеним платежем?

Налаштувати автоматичні нагадування покупцю, поки посилка у відділенні, ставити завдання менеджеру одразу після відмови і пропонувати часткову або повну онлайн-передоплату — вона помітно скорочує кількість відмов.

E-commerce

Схожі статті

Усі статті

0 ₴ · 24h

Покажемо ваш майбутній сайт до оплати

Залиште контакт — протягом 24 годин підготуємо безкоштовний прототип головної сторінки під ваш бізнес. Сподобається — фіксуємо ціну та строки в договорі.

  • Прототип за 24 години — безкоштовно
  • Фіксована ціна, без «доплат» в процесі
  • Запуск від 5 днів
  • Гарантія та підтримка після здачі
Де відповісти?

Без спаму. Натискаючи кнопку, ви погоджуєтесь з політикою конфіденційності.