↑↓ selectEnter openEsc close

    1. Elbuz

    How to create a carrier waybill from an order

    6 min readUpdated

    As order management software, Elbuz creates a carrier's electronic waybill from the order card: under your contract, via the marketplace the order came from, or in a batch. The number lands in the order.

    When you need this:

    • Your own Nova Poshta or Ukrposhta account — “Create waybill” in the “Delivery” section, under your contract.
    • An order from Rozetka — “Waybill via Rozetka” uses the import template's credentials.
    • A dozen orders to ship — “Create waybill (shipping)” covers all selected orders.
    • A carrier without a built-in waybill, like Justin — enter the number from its account manually.

    Where to start: order card → “Delivery” section → “Create waybill”.

    What a waybill from an order can do

    What to fill in the “Delivery” section

    The “Delivery” section has three regular fields — delivery type, delivery status and description — and a collapsed “More fields” block with twenty-one recipient fields: name, phone, city, branch, address. The section hint is short: “Delivery method and status; recipient address is under “More fields”.”

    The Delivery section of a customer order card
    1Create waybill link
    2Delivery type list
    3Delivery status list
    4More fields block
    1. Create waybill — the link in the section header opens the waybill window; it was not clicked.
    2. Delivery type — the delivery service chosen for the order.
    3. Delivery status — the current state of the shipment.
    4. More fields — a collapsed block with the recipient address.

    Return tracking number

    Under “More fields” there is a “Return tracking number” field — the number of the parcel the customer will use to return the item. Marketplaces that accept a shipment only together with a return number require it: OTTO does for items shipped as parcels. The format is number, or GLS:number (DHL:, HERMES:) if the return carrier differs from the shipping one. More: return number for OTTO.

    Three ways to create a waybill

    This is also where you create the carrier's electronic waybill. It's an irreversible action: the waybill is created by an external system, the carrier charges for it, and it can only be canceled in that carrier's account. There are three ways.

    Three ways to create a carrier waybill
    WayButtonWhen it fits
    Under your own contract “Create waybill” in the “Delivery” section you have your own account with Nova Poshta, Ukrposhta, Meest, InPost, Rozetka Delivery, or the Polish DHL24, GLS, DPD, Poczta Polska, ORLEN Paczka, UPS, FedEx or Apaczka.pl — for other carriers (Justin, courier companies) the link isn't shown
    Through the source system “Waybill via ‹source›” the order came from a marketplace and has no waybill yet: the marketplace creates it, taking the sender from its own settings and the recipient from the order
    In a batch from the list “Create waybill (shipping)” in the selected rows bar and in the row menu you need waybills for several orders at once

    Where to get a Nova Poshta API key. Waybills under your own contract need your Nova Poshta account's API key. Create it in the Nova Poshta business account: “Налаштування” (Settings) → “Безпека” (Security) tab → “Мої ключі API” (My API keys) block → “Створити ключ” (Create key); accept the API terms and copy the key. To see what this screen looks like, read the “Nova Poshta” article.

    In Elbuz, paste it into the “Token” field of the Nova Poshta record: “System settings” → “Other settings” → “External services and integrations”. The same key is needed for the automatic status by parcel.

    Branch from an Elbuz CMS store order. A customer in an Elbuz CMS store picks a Nova Poshta branch or parcel locker, a Meest or Ukrposhta branch, or an InPost or ORLEN Paczka point — and the order arrives in Elbuz with that point already set. The waybill form for your own contract fills in the point itself, so you don't have to parse the address.

    • The Nova Poshta or Meest branch number is shown in the “Delivery service: branch” field (“Delivery” section → “More fields”). InPost and ORLEN Paczka points have no number: the point code is at the start of the address, before the comma.
    • For Meest, Elbuz determines the recipient's city from the branch.
    • For Ukrposhta, the postcode of the chosen branch goes into the waybill — you can see it in the “Delivery service: branch” field.
    • You can replace the point in the waybill form before clicking “Create waybill”: the one chosen in the form wins.
    • If the customer chose a courier, the order has no point — the form fills in the address.

    The three paths warn you differently, and it's worth knowing in advance:

    • Through the source system, the warning is right in the form — “The waybill is created in an external system and is charged by the delivery service. It cannot be issued twice for this order.” — and Elbuz asks again: “Create the waybill in the external system? It can only be canceled in the delivery service account.”
    • Under your own contract there is no warning at all: the “Create waybill” button in the carrier form creates the waybill immediately.
    • In a batch from the list, Elbuz only asks how many documents are selected.

    So check the recipient details before you click, not after.

    The forms differ too:

    • Through the source system, it's short: delivery service, parcels, weight, length, width, height, contents description, declared value and two checkboxes — “Order is already paid” and “Delivery paid by recipient”; the “Create waybill” button, “Creating the waybill...” while it works, and “Waybill created: ‹number›” at the end.
    • The form for your own contract is more detailed: sender and address separately, shipment type, general parameters with weight and dimensions, declared value and who pays for delivery; at the end it says “Waybill created, No.‹number›”. If the carrier charges by volumetric weight, check it in advance with the parcel volumetric weight calculator.

    After that, the waybill number is stored in the order, and “View waybill” replaces the button. A second attempt gets “The order already has a waybill number”.

    The “Create waybill (shipping)” item in the selected rows bar works on all selected orders at once. Before clicking, check how many rows are selected: the created waybills can only be canceled in the carrier's account, one by one. How a batch run goes and what happens if a request breaks off — see waybills in a batch.

    How to order a courier and ship to a pickup point (Poland)

    UPS and FedEx work from any EU country. The sender's country is set by the “Country (ISO code: DE, FR, IT, ES…)” field in the carrier settings; empty means Poland. The recipient's country comes from the order — as a code or a name in any language — and you can correct it in the “Country” field of the UPS or FedEx waybill form.

    Courier pickup and cancellation follow the sender's country. Shipments are EU-only: Elbuz doesn't send customs data, and the carrier won't accept a waybill outside the EU.

    For GLS, DPD Polska, Poczta Polska, ORLEN Paczka, UPS, FedEx and Apaczka.pl, you order a courier for parcels from the waybill card: open the order's waybill, in the “Courier pickup” block enter the pickup date, number of parcels and total weight, and click “Order a courier”. The carrier takes the pickup address from the carrier record (“Sender” block); GLS takes it from the ADE account profile.

    • GLS — only the date and number of parcels are needed; GLS takes the pickup hours from the profile.
    • DPD Polska — if no hours are set, Elbuz takes the first window DPD offers for the sender's postcode. The carrier returns a request number, which appears in the message and in the order log.
    • Poczta Polska — without your own hours, the request goes for 08:00–20:00. The window can't start earlier than the current hour.
    • ORLEN Paczka — without your own hours, Elbuz takes the window ORLEN Paczka offers on that date for the sender's postcode and returns the request number.
    • UPS — without your own hours, the request goes for 09:00–17:00; UPS returns a request number (PRN). Cash on delivery isn't connected for UPS yet: in the UPS waybill, set “Return delivery (recipient)” to “Not required”.
    • FedEx — without your own hours, the request goes for 10:00–17:00; FedEx returns a confirmation code. You can print the FedEx label from Elbuz within 12 hours of creating the waybill, later — in FedEx Ship Manager. Cash on delivery isn't connected for FedEx yet.
    • Apaczka.pl — the courier is ordered for a parcel whose waybill was created from Elbuz; without your own hours, Elbuz takes the window Apaczka offers for the service on that date.

    To ship to a pickup point, fill in the point field in the waybill: DPD Pickup code, Poczta Polska point id, GLS ParcelShop id, ORLEN Paczka point code or, for Apaczka.pl, the point code of the service's carrier.

    If the order already has a point from the website, the field fills in itself. ORLEN Paczka delivers only to pickup points and parcel lockers, so without a point code the waybill won't be created.

    For ORLEN Paczka, points in the recipient's city appear under the field, and the point directory is updated daily; the GLS ParcelShop id is entered manually for now.

    How to create a waybill via Rozetka

    Today only Rozetka creates waybills through the source, and it uses the credentials of the import template the order came in with: Elbuz takes the API key or the seller account login and password from it, so you don't enter them in the waybill form.

    The carriers in the form are those Rozetka offers: Rozetka Delivery, Nova Poshta, Ukrposhta and Meest. If that template was deleted or recreated, Elbuz looks for any enabled Rozetka template.

    If it finds none, you see “Source import template not found — set the credentials” instead of the form. Then open the “Import” window (Operations → Data import), enable a Rozetka template or create a new one, enter the seller account credentials (see import from Rozetka) and click “Waybill via Rozetka” again.

    Justin and other carriers without a built-in waybill

    Elbuz shows the “Create waybill” link only for the delivery types listed above — for Justin, a courier company or pickup it isn't in the “Delivery” section, and you can't create a waybill from the order.

    Create the waybill in the carrier's account and enter its number in the “Delivery service: number” field in the “More fields” block of the “Delivery” section. From then on it works like a normal waybill number: the order leaves the “No waybill” quick filter, and if the delivery method has a “Tracking link”, a ready tracking link appears in the card in the “Delivery service: link” field.

    How the order status follows the carrier's status

    As the parcel travels, Elbuz asks the carrier for its status and moves the order to your status. This works for Nova Poshta, Ukrposhta, Meest, InPost, Rozetka Delivery, DHL24, GLS, DPD Polska, Poczta Polska, ORLEN Paczka, UPS, FedEx and Apaczka.pl, if the carrier record is enabled and has a key, and the order has that carrier's waybill number.

    GLS and DPD issue separate credentials for tracking. For GLS it's a GLS Track&Trace API user, which your GLS representative provides; the login goes into the “GLS Track&Trace API login” field and the password into “Token”. For DPD it's DPDInfoServices access: the login and channel go into their own fields of the DPD Polska record, the password into “Token”.

    GLS status codes are the number before the dot in the event code: 3 — delivered, 4 — not delivered, 5 — returned to sender, 11 — parcel with the courier.

    Poczta Polska answers status requests through shared access, so no separate key is needed. If you have many orders, Poczta Polska issues its own access to the tracking service: the login goes into the “Poczta Polska tracking service login” field, the password into “Token”.

    Poczta Polska status codes are event codes: P_NAD — sent, P_D — delivered, P_OWP — received at a point, P_OWU — received at a branch, P_A — notice left.

    You set it up in the carrier record: “System settings” → “Other settings” → “External services and integrations” → the carrier.

    1. In the “Order statuses for which to check the parcel status with the delivery service” block, check the statuses in which an order waits for delivery, for example “Shipped”. The status changes only in orders with checked statuses; Elbuz also polls the waybills of other orders from the last 60 days, but only for the “Shipments” register.
    2. In the “Notification settings” block, open “Order statuses” and, in the “Code (name) on site (API)” column next to your status, enter the carrier's status codes separated by commas. Do the same in “Delivery statuses” for the order's delivery status, and in “Payment statuses” for the payment status — for example, when the carrier reports that the cash on delivery was received.
    Nova Poshta setup: order statuses to check and notification settings
    1Order statuses to check
    2Order statuses button
    3Delivery statuses button
    4Payment statuses button
    1. Order statuses for which Elbuz checks the parcel status with the delivery service — tick the ones you need.
    2. Order statuses — configure notifications for order status changes.
    3. Delivery statuses — configure notifications for delivery status changes.
    4. Payment statuses — configure notifications for payment status changes.

    Then the “Checking delivery status” background job takes up to 100 waybills per carrier record every 10 minutes, starting with those not checked for the longest time, and requests their status.

    If the carrier's code is in your list and the order has a different status, Elbuz changes the order status, delivery status and payment status and writes to the operation log “Delivery status has changed: ‹code› ‹name› #‹waybill number›”, and for payment — “Payment status has changed”.

    What won't happen. A carrier code that isn't in any row doesn't change the order status. Justin and carriers whose number is entered manually aren't polled.

    Where the parcel is after the waybill is created, how long it has been waiting at the branch and whether the cash on delivery has arrived — see the “Shipments” register. Registers, returns, redirection and changing Nova Poshta waybill details are covered in Nova Poshta in Elbuz.

    Scenarios

    Ship an order with Nova Poshta under your own contract

    What to do. In the “Delivery” section, choose the “Nova Poshta” delivery type, check the recipient in “More fields” and click “Create waybill”.

    What you get. The waybill is created immediately, without a warning, and Elbuz shows “Waybill created, No.‹number›”. “View waybill” replaces the button.

    An order from Rozetka

    What to do. Click “Waybill via Rozetka” and fill in the number of parcels, weight and dimensions.

    What you get. Elbuz asks whether to create the waybill and creates it with the import template's credentials: at the end, “Waybill created: ‹number›”.

    Shipping with Justin

    What to do. Create the waybill in your Justin account and enter the number in the “Delivery service: number” field in “More fields”.

    What you get. The order leaves the “No waybill” quick filter, and if the delivery method has a “Tracking link”, a tracking link appears in the card.

    What to do when something goes wrong

    Common problems
    What you seeWhyWhat to do
    “The order already has a waybill number” A carrier waybill has already been created for this order Open “View waybill”; the waybill can only be canceled in the carrier's account (waybill)
    “A waybill cannot be issued through the source for this order” The system the order came from doesn't create waybills Create the waybill under your own contract with the “Create waybill” button (three ways)
    “Source import template not found — set the credentials” The import template the order came from Rozetka with no longer exists, and there's no other active Rozetka template with credentials Enable or create a Rozetka template in the “Import” window (Operations → Data import) and enter the seller account login and password in it (waybill through the source)
    “Failed to create the waybill:” followed by the carrier's text The carrier rejected the request Read the carrier's text: usually recipient details or weight and dimensions are missing (waybill form)

    FAQ

    Can I create a waybill for an order again?

    No. Once it's created, “View waybill” replaces the button, and a second attempt gets “The order already has a waybill number”.

    Can I cancel a waybill from Elbuz?

    No. The waybill is created by the carrier's external system, and it can only be canceled in that carrier's account — one by one.

    Where do I find the waybill number to send to the customer?

    In the “Delivery service: number” field of the “Delivery” section, “More fields” block. The “Send” button in the card header sends an email, SMS or messenger message.

    How do I find orders that don't have a waybill yet?

    Click the “No waybill” card in the stats bar above the list — only orders without a waybill number stay in the list.

    Where do I get a Nova Poshta API key?

    In the Nova Poshta business account: Settings → Security → My API keys → Create key. Paste the key into the “Token” field of the Nova Poshta record in “External services and integrations” (step by step).

    Who pays for the waybill?

    You do — to the carrier, at its rates; Elbuz doesn't charge anything for the waybill. Who pays for delivery when creating Nova Poshta waybills in bulk — see waybills in a batch.

    Where it is and who has access

    Menu
    Directories → Documents → Orders → order card → “Delivery” section
    Other entry points
    “Create waybill (shipping)” in the selected rows bar and in the row menu
    Access right
    a separate right for the carrier waybill window
    Prepare
    the delivery type in the order, recipient details in “More fields”, weight and dimensions

    The waybill window has its own access right on purpose: the operation can't be undone and costs money, so you can close it to people who are allowed to do everything else with orders.

    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