Description
Nova Poshta shipping for WooCommerce stores in Ukraine. The customer picks a city and a Nova Poshta branch or parcel locker right in the checkout, without leaving the page or typing an address. You create the TTN (express waybill) from the order screen and follow it in the shipment log.
Nova Poshta (Nova Post outside Ukraine) is the largest parcel carrier in Ukraine. Most Ukrainian online orders are delivered to its branches and parcel lockers, and the carrier expects a branch reference rather than a street address, which is why a plain address field does not work for these shops.
What it does
- City search with suggestions, plus a one-click list of the largest cities.
- Branch or parcel locker selection from the carrier’s live directory. A click on the field lists every branch of the city; typing narrows the list.
- Delivery cost: a fixed price, free shipping above an order total, or the carrier tariff through the API with an optional surcharge.
- TTN waybill created from the order screen, or automatically when the order reaches a status you choose.
- Shipment log in the admin area: search by order, TTN, name or phone, status filter, tracking links, manual status refresh.
- City and branch directories are cached in the plugin’s own tables, so the checkout never waits for the API.
- The API key is stored encrypted.
- Works with the classic checkout and the block checkout.
Need cash on delivery?
Nova Poshta Premium for WooCommerce on catcode.com.ua adds cash on delivery (COD) waybills, automatic status updates, return waybills, COD reconciliation and webhooks. This free plugin works on its own and has no time limit.
Nova Poshta is a third-party service. This plugin is an independent integration built on the carrier’s public API and is not affiliated with, endorsed by, or sponsored by Nova Poshta.
External services
This plugin connects to the Nova Poshta carrier API to look up cities and branches, calculate delivery cost and create waybills. Nothing is sent until you enter your own API key in the shipping method settings.
Nova Poshta API — https://api.novaposhta.ua
- When the checkout is displayed: the city and branch search terms typed by the customer, so the matching directory entries can be returned.
- When a delivery cost is calculated: the sender and recipient city references, cart weight and declared value.
- When a waybill is created: the recipient name, phone number, chosen branch, order total, weight and declared value, together with your sender profile.
- When a shipment status is refreshed: the waybill number.
The city and branch directories are also downloaded in bulk and cached locally so the checkout does not query the carrier on every page load.
Terms of service: https://novaposhta.ua/more/public-agreement-for-cbs
Privacy policy: https://novaposhta.ua/more/privacy-policy
Нова Пошта для WooCommerce — опис українською
Доставка Новою Поштою для інтернет-магазину на WooCommerce. Покупець обирає місто і відділення або поштомат Нової Пошти прямо на сторінці оформлення замовлення, без ручного введення адреси. ТТН (експрес-накладну) ви створюєте з картки замовлення.
- Пошук міста з підказками і список найбільших міст в один клік.
- Вибір відділення або поштомата з живого довідника Нової Пошти.
- Вартість доставки: фіксована ціна, безкоштовна доставка від суми замовлення або тариф Нової Пошти через API з націнкою.
- Створення ТТН з картки замовлення або автоматично при переході замовлення в обраний статус.
- Журнал відправлень з пошуком за номером замовлення, ТТН, ПІБ або телефоном, фільтром статусів і посиланнями на трекінг.
- Довідники міст і відділень зберігаються в базі сайту, тож оформлення замовлення не чекає на API.
- Працює з класичним і блоковим оформленням замовлення.
- API-ключ зберігається зашифрованим.
Післяплата, автоматичне оновлення статусів, зворотні ТТН і звірка післяплат є в повній версії Nova Poshta Premium на catcode.com.ua.
Нова Пошта — сторонній сервіс. Цей плагін є незалежною інтеграцією на публічному API перевізника і не афілійований з Новою Поштою.
Installation
- Install and activate the plugin.
- Go to WooCommerce → Settings → Shipping and add the “Nova Poshta” method to the zone you need.
- Paste your API key (Nova Poshta business account: Settings → Security → API keys) and save.
- Press “Test connection”, then fill in the sender profile.
- Optionally choose the order status that triggers automatic waybill creation.
FAQ
Where do I get a Nova Poshta API key?
In your Nova Poshta business account: Settings → Security → API keys. The key is enough to show cities and branches and to calculate rates.
Do I need a contract with Nova Poshta?
Showing branches and rates needs only the API key. Creating TTN waybills additionally requires a sender profile in that account.
How do I create a TTN for an order?
Open the order and press “Create waybill”, or choose an order status in the settings and the TTN is created when the order reaches it. The TTN number appears on the order screen and under WooCommerce → Nova Poshta.
Does it show parcel lockers (поштомати)?
Yes. Branches and parcel lockers come from the same Nova Poshta directory and are listed together in the branch field.
Does it work with the block checkout?
Yes. The selection is kept in the WooCommerce session, so the classic checkout and the block checkout behave the same way.
Is cash on delivery supported?
Not in this free plugin. Cash on delivery waybills and COD reconciliation are part of Nova Poshta Premium on catcode.com.ua.
In which language is the interface?
The source strings are English. Ukrainian and other locales come from translate.wordpress.org and are installed by WordPress automatically.
Screenshots





Changelog
1.0.15
- Fixed: on themes that set their own padding for text fields (for example Storefront), a long branch name no longer runs under the icon in the city and branch fields.
1.0.14
- Fixed: on the block checkout the branch field stays under the list of delivery methods after the city is changed, instead of dropping below the whole delivery step.
1.0.13
- Fixed: on the classic checkout a branch picked just before “Place order” could be lost.
- Fixed: when an order stops on a missing delivery choice, the city or branch field is highlighted with the reason under it.
- Fixed: the block checkout no longer accepts a Nova Poshta order without a chosen branch.
- City and branch fields use a 16 px font on phones, so an iPhone does not zoom the page while typing.
1.0.12
- Fixed: a city missing from the local directory is fetched from Nova Poshta, so Kyiv, Lviv or Ternopil can always be picked.
- Added: the city directory loads by itself in the background.
1.0.11
- Changed: the branch field lists every branch of the city with the chosen one highlighted; big cities load in pages of 100 as you scroll.
- Changed: the shipment log has pages of 25, search, a status filter and separate city and branch columns.
1.0.10
- Fixed: with the full version installed, deleting this copy keeps the shared settings and tables; this copy switches itself off while the full version is active.
1.0.9
- Fixed: an order shipped to a branch no longer carries the second address line from the shopper’s account.
1.0.8
- Fixed: the block checkout on non-Ukrainian stores could refuse a Nova Poshta order because of an empty hidden region field.
- Fixed: the branch list no longer stays on “Loading branches…” after picking a city.
1.0.7
- Fixed: the branch is no longer saved as the logged-in shopper’s own billing and shipping address.
1.0.6
- Fixed: the branch picker no longer opens for other carriers whose name contains “пошт”; a branch picked earlier no longer leaks into orders shipped by another method.
1.0.5
- The chosen city and branch are written into the order’s shipping address.
- Security: stored API keys are encrypted with AES-256 (OpenSSL).
1.0.4
- Fixed: branches no longer go missing in large cities (the API returns at most 500 rows per call; the list is fetched page by page now).
1.0.3
- Fixed: two waybills could be created for one order.
1.0.2
- Ukrainian translation bundled again.
1.0.1
- Rate calculation through the API is opt-in; a zero cost is labelled “(paid on pickup)”.
- Translations are handled through translate.wordpress.org.
1.0.0
- First release: checkout branch picker, live rates, waybill creation, shipment log.
