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, перевірка підключення з поясненням кодів НПГ.