=== 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.1.1
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: окремий екран з ендпоінтами, секретами і журналом доставок.

Преміум можна **спробувати 7 днів безкоштовно**: WooCommerce → Налаштування → Доставка → Нова Пошта → «Спробувати Преміум 7 днів безкоштовно». Картка не потрібна; коли пробний період завершиться, вимкнуться лише Преміум-можливості, решта модуля працює далі.

== Installation ==

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

== Frequently Asked Questions ==

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

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

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

== Changelog ==

= 1.1.1 =
* Дві ТТН на одне замовлення: автостворення за статусом і кнопка в адмінці (або два кліки поспіль) могли одночасно оформити два реальні відправлення в Новій Пошті. Тепер створення ТТН серіалізується, і другий виклик бачить уже створену накладну.
* Час останньої перевірки ліцензії пишеться в UTC — на київському часі статус показував «перевірена -1 дн. тому», а пільговий період розтягувався на зайві години.

= 1.1.0 =
* Пробний період Преміум на 7 днів — за кліком, з видачею справжнього ключа на e-mail. Сам собою не вмикається: свіжий інстал працює як безкоштовний.
* Преміум-можливості тепер видно на своїх місцях — неактивні, з позначкою Pro і поясненням, що вони дають, замість того щоб бути прихованими.
* Новий екран «Вебхуки» (WooCommerce → Нова Пошта → Вебхуки): додавання ендпоінтів, секрет для підпису, вибір подій і журнал доставок. Раніше вебхуки працювали лише через прямий запис у базу.
* Ключ ліцензії більше не затирається при звичайному «Зберегти зміни», а вставлений у поле ключ активується без окремого кліку.
* Одне ненав'язливе повідомлення після першої успішної дії (а не після активації), яке закривається назавжди.

= 1.0.1 =
* Розрахунок тарифу через API став опцією і за замовчуванням вимкнений. Раніше «Запасна вартість» була лише фолбеком: щойно налаштовані ключ і місто відправника, вартість завжди перебивалася тарифом Нової Пошти, і магазини, де доставку оплачує отримувач, не мали як це вимкнути.
* Нульова вартість більше не показується як «Безкоштовно!» — метод підписується «(оплата при отриманні)», а ціна замінюється на «за тарифами перевізника». Безкоштовна доставка від суми (`Безкоштовно від суми`) працює як раніше.

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