Elbuz sends orders to the Nova Poshta Fulfillment warehouse with one button; the warehouse picks, packs and ships the parcel. The waybill number returns to the order, and statuses and stock arrive automatically.
When you need this:
- Your goods are at a Nova Poshta warehouse — no re-entering orders and products in the fulfillment account.
- The customer needs the waybill number — it's in the order at once; SMS, emails and the “Shipments” registry work.
- The site sells items the warehouse no longer has — warehouse stock is updated hourly.
Where to start: get access from your fulfillment manager and fill in the “Nova Poshta Fulfillment” connection.
What Nova Poshta Fulfillment can do in Elbuz
- Products to the warehouse — name, barcode, weight and dimensions from the product card, with no manual setup in the fulfillment account.
- Orders to the warehouse — recipient, branch or parcel locker, items by product code and cash on delivery with one button.
- Waybill from the warehouse — the warehouse creates the Nova Poshta waybill, and the number is written to the order right away.
- Cancellation — while the warehouse hasn't started working on the order.
- Statuses — warehouse statuses until dispatch, then Nova Poshta statuses, and the order moves to your status on its own, all the way to “Delivered” or “Refused”.
- Stock — a separate “Nova Poshta Fulfillment” warehouse in Elbuz, updated every hour.
- Request or action
- Reply
- Note
How to connect Nova Poshta Fulfillment
Fulfillment is connected not with an API key but with access to the warehouse web service. Your Nova Poshta fulfillment manager issues it.
What to get from your fulfillment manager
Where: System settings → “Other settings” → “External services and integrations” → “Delivery” group → “Nova Poshta Fulfillment”. This is a separate record, not the “Nova Poshta” one.
- Enter the web service “User” and “Password”.
- Fill in “Organization code” and “Fulfillment warehouse code”.
- Choose “Who pays for delivery” (the recipient by default) and “Delivery payment method” (cash by default). These values can't be changed in the waybill form.
- Choose how to collect money on delivery — see below.
- Choose the “Product code at the fulfillment warehouse” — which one.
- Turn on “Active”.
1
Who issues access, IP whitelist2
From the fulfillment manager3
Warehouse that ships4
Cash on delivery or payment control5
How the warehouse recognizes a product6
Fulfillment test server- The grey hint — who issues access and that the Elbuz server IP must be added to the whitelist.
- Organization code (NPL_A1) — the fulfillment manager provides it.
- Fulfillment warehouse code (3PL_OCN) — the warehouse orders are shipped from.
- “Payment on delivery” — cash on delivery or payment control.
- “Product code at the fulfillment warehouse” — which card field the warehouse uses to recognize a product.
- The “Sandbox environment” switch turns on the fulfillment test server.
“Payment on delivery” has two modes. “Cash on delivery (money return shipment)” — the money is sent back to you by transfer, and the recipient pays its fee. “Payment control (to your account, requires an agreement with Nova Poshta)” — the money goes to your bank account; you need a company contract with Nova Poshta.
“Unit of measure at the fulfillment” is “pcs” by default — change it only if the warehouse keeps the product in other units. “Sandbox environment” sends requests to the fulfillment test server.
You don't enter a Nova Poshta API key in this connection. To track parcels by Nova Poshta codes and print waybills from Elbuz, also connect “Nova Poshta” for the same company — with the key you handed to the warehouse.
Which product code to choose
The warehouse identifies a product by a single code. Elbuz uses this code to send order items, set up products at the warehouse and match stock. Which code to take from the product card is set by the “Product code at the fulfillment warehouse” field in the connection.
1
SKU, Elbuz UUID, model code or EAN2
One code for orders and stock3
The warehouse knows the products — keep the code- The list — SKU, Elbuz UUID, model code or EAN.
- The grey hint — the warehouse recognizes the product by this one code in orders and stock.
- The orange warning — this connection already has stock or shipments, so the code must not change.
| Value | Product card field | When to choose |
|---|---|---|
| SKU (default) | “SKU” | products are already set up in the fulfillment account by SKU |
| Elbuz UUID | “UUID” | a new connection, and Elbuz sends the products to the warehouse: every product has a UUID, and it never changes |
| Model code | “Model” | the warehouse keeps products by model code |
| EAN | “EAN (European Article Number)” | the warehouse keeps products by barcode |
If you're just connecting and setting up products through Elbuz, choose Elbuz UUID: SKUs often change when a product is renamed or the supplier changes, but the UUID never does. If products are already at the warehouse under their SKUs, leave “SKU”.
The code must be filled in for every product that goes to the warehouse. An empty code stops the transfer before it reaches the warehouse, with the product name in the message — error breakdown.
How to send products to the warehouse
To accept a delivery and pick orders, the warehouse has to know your products. Elbuz sets them up at the warehouse itself — from the product cards.
Where: “Products” window → right-click a row → “Send to Nova Poshta Fulfillment”. The item appears only when the fulfillment connection is active.
1
Send selected products to the warehouse2
Selected products- “Send to Nova Poshta Fulfillment (3)” — sends the selected products to the warehouse.
- Checkboxes — the selected products.
- Select products with checkboxes. With nothing selected, the product in the row under the cursor is sent.
- Right-click → “Send to Nova Poshta Fulfillment (N)”, where N is the number of selected products.
- Wait for the warehouse to respond. All accepted — the message “Products accepted by the fulfillment warehouse: N”. Some not accepted — a window with the “Not accepted:” list and a reason next to each product.
What the warehouse receives for each product:
- Code — the one chosen in the connection.
- Name — up to 150 characters.
- Barcode — from the EAN field, if filled in.
- Weight and dimensions — from the card; Elbuz converts them to kilograms and centimeters itself.
- Unit of measure — from the connection's “Unit of measure at the fulfillment” field.
You don't have to send products separately before every order. “Create waybill” itself sends the warehouse any order products it doesn't know yet under the current code. If the warehouse doesn't accept a product, the order isn't sent, and the response shows the reason.
If you change the name, weight or barcode in the card, send the product again: changes don't reach the warehouse on their own. Deliveries (the product receiving plan) are arranged in the fulfillment account; Elbuz doesn't create them. Elbuz doesn't send additional barcodes or packaging.
How to send an order to the warehouse
The button is the same as for other carriers' waybills; the order just needs the “Nova Poshta Fulfillment” delivery method.
Where: order card → “Delivery” section → “Create waybill”. In bulk — from the order list, the same way as for other carriers.
1
Warehouse picks, items by product code2
NP branch or parcel locker3
Cash on delivery, the recipient pays4
Cash on delivery amount in UAH5
Send the order to the warehouse- The grey note — the warehouse picks the order, and items are sent by the product code from the connection settings.
- Pickup point — a Nova Poshta branch or parcel locker; empty means address delivery.
- “Return delivery (recipient)” — cash on delivery, paid by the recipient.
- Amount — the cash on delivery amount in hryvnias.
- “Create waybill” — sends the order to the warehouse.
- Check the recipient and phone — an order without a phone isn't sent.
- Check the “Pickup point code” — a Nova Poshta branch or parcel locker. The order fills it in if the customer chose a point on the site; otherwise enter the number or pick it from the city's branch list. An empty point means address delivery, and then “Street” and “House” are required.
- Check “Return delivery (recipient)” and “Amount” — cash on delivery in hryvnias. By default it's the full order amount if the order isn't marked “Paid” and the payment type is cash on delivery. With prepayment it's also the full amount, so correct it by hand. “Paid on delivery” amounts are always added, even to a paid order.
- Click “Create waybill”.
The warehouse accepts the order and immediately returns the Nova Poshta waybill number: “Waybill created, No. …”. The number is written to the order, and then the “Shipments” registry, SMS and emails to the customer work.
What the warehouse receives:
- Items by product code. Every order line with a quantity — code, name, quantity and price. The code is taken from the product card according to the connection setting; a line not linked to a product goes with its own SKU. Elbuz sends the warehouse any products it doesn't know yet before the order. Elbuz later pulls stock by the same code.
- Order number — the same as in Elbuz. Sending the same order again, before the warehouse starts working on it, updates the order at the warehouse and doesn't create a second one.
- Declared value — the order amount.
- Recipient — always as a private individual. An organization with an EDRPOU code and a “Third party” payer can't be set up through Elbuz.
Elbuz doesn't arrange deliveries to the warehouse (the receiving plan) — they're handled in the fulfillment account. Nova Poshta extra services (carrying upstairs, Saturday delivery) aren't in this form.
How to cancel an order at the warehouse
Where: order card → “View waybill” → “Delete waybill”, or “Shipments” → row → “Delete waybill”.
The warehouse cancels an order only while its status is Новый (New): the waybill number then disappears from the order, and you can send it again. If picking has started, the warehouse refuses with a reason (for example, the order is Упакован, Packed). The waybill stays in the order — sort it out with your fulfillment manager.
Statuses and waybill printing
Elbuz requests the status every 10 minutes — with the same “Checking delivery status” task as for other carriers. Where the status comes from depends on whether “Nova Poshta” is connected as well:
| Connected | What you see | Waybill printing from Elbuz |
|---|---|---|
| Fulfillment and “Nova Poshta” for the same company | Nova Poshta statuses, codes and storage deadlines, as for regular waybills; the order status changes along the whole route | yes |
| Fulfillment only | before dispatch — the warehouse status (Новый … Упакован), after — the waybill status as text from the warehouse; no storage deadlines or COD data. Elbuz converts the text into a Nova Poshta code using a dictionary, so the order status also reaches “Delivered” or “Refused”; unfamiliar text counts as “on the way” | no, the warehouse prints the waybill |
Elbuz fills in the codes in “Delivery statuses” itself. The warehouse returns its statuses in Russian, and that's how you see them.
The numeric codes are Nova Poshta codes: with “Nova Poshta” connected they come from it, without it Elbuz gets them from the dictionary of warehouse texts. How order statuses change by these codes is covered in the Nova Poshta article.
| Delivery status | Default codes |
|---|---|
| Awaiting sender | warehouse statuses from Новый (New) to Упакован (Packed) |
| On the way | Отгружен (Shipped), 4, 41, 5, 6 |
| At destination | 7, 8 |
| Delivered | 9, 10, 11 |
| Refused | 102, 103 |
Fulfillment warehouse stock
Once an hour, Elbuz pulls the quantity available for dispatch from the warehouse and writes it to a separate warehouse, “Nova Poshta Fulfillment (<warehouse code>)”. The warehouse appears on its own after the first update. Defective and quarantined goods aren't counted.
1
How many products the FF warehouse has2
Pull stock now- The “Products in stock at the fulfillment warehouse” row — how many products the fulfillment warehouse has and when stock was last updated.
- The “Update directories” button — pulls stock from the warehouse right away, without waiting for the hourly update.
- The product is looked up by the product code from the connection settings. A product that isn't at the fulfillment warehouse gets 0.
- Every change is a line in the warehouse movement log, with no document.
- The product's overall “Quantity” is recalculated only if the “Sum stock across warehouses” setting is on. Otherwise the fulfillment warehouse stock is shown in the product card under the “Quantity” field, and the site still gets the overall quantity, as before.
1
FF warehouse, filled in by Elbuz2
Available for dispatch- The “Nova Poshta Fulfillment (3PL_OCN)” line — the fulfillment warehouse; Elbuz fills it in itself.
- The number — how much is available for dispatch.
To update stock now, use the “Update directories” button in the connection form, “Service directories” block. The nightly update of carrier directories also pulls stock — for each fulfillment connection separately.
What to do when an order isn't sent
| What you see | Why | What to do |
|---|---|---|
| “login/password rejected or IP is not whitelisted (HTTP 401)” or “check that the Elbuz server IP is whitelisted by the fulfillment” | Wrong login or password, or the Elbuz server IP isn't on the whitelist | Check the access details and ask your fulfillment manager to add the IP (connection) |
| “Product «…» has no SKU (Elbuz UUID, model, EAN) — it is the product code at the fulfillment warehouse” | The product card field chosen as the product code in the connection is empty | Fill in that field in the card and try again (product code) |
| “Item without SKU: … — the fulfillment warehouse picks goods by SKU” | The order line isn't linked to a product and has no SKU | Enter the SKU in the line or link a product (sending an order) |
| “products are not accepted by the warehouse” with “«product»: reason” below; or the “Not accepted:” window after “Send to Nova Poshta Fulfillment” | The warehouse refused to set up the product — the reason is written by the warehouse itself | Fix the card according to the reason and send the product again (sending products) |
| “«…»: the same code «…» as «…»” | Two selected products have the same code — the warehouse can't tell them apart | Make the codes different or choose Elbuz UUID (product code) |
| After the product code was changed, the warehouse can't find the products, and the fulfillment warehouse stock dropped to 0 | The warehouse stores products under the old code | Restore the previous code in the connection; switch to another code only together with your fulfillment manager (product code) |
| “organization code is required” or “warehouse code is required” | The organization code or warehouse code isn't filled in | Enter the codes from your fulfillment manager (connection) |
| “Street and house are required for address delivery” | The pickup point is empty and there's no address | Choose a branch or parcel locker, or enter the street and house |
| “Recipient phone is required” | The order has no recipient phone | Enter the phone and try again |
| “the warehouse prints the waybill; to print it here, connect Nova Poshta with the same API key” | “Nova Poshta” isn't connected — the warehouse prints the waybill | Connect “Nova Poshta” with the same key (statuses and printing) |
Scenarios
First connection
What to do. Get access and codes from your fulfillment manager, and ask them to add the Elbuz server IP. Fill in the connection, turn on “Active” and click “Update directories”.
What you get. The “Products in stock at the fulfillment warehouse” row shows a count, and the “Nova Poshta Fulfillment” warehouse is added to your list.
A site order to a branch with cash on delivery
What to do. Open the site order (delivery: “Nova Poshta Fulfillment”) → “Create waybill” → check the point and amount → “Create waybill”.
What you get. The waybill number in the order. First you see the warehouse status (Новый, Упакован), and after dispatch — Nova Poshta statuses.
The customer changed their mind
What to do. “Delete waybill”.
What you get. If the warehouse hasn't started on the order, it's canceled and the number is gone. If the warehouse is already picking, you get a refusal with a reason — call the fulfillment.
New connection, Elbuz manages the products
What to do. In the connection, choose Elbuz UUID as the product code and save. Send the products from the product list, then arrange a delivery in the fulfillment account.
What you get. “Products accepted by the fulfillment warehouse: N” — the warehouse knows the products and will accept them in the delivery.
A product has no code
What to do. “Create waybill” replied “Product «…» has no …” — fill in the SKU, model or EAN in the product card, whichever the connection uses as the code, and click again.
What you get. The product now exists in the fulfillment system, and “Create waybill” succeeds.
You want to change the product code
What to do. Under the product code field in the connection, there's an orange “This connection already has shipments or stock…” — don't change the code; write to your fulfillment manager.
What you get. The warehouse keeps recognizing the products, and stock and orders aren't lost.
You sold the last unit at the warehouse
What to do. Turn on “Sum stock across warehouses” if the site should get warehouse stock.
What you get. Within an hour, the stock at the “Nova Poshta Fulfillment” warehouse becomes 0, and the site shows the product as out of stock.
FAQ
Where do I get an API key for fulfillment?
You don't enter an API key in the fulfillment connection: you need the login, password and codes from your fulfillment manager. You hand your Nova Poshta key to the warehouse itself.
Does Elbuz send products to the fulfillment account?
Yes, from the “Products” window, and “Create waybill” itself sends products the warehouse doesn't know yet. Deliveries to the warehouse are arranged in the fulfillment account.
Which product code should I choose for fulfillment?
New connection, and Elbuz sends the products — Elbuz UUID: every product has one, and it doesn't change. Products already set up at the warehouse by SKU — “SKU”.
Can I change the product code once products are at the warehouse?
No, the warehouse will stop recognizing products in orders and stock. Agree on any switch to another code with your fulfillment manager.
What happens if I click “Create waybill” twice?
The second attempt replies that the waybill has already been created. No second order appears at the warehouse.
Can I ship to an organization with an EDRPOU code?
No, through Elbuz the recipient can only be a private individual.
Can I use both fulfillment and regular Nova Poshta?
Yes. They're two separate connections and two delivery methods — you choose the carrier in each order.
Where it is and who has access
- Menu
- order card → “Delivery” → “Create waybill”; products — “Products” window → right-click → “Send to Nova Poshta Fulfillment”
- Connection
- the “Nova Poshta Fulfillment” record in the “Delivery” group of “External services and integrations”
- Access right
- waybill — the “Delivery waybill creation” window; sending products — the “Products” window; connection — “API and access tokens”
- Prepare
- access and codes from the fulfillment, Elbuz IP on the whitelist, product code filled in on the cards
Related topics
- If you ship some parcels yourself — Nova Poshta: waybills, registries, cash on delivery.
- If you need to find a parcel or remind the recipient — Shipments.
- If you're choosing a carrier for another country — Delivery services in Elbuz.
- If the customer pays by card before shipping — Payments via NovaPay.
