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.

Как установить

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