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

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

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

На чекауте появляется способ доставки «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) — считает одно место и умножает.

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

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

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

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

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

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

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