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

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

Виджет не просто добавляется сбоку: он заменяет поля адреса. Улица, город, область и индекс заполняются из выбранного отделения, поэтому покупателю нечего вводить вручную, а у вас в заказе остаётся корректный адрес доставки.

Базовая версия бесплатная — выбор отделения, тариф, создание ТТН и журнал отправлений. Лицензия Премиум добавляет наложенный платёж в ТТН, автоматическое обновление статусов, обратные накладные, сверку наложенных платежей и вебхуки.

Как это выглядит для покупателя

В чекауте вместо привычного набора полей адреса покупатель видит один блок: город с подсказками (или список популярных городов в один клик) и список отделений и почтоматов этого города. После выбора стоимость доставки в итоге сразу пересчитывается по тарифу Новой Почты.

Блок работает и на классическом чекауте, и на чекауте-блоках (Checkout Blocks): выбор сохраняется через сессию WooCommerce, поэтому оба варианта ведут себя одинаково. Если покупатель выбрал Новую Почту, но не выбрал отделение — заказ не оформится, пока выбор не сделан.

Что получает админ

Все отправления — в одном журнале: номер ТТН со ссылкой на трекинг, получатель, текущий статус, суммы наложенного платежа и номера денежных переводов.

В карточке заказа видно, какое именно отделение выбрал покупатель, и есть кнопка создания ТТН — без переходов в кабинет НП.

Настройки — одна страница

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

Как это работает — шаг за шагом

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

Что включено в лицензии

Бесплатно: выбор города и отделения в чекауте (классический и блочный), расчёт тарифа, замена и автозаполнение полей адреса, создание ТТН вручную и по статусу заказа, журнал отправлений, кеш справочников, шифрование ключа.

Премиум: наложенный платёж (денежный перевод) в ТТН, автоматическое обновление статусов ежечасно, обратные ТТН в один клик, сверка наложенных платежей с суммами и номерами переводов, исходящие вебхуки на события доставки с подписью HMAC-SHA256.

Технические требования

• WordPress 6.2 или новее
• WooCommerce 7.0 или новее (совместимость с HPOS)
• PHP 7.4 или новее
• API-ключ Новой Почты из личного кабинета

Что под капотом

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

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

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

История версий

1.1.2 — исправлено создание обратной ТТН: запрос к Новой Почте шёл без подтипа причины возврата, а отделение подставлялось в поле, которое ожидает адрес контрагента, — из-за этого кнопка падала с ошибкой. Теперь перед созданием модуль спрашивает у перевозчика, возможен ли возврат для этой накладной, и показывает именно его ответ (например, возврат недоступен, пока отправление ещё не передано в Новую Почту).

1.1.1 — один заказ больше не получает две ТТН: автосоздание накладной по статусу и кнопка в админке (или два клика подряд) могли сработать одновременно и оформить в Новой Почте два реальных отправления. Теперь создание ТТН сериализуется, и второй вызов видит уже созданную накладную. Время последней проверки лицензии пишется в UTC — статус больше не показывает «проверена -1 дн. назад».

1.1.0 — пробный период Премиум на 7 дней по клику: ключ приходит на e-mail, карта не нужна. Свежая установка больше ничего не включает сама — Премиум-возможности видно на своих местах, неактивными, с пометкой Pro и пояснением, что они дают. Появился отдельный экран «Вебхуки» (WooCommerce → Новая Почта → Вебхуки): эндпоинты, секрет для подписи HMAC-SHA256, выбор событий и журнал доставок с повторами — раньше вебхуки можно было завести только прямой записью в базу. Ключ лицензии больше не затирается обычным «Сохранить изменения». В журнале отправлений колонка «Получатель» показывает покупателя, а направление переехало в собственную колонку «Куда».

1.0.1 — расчёт тарифа через API стал опцией и по умолчанию выключен: раньше «Запасная стоимость» была лишь фолбеком и всегда перебивалась тарифом Новой Почты. Нулевая стоимость больше не показывается как «Бесплатно!» — метод подписывается «(оплата при получении)», а цена как «по тарифам перевозчика». Бесплатная доставка от суммы заказа работает как раньше.

1.0.0 — первый релиз: виджет выбора отделения для классического чекаута и Checkout Blocks, живой тариф, создание ТТН, журнал отправлений, трекинг статусов, лицензия Премиум.