Нічого не знайдено

Спробуйте інший пошуковий запит

Популярні запити:

Додати в кошик

Кошик

У вас поки немає покупок

Переглянути маркетплейс
Початкова сума:
Знижка на товари:
Знижка за кількість:
Всього:
Оформити замовлення

Доставка Укрпоштою в OpenCart: огляд модуля «Укрпошта API»

Розбираємо модуль «Укрпошта API» по екранах адмінки: ключі API, способи доставки, локальна база відділень, накладний платіж, Cron, створення накладних і що врахувати перед покупкою.

7 хв читання
54
1
Доставка Укрпоштою в OpenCart: огляд модуля «Укрпошта API»

Укрпошта досі закриває те, що не завжди закривають інші перевізники: малі міста й села, 11000+ точок видачі, тарифи без об'ємної ваги. Але без інтеграції працювати з нею з магазину незручно: менеджер копіює дані замовлення в кабінет Укрпошти, вручну друкує накладну, потім так само вручну шукає статус і пише клієнту. Модуль «Укрпошта API» переносить цю роботу в адмінку OpenCart: покупець обирає відділення й бачить вартість та термін доставки на оформленні, а накладна створюється з картки замовлення з уже заповненою формою.

Модуль працює через API Укрпошти для e-commerce. Окрім способу доставки, у ньому є робота з накладними, калькулятори вартості й терміну доставки, автоматичне відстеження відправлень зі зміною статусів замовлення та сповіщеннями. Загальне порівняння модулів доставки для українських перевізників є в статті про модулі доставки для OpenCart: Нова пошта, Укрпошта, Rozetka, а тут розберемо саме цей модуль по екранах адмінки.

Основні налаштування і ключі API

Перша вкладка відповідає за підключення. Сюди вводяться три ключі від Укрпошти: eCom Bearer, StatusTracking Bearer і User token, без них модуль не працюватиме. Тут же вмикається режим налагодження, задається логотип перевізника і місце, де він виводиться на оформленні. Корисна дрібниця: під кнопкою збереження є завантаження базових налаштувань, а також експорт та імпорт, тож налаштований модуль можна перенести на інший магазин без ручного повторення.

Основні налаштування модуля Укрпошта API в адмінці OpenCart
Вкладка «Основні»: ключі API, логотип, тайм-аути і меню збереження.
  1. Меню збереження. Зберегти та вийти, завантажити базові налаштування, імпорт і експорт налаштувань.
  2. Вкладки модуля. Тарифи, база даних, відправник, отримувач, відправлення, оплата, ТТН, завдання Cron і підтримка.
  3. Налагоджувальний режим. Вмикайте, коли треба розібратися, що саме відповідає API.
  4. Ключі Укрпошти. eCom Bearer, StatusTracking Bearer і User token, усі три обов'язкові.
  5. Логотип і місце виведення. Картинка перевізника та де вона показується серед способів доставки.
  6. cURL тайм-аути. Окремо на підключення і на виконання запиту до API.

Способи доставки: Експрес і Стандарт

Модуль дає чотири способи доставки: Експрес у відділення, Експрес кур'єром, Стандарт у відділення і Стандарт кур'єром. Кожен налаштовується окремо: назва кількома мовами, геозона, податковий клас, мінімальна й максимальна сума замовлення, поріг безкоштовної доставки з власним текстом. Вартість можна рахувати через API Укрпошти або за власними тарифами з вкладки «Тарифи», окремо вмикається показ терміну доставки. Для доставки у відділення ще обирається, які типи відділень показувати покупцю.

Налаштування способу доставки Укрпошта Експрес у відділення
Налаштування способу «Експрес у відділення», решта способів мають такий самий набір полів.
  1. Перемикач способів. Загальні налаштування і чотири способи доставки, кожен зі своїми параметрами.
  2. Геозона і податковий клас. Обмеження способу за регіонами та податки на доставку.
  3. Безкоштовна доставка. Сума, від якої доставка безкоштовна, і текст, який побачить покупець.
  4. Розрахунок вартості. Показ вартості, розрахунок через API або за тарифами.
  5. Типи відділень. Які відділення показувати: міські, сільські, пересувні.

База даних: області, населені пункти, відділення

Довідники, області, населені пункти і відділення модуль тримає у своїй базі, тому покупець на оформленні не чекає відповіді API на кожен символ. На вкладці видно, коли база оновлювалась востаннє і скільки записів додалось. Оновити можна вручну кнопкою або поставити на Cron, про це нижче.

Вкладка База даних модуля Укрпошта API з кількістю відділень і населених пунктів
Локальна база Укрпошти: дата оновлення і кількість записів по кожному довіднику.
  1. Довідники та області. Службова інформація Укрпошти і список областей, оновлення не зачіпає стандартні області OpenCart.
  2. Населені пункти і відділення. Основні дані для вибору адреси на оформленні, з лічильником нових записів.
  3. Ручне оновлення. Кнопка запускає оновлення конкретного довідника одразу.

Оплата і накладений платіж

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

Налаштування оплати і накладеного платежу в модулі Укрпошта API
Параметри оплати, які автоматично підставляються в нову накладну.
  1. Платник доставки. Відправник або одержувач.
  2. Метод оплати накладним платежем. Способи оплати магазину, для яких у накладну додається післяплата.
  3. Врахування накладного платежу. Вимкнено, увімкнено або для всіх способів оплати.
  4. Комісія за оголошену вартість. Чи додавати її до розрахунку.
  5. Платник зворотної доставки. Хто оплачує переказ коштів.
  6. Спосіб отримання переказу. У відділенні або на розрахунковий рахунок.

Завдання Cron: оновлення бази і відстеження відправлень

Тут модуль сам генерує команди для планувальника на хостингу. Розробник радить частоту: населені пункти й відділення раз на добу, області й довідники раз на місяць, відстеження відправлень за потребою. Відстеження змінює статус замовлення відповідно до статусу посилки і може надсилати e-mail чи SMS адміністратору й покупцю за шаблонами з макросами. Статуси Укрпошти, які треба відстежувати, обираються в списку, а відповідність статусів магазину, затримка і тексти повідомлень налаштовуються нижче на цій же вкладці.

Завдання Cron у модулі Укрпошта API для оновлення бази і відстеження відправлень
Команди Cron для оновлення бази і відстеження. Ключ і команди з ним розмиті.
  1. Рекомендована частота. Підказка, як часто запускати кожне завдання.
  2. Cron ключ. Захищає адреси завдань від сторонніх запусків, генерується кнопкою праворуч.
  3. Оновлення бази даних. Окремі команди для довідників, областей, населених пунктів і відділень.
  4. Відстеження відправлень. Команда, яка перевіряє статуси посилок і змінює статуси замовлень.
  5. Статуси і макроси. Які статуси Укрпошти відстежувати та макроси для шаблонів повідомлень.

Створення накладної із замовлення

Найбільше часу модуль економить саме тут. Якщо покупець обрав сумісний спосіб доставки, у замовленні з'являється кнопка роботи з накладною. Форма заповнюється автоматично: відправник береться з налаштувань, одержувач і адреса з замовлення, вага, габарити, оголошена вартість і опис рахуються за правилами з вкладки «Відправлення». Перед відправкою в API поля перевіряються, а клієнт і адреса в базі Укрпошти шукаються або створюються автоматично. Будь-яке значення можна виправити вручну перед збереженням.

Форма створення накладної Укрпошти в адмінці OpenCart
Форма нової накладної, заповнена з замовлення. Дані одержувача й адреса відправника розмиті.
  1. Зберегти накладну. Створює відправлення в Укрпошті і прив'язує його до замовлення.
  2. Відправник. Дані з налаштувань, тип клієнта, ІПН, IBAN, адреса.
  3. Одержувач. Дані з замовлення з вибором області, населеного пункту і відділення.
  4. Пошук за телефоном. Підтягує дані одержувача за номером.
  5. Оплата. Платник доставки, сума і платник зворотної доставки, спосіб отримання переказу.
  6. Вага і габарити. Розраховуються автоматично, можна додати кілька місць.
  7. Оголошена вартість і опис. Опис формується з товарів замовлення.
  8. Додаткові послуги. Повідомлення про вручення, SMS, огляд при врученні і дія у разі невручення.

Список накладних і друк

Усі створені накладні зібрані в окремому списку з фільтром за номером накладної і замовлення. Звідси накладну можна редагувати, видалити, додати в групу відправлень або завантажити в PDF разом із супровідними документами. Формат друку налаштовується окремо.

Список накладних Укрпошти в модулі для OpenCart
Список накладних. Ім'я, телефон і адреса одержувача розмиті.
  1. Дії зі списком. Друк, створення і видалення накладних.
  2. Фільтр. Пошук за номером накладної або номером замовлення.
  3. Меню накладної. Додати в групу, редагувати, налаштування друку, видалити.

Як це бачить покупець

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

Вибір доставки Укрпоштою і відділення на оформленні замовлення OpenCart
Оформлення замовлення на стандартному checkout.
  1. Способи доставки. Експрес і Стандарт, у відділення чи кур'єром, з ціною і терміном.
  2. Населений пункт. Вибір зі списку з пошуком за назвою.
  3. Відділення. Список відділень з індексами для обраного міста.

Що врахувати перед покупкою

  • Потрібен договір з Укрпоштою і три ключі API: eCom Bearer, StatusTracking Bearer та User token. За словами розробника, клієнти API Укрпошти отримують 5% знижки на відправлення.
  • Модуль закодований, на сервері має бути ionCube Loader 5.0 або новіший, а також PHP з cURL. Підтримуються PHP від 5.6 до 8.3.
  • Працює на OpenCart від 2.0.3 до 3.0.5 і збірках на їх основі, на скрінах ocStore 3.0.4.1.
  • Модуль звертається до сервера розробника, але якщо той недоступний, доповнення продовжує працювати. Ліцензія на один домен з піддоменами, включно з тестовими.
  • Для автоматичного оновлення бази і відстеження посилок треба налаштувати завдання Cron на хостингу.
  • Повний функціонал на оформленні є з One Page Checkout, Smart Checkout шаблонів OCTemplates і Simple. Зі стандартним оформленням і Ajax Quick Checkout працює тільки вибір міста й відділення. Для інших модулів і шаблонів розробник робить адаптацію за окрему плату.
  • SMS-сповіщення підтримуються через SmsFly, з редакторів замовлень сумісний «Менеджер Замовлень».

Кому підійде

Магазинам, які регулярно відправляють Укрпоштою, особливо в невеликі населені пункти, і хочуть створювати накладні з адмінки та автоматично міняти статуси замовлень. Якщо відправок кілька на місяць, вигода менш очевидна: доведеться отримати ключі API і налаштувати Cron. Якщо у вас нестандартне оформлення замовлення, спершу уточніть у розробника сумісність.

«Укрпошта API» від Prorab337 на маркетплейсі OpenCart Code. Питання щодо налаштування можна поставити розробнику прямо на сторінці модуля.

Перейти до модуля

Рекомендовані товари
P Prorab337 Доставка

«Укрпошта API» - модуль доставки для OpenCart

«Укрпошта API» для OpenCart - сучасний модуль доставки з повною інтеграцією API E-COMMERCE. Автоматизує оформлення накладних, розрахунок вартості й термінів доставки, сповіщення клієнтів та зміну статусів замовлень. Економить час, знижує витрати та спрощує обробку замовлень.

7
продажів
1 797 ₴ -28%
1 300 ₴
OCTemplates

OCTemplates

OCTemplates — команда розробників та дизайнерів з України з досвідом у веброзробці з 2002 року. З 2015 року спеціалізуються на шаблонах та модулях для OpenCart: швидких, SEO-оптимізованих і готових до роботи в реальних умовах e-commerce. Продукти OCTemplates використовують тисячі інтернет-магазинів у Європі, Азії, Північній Америці та Австралії. Кожен покупець отримує не лише готове рішення, а й технічну підтримку та консультації з налаштування магазину.

статей
28
переглядів
27,724
вподобань
22
підписників
0
Схожі статті
Порівняння модулів доставки для OpenCart: Нова пошта, Укрпошта, Rozetka Огляди

Порівняння модулів доставки для OpenCart: Нова пошта, Укрпошта, Rozetka

Порівнюємо три модулі доставки з маркетплейсу OpenCart Code: Нова пошта API, Укрпошта API та ROZETKA Delivery. Розрахунок вартості через API, ТТН з адмінки, автотрекінг, обмеження кожного модуля й чек-лист запуску.

Доставка Модулі Огляди
829 4 8 хв
20 лип 2026
Обробка, відправлення та доставка: три різні строки, які часто плутають Продуктивність

Обробка, відправлення та доставка: три різні строки, які часто плутають

Дізнайтеся різницю між обробкою, відправленням та доставкою замовлення. Пояснення клієнтам реальні строки та правильно розраховані терміни. Читайте статтю!

Продуктивність Доставка
197 3 4 хв
05 лис 2026
Коментарі (0)
Відповідь для

Увійдіть, щоб залишити коментар

Увійти

Коментарів поки немає

Будьте першим, хто залишить коментар до цієї статті!

Ми використовуємо cookies

Ми використовуємо cookies та схожі технології для покращення вашого досвіду, аналізу трафіку та показу персоналізованої реклами. Детальніше — у нашій Політиці cookies.