In Ukraine: Nova Poshta and Ukrposhta labels

This article is for sellers shipping inside Ukraine. Nova Poshta and Ukrposhta are Ukrainian carriers, and the steps below apply only to them. For carriers elsewhere, see Connect a carrier and buy shipping labels, which covers the label form these carriers share.

Connect Nova Poshta

Open Settings → Integrations → Shipping and click Connect on Nova Poshta.
Paste the API key. Create it in the Nova Poshta business cabinet under Settings → Security. A key works for one year, so enter Key valid until to see a lapse coming before waybills start failing.
Press Find to list the senders on your account (your sole proprietorship or company) and pick one. Then use Find to pick the contact person.
Optionally set the sending city, the branch where you hand parcels over and the address a courier comes to.
Save and press Test.

Create a waybill

Open a confirmed order and click Create shipping label. Under Delivery to, choose:

Branch: search the city, then the branch by number or street.
Parcel locker: leave the locker empty and the carrier picks the nearest one to the address. The one it picked is shown on the waybill. A locker takes a limited weight per parcel, which the form shows.
Address: search the street from the carrier’s own list, then enter the house and apartment. Where the carrier has no street list (a village), type the street as the order gives it.

Nova Poshta takes the recipient’s name in Ukrainian only. If the order’s delivery method says a door, a branch or a locker and the carrier cannot create that kind here, the form tells you which one it started on instead.

Carry up to the floor is a paid service at the carrier. The price you see from Get price does not include it. A sales channel can require it on courier orders.

For an unpaid order, set Payment on delivery:

Payment control (needs a contract with Nova Poshta, not available at lockers).
Cash on delivery.
None.

When the carrier scans the parcel, the order moves to shipped, and later to delivered, on its own.

Redirect, call a courier, cancel

On the label’s More actions:

Redirect sends a parcel already travelling to another branch, locker or address. The carrier charges for it. Choose who pays, or leave it as on the waybill.
Book courier asks Nova Poshta to collect parcels from your address.
Cancel label cancels at the carrier.

Ukrposhta

Connect Ukrposhta the same way. You will need the credentials from your Ukrposhta contract (the eCom bearer, the counterparty token and the status tracking bearer).

A waybill goes to a post office or a door, inside Ukraine.
It can also go abroad, from Ukraine to any country Ukrposhta serves, as a small bag or a parcel. The recipient’s address must be written in Latin letters, and every product needs a full HS code and a country of origin. Keelvy prints the customs forms.
A parcel abroad is sent as a sale, and the sender pays. There is no payment on delivery abroad.
A label can be canceled only while the shipment is still created. Once it is registered at a post office, Ukrposhta refuses.
Ukrposhta does not do lockers, floor lifting or several boxes under one document.

Nova Global

Nova Global is Nova Poshta’s international express service. Connect it with the login, password and company ID Nova Global gave you. It does not give a price before you create the label, so Keelvy shows none.

Customer details a carrier asks for

A carrier sometimes needs a number that is not an address or a contact. Add it on the customer card under Carrier identities, for example Nova Poshta recipient. Keelvy keeps it for the next label.

Fiscal receipts

Sellers who must issue a fiscal receipt with each sale can connect a cash register. See In Ukraine: fiscal receipts.