Nova Poshta

Connecting

Waybills are created in your name — with your Nova Poshta API key.

1. Create an API key in your Nova Poshta account (in the security settings).
2. Settings → Integrations → Nova Poshta — paste the key and click “Load profiles”.
3. Choose the sender profile (your business), the sender city and sender branch, and enter the sender phone.
4. Click “Connect Nova Poshta”.

The card shows “Nova Poshta is connected and working”. Without a key no waybill is created, and the dashboard says so plainly.

Creating a waybill

On the order card, the order page or in a conversation — “Create waybill”.

In one click. If the order has an address and the packaging and weight are known (from the product card or packaging warehouse), the waybill is created right away. If a box or dimensions are missing, the form opens by itself.

Manually — the arrow next to it → “Create waybill manually”. The form shows everything that goes into the waybill, and everything can be changed:

• recipient — last name, first name, patronymic, phone in the 380XXXXXXXXX format;
• delivery — city and branch, parcel locker or courier (street, house, flat). If the buyer asked to ship to someone else or another branch, fix it here — the new details are saved to the order too;
• packaging — a box from the warehouse (taken off stock when the waybill is created) or custom dimensions and weight;
• shipment description — for example, “Clothing”. For a gift it's filled in automatically;
• declared value — for parcel insurance;
• cash on delivery — how much the post office collects from the buyer. It starts with the amount the dashboard calculated from the payment method; you can change it, 0 — no COD.

“Remember these dimensions and packaging” — next time, for the same combination of products, the packaging is filled in automatically.

The created waybill appears on the order card — tap the number to copy it.

Why a waybill won't be created

The dashboard always names the reason. The main three:

1. the order is cancelled — its items have already been returned to stock;
2. the order has no items;
3. the order is unpaid while the payment method requires payment:

| Payment method | When you can ship | | :---- | :---- | | Cash on delivery | always | | Partial prepayment | after the deposit | | Full prepayment, card | after full payment |

The money came another way — mark the payment by hand, and the block disappears. The buyer didn't pay and asks for cash on delivery — open “Create waybill manually” and enter the COD amount: the waybill is created, and the order switches to cash on delivery.

Other reasons: no Nova Poshta key, incomplete sender details, no city and branch in the order's address.

Several waybills at once (Pro)

In the order list — “Select”, mark the orders and click “Create waybill”. You can immediately choose:

• “Waybill only”;
• “Waybill + new registry”;
• “Waybill + add here” — into the current active registry.

The dashboard reports how many were created and how many failed (most often — incomplete buyer details). If some orders need packaging chosen, it asks for that.

Registries (Pro)

A registry collects the day's waybills for handing over to the carrier. The active registry is shown at the top of the order list: its number and parcel count. From there you can print and disband it. A single waybill can be removed from the registry.

Printing

“Print waybills” — three formats:

• full waybill (A4);
• labels — 6 per A4 sheet;
• thermal label 100×100.

Printing opens in a new tab. If the browser blocked the pop-up, the dashboard says so — allow pop-ups for the site. One waybill prints on any plan; a batch — from Pro.

Parcel statuses

From the Plus plan the dashboard asks Nova Poshta about active shipments every hour: in transit → at the branch → picked up or refused. The ↻ button in the order list does the same right away. Pickup dates and the start of paid storage are recorded along the way.

Orders move between tabs by themselves: “In transit”, “At branch”, “Storage fee soon”, “Paid storage”, “Refused”, “Returned”. You get a notification about returns and the start of paid storage — once per parcel.

Until the parcel is accepted at the branch, the order stays “Ready to ship”, even if the waybill already exists.

Waybill number for the buyer (Plus)

Settings → Automations → Waybill number in the chat: as soon as you create a waybill, the buyer gets the number and a tracking link in the chat where they ordered. The number also appears on the buyer's order page.

Deleting a waybill

On the order page: “•••” → “Delete waybill”. The dashboard cancels the waybill at Nova Poshta (and removes it from the registry), the order waits for shipping again, and the box goes back to stock.

Nova Poshta legitimately refuses to cancel a waybill once the parcel has been accepted. Then the dashboard shows the reason and asks whether to unlink the waybill only in Poleso. This is a deliberate choice: an unlinked but not cancelled waybill stays alive at the carrier, and the parcel will travel.

Deleted the waybill in your Nova Poshta account? Status sync unlinks it by itself: the number disappears, the order returns to processing, the box goes back to stock, and you get a notification.

Other carriers

• Meest — waybills from the dashboard in the same way.
• Ukrposhta or any other service — tracking number by hand.