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