Creating an electronic waybill (TTN)
The Nova Poshta module creates electronic waybills right from the admin panel — no need to log in to the Nova Poshta cabinet.
Where the data comes from
| Data | Source |
|---|---|
| Sender | Module settings: API key, sender counterparty, dispatch city and branch |
| Recipient | Filled in automatically from the order data (see below) |
| Delivery address | The city and branch/parcel locker the customer picked in the cart — or the street address, when courier delivery is enabled in the module settings |
Automatic recipient selection
When you open the waybill creation form, the system looks up the recipient contact person by the phone number from the order among the contacts that already exist in your Nova Poshta cabinet:
- Match found — the contact person is selected automatically; nothing to fill in: review and create the waybill.
- No match (a new customer) — click "Create counterparty". The form is already prefilled with the order data (full name, phone, email, city) — just confirm. This happens once: for the customer's next orders the contact is selected automatically.
If the order has the "This buyer is not the recipient" checkbox enabled, the contact lookup and counterparty creation use the recipient's data, not the buyer's.
Parcel weight and volume
The "Parcel parameters" block prefills the total weight and the total volume from the ordered products, when their dimensions are specified: value × quantity per order line, with a "from products" hint next to the field. Both fields stay editable — correct them freely before creating the waybill. Products without dimensions contribute nothing; when no product has them, the module falls back to its defaults.
Statuses
In the NP orders list:
- Not processed — no waybill yet; the create button is available.
- Processed — the waybill exists; opens the waybill page with the delivery status, cost, and print buttons.
If the waybill was deleted in the Nova Poshta cabinet, the system detects that when the page is opened and returns the order to "Not processed".
The waybill number is also visible on the order edit page: the Waybill / tracking № field shows it read-only with a Manage waybill button; before creation it says "Waybill not created yet".
Bulk creation
For several orders at once there is bulk TTN creation in the NP orders list — the system creates waybills one by one and reports the result per order. The weight and volume of every waybill are calculated from the products the same way as in the single-order form.