↑↓ selectEnter openEsc close

    1. Elbuz

    Parcel tracking: where a parcel is, how long it has waited at the pickup point, whether the COD money has arrived

    19 min readUpdated

    Elbuz tracks parcels from all carriers in one register: every 10 minutes it asks Nova Poshta, Ukrposhta, Meest and the other carriers where each waybill is. No Nova Poshta account needed for daily control.

    When you need this:

    • Customer doesn't pick up — the “Storage ≤ 2 days” tile collects parcels soon going back.
    • Customer refused — the “Refused” filter shows them with the carrier's reason.
    • Picked up, but no money — the “COD transfers on the way” tile totals what hasn't arrived.
    • Evening handover — the Nova Poshta registry and labels print from checked rows.

    Where to start: the “Shipments” window → the “Storage ≤ 2 days” tile.

    What the shipments register does

    • Parcels at the pickup point — how many days a parcel has waited and the date it is kept until; those going back within 2 days are at the top in red.
    • Cash on delivery — the amount waiting to be transferred and a “transfer received”, “transfer pending” or “not collected” mark on each row.
    • Refusals and problems — in separate filters, with the carrier's non-delivery reason.
    • All carriers in one table — Nova Poshta, Ukrposhta, Meest, Rozetka Delivery, InPost, Polish carriers and DHL Germany.
    • Parcel actions — SMS to the recipient, printing, tracking on the carrier's site; for Nova Poshta also the registry, labels, redirect, return and waybill changes.
    • Statuses without your involvement — every 10 minutes, or right away with the “Refresh statuses” button.

    Where statuses come from and why the register is empty

    Elbuz gets each parcel's status from the carrier using your API key. The “Checking delivery status” background task runs every 10 minutes.

    Each pass takes up to 100 waybills per carrier connection record, the longest unchecked first, and writes the state, pickup point, storage end date, cash on delivery amount and transfer to the order.

    Elbuz polls a waybill if all of the following are true:

    • it is a customer order with a waybill number — created in Elbuz or entered manually, with this carrier's delivery method (Nova Poshta and Ukrposhta numbers from the old modules are polled with any delivery method);
    • the carrier record in “External services and integrations” is enabled and has a key (for Meest — a login and password); a record linked to a company polls only that company's orders;
    • the order was created no more than 60 days ago and the parcel hasn't reached its final state yet — or the order has a status checked in the carrier record under “Order statuses for which to check the parcel status with the delivery service”.
    Three checks decide whether Elbuz finds out where a parcel is; the 60 days count from the order date, not the waybill date
    NoYesYesNoYesNoIs the carrier record enabled anddoes it have a key?The carrier isn't polled — the statefollows your delivery status, or “Nottracked”Is the order in a status checked inthe carrier record?The waybill is queued for pollingWas the order created no more than60 days ago, and the parcel hasn'treached its final state?Not polled — the register keeps thelast known stateEvery 10 minutes — up to 100waybills per carrier record, thelongest unchecked first
    • Action or result
    • Decision: the path depends on the answer

    The 100-waybill queue also includes all orders in checked statuses — with no 60-day limit. With more waybills, a full round takes several passes: about 600 waybills an hour per connection record, so a parcel just arrived at the pickup point may show “In transit” for a while. To skip the wait, click “Refresh statuses”.

    Nova Poshta returns the storage end date only together with the sender's or recipient's phone. Elbuz uses the first one it finds: from the waybill data, the carrier record, the delivery phone, the order phone, your company phone.

    Polling doesn't always change the order status. Elbuz changes the order, delivery and payment status only for orders in checked statuses, using the codes you entered in the carrier record (more: order status from the carrier status). For other orders, the register shows the parcel state and the status stays yours.

    Refresh statuses now

    The “Refresh statuses” button runs the same pass out of turn: up to 100 waybills per carrier record, the longest unchecked first — not necessarily the ones on screen.

    While the request runs, you see “Requesting statuses from carriers…”; when done — “Statuses updated”, the table reloads and row checkmarks are cleared.

    Clicking again is safe. The pass doesn't just read statuses: for orders in checked statuses it changes the order, delivery and payment status and runs your automatic actions, like the background task — but only when the carrier status has really changed, so a repeat doesn't duplicate anything.

    How to read the register: state, tiles, filters, columns

    The window opens on the “Active” filter (what it includes). At the top are parcels at the pickup point, nearest storage end first; then problems, refusals, parcels in transit, created waybills.

    The Shipments window with the Active filter, status tiles and the first rows
    1Quick filters with counters
    2Storage ≤ 2 days tile
    3State badge
    4Refresh statuses
    1. Filter parcels by state, each with a counter.
    2. Parcels going back within two days: click to show only them.
    3. Parcel state; hover to see the carrier's exact wording.
    4. Request statuses from the carriers out of turn.

    Parcel state

    Hover over the “State” badge to see the carrier's exact status, as in the “Carrier status” column.

    StateWhat is happening with the parcel
    CreatedThe waybill is created, the parcel hasn't been handed to the carrier yet
    In transitThe parcel is on its way or being sorted, including courier delivery
    At pickup pointThe parcel is waiting for the recipient, the storage period is running
    DeliveredThe recipient picked it up; if there was cash on delivery, the transfer may still be on the way
    RefusedThe recipient refused, the parcel is coming back to you
    ProblemThe carrier didn't find the number, delivery to the address failed, and so on
    UnknownThe carrier replied with a code Elbuz doesn't know
    DeletedThe waybill was deleted at the carrier
    Not trackedThe carrier hasn't replied about this waybill even once

    For Nova Poshta, the state comes from the carrier's code. For other carriers, it goes through your “Delivery statuses” table in the carrier record: carrier code → your delivery status → state; a code missing from the table gives “Unknown”.

    While the carrier is silent, the state comes from your order's delivery status; after the first reply — only from the carrier
    NoYesNoYesYesNoYesNoHas the carrier replied about thiswaybill yet?Does the order have a built-indelivery status — “On the way”, “Atdestination”, “Delivered” and so on?State from your delivery statusNot trackedIs it Nova Poshta?State from the Nova Poshta codeIs the carrier's code in the “Deliverystatuses” table of the carrier record?State from your tableUnknown — in the “Problems” filter
    • Action or result
    • Decision: the path depends on the answer

    Tiles above the table

    Clicking a tile filters the table, just like a filter.

    • At pickup point — parcels waiting for the recipient.
    • Storage ≤ 2 days — those of them that will go back within two days or are already going back; red when not zero.
    • In transit and Refused — the number of parcels in these states.
    • COD transfers on the way — the cash on delivery total for delivered parcels whose money hasn't arrived yet.
    • COD in active parcels — the cash on delivery total for all active parcels; this tile doesn't filter.
    • No status from carrier — waybills the carrier hasn't replied about even once.
    Filters, the seven tiles and the first table rows
    1Storage ≤ 2 days
    2COD transfers on the way
    3COD in active parcels
    4No status from carrier
    1. Red when parcels are about to be returned.
    2. Sum for received parcels whose money has not arrived yet.
    3. All COD in active parcels; it does not filter.
    4. Waybills the carrier has not answered about yet.

    Quick filters

    A row in the window header after the “Refresh statuses” button; whatever doesn't fit scrolls sideways. Filters at zero are hidden, except “Active” and “All”. While waybills are selected, actions take the place of the filters (what you can do with a parcel).

    FilterWhat it includes
    ActiveEverything except delivered and deleted, plus Nova Poshta parcels that are delivered while the COD transfer is still on its way
    At pickup pointThe “At pickup point” state
    Storage endingAt the pickup point, with 2 days or less until return
    In transitThe “In transit” state
    Not handed overThe “Created” state: the waybill exists, the carrier doesn't have the parcel
    RefusedThe “Refused” state
    ProblemsThe “Problem” and “Unknown” states
    COD transfer pendingNova Poshta reported “received, transfer still on its way”, and the money hasn't come yet
    DeliveredThe “Delivered” state
    AllAll orders with a waybill number

    Columns

    Visible by default: the “Open” and “SMS” buttons, order, state, waybill with a copy button, carrier (the carrier's name, not the site's delivery method), customer, city, pickup point, carrier status, “Days in transit”, “Arrived”, “Days at point”, “Storage until”, “Cash on delivery”, order total, shipping cost, “Non-delivery reason”, “Waybill created”, “Expected”, “NP registry”.

    Hidden columns are turned on in the window menu (☰) → “Column settings”: “Delivered at”, “Paid storage”, “COD received”, “Return waybill”, “Last movement”, “Checked”, “Order date”, “Order status”, “Payment”, “Phone”. Each column has a filter row; click a header to sort.

    “Days in transit” count from waybill creation to delivery, to arrival at the pickup point, or to today; empty until the carrier replies.

    Only Nova Poshta provides the waybill creation date; until it replies, and for other carriers, “Waybill created” is the order date. “Days at point” count from the first storage day while the parcel is waiting.

    Which parcels are at the pickup point and will soon go back

    Parcels about to go back are placed at the top and shown in red. Click the “Storage ≤ 2 days” tile — the table keeps the parcels at the pickup point with two days or less until return.

    The “Storage until” column shows the date the carrier gave and how much time is left:

    • “N days left” — a grey badge, red at two days or less;
    • “last day” — the parcel can still be picked up today;
    • “returning” — the date has passed, the parcel will go back.
    Parcels with storage ending: pickup point, arrived, days at point, storage until
    1Last day badge
    2Returning badge
    3Days at point
    4Arrived
    1. The parcel can still be picked up today.
    2. Storage has expired: the parcel goes back.
    3. How many days the parcel has already been waiting.
    4. The first day of storage.

    How long Nova Poshta keeps a parcel for free is up to Nova Poshta, and it also reports the date: Elbuz doesn't make it up but takes it from the carrier's reply. The paid storage cost is in the hidden “Paid storage” column. “Arrived” is the first storage day, “Days at point” is how long the parcel has been waiting.

    What you can do with a waiting parcel:

    • Remind the customer — “SMS to recipient” opens the same SMS window as the order card and fills in the recipient's phone from the order's delivery details.
    • The customer moved to another city — “Redirect” to another Nova Poshta branch (actions from the register).
    • The customer won't pick it up — “Return to sender” without waiting for storage to end.

    You can't extend storage from Elbuz — only in the Nova Poshta account or its app.

    Has the cash on delivery transfer arrived

    Elbuz takes the cash on delivery amount from Nova Poshta — both for “Payment Control” and for a regular money return delivery. The “Cash on delivery” column shows the amount and its current state:

    MarkWhen it appears
    transfer receivedThe carrier reported the transfer amount or that the money has been transferred
    transfer pendingNova Poshta reported “received, transfer still on its way”, and the money hasn't come yet
    not collectedThe recipient refused, the money won't come
    no markThe parcel is still in transit or at the pickup point — or it's delivered, but the carrier reported nothing about the transfer
    The Cash on delivery column with transfer received, transfer pending and not collected badges
    1transfer received
    2transfer pending
    3not collected
    1. The carrier reports the money has been transferred.
    2. Received, but the transfer is still on its way.
    3. Refused: the money will not arrive.

    The “COD transfers on the way” tile adds up all parcels marked “transfer pending”; clicking it applies the “COD transfer pending” filter.

    A Nova Poshta parcel in the “received, transfer still on its way” state stays among the “Active” ones and keeps being polled until the carrier reports the money was transferred.

    A regular delivery without that mark is a final state: Elbuz no longer polls such a parcel unless the order is in a status checked in the carrier record (those orders are polled even after the final state). The transfer amount is in the hidden “COD received” column.

    Refusals and problem parcels

    Elbuz sees a refused Nova Poshta parcel at the next poll, and the row gets the “Refused” state. The “Refused” filter collects these parcels; the carrier's reason is in the “Non-delivery reason” column, the return waybill number — in the hidden “Return waybill” column.

    The “Problems” filter collects two states. “Problem” — the carrier didn't find the number or couldn't deliver to the address. “Unknown” — the carrier replied with a code Elbuz didn't recognize.

    Many Ukrposhta, Meest or Polish carrier parcels in the “Unknown” state don't mean a problem with the parcels — they mean an empty “Delivery statuses” table in the carrier record. Enter the carrier's codes next to your delivery statuses — from the next poll the state will be correct (where to enter the codes).

    The hidden “Last movement” column shows when the parcel's status last changed, and “Checked” — when Elbuz last asked the carrier. A parcel stuck “In transit” for a long time stands out by an old “Last movement” date.

    What you can do with a parcel right from the register

    Check a row on the left — the quick filters in the header give way to a badge with the order and waybill number, action buttons and a “Clear selection” cross that brings the filters back. With several rows checked, you see “Selected: N” and only the actions for multiple waybills. Double-click a row to open the order card; click the customer to open their card.

    Header with the selected waybill and action icons, plus the selected row
    1Selected waybill
    2Track on carrier site
    3Add to Nova Poshta registry
    4Redirect
    5Return to sender
    1. Which waybill is selected.
    2. The carrier's tracking page with the number.
    3. Hand over several parcels with one registry.
    4. To another Nova Poshta branch.
    5. A paid request to return it to you.
    ActionFor which waybillsWhat happens
    Open orderOne, any carrierThe order card
    SMS to recipientOne, any carrierThe SMS window, as from the order card; the number is the order's delivery phone or, if there's none, the one from the customer card
    Print waybillOne, a carrier with a built-in waybill and a key; several — Nova Poshta onlyThe carrier's print form in a new tab; for Nova Poshta — an A4 express waybill form, for several — all forms in one PDF. If printing is impossible before the request (no key or number), a toast shows the reason; if the carrier itself refuses, the tab opens with the reason
    Track on carrier siteOneThe carrier's tracking page with the number: Nova Poshta, Ukrposhta, InPost, DHL Germany; for Meest — the page without the number
    Add to Nova Poshta registryOne or several, Nova PoshtaThe waybills go into the open registry or a new one for today; the registry number appears in the “NP registry” column and the order history. After “Add” — the “Print registry” button and label buttons in both formats
    Print labelsOne or several, Nova PoshtaChoice of format: “Labels on A4 (6 per sheet, 85×85)” or “Labels for thermal printer 100×100”; a PDF with labels for all checked waybills
    RedirectOne, Nova PoshtaA request to deliver to another branch
    Change waybill detailsOne, Nova PoshtaA request to change the recipient's name and phone or the payer
    Return to senderOne, Nova PoshtaA request to return the parcel to you
    Call a courierOne or several, Nova PoshtaA request to collect the parcels from your address: date, time slot, address, planned weight
    Delete waybillOne, Nova Poshta, “Created” stateThe waybill is deleted at Nova Poshta, the number disappears from the order — it can be shipped again

    Nova Poshta operation buttons appear only when the Nova Poshta record has a key. For Ukrposhta, Meest and other carriers, the register offers tracking, printing and SMS. Whether Nova Poshta allows an operation for this particular waybill shows as soon as the form opens: the carrier checks it with the first request.

    In the redirect and return forms, the “Calculate” button doesn't submit anything — it shows the cost and estimated date. The second button creates the request after confirmation; it also writes to the order history, for example “Return to sender requested for waybill ‹number›, request ‹number›”.

    The Return to sender panel with the calculated cost
    1Return to
    2Reason
    3Cost block
    4Request return
    1. The return address from your Nova Poshta account.
    2. The Nova Poshta reason list.
    3. Only a calculation: nothing has been created yet.
    4. Creates a paid request that cannot be cancelled from Elbuz.

    Return and redirect are paid Nova Poshta services at its rates. You can't cancel a request from Elbuz, only in the Nova Poshta account.

    Registries, courier calls and account waybills

    Window menu (☰) → “Nova Poshta registries” shows your account's registries marked “printed” or “open”, prints them and disbands them. Once a registry is printed, you can't add waybills to it. A disbanded registry disappears, the waybills stay, and the “NP registry” column in their orders is cleared.

    A registry is shared by the whole Nova Poshta account and holds every manager's waybills, so only users who see all orders have this menu item.

    With a restricted “Data scope”, “Add to Nova Poshta registry” puts waybills only into a new registry, and you can print only a registry that holds your order; otherwise — “Nova Poshta registries are managed by staff who can see all orders: a registry holds waybills of the whole account.”

    The same menu has “Courier calls” for the last 7 days and “Nova Poshta account waybills”: waybills created in the account outside Elbuz, which you can link to an order. These items, too, are only for users who see all orders.

    How registries, returns, redirects and detail changes work at Nova Poshta — Nova Poshta in Elbuz.

    The Nova Poshta registries panel with an open and a printed registry
    1open badge
    2printed badge
    3Disband
    1. Waybills can still be added to an open registry.
    2. After printing the registry is closed for adding.
    3. Disband: the registry disappears, the waybills stay.

    Scenarios

    A morning check instead of the Nova Poshta account

    What to do. Open “Shipments” and click the “Storage ≤ 2 days” tile. For each row — “SMS to recipient”.

    What you get. In a few minutes, customers whose parcels go back in the coming days get a reminder; the other parcels at the pickup point are on the “At pickup point” tile.

    The customer moved to another city

    What to do. Check the parcel → “Redirect”, start typing the city, choose the branch and who pays, click “Calculate”, then “Request redirect”.

    What you get. Nova Poshta receives the request, Elbuz shows “Redirect request created: ‹number›”, and the order history gets a redirect entry.

    Reconcile cash on delivery before the weekend

    What to do. Click the “COD transfers on the way” tile, turn on the “Delivered at” and “COD received” columns.

    What you get. All delivered parcels whose money hasn't arrived yet, with the delivery date. A parcel picked up long ago with no transfer is a reason to contact Nova Poshta.

    Evening parcel handover at the branch

    What to do. The “Not handed over” filter → check the Nova Poshta waybills → “Add to Nova Poshta registry” → “Add”, then “Print registry” and labels — “Labels on A4 (6 per sheet, 85×85)” or “Labels for thermal printer 100×100”.

    What you get. One registry for all parcels instead of a separate waybill for each; the registry number is in the “NP registry” column.

    Stop checking manually

    What to do. First set up automatic statuses: check the order statuses in the carrier record and enter the carrier's codes in “Delivery statuses” (how to do it). Then in “Tickets”, turn on the problems “parcel is waiting at the branch, not picked up”, “parcel refused / returning to sender” and “cash on delivery not received after delivery”, and in automatic actions — an SMS on delivery status change.

    Why. The SMS and two of the three problems are triggered by the order's delivery status, which Elbuz changes only for orders in checked statuses. Without automatic statuses, only a refused Nova Poshta parcel works: Elbuz recognizes it by the carrier's code.

    What you get. The customer gets a message when the parcel arrives, and the manager gets a ticket when a parcel waits too long or the money doesn't come (problem orders).

    What to do when something goes wrong

    Common problems
    What you seeWhyWhat to do
    All rows are “Not tracked”, the “No status from carrier” tile equals the number of parcels The carrier record has no API key or is disabled Window menu → “Delivery services”, enter the key in the carrier record (Nova Poshta key)
    Statuses don't update at all, “Checked” hasn't changed for a long time, although the key is entered The “Checking delivery status” background task is turned off in the schedule Turn the task on in the schedule (schedule and task queue); until then — the “Refresh statuses” button
    The parcel is already at the pickup point, but the register shows “In transit” Statuses come every 10 minutes, 100 waybills per carrier record; the waybill is waiting its turn Click “Refresh statuses” or wait; the last check time is in the “Checked” column (how polling works)
    An old parcel hasn't changed state for a long time The order was created more than 60 days ago and isn't in a status checked in the carrier record — it is no longer polled Check the order status in the carrier record, or check the parcel with the “Track on carrier site” button
    The parcel is “At pickup point”, but “Storage until” is empty Nova Poshta returns the date only with a phone, and neither the order nor the carrier record has one Enter the recipient's phone in the order or the sender's phone in the Nova Poshta record
    Ukrposhta, Meest or Polish carrier parcels are “Unknown” The carrier's code is missing from the “Delivery statuses” table in the carrier record Enter the carrier's codes next to your delivery statuses (where to enter the codes)
    No “Redirect” or “Return to sender” buttons Several rows are checked, the waybill isn't Nova Poshta, or the Nova Poshta record has no key Check one Nova Poshta row; for other carriers — the carrier's account (actions from the register)
    “The carrier is not connected or its API key is missing.” There's no enabled record of this carrier with a key at all — neither for the order's company nor for another one Window menu → “Delivery services”, enable the carrier record and enter the key
    “The carrier does not allow changing this waybill.” Nova Poshta doesn't allow changing this waybill in its current state Check in the Nova Poshta account or with Nova Poshta support
    “You have no access to this shipment.” The order is outside your “Data scope” Ask the order's manager or an administrator to do it (who has access)
    “This carrier has no public tracking page.” Elbuz doesn't know a tracking page for this carrier Copy the number with the button next to the waybill and check it in the carrier's account

    FAQ

    How long does Nova Poshta keep a parcel, and where can I see it?

    Nova Poshta sets the period and reports it as a date — it's in the “Storage until” column with an “N days left” hint. The paid storage cost is in the hidden “Paid storage” column.

    Can I extend parcel storage from Elbuz?

    No. Extending storage, redirecting to an address and returning to another branch — only in the Nova Poshta account. From the register, you can redirect to another branch and return to sender.

    Why isn't a waybill created in the Nova Poshta account in the register?

    The register shows only customer orders with a waybill number. Window menu → “Nova Poshta account waybills” finds such waybills and links them to an order — the parcel appears and is polled on the next pass.

    Can I cancel a return or redirect request?

    Not from Elbuz — only in the Nova Poshta account. So click “Calculate” and check the cost before submitting.

    Do the registry and returns work for Ukrposhta or Meest?

    No. For them, the register shows the state, prints the waybill, opens the tracking page and sends SMS. Waybill operations are for Nova Poshta only.

    Does the register change my order statuses by itself?

    No. The order status changes only for orders in checked statuses, using the codes you entered in the carrier record (automatic status).

    How much does parcel tracking cost?

    Elbuz charges nothing for polling carriers. You pay only for the carrier's own services — Nova Poshta charges for returns and redirects at its rates.

    Where it is and who has access

    Menu
    Directories → Documents → Shipments
    Access right
    the “Shipments” window in group permissions; initially open to everyone who has “Orders”
    Prepare
    a carrier record with an API key in “External services and integrations”

    A manager sees parcels only for orders they see in “Orders” under “Data scope”. Actions have the same limit: you can't return or redirect someone else's parcel from the register. A Nova Poshta registry is shared by the whole account, so with a restricted “Data scope” waybills go only into a new registry, and you can print only one that holds your order (Nova Poshta registries).

    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