Nova Poshta

What we fixed

Customers from towns with an apostrophe in the name, such as Кам’янець-Подільський, sometimes didn’t see Nova Poshta among the delivery options and chose another one. The city suggestion writes the apostrophe as ’ and the carrier’s directory writes it as ', so the city wasn’t found. Nova Poshta now finds the city and street whichever apostrophe is used, including when customers search for them themselves.

What we fixed

Some customers could not choose Nova Poshta at checkout. The carrier lists certain towns with a note in brackets and no space, such as “Первомайськ(Микол.обл.Первомайс.р-н)”. A customer typed just “Первомайськ”, the store found no branches there and removed the shipping method. A manager editing the order could not select it either.

The store now finds branches and parcel lockers in such towns by their plain name. For courier delivery it suggests streets to the customer and puts the right town on the waybill. The store also calculates the delivery price to that town. Before, it could price the delivery to a different place with a similar name, such as “Первомайське”.

What was fixed

A customer could place a Nova Poshta order to a branch or parcel locker without picking which one, or a courier order without the street and building number. The manager then had to call to find out the address. Now the shop won’t accept such an order and tells the customer which field is still empty. An order a manager creates in the panel also won’t save without a branch or address.

What we fixed

Customers type the name of their town, and Nova Poshta has dozens of villages sharing one name. Branches and parcel lockers of different villages appeared at checkout as one unlabelled list, the right village was sometimes not found at all, and the parcel went to another region. Now the shop also finds villages whose region is written in brackets, and every point from different villages is labelled with its village and region.

What's new

An order shipped with Nova Poshta now keeps not only the branch name but also the carrier's city code, and for courier delivery the city and street codes from the directory. The waybill takes them straight from the order, so the waybill window opens at once without waiting for the carrier.

What's new

Nova Poshta streets are now stored in your shop instead of being requested from the carrier on every keystroke. The suggestion answers instantly and keeps working even when the carrier is slow. The street directory refreshes together with cities and branches — with the «Update cities, branches and streets» button and nightly on schedule.

Other delivery methods can use the same directory now — a city courier or delivery at your own rates. Pick Nova Poshta in the «Suggest the street as the customer types» setting of the method.

Important before you update

The carrier gives out streets one city at a time, and there are eleven thousand cities, so the first download runs for a few hours and continues over the following nights. Your shop works throughout, and until a city has its streets the suggestion asks the carrier directly, as before.

What to do after the update

Press «Update cities, branches and streets» in the add-on settings.

What's new

The store has learned to ask any shipping method for a delivery address, and this method tells it that it handles the address itself: with a carrier it depends on the chosen branch, parcel locker or courier. Thanks to that no extra address switch appears in the settings, and the customer is not asked for the street twice.

Important before the update

The add-on works with store version 2.68.0 and newer. Update the store first, otherwise the add-on will not install.

The nightly refresh of the city and branch directory now runs to the end. Before, it broke off halfway: the shop ran out of memory while reading the next pages of the directory, and the rest of the background work stopped with it — customer e-mails, exports, mailings. The directory was left with old branches, and a customer could pick a branch that no longer exists.

What we fixed

Street suggestions for courier delivery work again. The store asked the carrier about streets with the wrong settlement code, and the answer was always an empty list: the customer typed the street by guess and the manager corrected it when issuing the waybill.

A parcel locker is no longer offered for a parcel it cannot take. An order weighing 21 kg still showed the "Parcel locker" tab, and choosing it made delivery disappear from checkout along with the chosen city. Now a pickup option with no suitable point in the city is not shown at all, and if the cart got heavier after the choice was made, checkout switches to an available option instead of losing delivery.

The store now respects the carrier's limit on the weight of a single place. For parcel lockers this is usually the important one: the carrier leaves the total limit of the point empty and caps a single place at twenty kilograms.

Delivery no longer disappears after a branch is picked

The customer picked a branch and Nova Poshta vanished from the checkout, taking the payment block with it. That was the method itself: once a point was chosen it went to the carrier for a price, and when the price could not be obtained it removed itself from the list.

The method now stays, and instead of a sum it says «We will confirm the cost with you». The order goes through and you confirm the shipping cost yourself.

The recipient city is taken from the chosen branch rather than from the name typed in the field. A branch knows its own city: the customer lives in a village but collects the parcel in the district centre — exactly where the chosen point is.

And the important part for setup: if the dispatch city is not filled in, the shop now says so plainly. Without it the carrier calculates nothing, while the method used to look configured.

Branches are listed by number

The list of branches did not start with the first one: points came in the order the carrier returned them during the directory refresh, and a customer in a large city saw «Branch No. 55» first. Both the branch picker at checkout and the lookup on the storefront now put them in order — No. 1, No. 2, No. 3.

The order appears right after the add-on is updated; there is no need to wait for the nightly directory refresh.

You can see what kind of branch it is

The carrier has different branches: ordinary, cargo, partner point. They used to look the same in the list, and a customer with a crate of bottles could pick one that would not accept it. The kind of branch is now written right in the list while choosing, and it is stored in the order parameters together with the point itself — the manager sees it in the order card.

The branch kinds appear after the next nightly refresh of the directory, which runs on its own.

The branch now tells you about itself

In the list of branches, the name is followed by how late it works today and the number to call, and next to the shipping cost the customer sees the date the carrier promises to deliver. For courier delivery the street is suggested from the carrier directory: the customer picks it from a list, and the waybill gets the name exactly as Nova Poshta knows it.

The directory refreshes itself

Carrier branches open and close every month. The list of cities and branches is now refreshed every night without your involvement — before that it had to be started with a button in the settings. The city and branch lookup addresses were fixed as well: a registration mistake left them not working at all.

The directory update now shows its progress

Press «Update cities and branches» and you see what is happening: how many cities and branches are already downloaded and when it finished. Previously the button stayed at «Queued…», and cities were not downloaded at all when started from the settings — only branches were.

The add-on tells you when the directory is empty

Until cities and branches are downloaded, delivery does not work: customers have nothing to choose from. The add-on now says so in its settings and in the delivery method, right next to the «Update cities and branches» button. The same goes for a missing access key.

The access key moved to the add-on settings

The Nova Poshta key is now entered once, in the add-on settings, next to the button that refreshes the branch directory. It used to live in the shipping method, so a shop with two storefronts had to keep two methods with the same key. Your key is carried over automatically.

The sending city stays with the method: a shop may have several warehouses in different cities — add a method for each.

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.

Первый релиз