Nova Poshta Premium — Нова Пошта для WooCommerce

Nova Poshta Premium для WooCommerce — модуль, який під’єднує ваш магазин до Нової Пошти за 10 хвилин. Покупець обирає місто і відділення прямо в чекауті, вартість доставки рахується за живим тарифом НП, а ТТН створюється з картки замовлення або автоматично — коли замовлення переходить у потрібний статус.

Віджет не просто додається збоку: він замінює поля адреси. Вулиця, місто, область та індекс заповнюються з обраного відділення, тож покупцю нема чого вводити вручну, а у вас у замовленні лишається коректна адреса доставки.

Як це виглядає для покупця

У чекауті замість звичного набору полів адреси покупець бачить один блок: місто з підказками (або список популярних міст в один клік) і список відділень та поштоматів цього міста. Після вибору вартість доставки в підсумку одразу перераховується за тарифом Нової Пошти.

Блок працює і на класичному чекауті, і на чекауті-блоках (Checkout Blocks): вибір зберігається через сесію WooCommerce, тому обидва варіанти поводяться однаково. Якщо покупець обрав Нову Пошту, але не вибрав відділення — замовлення не оформиться, поки вибір не зроблено.

Що отримує адмін

Усі відправлення — в одному журналі: номер ТТН із посиланням на трекінг, отримувач, поточний статус, суми післяплати й номери грошових переказів.

У картці замовлення видно, яке саме відділення обрав покупець, і є кнопка створення ТТН — без переходів у кабінет НП.

Налаштування — одна сторінка

Модуль додається як звичайний метод доставки WooCommerce. Усі налаштування — на одній сторінці: ключ API, профіль відправника, правила ціни, вигляд віджета й автоматизація ТТН. Кнопки «Перевірити підключення» і «Тестова перевірка тарифу» одразу показують, чи все налаштовано правильно.

Як це працює — крок за кроком

1. Вставляєте API-ключ із кабінету Нової Пошти й натискаєте «Перевірити підключення».
2. Обираєте своє місто, відділення та профіль відправника — з них створюватимуться ТТН.
3. Покупець у чекауті обирає місто й відділення, бачить вартість доставки за тарифом НП.
4. Замовлення зберігає місто, відділення й адресу доставки, а в журналі з’являється чернетка відправлення.
5. ТТН створюється кнопкою в замовленні або автоматично — при переході в обраний вами статус.
6. Статуси доставки оновлюються з API НП (автоматично — на Преміум, вручну кнопкою — на безкоштовній версії).

Що під капотом

Модуль працює через офіційний API Нової Пошти (api.novaposhta.ua/v2.0). Довідники міст і відділень зберігаються у власних таблицях: міста повністю оновлюються раз на добу, відділення підтягуються по місту при першому запиті й кешуються на 7 днів, тому чекаут здебільшого не чекає на зовнішній запит. API-ключ зберігається в базі в зашифрованому вигляді й ніколи не показується назад у формі. Жодних чужих iframe і підміни шаблонів чекауту — тільки штатні хуки WooCommerce.

Коли API Нової Пошти не відповідає, ваш чекаут працює далі: міста й відділення — з кешу модуля, вартість — останній відомий тариф, а ТТН стають у чергу й створюються самі, щойно Нова Пошта оживе. На тестовому стенді з «завислим» API оформлення замовлення займало 0,2 секунди замість 30.

Як встановити

1. Завантажте архів і встановіть його через «Плагіни → Додати новий → Завантажити плагін».
2. Активуйте плагін.
3. WooCommerce → Налаштування → Доставка → додайте метод «Нова Пошта» у потрібну зону.
4. Вставте API-ключ, збережіть і заповніть блок «Звідки відправляєте».