Nova Post Global для OpenCart — міжнародна доставка з тарифом у чекауті

Nova Post Global для OpenCart — міжнародна доставка Нової Пошти з ціною прямо в чекауті. Покупець із Німеччини, Польщі чи США вводить адресу й одразу бачить вартість доставки за кордон, а не пише менеджеру «скільки буде до Берліна?». Тариф рахується через офіційний API Nova Post Global за вагою й габаритами саме цього кошика. Три збірки: OpenCart 4.x, 3.x і 2.3.

Живе демо

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

Як це виглядає для покупця

У кроці доставки з’являється спосіб «Nova Post Global — доставка за кордон» із ціною у валюті магазину. Він показується лише для країн, які покриває тариф НПГ, і лише для адрес за межами України — українці бачать звичну Нову Пошту. Якщо НПГ не возить у країну (CALC004) або вага поза тарифом, спосіб просто не з’являється.

Що отримує адмін

Одна сторінка налаштувань: логін і пароль API (пароль зберігається зашифрованим), робоче чи тестове середовище, код послуги, вага й габарити для товарів із порожніми полями, ліміт одного місця, поведінка на випадок збою API, кеш і журнал помилок, гео-зона, клас податку й порядок сортування. Кнопка «Перевірити підключення» людською мовою пояснює, що не так: неправильний пароль, закритий порт 8243 чи країна поза тарифом.

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

1. Покупець кладе товари в кошик і вводить адресу за кордоном.
2. Модуль складає кошик в одну коробку: сумарна фактична вага, сумарний об’єм, найдовший бік — найдовший товар. Одиниці ваги й довжини магазину переводяться в кілограми й сантиметри через ядро OpenCart.
3. Запит іде в API Nova Post Global (IEW/publicCalculateCost) — продукт Global Delivery Econom, той самий, що в публічному калькуляторі НПГ.
4. НПГ повертає ціну в гривнях; модуль переводить її у валюту магазину за курсом із «Локалізація → Валюти», у Pro додає націнку або обнуляє доставку від суми.
5. Ціна кешується: однаковий кошик у ту саму країну не смикає API на кожному оновленні чекауту.

Важкі замовлення (Pro). Econom везе одне місце до 68 кг, а в більшість країн рахує лише до ~30 кг платної ваги. Без Pro таке замовлення не отримає тарифу. Pro ділить його на кілька однакових місць — за фактичною, а на відповідь CALC005 за платною вагою (фактична або об’ємна Д×Ш×В/5000) — і показує в назві способу кількість місць.

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

Безкоштовна версія рахує тариф одним місцем кур’єром до дверей без обмежень у часі. Pro — 990 грн на домен: доставка у відділення Nova Post за кордоном, націнка, безкоштовна доставка від суми й поділ важких замовлень на місця. Ліцензія назавжди: оплачуєте один раз, без щорічних платежів. Pro можна спробувати 7 днів безкоштовно прямо з налаштувань.

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

• OpenCart 4.0.2 – 4.1.x, 3.0.2 – 3.0.5.0 або 2.3.0.x — окрема збірка під кожну лінійку.
• PHP 8.1+ для OpenCart 4, 7.0+ для 3.x і 2.3; розширення cURL.
• Логін і пароль API Nova Post Global, видані на вашу компанію чи ФОП. Звичайний API-ключ Нової Пошти по Україні для міжнародних тарифів не підходить.
• Хостинг має випускати вихідні з’єднання на порт 8243.

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

• Звичайне розширення доставки OpenCart, без ocmod-патчів і змін у файлах ядра.
• Відповідь HTTP 424 з кодами CALC004/CALC005/CALC006 вважається відповіддю тарифу й кешується; мережеві збої й помилки авторизації не кешуються, щоб наступний запит спробував знову.
• Пароль API в базі зашифрований: дамп БД не віддасть його відкритим текстом.
• Той самий ліцензійний клієнт, що в інших модулях CatCode: 7-денний тріал, 14-денний офлайн-запас.

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

1. Завантажте збірку під свою версію через «Розширення → Встановлення розширень»: cc_npglobal.ocmod.zip для OpenCart 4.x, cc_npglobal-oc3-1.0.0.ocmod.zip для 3.x, cc_npglobal-oc2-1.0.0.ocmod.zip для 2.3.
2. «Розширення → Розширення → Доставка»: встановіть «Nova Post Global» і відкрийте налаштування.
3. Введіть логін і пароль API, увімкніть модуль, збережіть і натисніть «Перевірити підключення».
4. Оформіть тестове замовлення з адресою за кордоном і переконайтеся, що ціна з’явилась у кроці доставки.

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

1.0.0 — перший випуск для OpenCart 4.x, 3.x і 2.3: тариф Nova Post Global у чекауті через API, перевірка підключення з поясненням кодів НПГ; у Pro — відділення за кордоном, націнка, безкоштовна доставка від суми й поділ на місця.