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

Nova Post Global для WooCommerce — международная доставка Новой Почты прямо в корзине магазина. Покупатель из Германии, Польши или США вводит адрес и сразу видит цену доставки за границу, а не пишет в мессенджер «сколько будет до Берлина?». Тариф считается через официальный API Nova Post Global по весу и габаритам именно этого заказа.

Живое демо

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

Как это выглядит для покупателя

На чекауте появляется способ доставки «Nova Post Global — доставка за границу» с ценой. Он показывается только для стран, которые покрывает тариф НПГ, и только для адресов за пределами Украины — украинцы видят привычную Новую Почту по Украине. Цена обновляется, как только покупатель меняет страну или корзину.

Если НПГ не возит в страну (код CALC004) или вес вне тарифа, способ просто не появляется — покупатель не увидит цену, которую потом придётся переписывать вручную.

Что получает админ

Отдельный экран WooCommerce → Nova Post Global: логин и пароль API, тестовое или рабочее окружение, код услуги (по умолчанию 28 — Global Delivery Econom), вес и габариты для товаров с пустыми полями, лимит одного места, курс для магазинов не в гривне, поведение при сбое API, кеш и журнал ошибок. Кнопка «Проверить подключение» считает тестовую посылку и человеческим языком объясняет, что не так: неверный пароль, закрытый порт 8243 или страна вне тарифа.

Как это работает — шаг за шагом

1. Покупатель кладёт товары в корзину и вводит адрес за границей.

2. Модуль складывает заказ в одну коробку: суммарный фактический вес, суммарный объём, самая длинная сторона равна самому длинному товару. Единицы магазина (г, фунты, дюймы) переводятся в килограммы и сантиметры автоматически.

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

Технические требования

WordPress 6.2+, WooCommerce 7.0+ (проверено на 10.7), PHP 7.4+. Совместим с HPOS, классическим и блочным чекаутом. Нужны логин и пароль API Nova Post Global, выданные на вашу компанию или ФЛП, — обычный API-ключ Новой Почты по Украине для международных тарифов не подходит. Хостинг должен разрешать исходящие соединения на порт 8243.

Что под капотом

Обычный метод доставки WooCommerce в зонах доставки, без переписанного чекаута. Запросы — через WordPress HTTP API с Basic-авторизацией, поэтому их видно в стандартных инструментах отладки. Ответ HTTP 424 с кодами CALC004/CALC005/CALC006 модуль считает ответом тарифа, а не сбоем, и кеширует; сетевые сбои и ошибки авторизации не кешируются, чтобы следующее обновление страницы попробовало снова.

Как установить

1. Загрузите архив в «Плагины → Добавить новый → Загрузить плагин» и активируйте.

2. WooCommerce → Nova Post Global: введите логин и пароль API, сохраните и нажмите «Проверить подключение».

3. WooCommerce → Настройки → Доставка: добавьте «Nova Post Global» в зоны со странами, куда отправляете.

4. Оформите тестовый заказ с адресом за границей и убедитесь, что цена появилась в чекауте.

История версий

1.0.0 — первый выпуск: тариф Nova Post Global в корзине через API, деление на места, наценка, бесплатная доставка от суммы и доставка в отделение за границей в Pro, проверка подключения с объяснением кодов НПГ.