↑↓ selectEnter openEsc close

    1. Elbuz
    2. Sales and documents
    3. Customer order processing
    4. Delivery services in Elbuz

    Nova Poshta Fulfillment: orders to the NP warehouse and stock in Elbuz

    13 min readUpdated

    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.
    Who does what: Elbuz sends the order and asks for statuses, the warehouse picks it and creates the waybill, Nova Poshta delivers
    Nova PoshtaFulfillment warehouseElbuzpicks and packs the orderproducts — code, name, barcode, weight and dimensions“Create waybill” — recipient, point, items by product code, CODcreates the waybill with your API keywaybill number, Elbuz writes it to the orderhands over the parcelevery 10 minutes — order status at the warehousewith “Nova Poshta” connected — waybill statusonce an hour — warehouse stock
    • 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.

    1. Enter the web service “User” and “Password”.
    2. Fill in “Organization code” and “Fulfillment warehouse code”.
    3. 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.
    4. Choose how to collect money on delivery — see below.
    5. Choose the “Product code at the fulfillment warehouse” — which one.
    6. Turn on “Active”.
    The Nova Poshta Fulfillment connection form: organization and warehouse codes, payment terms, product code at the warehouse
    1Who issues access, IP whitelist
    2From the fulfillment manager
    3Warehouse that ships
    4Cash on delivery or payment control
    5How the warehouse recognizes a product
    6Fulfillment test server
    1. The grey hint — who issues access and that the Elbuz server IP must be added to the whitelist.
    2. Organization code (NPL_A1) — the fulfillment manager provides it.
    3. Fulfillment warehouse code (3PL_OCN) — the warehouse orders are shipped from.
    4. “Payment on delivery” — cash on delivery or payment control.
    5. “Product code at the fulfillment warehouse” — which card field the warehouse uses to recognize a product.
    6. 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.

    The “Product code at the fulfillment warehouse” field set to SKU, with a grey hint and an orange warning below it
    1SKU, Elbuz UUID, model code or EAN
    2One code for orders and stock
    3The warehouse knows the products — keep the code
    1. The list — SKU, Elbuz UUID, model code or EAN.
    2. The grey hint — the warehouse recognizes the product by this one code in orders and stock.
    3. The orange warning — this connection already has stock or shipments, so the code must not change.
    ValueProduct card fieldWhen 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 warehouse stores a product under the code it was set up with. After you change the code, the warehouse doesn't recognize order items, stock under the old code doesn't land on any product (the “Nova Poshta Fulfillment” warehouse in Elbuz shows 0), and Elbuz sets up a second, empty product at the warehouse. When the connection already has stock or sent orders, an orange warning appears under the field. You can change the code for products already at the warehouse only together with your fulfillment manager.

    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.

    The row menu in the Products window with the Send to Nova Poshta Fulfillment (3) item and three selected rows
    1Send selected products to the warehouse
    2Selected products
    1. “Send to Nova Poshta Fulfillment (3)” — sends the selected products to the warehouse.
    2. Checkboxes — the selected products.
    1. Select products with checkboxes. With nothing selected, the product in the row under the cursor is sent.
    2. Right-click → “Send to Nova Poshta Fulfillment (N)”, where N is the number of selected products.
    3. 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.

    The waybill form for Nova Poshta Fulfillment: a grey note, recipient, address, pickup point, return delivery with the amount and the Create waybill button
    1Warehouse picks, items by product code
    2NP branch or parcel locker
    3Cash on delivery, the recipient pays
    4Cash on delivery amount in UAH
    5Send the order to the warehouse
    1. The grey note — the warehouse picks the order, and items are sent by the product code from the connection settings.
    2. Pickup point — a Nova Poshta branch or parcel locker; empty means address delivery.
    3. “Return delivery (recipient)” — cash on delivery, paid by the recipient.
    4. Amount — the cash on delivery amount in hryvnias.
    5. “Create waybill” — sends the order to the warehouse.
    1. Check the recipient and phone — an order without a phone isn't sent.
    2. 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.
    3. 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.
    4. 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.
    A product without a code stops the transfer before it reaches the warehouse: “Product «<name>» has no SKU — it is the product code at the fulfillment warehouse”. Instead of SKU, the message names whatever is chosen as the product code: Elbuz UUID, model or EAN. Fill in that field in the product card and try again. An order line with no product and no SKU gives “Item without SKU: <name>”: enter the SKU in the line itself.

    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:

    ConnectedWhat you seeWaybill printing from Elbuz
    Fulfillment and “Nova Poshta” for the same companyNova Poshta statuses, codes and storage deadlines, as for regular waybills; the order status changes along the whole routeyes
    Fulfillment onlybefore 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 statusDefault codes
    Awaiting senderwarehouse statuses from Новый (New) to Упакован (Packed)
    On the wayОтгружен (Shipped), 4, 41, 5, 6
    At destination7, 8
    Delivered9, 10, 11
    Refused102, 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.

    The “Service directories” block of the Nova Poshta Fulfillment settings: the number of products at the warehouse and the Update directories button
    1How many products the FF warehouse has
    2Pull stock now
    1. The “Products in stock at the fulfillment warehouse” row — how many products the fulfillment warehouse has and when stock was last updated.
    2. 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.
    The Quantity field in the product card with the Nova Poshta Fulfillment (3PL_OCN) warehouse stock: 12
    1FF warehouse, filled in by Elbuz
    2Available for dispatch
    1. The “Nova Poshta Fulfillment (3PL_OCN)” line — the fulfillment warehouse; Elbuz fills it in itself.
    2. 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

    Common problems
    What you seeWhyWhat 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

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free