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. Оформите тестовый заказ с адресом за границей и убедитесь, что цена появилась в шаге доставки.