Навіщо інтегрувати Nova Poshta API в OpenCart
Інтернет-магазини, які змушують покупця вручну вводити відділення Нової Пошти, втрачають замовлення на етапі оформлення. Автоматична інтеграція через Nova Poshta API розраховує вартість доставки у реальному часі, підставляє відділення за введеним містом та формує декларацію без участі менеджера.
Що дає інтеграція Nova Poshta з OpenCart
- Автоматичний розрахунок вартості доставки за вагою та адресою отримувача
- Динамічний вибір відділення або адресна доставка Кур'єром
- Автоматичне формування ТТН після підтвердження оплати
- Синхронізація статусу відправлення з карткою замовлення в адмінпанелі
Як ми будуємо інтеграцію в MaxiMoruM
Nova Poshta надає REST API з JSON-відповідями. Ми підключаємо його до OpenCart через кастомний PHP shipping-модуль — без сторонніх плагінів, що дає повний контроль над логікою і оновленнями.
1. API-ключ і базові налаштування
Отримайте API-ключ у особистому кабінеті Nova Poshta (розділ Налаштування → Безпека). Збережіть його в конфігурації модуля через адмінпанель OpenCart — ніколи у публічному репозиторії.
2. Shipping-модуль OpenCart
Створюємо PHP-клас, що відповідає архітектурі розширень OpenCart. Метод getQuote() викликає Nova Poshta API endpoint getDocumentPrice з параметрами CitySender, CityRecipient, вагою і габаритами посилки. Відповідь парсимо і повертаємо масив тарифів у стандартному форматі OpenCart — жодних змін у ядрі системи.
3. Динамічний вибір відділень
На сторінці чекауту підключаємо AJAX-запит до API endpoint getWarehouses. Покупець вводить місто — список відділень підвантажується без перезавантаження сторінки. Реалізуємо debounce на 300 мс, щоб не перевантажувати API при швидкому введенні.
4. Автоматичне формування ТТН
Після підтвердження замовлення або оплати — залежно від бізнес-логіки клієнта — тригеримо API endpoint save моделі InternetDocument. Номер ТТН зберігається в order_history OpenCart і одразу надсилається покупцю на email.
5. Відстеження статусів
Налаштовуємо cron-задачу, що раз на годину запитує getStatusDocuments для активних відправлень і оновлює статус замовлення в OpenCart — від "Відправлено" до "Отримано".
Результати для бізнесу
Магазини з автоматичним розрахунком доставки фіксують зниження відмов на чекауті на 10–20%. Менеджери перестають вручну виписувати накладні — це економить 1–2 години на день при обсязі від 20 замовлень на добу. При масштабуванні до 100+ замовлень економія стає суттєвою статтею операційних витрат.
Строки та обсяг робіт
Базова інтеграція Nova Poshta для OpenCart займає 3–4 робочі дні: розробка модуля, тестування у sandbox-режимі Nova Poshta та деплой на production. Для WordPress / WooCommerce — аналогічний строк. Модуль не змінює ядро OpenCart і сумісний з майбутніми оновленнями платформи.
MaxiMoruM будує доставкові інтеграції для українських інтернет-магазинів понад 20 років. Розкажіть про ваш проєкт — maximorum.com.
]]>