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