Shipping fulfilment is one of the highest-friction points in e-commerce operations. When staff manually create waybills, copy tracking numbers, and paste them into customer emails, every order costs time. At 50 shipments a day, that overhead reaches 400–700 minutes — nearly a full working day lost to copy-paste.
Nova Poshta's JSON-RPC API v2, integrated into a Laravel application, eliminates that friction entirely. Waybills are created automatically, tracking status flows into your database via scheduled jobs, and customers receive dispatch notifications without anyone touching a keyboard.
What the integration handles
- Waybill generation — when an order status moves to "Processing," a Laravel observer triggers an API call to
InternetDocument/save. The waybill reference number is stored on the order record in seconds. - Branch and city autocomplete — your checkout fetches Nova Poshta's live branch directory. Customers pick the correct post office from a dropdown, not a free-text field. Wrong-branch errors fall to near zero.
- Real-time tracking — a Laravel scheduled job polls
TrackingDocument/getStatusDocumentsevery hour and updates order status automatically. - Automated notifications — Mail or SMS alerts fire when the parcel status changes to "En Route" or "Waiting at Branch." Customer support tickets about delivery drop sharply.
The technical architecture
Laravel's built-in Http facade keeps Nova Poshta calls readable and testable. A dedicated NovaPoshtaService class handles authentication (API key via config('services.novaposhta.key')), request formatting, and error handling. Observers and queued jobs decouple shipping logic from your order flow — checkout response time stays fast regardless of API latency.
Branch and city reference data is cached in Redis with a 24-hour TTL, reducing API round-trips and keeping the checkout performant under load.
Measurable outcomes
Projects we have delivered typically show:
- Order processing time drops from 6–8 minutes to under 30 seconds per shipment.
- "Wrong branch" errors fall by over 90% after switching from free-text to autocomplete.
- Fulfilment team headcount stays flat as order volume grows — automation absorbs the load.
What MaxiMoruM delivers
We integrate Nova Poshta API into Laravel applications, OpenCart stores, and custom PHP platforms. The scope covers API key management, waybill generation, tracking jobs, branch/city reference caching, and customer notification templates.
Ready to automate your shipping workflow? Talk to us at maximorum.com — we scope and estimate within 24 hours.