Укрпошта досі закриває те, що не завжди закривають інші перевізники: малі міста й села, 11000+ точок видачі, тарифи без об'ємної ваги. Але без інтеграції працювати з нею з магазину незручно: менеджер копіює дані замовлення в кабінет Укрпошти, вручну друкує накладну, потім так само вручну шукає статус і пише клієнту. Модуль «Укрпошта API» переносить цю роботу в адмінку OpenCart: покупець обирає відділення й бачить вартість та термін доставки на оформленні, а накладна створюється з картки замовлення з уже заповненою формою.
Модуль працює через API Укрпошти для e-commerce. Окрім способу доставки, у ньому є робота з накладними, калькулятори вартості й терміну доставки, автоматичне відстеження відправлень зі зміною статусів замовлення та сповіщеннями. Загальне порівняння модулів доставки для українських перевізників є в статті про модулі доставки для OpenCart: Нова пошта, Укрпошта, Rozetka, а тут розберемо саме цей модуль по екранах адмінки.
Основні налаштування і ключі API
Перша вкладка відповідає за підключення. Сюди вводяться три ключі від Укрпошти: eCom Bearer, StatusTracking Bearer і User token, без них модуль не працюватиме. Тут же вмикається режим налагодження, задається логотип перевізника і місце, де він виводиться на оформленні. Корисна дрібниця: під кнопкою збереження є завантаження базових налаштувань, а також експорт та імпорт, тож налаштований модуль можна перенести на інший магазин без ручного повторення.

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

- Перемикач способів. Загальні налаштування і чотири способи доставки, кожен зі своїми параметрами.
- Геозона і податковий клас. Обмеження способу за регіонами та податки на доставку.
- Безкоштовна доставка. Сума, від якої доставка безкоштовна, і текст, який побачить покупець.
- Розрахунок вартості. Показ вартості, розрахунок через API або за тарифами.
- Типи відділень. Які відділення показувати: міські, сільські, пересувні.
База даних: області, населені пункти, відділення
Довідники, області, населені пункти і відділення модуль тримає у своїй базі, тому покупець на оформленні не чекає відповіді API на кожен символ. На вкладці видно, коли база оновлювалась востаннє і скільки записів додалось. Оновити можна вручну кнопкою або поставити на Cron, про це нижче.

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

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

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

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

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

- Способи доставки. Експрес і Стандарт, у відділення чи кур'єром, з ціною і терміном.
- Населений пункт. Вибір зі списку з пошуком за назвою.
- Відділення. Список відділень з індексами для обраного міста.
Що врахувати перед покупкою
- Потрібен договір з Укрпоштою і три ключі 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. Питання щодо налаштування можна поставити розробнику прямо на сторінці модуля.