• Інтеграції · API Укрпошти
  • Вимір 31.07.2026

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

Інтеграція Укрпошти — це вибір відділення за індексом прямо в кошику, орієнтовний розрахунок вартості за вагою й габаритами та формування відправлення з адмінки замість повторного набору даних у кабінеті перевізника. Підключаємо тарифні класи окремими рядками — експрес у відділення, стандарт у відділення, кур'єр за адресою, — бо строки в них різні, а слово «Укрпошта» одне. Довідник відділень і індексів тримаємо у своїй таблиці й оновлюємо фоновою задачею за розкладом. Робота займає 5–11 робочих днів і починається з безкоштовної перевірки вашого чекауту.

Подивитись, як це працює
Вартість
після безкоштовного аудиту
Гарантія
30 днів після підписання акта
Тарифні класи в чекауті
експрес у відділення, стандарт у відділення, кур'єр за адресою
Вартість
після безкоштовного аудиту
Гарантія
30
днів після підписання акта
Тарифні класи в чекауті
експрес у відділення, стандарт у відділення, кур'єр за адресою
Строк робіт
5–11
робочих днів від отримання доступів до API
Перевірка чекауту
1–2
робочих дні, безкоштовно, без зобов'язань
Укрпошта у власних вимірах
13
живих магазинів зі сторінок доставки, вимір 31.07.2026
Що входить

Повний перелік робіт і того, що ви отримуєте на виході

  • Вибір відділення зі списку з пошуком по місту й індексу — покупець не набирає індекс руками, а саме рукописний індекс найчастіше й ламає відправлення
  • Тарифні варіанти окремими рядками: експрес у відділення, стандарт у відділення, кур'єр за адресою — покупець бачить різницю в строку, а не одну назву перевізника
  • Орієнтовний розрахунок вартості за вагою, габаритами й оголошеною вартістю — сума видна до оформлення, а не через дзвінок менеджера
  • Автоматичне оновлення довідника відділень і індексів за розкладом — нове відділення з'являється у вас без ручного імпорту
  • Формування відправлення з адмінки й друк супровідних документів — менеджер не переходить у кабінет перевізника й не набирає адресу вдруге
  • Передача трек-номера в замовлення й у лист покупцю — питання «де моя посилка» доходять до менеджера рідше
  • Перевірка післяплати під ваш товар: чи підтримується ваш сценарій розрахунку для обраних тарифів — відповідь фіксуємо до запуску
  • Сценарій міжнародного відправлення з переліком вкладень — якщо він вам потрібен; дані передаємо у форматі, який приймає перевізник
  • Наскрізна перевірка на живому замовленні разом із вашим менеджером: від кошика до друку документів і трек-номера в листі
  • Технічна передача: доступи, коротка письмова інструкція під ваші процеси, гарантія 30 календарних днів на виконані роботи
Коли ця послуга не підходить

Що не входить у роботу — щоб не було сюрпризів на здачі

  • Договір із перевізником і отримання доступів до API — оформлюються на вас
  • Тарифні домовленості й розрахунок собівартості доставки
  • Митне оформлення міжнародних відправлень
  • Обробка повернень і претензій
  • Підключення інших перевізників — окремий обсяг робіт
Кому підходить

Ситуації, у яких ця послуга дає результат

Сценарій 1 із 5

Товар легкий, і комісія перевізника з'їдає маржу

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

Розберемо вашу ситуацію на безкоштовному аудиті
Безкоштовний аудит

Безкоштовна перевірка сценарію доставки

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

Що ми міряємо

  1. Які тарифи вам справді потрібніЕкспрес у відділення, стандарт у відділення, кур'єр — у виміряному магазині були увімкнені всі три. Кожен додатковий тариф — це окремий розрахунок і окремий рядок у чекауті.
  2. Довідник відділень і індексівПеревіряємо, чи підтягується перелік відділень і поштових індексів автоматично. Індекс, введений покупцем руками, — найчастіша причина неприйнятого відправлення.
  3. Що бачить покупець у чекаутіЦіна доставки має бути видимою або чесно поміченою як орієнтовна. Ми бачили в чекауті «0 грн» на перевізнику, у якого інформаційна сторінка того ж сайту називала 35–80 грн.
  4. Міжнародні відправленняЯкщо ви відправляєте за кордон, це окремий сценарій із митною декларацією й переліком вкладень. Його краще врахувати до, а не після запуску.
  5. Що з післяплатоюУмови післяплати в Укрпошти відрізняються від комерційних перевізників — перевіряємо, чи ваш сценарій узагалі підтримується.

Що ви отримуєте

  • Звіт із реального чекауту: які способи доставки віддає сайт зараз і з якими цінами.
  • Перелік тарифів Укрпошти, які має сенс увімкнути саме вам.
  • Оцінку робіт і строку з поділом на обов'язкове й бажане.
  • Розмову на 20–30 хвилин із менеджером, який відправляє замовлення.

Строк: 1–2 робочих дні

Чому це безкоштовно

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

Що далі

Після перевірки даємо кошторис і строк. Якщо для вашого обсягу достатньо ручного оформлення в кабінеті перевізника — скажемо прямо.

Коротка форма: контакт і адреса сайту
Договір і документи

Працюємо офіційно

Договір, акт і рахунок — на кожен проєкт, а не тільки на великий. Без документів у вас немає ні прав на роботу, ні підстави провести витрати.

Нам довіряють6 брендів

Нам довіряють: Kvant Energy, GYPSUN, Naturel Cosmetics, Pancer Protection, LUGI, BeeTech

Умови, зафіксовані письмово8 пунктів

  • Договір, акт і гарантія 30 днів

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

  • ФОП і безготівковий розрахунок

    Виконавець — зареєстрований ФОП. Оплата на рахунок із закривними документами.

  • Права й доступи — ваші

    Код, дизайн і матеріали переходять до вас після повної оплати. Домен, хостинг, репозиторій, аналітику оформлюємо на вас.

  • Портал клієнта замість переписки

    На час роботи ви отримуєте доступ до порталу: договори, рахунки, акти й стан проєкту в одному місці.

  • Сайти в дев'яти країнах

    Наші сайти працюють у дев'яти країнах: крім України — Польща, Німеччина, Австрія, Англія, Норвегія, Болгарія, Молдова, Іспанія.

  • Цифри, які можна перевірити

    Кожен кейс у портфоліо — з посиланням на живий сайт і технічним виміром.

  • Спершу аудит, потім сума

    Прайсу на сайті немає навмисно: обсяг тієї самої роботи у двох клієнтів відрізняється в рази.

  • Кажемо «ні», коли не впевнені

    Якщо задача не наша або строк нереальний — скажемо одразу.

  • Договір, акт і гарантія 30 днів

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

  • ФОП і безготівковий розрахунок

    Виконавець — зареєстрований ФОП. Оплата на рахунок із закривними документами.

  • Права й доступи — ваші

    Код, дизайн і матеріали переходять до вас після повної оплати. Домен, хостинг, репозиторій, аналітику оформлюємо на вас.

  • Портал клієнта замість переписки

    На час роботи ви отримуєте доступ до порталу: договори, рахунки, акти й стан проєкту в одному місці.

  • Сайти в дев'яти країнах

    Наші сайти працюють у дев'яти країнах: крім України — Польща, Німеччина, Австрія, Англія, Норвегія, Болгарія, Молдова, Іспанія.

  • Цифри, які можна перевірити

    Кожен кейс у портфоліо — з посиланням на живий сайт і технічним виміром.

  • Спершу аудит, потім сума

    Прайсу на сайті немає навмисно: обсяг тієї самої роботи у двох клієнтів відрізняється в рази.

  • Кажемо «ні», коли не впевнені

    Якщо задача не наша або строк нереальний — скажемо одразу.

NDA підписуємо на запит. Після завершення співпраці наші доступи до ваших сервісів видаляємо самі.

Що впливає на вартість

Чому дві однакові на вигляд задачі рахуються по-різному

  • Скільки тарифних класів вмикаємоОдин клас у відділення — один розрахунок і один рядок у кошику. Три класи — три розрахунки, правило вибору між ними й три сценарії тестування. Це найчастіша різниця між короткою роботою й довгою.
  • Чи потрібне формування відправлень з адмінкиЯкщо менеджеру достатньо кабінету перевізника, цього блоку не робимо взагалі. Якщо потрібен друк документів прямо із замовлення — додаються права доступу, шаблони й обробка помилок від API, коли дані не пройшли.
  • Стан чекауту на стартіУ магазин, де вже працює один перевізник із нормальним вибором відділення, Укрпошта лягає рядком. Якщо ж чекаут показує «0 грн» на платній доставці, спершу доводиться привести до ладу сам розрахунок — інакше новий перевізник просто додасть другу неправильну цифру.
  • Платформа й версіяПід OpenCart і WooCommerce часто є готовий модуль, і робота зводиться до налаштування й перевірки. Самописний чекаут або вітрина на Next.js означають, що виклики API пишемо під ваш код.
  • Міжнародні відправленняОкремий сценарій: перелік вкладень, дані одержувача латиницею, декларація. Він майже подвоює обсяг тестування, тому вирішувати «беремо чи ні» треба на перевірці, а не в середині роботи.
  • Обсяг живого тестуванняОдне контрольне відправлення з вашим менеджером входить у роботу. Прогін усіх тарифів реальними посилками різної ваги — додаткові дні, і зазвичай вони себе виправдовують.
Кейси

Задачі та результат у цифрах — усі показники зняті нашим виміром

спеціалізований інтернет-магазин засобів самооборони

Задача
Дати вибір між двома перевізниками при невеликому каталозі й тримати сторінки легкими на мобільному.
Рішення
OpenCart 3.x за nginx і HTTP/2. Оплата карткою й накладений платіж при отриманні, доставка двома перевізниками — Нова Пошта й Укрпошта. Карта сайту — індекс із чотирьох підкарт.
Результат
Вимір 31.07.2026: 48 товарів і 18 категорій — 68 адрес у карті сайту, нуль зайвих записів. Перша відповідь сервера 494,7 мс, повне завантаження HTML 567,5 мс. Знайдений дефект: нуль блоків JSON-LD і жодного лічильника Google — конверсії не міряються взагалі.

інтернет-магазин садового інструменту для приватних покупців

Задача
Показати покупцю всі варіанти доставки й розрахунку на одній сторінці умов і не зробити при цьому важку головну.
Рішення
OpenCart 3.x, чотири перевізники — Нова Пошта, Meest Express, Укрпошта, Rozetka Delivery — і п'ять способів розрахунку, серед них безготівковий з ПДВ і без.
Результат
Вимір 31.07.2026: HTML головної 252,6 КБ, перша відповідь 547,2 мс, повне завантаження 676,7 мс; 66 з 69 зображень (96%) вантажаться відкладено. Знайдений дефект: назви перевізників подані лише картинками без alt — ні пошуковик, ні скрінрідер їх не бачать.

офіційний інтернет-магазин садового інструменту світового бренду

Задача
Обслужити каталог у кілька тисяч позицій і дати широкий вибір оплати й доставки.
Рішення
OpenCart 3.x за nginx, HTTP/2, HSTS. Вісім способів оплати й чотири служби доставки, серед них Укрпошта; логотипи перевізників подані з alt-текстом.
Результат
Вимір 31.07.2026: 8 690 унікальних адрес у карті сайту — близько 8,6 тис. карток і 81 категорійний вузол. Перша відповідь 789,4 мс разом із 301-редиректом на мовну гілку. Знайдений дефект: 33 493 записи в карті сайту на ті самі 8 690 адрес, і жодного посилання на другу мовну версію.

інтернет-магазин доставки солодощів, снеків і подарункових наборів

Задача
Зібрати чекаут під імпульсну покупку з телефона: вибір між дешевшою й швидшою доставкою.
Рішення
OpenCart 3.x, п'ять способів онлайн-оплати й чотири способи доставки — Нова Пошта, Укрпошта, самовивіз, кур'єр.
Результат
Вимір 31.07.2026: перша відповідь 402,9 мс, повне завантаження HTML 532,4 мс при 303,4 КБ розмітки. Знайдені дефекти: карта сайту віддає 200 із порожнім тілом, аналітики немає взагалі — ні GTM, ні GA, ні Meta Pixel.

Не знайшли свій випадок?

Опишіть, як це влаштовано у вас, — відповімо, чи підходить «Інтеграція Укрпошти» і що це означає у вашій ситуації. Без брифу й без дзвінка: одне питання, одна відповідь.

Етапи роботи

Прозорі етапи з погодженням на кожному кроці

Загальний строк:3–10 днів

  1. Перевірка чекауту й доступи

    1–2 робочих дні

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

  2. Довідник відділень і тарифні класи

    1–3 робочих дні

    Заводимо власну таблицю відділень та індексів, ставимо фонову задачу оновлення за розкладом і розводимо тарифи окремими рядками з поясненням строку. Тут же вирішується, що показувати за замовчуванням.

  3. Розрахунок вартості в кошику

    1–2 робочих дні

    Вага, габарити й оголошена вартість підв'язуються до розрахунку, сума виводиться з позначкою «орієнтовно». Окремо описуємо поведінку, коли API не відповів: кошик не має падати разом із ним.

  4. Формування відправлень і трек-номери

    1–3 робочих дні

    Кнопка створення відправлення в адмінці, друк супровідних документів, запис трек-номера в замовлення й у лист покупцю. Помилки від перевізника показуємо менеджеру текстом, а не мовчазним збоєм.

  5. Живий прогін і передача

    1 робочий день

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

Технології та інтеграції

На чому будуємо і з чим це з'єднується

Стек

  • API Укрпошти — єдине джерело довідника відділень і індексів; його межа в тому, що остаточну суму перевізник рахує при прийомі
  • OpenCart 3 / 4 — готові модулі є, але збірка під 4.x є не в кожного розробника; версію фіксуємо до старту
  • WooCommerce — плагіни існують, частина не оновлювалась роками; беремо той, який прочитали в коді
  • Next.js — готового модуля немає, виклики API пишемо руками; натомість чекаут не обмежений чужим шаблоном
  • PHP і MySQL — довідник тримаємо у своїй таблиці, а не смикаємо API на кожен рендер кошика
  • Фонова задача оновлення довідника — за розкладом і з логом; якщо перевізник не відповів, кошик працює на попередній версії списку

Інтеграції

  • Укрпошта — експрес у відділення
  • Укрпошта — стандарт у відділення
  • Укрпошта — кур'єр за адресою
  • післяплата
  • трек-номер у листі покупцю
  • KeyCRM
  • Telegram-бот для сповіщень
Інтеграція проти ручного оформлення в кабінеті перевізника

Чим цей варіант відрізняється від альтернативи

Ручне оформлення в кабінетіНаш підхід
Хто вводить адресуменеджер уточнює індекс у переписці й набирає його рукамипокупець обирає відділення зі списку з пошуком по місту й індексу
Актуальність довідникакабінет перевізника завжди свіжий — тут ручний спосіб не програєфонове оновлення за розкладом, із логом невдалих спроб
Вартість доставки для покупцясуму називає менеджер, а часто покупець не дізнається її взагаліорієнтир за вагою й габаритами видно до оформлення
Час на одну посилкуповторне введення тих самих даних на кожному замовленнідані вже в замовленні, лишається натиснути «створити відправлення» й роздрукувати
Коли вигіднішеодиниці замовлень на місяць — інтеграція не окупитьсявід кількох відправлень на день і за наявності другого перевізника
Що потрібно від вас

Без цього не почнемо — краще підготувати заздалегідь

  1. Доступи до API Укрпошти з вашого кабінету — договір перевізник оформлює на вас, не на підрядника.
  2. Доступи до сайту й адмінки з правами на встановлення модулів, плюс тестове середовище, якщо воно у вас є.
  3. Перелік тарифів, які вмикаємо, і правило вибору між ними: що показувати покупцю за замовчуванням.
  4. Дані відправника: адреса, поштовий індекс, контактна особа, телефон.
  5. Типову вагу й габарити відправлень або формулу, за якою вони рахуються з товарів у кошику.
  6. Менеджера із замовлень на дві-три години — саме він проходить живий сценарій і каже, де незручно.
Якщо чогось із цього немає — скажіть, підкажемо, як зібрати або зробимо самі окремою задачею.
Часті питання

Те, що питають найчастіше — з конкретними відповідями

Чим Укрпошта складніша за комерційного перевізника з боку інтеграції?

Двома речами: довідником і тарифними класами. Адреса відділення тут прив'язана до поштового індексу, а не до номера відділення в місті, тому пошук у кошику треба робити і по назві населеного пункту, і по індексу. А тарифи діляться на експрес і стандарт із різними строками доставки. Якщо звести їх в один рядок «Укрпошта», покупець отримає не той строк, на який розраховував, і претензія прилетить вам, а не перевізнику.

Чи можна показати покупцю точну вартість доставки?

Орієнтовну — так, за вагою, габаритами й оголошеною вартістю. Точну суму перевізник рахує при прийомі відправлення, і жоден модуль цього не обійде. Тому виводимо розрахунок із чесною позначкою «орієнтовно». Чого точно не варто робити — показувати «0 грн», коли доставка платна: ми бачили саме такий чекаут у магазині, інформаційна сторінка якого на тому ж домені називала 35–80 грн.

У нас уже стоїть Нова Пошта — це буде швидше?

Так, і помітно. Найдорожча частина роботи — привести до ладу сам крок доставки в кошику: розрахунок, валідацію, поведінку при недоступному API. Якщо це вже зроблено, Укрпошта лягає другим блоком у готову схему. Зворотне теж правда: якщо ви плануєте обох перевізників, беріть їх однією роботою — чекаут переробляється один раз, а не двічі.

Чи підтримується післяплата?

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

А міжнародні відправлення?

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

Скільки триває робота і чому сума днів по етапах більша за строк?

Строк — 5–11 робочих днів. По етапах: перевірка чекауту 1–2 дні, довідник і тарифи 1–3, розрахунок вартості 1–2, формування відправлень з адмінки 1–3, живий прогін 1. Сума виглядає більшою, бо етапи частково йдуть паралельно: поки оновлюється довідник, уже пишеться розрахунок. Нижня межа 3 дні реальна тоді, коли доступи є з першого дня й вмикається один тарифний клас.

Хто оновлює довідник відділень після запуску?

Ніхто руками. Довідник лежить у вашій базі й оновлюється фоновою задачею за розкладом — це свідоме рішення, а не економія на API. Якщо смикати перевізника на кожен рендер кошика, ваш кошик перестане працювати рівно тоді, коли ляже чужий сервер. З локальною копією в такий момент покупець просто бачить трохи старіший список відділень, а замовлення оформлюється.

А якщо готового модуля під нашу платформу немає?

Пишемо звернення до API самі — так робиться на вітринах Next.js і на самописних чекаутах. Обсяг більший, ніж налаштування коробкового модуля, зате немає чужого коду, який одного дня перестануть підтримувати. І окрема порада з практики: перш ніж ставити плагін із каталогу, ми відкриваємо його код і дивимось дату останньої правки. Кількість встановлень про живість модуля не говорить нічого.

Коли інтеграція вам не потрібна?

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

Як отримати доступ до API Укрпошти?

Через договір з Укрпоштою: після підписання ваш менеджер видає два ключі, bearer і token, і запити до API ідуть із цими ключами. Для відстеження статусів, за довідкою самої Укрпошти, потрібен ще окремий ключ — його теж видає менеджер, тому просити варто одразу, а не після запуску. Ключі оформлюються на вас; ми отримуємо їх на час налаштування й тримаємо тільки на сервері. Строк 5–11 робочих днів рахується саме від дня, коли доступи на руках.

Дайте посилання на чекаут — почнемо з перевірки, а не з кошторису

За 1–2 робочих дні повернемось зі звітом: що сайт віддає покупцю зараз, які тарифи Укрпошти має сенс увімкнути саме вам і скільки це роботи. Якщо для вашого обсягу вистачить кабінету перевізника, почуєте це першим же листом.

З виміряних кейсівВимір 31.07.2026: 48 товарів і 18 категорій

Дивитись кейси
  • Відповідь протягом 2 годин
  • Без зобов’язань
  • Працюємо за договором

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