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

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

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

У кроці доставки з’являється спосіб «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) — і показує в назві способу кількість місць.

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

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

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

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. Оформіть тестове замовлення з адресою за кордоном і переконайтеся, що ціна з’явилась у кроці доставки.