Nova Poshta waybills
A Nova Poshta express waybill straight from the order.
You can issue a Nova Poshta waybill right in the order, without opening the carrier’s account. The shop takes the recipient, city, branch, parcel locker or courier delivery address from the order and works out the weight from its items. The waybill number is saved with the order and appears in its history and on the printed forms.
What it does
- Creates an express waybill with one button in the order. The shop registers the recipient with Nova Poshta using the name and phone from the order.
- Picks the delivery type on its own. If the buyer chose a branch or parcel locker, the parcel goes there, and if the order has a street address, a courier delivers it.
- Calculates the weight and the number of parcels from the order’s items, falling back to the default weight from the settings when products have none.
- Provides links to print the waybill as a PDF and the 100×100 label for a thermal printer.
- Shows the parcel status by waybill number. You can delete a waybill issued by mistake. The number then disappears from the order, and the deletion stays in its history.
- When a buyer doesn’t collect a parcel, asks the carrier how much the delivery, the return and paid storage at the branch cost. It takes the return cost from the return waybill and knows when Nova Poshta returns a parcel for free.
- Follows a refused parcel by its return waybill until it’s back with you and records the day it returned. If you have Dropshipping, it uses this to charge the dropshipper what the refusal actually cost.
- If a sender has their own Checkbox register, receipts issued after their waybill is created come from it.
- Runs independently of your shop’s shipping methods, so it suits you even if buyers never pick Nova Poshta at checkout.
What you need
- An access key from your Nova Poshta account. You create it in the account’s security settings. Turn on the express waybill option for the key, otherwise the shop can’t issue waybills.
- A sender with a phone number and a sending branch. Once you save the key, you can pick them from your account’s list. If the sender has no phone number, Nova Poshta leaves out some parcel details, such as the costs of a refusal.
- CartiX 2.134.0 or later.
What’s new
The waybill can now be adapted to your shop’s rules: it can use your own declared value and say who pays for delivery. For example, the shop can pay for delivering a paid order above a certain number of items. These values are already filled in the waybill window, and the manager can change them. If you have no such customisation, the waybill is built as before.
What’s new
A receipt can now come from the register of the sole proprietor (FOP) who shipped the parcel. Open the sender on the add-on screen and choose their register in the "Receipt cash register" field. The field appears once the shop has more than one register connected. This works when the receipt is issued after the waybill is created. Receipts for orders paid before shipping still come from the shop’s usual register. Before, the shop’s register issued every receipt, whoever the waybill was from.
What’s new
When a buyer doesn’t collect a parcel, the shop asks Nova Poshta how much the delivery, the return and paid storage at the branch cost. It takes the return cost from the return waybill. The shop counts a return as free if you paid for delivery at the branch when sending the parcel and it weighs no more than 30 kg. It uses the largest of the declared, actual and volumetric weight. If you pay Nova Poshta under a contract, the return counts as paid.
The shop follows a refused parcel by its return waybill until it’s back with you, even if the order has already moved to a closed status. It records the day the parcel returned and then stops checking it.
The shop now asks Nova Poshta about a parcel together with the sender’s phone. Without it, the carrier shows only part of the details and, for example, doesn’t report the costs of a refusal.
If you have Dropshipping 1.1.0, it uses this information to charge the dropshipper what the refusal actually cost. Under the “The dropshipper pays” scheme, it credits cash on delivery minus Nova Poshta’s fee for transferring the money, if you’re the one paying that fee.
Before updating
This version works with CartiX 2.133.0 and later. Update the shop first.
What we fixed
If the apostrophe in the order address was a different character from the one Nova Poshta uses, the waybill couldn’t find the recipient’s city and street. For Кам’янець-Подільський you had to pick them by hand. The waybill now finds them whichever apostrophe the address uses.
What we fixed
The add-on asked Nova Poshta about every order with a tracking number, Ukrposhta numbers included. The carrier replied “Waybill number not found”. If you had given that state a status in the settings, the order changed its status by itself and the customer got an email. The add-on now follows only Nova Poshta parcels. These are waybills issued through the store and numbers on orders shipped by Nova Poshta. A number typed in by hand on such an order can now be tracked with the “Where the parcel is” button.
What we fixed
Some courier orders could not be shipped without manual fixes. The carrier lists certain towns with a note in brackets, such as “Первомайськ(Микол.обл.Первомайс.р-н)”, while the order says just “Первомайськ”. The waybill window left the town empty. With “Check the waybill before issuing” turned off, the button in the order reported that the recipient town could not be found. The store now finds such towns by their plain name.
What's new
The add-on settings now have a default parcel length, width and height. If the order has no parcel details, the waybill window fills in these sizes. They go to Nova Poshta even if the manager leaves the fields empty. This is handy if you ship every order in the same size box or envelope.
The “Places” field in the waybill window now shows 1. Before, the field was empty, though the waybill went out for one place anyway.
Fixed
The waybill window now fills in today's shipping date in shop time. Before, between midnight and three in the morning Kyiv time it showed yesterday's date, and a waybill created without the window got the same date.
What’s new
You can now collect payment for parcels with Nova Poshta’s Payment control. Nova Poshta takes the cash-on-delivery amount from the recipient and pays it through NovaPay straight into your business account instead of sending the money back as a separate delivery. Choose this service in the add-on settings under “How to collect the money for the parcel”, and every cash-on-delivery waybill will use it. You can switch the service for a single parcel in the waybill window.
If some of your senders do not have the service, the shop sends the parcel from the next sender who does. In the waybill window you will see that the chosen sender has no Payment control.
What to do after updating
Before choosing Payment control, make sure the service is included in your contract with Nova Poshta.
What's new
Waybills can now go out from several senders. Each sender has their own access key, full name, phone and the branch or parcel locker they ship from. This is for shops that ship from private persons: Nova Poshta lets a private person receive only a limited cash-on-delivery amount a month.
You set the monthly cash-on-delivery limit yourself, and the shop offers a new waybill to the first sender in the list whose limit is not used up yet. The limit counts per person: if you delete a sender and add them again with the same key, the month's amount stays. An amount counts towards the limit when the waybill is issued, returns do not reduce it, and a new month starts by itself. The waybill window shows how much each sender has received this month, and every sender has the «Issue above the monthly limit» mark: with it the manager issues the waybill even after raising the cash-on-delivery amount or when the limit filled up while the window was open.
Senders sit in a compact list: you change their order by dragging or with the arrows, and edit a sender in a window by clicking the row. The sending branch is picked from the Nova Poshta directory by city and number, even when your carrier account has no sender addresses at all. If you give a sender a key from another person's account, the shop saves it as a new sender, and the previous one leaves the list together with their waybills. Waybills of deleted senders are still printed and tracked with their keys.
The shop keeps access keys encrypted and apart from the other settings, and the Add-ons page no longer receives them.
Parcel tracking now has a period in days (up to 90) and a list of order statuses the shop leaves alone. You set the cargo description on the waybill yourself, for example «Accessories».
The waybill window opens at once: the shop takes the recipient, city and branch from the order and the sender from its own settings, without asking the carrier. The delivery cost is calculated with the “Calculate the cost” button. If an old or migrated order has the branch only as text, the shop picks it by number and asks you to check it. A city name that exists in several regions is never guessed — the shop asks you to choose.
What we fixed
The waybill and label now open as a file from your shop. Before, the print link led straight to Nova Poshta, and the access key stayed in the address bar and the browser history.
Important before you update
Parcels leave from the sender's branch or parcel locker. Courier pickup from your door remains only for the sender from the previous settings, if a Nova Poshta account address was chosen there.
What to do after the update
Nothing needs to be set up again: the key, contact person and sending address from the previous settings became the first sender. For the shop to spread parcels across senders, enter the monthly cash-on-delivery limit above the list of senders.
What we fixed
Street suggestions in the waybill dialog work again. The add-on asked the carrier about streets by city code, while the carrier knows them by settlement, so the list always came back empty. The street had to be typed by hand, otherwise the courier address was not saved.
Seats come from the person packing the order
The number of seats on a waybill is no longer filled in automatically. Until your packer enters it, the field stays empty and the carrier receives the shipment as a single seat. Previously the pre-filled one looked like a staff decision.
The parcel block can be hidden from the order
If your parcels are all alike, switch off the question about places, size and weight: the shop works the weight out from the products and ships a single place. With the block on, the number of places stays empty until the packer enters it — the carrier treats empty as one place, while a pre-filled 1 would look like your decision. A line bought by the pack is printed on the waybill with the pack name.
An icon of its own
In the «Plugins» section and in the list of installed items the add-on now shows its own icon instead of an identical box, so you find the one you need at a glance. The icon appears on shops running version 1.30.0 and newer.
The check window is optional
If your parcels are all alike, the window before issuing can be switched off in the add-on settings: the button in the order then creates the waybill straight away, from the order and the shipment details you set next to it.
The city and the branch are no longer lost
The shop used to look the recipient city up by the name stored in the order, and that name is not always written the way the Nova Poshta directory has it — so the city and the branch stayed empty. Both are now taken from the pick-up point the customer chose at checkout: it knows its own name and its own city.
The waybill is issued after a check, not straight from a button
The issue button moved to the orders workspace and opens a window where you check and edit everything that goes to Nova Poshta: the sender contact and address, the recipient with the phone, the branch or parcel locker, the courier address with the floor, places, weight, dimensions and payment. The shop shows the delivery date, its cost and the cash on delivery fee right there and recalculates them while you edit.
Small things that save calls to the branch
A street missing from the carrier directory can be typed in by hand. A parcel locker always takes a single place whatever the form says, and the weight is split between places. The order number now goes into the waybill as its own field, so the waybill is easy to find in your Nova Poshta account.
The sender comes from your access key
There is no sender to pick any more: at Nova Poshta it is always the owner of the key. You only choose the contact person and the address parcels leave from — both lists come from your account, and the phone fills itself in. These lists used to arrive empty, and the sender phone was lost on save.
The shop keeps an eye on parcels
Every half hour the shop asks the carrier where the order is, shows the state in the order card and moves the order to the status you mapped — the customer gets your usual status e-mail. When the customer pays on receipt, the amount due goes into the waybill as cash on delivery. A company order is issued to the legal entity by its state registration code, and when someone else collects the parcel the waybill is issued to that person.
Первый релиз