Nova Poshta Premium — Nova Poshta for WooCommerce

Nova Poshta Premium for WooCommerce is a module that connects your store to Nova Poshta in 10 minutes. The customer picks a city and a branch right at checkout, the shipping cost is calculated using Nova Poshta’s live rate, and the waybill is created from the order screen or automatically — once the order reaches the status you choose.

The widget doesn’t just get added alongside — it replaces the address fields. Street, city, region and postcode are filled in from the chosen branch, so the customer has nothing to type by hand, and you’re left with a correct shipping address on the order.

What the customer sees

At checkout, instead of the usual set of address fields, the customer sees a single block: a city field with suggestions (or a one-click list of popular cities) and a list of that city’s branches and parcel lockers. Once a branch is chosen, the shipping cost in the order summary is instantly recalculated using Nova Poshta’s rate.

The block works on both the classic checkout and Checkout Blocks: the choice is stored via the WooCommerce session, so both behave the same way. If the customer picks Nova Poshta but doesn’t select a branch, the order can’t be placed until they do.

What the admin gets

Every shipment sits in one log: waybill number with a tracking link, recipient, current status, cash-on-delivery amounts and money-transfer numbers.

The order screen shows exactly which branch the customer chose, plus a button to create the waybill — no need to go into your Nova Poshta account.

Settings — a single page

The module is added as a regular WooCommerce shipping method. All settings live on one page: API key, sender profile, pricing rules, widget appearance and waybill automation. The “Check connection” and “Test rate lookup” buttons show right away whether everything is set up correctly.

How it works, step by step

1. Paste in the API key from your Nova Poshta account and click “Check connection”.
2. Choose your city, branch and sender profile — waybills will be created from these.
3. At checkout, the customer picks a city and branch and sees the shipping cost at Nova Poshta’s rate.
4. The order stores the city, branch and delivery address, and a shipment draft appears in the log.
5. The waybill is created via a button on the order, or automatically once it reaches the status you chose.
6. Delivery statuses are updated from the Nova Poshta API (automatically on Premium, manually via a button on the free version).

Under the hood

The module works through the official Nova Poshta API (api.novaposhta.ua/v2.0). City and branch directories are stored in their own tables: cities are fully re-synced once a day, branches are fetched per city on first request and cached for 7 days, so checkout rarely waits on an external request. The API key is stored encrypted in the database and is never shown back in the form. No third-party iframes, no swapped-out checkout templates — only standard WooCommerce hooks.

When the Nova Poshta API is down, your checkout keeps working: cities and branches come from the module’s cache, shipping uses the last known rate, and waybills are queued and created automatically once Nova Poshta is back. On a test stand with a hung API, placing an order took 0.2 seconds instead of 30.

How to install

1. Download the archive and install it via “Plugins → Add New → Upload Plugin”.
2. Activate the plugin.
3. WooCommerce → Settings → Shipping → add the “Nova Poshta” method to the zone you need.
4. Paste in the API key, save, and fill in the “Ship from” block.