Ukrposhta — доставка Укрпоштою для OpenCart 3.x & 4.x

Ukrposhta Shipping для OpenCart 4 — модуль доставки Укрпоштою: віджет вибору відділення (область → місто → відділення) у чекауті на базі офіційного Адресного класифікатора та живий розрахунок вартості доставки по Україні через eCom API. Обране покупцем відділення фіксується в замовленні, тож менеджеру не доводиться перепитувати адресу в месенджері.

Модуль безкоштовний. Встановлюється як стандартне розширення OpenCart (ocmod) і не потребує правок теми — віджет підключається через систему подій.

Як це працює — крок за кроком

1. Адмін встановлює розширення, натискає «Встановити» на сторінці налаштувань — модуль створює свої таблиці, події та cron-завдання, — і синхронізує області одним кліком.
2. Вводяться Bearer eCom та індекс відправника; кнопки «Перевірити з’єднання» і «Тестовий тариф» одразу показують, що ключ прийнято і API відповідає.
3. Покупець у чекауті обирає доставку Укрпоштою — подія footer/after підключає віджет, і він веде по ланцюжку область → місто → відділення.
4. Модуль запитує тариф у eCom API за індексами відправника й отримувача; якщо API недоступний — показується тариф за замовчуванням із налаштувань.
5. Після оформлення подія order.addOrder/after зберігає обране відділення (індекс, місто, назву) разом із замовленням.
6. Раз на тиждень cron OpenCart оновлює кеш класифікатора областей — довідник не застаріває.

Скільки коштує

Безкоштовно. Завантажуєте ukrposhta.ocmod.zip зі сторінки модуля і користуєтесь без підписок та платних версій.

Технічні вимоги

• OpenCart 4.0.2 – 4.1.x
• Договір eCom з Укрпоштою: Bearer-ключ видається в кабінеті eCom після підписання договору — він потрібен для класифікатора адрес і розрахунку тарифу
• Для розрахунку тарифу — поштовий індекс складу відправника

Що під капотом

• Bearer-ключ шифрується перед записом у базу; у формі налаштувань показується лише маска «збережено», без відкритого значення.
• Класифікатор кешується у власних таблицях (up_regions, up_cities, up_offices) — чекаут читає локальну базу, а не смикає API на кожен запит.
• Інтеграція через події OpenCart (footer inject, order added) — без OCMOD-патчів контролерів і правок шаблонів теми.
• Стандартні для методів доставки OpenCart налаштування: гео-зона, клас податку, порядок сортування.
• Вигляд віджета налаштовується: акцентний колір, радіус заокруглення, тема (авто/світла/темна).
• Є перемикач sandbox для роботи з тестовим середовищем Укрпошти.

Як встановити

1. Завантажте ukrposhta.ocmod.zip та встановіть через «Розширення → Встановлення розширень».
2. У «Розширення → Розширення → Доставка» знайдіть «Укрпошта — доставка» і натисніть Install.
3. Відкрийте налаштування, натисніть «Встановити» — створяться таблиці, події та cron-завдання.
4. Введіть Bearer eCom та індекс відправника, натисніть «Перевірити з’єднання», потім «Синхронізувати області».
5. Увімкніть метод доставки та збережіть — віджет вибору відділення з’явиться в чекауті.

Історія версій

1.0.4 — 23 липня 2026

Виправлено фатальну помилку у розрахунку способів доставки: getQuote() завантажував неіснуючу в OpenCart 4.x catalog-модель localisation/geo_zone, через що увесь список способів доставки не з’являвся («Потрібна адреса доставки»). Гео-зона тепер перевіряється прямим запитом до zone_to_geo_zone. Плюс: блок область → місто → відділення з’являється лише після вибору методу «Укрпошта» (спочатку метод — потім поля), і має демо-набір областей/міст/відділень для клікабельного тесту без Bearer-ключа eCom.

1.0.0 — липень 2026

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