Every order placed on your store triggers a manual task: create a waybill, paste the tracking number, notify the customer. Nova Poshta's API removes that loop entirely.
Integrating the Nova Poshta API into a Laravel application takes two core steps: authenticate with your API key, then call the InternetDocument.save method to generate a waybill automatically at the moment an order is confirmed.
What this automates for your business
- Waybill creation fires on order status change — no staff intervention
- Tracking numbers write back to the order record in real time
- Customer notification emails dispatch with the tracking link included
- Failed deliveries trigger a webhook that flags the order for follow-up
How we build it in Laravel
We wrap all Nova Poshta calls in a dedicated NovaPoshtaService class, injected via Laravel's service container. This keeps shipping logic decoupled from order processing and straightforward to unit test in isolation.
The service handles three responsibilities: creating the waybill, polling the tracking status on a scheduled job, and broadcasting status changes to the order management layer. Each responsibility maps to a single method — no tangled conditionals, no God classes.
OpenCart: shipping module with live branch lookup
For OpenCart stores, we build a custom shipping module that hooks directly into the checkout flow. When the customer selects Nova Poshta and picks a branch, the module fetches the live branch list from the Address.getCities and Address.getWarehouses endpoints. The chosen delivery address writes to the order record immediately, formatted and ready for dispatch.
No manual copy-pasting. No mismatch between what the customer entered and what appears on the waybill.
The business case
A mid-sized store processing 200 orders per day saves roughly 3–4 staff-hours daily once this integration is live. At an average operator cost of ₴200/hour, that is ₴180,000–240,000 per year — freed for higher-value work. The payback period is typically under two months.
Ready to automate your fulfilment?
We have shipped Nova Poshta integrations for Laravel and OpenCart platforms. If your fulfilment team still creates waybills by hand, we can change that.