=== Nova Poshta Premium for WooCommerce ===
Contributors: catcode
Tags: woocommerce, shipping, nova poshta, delivery, ukraine
Requires at least: 6.2
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Доставка Новою Поштою для WooCommerce: вибір міста і відділення в чекауті, живий тариф, створення ТТН і трекінг статусів.

== Description ==

Плагін додає метод доставки «Нова Пошта» у WooCommerce і повноцінний віджет вибору відділення просто в чекауті — без переходів і зайвих полів.

**Можливості (безкоштовно):**

* Пошук міста з підказками + список популярних міст в один клік.
* Вибір відділення або поштомата з живого довідника Нової Пошти.
* Розрахунок вартості доставки через API (`InternetDocument.getDocumentPrice`) з націнкою і безкоштовною доставкою від суми.
* Створення ТТН з картки замовлення або автоматично при переході замовлення у вибраний статус.
* Журнал відправлень в адмінці з посиланнями на трекінг.
* Кешування довідників міст і відділень у власних таблицях — чекаут не чекає на API.
* API-ключ зберігається зашифрованим.
* Працює і на класичному чекауті, і на чекауті-блоках (Blocks).

**Можливості Преміум (ліцензія):**

* Післяплата (грошовий переказ) у ТТН.
* Автоматичне оновлення статусів відправлень щогодини.
* Зворотні ТТН в один клік.
* Звірка післяплат — суми переказів і номери грошових переказів.
* Вихідні вебхуки на зміну статусу з підписом HMAC-SHA256.

== Installation ==

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

== Frequently Asked Questions ==

= Чи потрібен договір з Новою Поштою? =
Для розрахунку тарифу і вибору відділення достатньо API-ключа з особистого кабінету. Для створення ТТН потрібен налаштований профіль відправника в кабінеті НП.

= Чи працює з чекаутом-блоками? =
Так. Вибір зберігається через сесію WooCommerce, тому обидва типи чекауту працюють однаково.

= Де подивитись створені ТТН? =
WooCommerce → Нова Пошта. Також ТТН показується в картці замовлення.

== Changelog ==

= 1.0.0 =
* Перший реліз: віджет вибору відділення, тариф, ТТН, журнал відправлень, ліцензія Преміум.
