↑↓ selectEnter openEsc close

    1. Elbuz
    2. Delivery services in Elbuz

    Poczta Polska in Elbuz: Pocztex shipments via e-Nadawca

    4 min readUpdated

    Elbuz creates a Pocztex Kurier shipment from an order via e-Nadawca: the parcel joins your zbiór (shipment batch), the number goes to the order at once, the label prints from the card.

    When you need this:

    • You ship by Pocztex courier — the address comes from the order.
    • The customer pays on delivery — the amount comes from the order; the payout account is set once.
    • Many parcels a day — call a courier from “View waybill”.
    • Where's the parcel? — the status updates in the order and “Shipments”.

    Where to start: create a WebAPI user in e-Nadawca → enter the login and password in Elbuz.

    What Poczta Polska does in Elbuz

    • Pocztex Kurier shipments — to an address or a pickup point, with cash on delivery to your account.
    • PDF label — from the order card and from the “Shipments” register, until the zbiór is sent.
    • Courier pickup — on the date and hours you specify.
    • Parcel statuses — every 10 minutes; an order in a checked status moves to your status automatically.

    How to connect Poczta Polska: an e-Nadawca WebAPI user

    What you need from Poczta Polska

    Elbuz works through the Elektroniczny Nadawca (e-Nadawca) WebAPI. Poczta Polska requires registration and a contract for it.

    1. Register at e-nadawca.poczta-polska.pl and sign a contract with Poczta Polska.
    2. In e-Nadawca, open “Ustawienia” (Settings) → “Lista użytkowników” (User list) and create a user for Elbuz with shipping rights.
    3. Save its login and password: you'll enter them in Elbuz.

    After 30 days, e-Nadawca recommends changing the password. If you change it, update it in Elbuz too. To make the change optional for the integration, ask Poczta Polska to configure this for your account.

    Where to enter the credentials in Elbuz

    Where: “External services and integrations” → “Delivery” group → “Poczta Polska (Pocztex)”.

    1. Turn on “Active”.
    2. Enter the WebAPI user's login in “User” and the password in “Password”.
    3. Choose the “Default Pocztex size”.
    4. For cash on delivery, enter the “Bank account for cash on delivery (NRB)”.
    5. Leave the “Zbiór number” empty if parcels should go into the active zbiór.
    Poczta Polska (Pocztex) connection form: e-Nadawca login fields, Pocztex parameters and the Sender block
    1User and Password
    2Bank account for cash on delivery (NRB)
    3Zbiór number
    4Tracking service login
    5Sender hint
    1. User and Password — the Elektroniczny Nadawca WebAPI login and password.
    2. Bank account for cash on delivery (NRB) — the account that receives cash-on-delivery payments.
    3. Zbiór number — leave empty to use the active zbiór.
    4. Poczta Polska tracking service login — your own access for tracking many orders.
    5. Sender — if empty, e-Nadawca takes the address from the sender profile.

    You can leave the “Sender” block empty: e-Nadawca then takes the address from the sender profile. Elbuz sends its own address only if the company name and postcode are filled in. To call a courier, you need the name, postcode, city and street.

    The form saves itself whenever a field changes. The login and password aren't checked when saved: the first waybill will show an error.

    “Sandbox environment” switches Elbuz to the e-Nadawca test server. Its login and password are separate from the production ones.

    Parcel size

    Pocztex Kurier sizes
    SizeMaximum dimensionsWeight
    S9 × 40 × 65 cmup to 20 kg
    M (default)20 × 40 × 65 cmup to 20 kg
    L42 × 40 × 65 cmup to 20 kg
    XL60 × 60 × 70 cmup to 20 kg
    2XLsum of sides up to 250 cm, length up to 120 cmup to 50 kg, over 30 kg — with a surcharge

    The waybill form fills in the size from the carrier record itself. For a parcel of another size, choose it in the form's “Size (max. dimensions, cm)” field — you don't need to change the carrier record.

    How to ship an order with Pocztex

    Where: order card → “Delivery type” = “Poczta Polska (Pocztex)” → “Delivery” section → “Create waybill” (“Edit waybill” if the form has been opened before).

    The form takes the last name, first name, phone, email, postcode, city and street from the order. Required: last name or first name, phone, postcode, city and street; without a weight, Elbuz sends 1 kg. Recipients — only in Poland.

    Waybill window for Poczta Polska (Pocztex) with recipient, address, shipment parameters and cash on delivery
    1Address block
    2Pickup point id
    3Parcel size
    4Cash on delivery
    5Create waybill
    1. Address — the block for door-to-door delivery to the recipient's address.
    2. Poczta Polska pickup point (id) — fill it in to deliver to a pickup point instead of the address.
    3. Size — the size of this parcel, taken by default from the delivery service record.
    4. Cash on delivery (recipient) — with Money selected, the recipient pays the amount on receipt.
    5. Create waybill — sends the request to Poczta Polska (not pressed while shooting).

    Delivery to a pickup point

    To have the parcel wait for the customer at a pickup point, enter the point's numeric id in the “Poczta Polska pickup point (id)” field. Elbuz has no list of Poczta Polska points: the id comes from the order or is entered manually.

    Points are Poczta Polska post offices, Pocztex parcel lockers and Żabka, Groszek, Lewiatan, ABC and other chain stores. A parcel waits at a post office for 7 days after the notice, at a point — 3 days, in a locker — 72 hours. Then it goes back to the sender at the sender's expense.

    Cash on delivery

    “Return delivery (recipient)” is set to “Money” if the order isn't paid and payment is on delivery. The amount is the order total without currency conversion: if the order isn't in złoty, enter the amount in zł manually. The money goes to the NRB account from the carrier record.

    The maximum cash on delivery amount depends on your contract; at points and lockers — on the point's limit. Partner stores don't accept cash on delivery: only Poczta Polska post offices and Pocztex lockers do.

    What happens after “Create waybill”

    1. Elbuz checks that the order doesn't have a number yet and that the required fields are filled in.
    2. It adds the shipment to the active e-Nadawca zbiór or to the zbiór with the number from the carrier record.
    3. It writes the shipment number to the “Delivery service: number” field — Poczta Polska returns it immediately.

    Elbuz sends the order number as the customer reference for the shipment (up to 25 characters); e-Nadawca doesn't receive the “Shipment description”.

    Zbiór: without it, the parcel won't ship

    A zbiór is a batch of shipments prepared for handover. Elbuz only adds parcels to it; you send the zbiór to the post office in e-Nadawca: “Przekaż dane do Poczty” (Send data to the post office) → “Przekaż zbiory” (Send batches).

    Until the zbiór is sent, Poczta Polska doesn't know about the parcel. The shipping date is set on the day the zbiór is sent, so send it on the day you hand over the parcels.

    Printing and deleting a label

    “Print” next to the number in “View waybill” or “Print waybill” in “Shipments” opens the PDF label. Elbuz finds the shipment in the zbiór by its number and downloads the label itself.

    After the zbiór is sent, Elbuz can no longer find the label — print it in e-Nadawca.

    You can't delete a shipment from Elbuz. Remove it from the zbiór in e-Nadawca before sending, and clear the number in the “Delivery service: number” field — then you can create the waybill again.

    How to call a Poczta Polska courier

    Where: order card → “View waybill” → “Courier pickup” block.

    1. Check the “Pickup date” — by default, the next business day.
    2. Set “Pickup from” and “to”, or leave them empty — then the request goes for 08:00–20:00. e-Nadawca accepts only 08:00–20:00 or two-hour windows from 08:00–10:00 to 18:00–20:00, no earlier than the current hour.
    3. Enter “Parcels, pcs” and “Total weight, kg”, then click “Order a courier”.

    The pickup address is the “Sender” block of the carrier record. Poczta Polska doesn't return a request number: the window shows “Courier ordered”, and the post office sends a confirmation to the email in the “Sender” block, if it's filled in. The result is written to the order log.

    How Elbuz tracks the parcel

    Every 10 minutes, Elbuz queries the Poczta Polska tracking service one number at a time and takes the latest event: its code and name in Polish. The service only sees parcels with an event in the last 30 days.

    Without its own access, Elbuz uses Poczta Polska's shared access for occasional requests. If you have many orders, request your own access with the “Wniosek o utworzenie konta WSDL/SOAP” (WSDL/SOAP account request) form on the tracking service page. Enter the login in “Poczta Polska tracking service login” and the password in “Token”.

    Elbuz enters the event codes from the table below into the “Delivery statuses” window of the Poczta Polska record itself — “Shipments” shows the parcel state by them. A code outside the table gives the state “Unknown”. How the code windows work is covered in the article on carrier statuses.

    Poczta Polska event codes for the “Delivery statuses” window
    Elbuz delivery statusPoczta Polska codesWhat it means
    On the wayP_NADparcel shipped
    At destinationP_A, P_KWDnotice left; ready for pickup at the post office
    DeliveredP_D, P_OWP, P_OWUdelivered; picked up at a point; picked up at the post office
    RefusedP_ZZPreturned from the point

    The full list of codes is in the Poczta Polska event list (PDF). The post office recommends matching by code: event names may change.

    “Track on carrier site” in “Shipments” opens the search page poczta-polska.pl/sledzenie-przesylek: Poczta Polska doesn't publish a link with the number, so you enter the number in the field manually. The customer tracks the parcel there too.

    Scenarios

    A regular shipping day

    During the day, create waybills from orders and print labels. In the evening, send the zbiór in e-Nadawca and call a courier from “View waybill” of any of the day's waybills.

    Orders paid on delivery

    Enter the NRB account in the carrier record once. After that, for an unpaid order with payment on delivery, the form sets “Money” and the order total itself.

    What to do when something goes wrong

    Common problems
    What you seeWhyWhat to do
    “The delivery service is not connected: fill in its API settings…” The record has no password, or “Active” is off Enter the WebAPI login and password (where to enter them)
    “Error: login/password is required (API settings)” Only “Token” is filled in the record, or there's no login Enter the WebAPI login and password (where to enter them)
    “Error: bank account for COD is required (API settings)” “Money” is selected, but the record has no account for cash on delivery Enter the “Bank account for cash on delivery (NRB)” (cash on delivery)
    “Error: postcode is required for recipient” (or city, street) The order has no postcode, city or street Add the address in the form (shipment)
    “Error: ‹description› (‹error number›)” e-Nadawca rejected the shipment; the reason is in the description Fix the data according to the error text and create the waybill again
    The print tab shows “e-Nadawca: shipment … is not in the buffer (already sent?)” The zbiór has already been sent to the post office Print the label in e-Nadawca (printing)
    The state in “Shipments” is “Unknown” Poczta Polska codes aren't entered in “Delivery statuses” Enter the codes from the table (statuses)

    FAQ

    How much does the Poczta Polska integration cost?

    Elbuz doesn't charge anything for shipments, labels or statuses. You pay Poczta Polska for parcels under your contract.

    The order has a number, but the parcel isn't moving — why?

    Most often the zbiór hasn't been sent to the post office: until then, Poczta Polska doesn't see the parcel. Send it in e-Nadawca (zbiór).

    Can I choose a size for a single parcel?

    Yes: in the waybill form — the “Size (max. dimensions, cm)” field. By default, it has the size from the carrier record (size).

    Do I need separate access for tracking?

    No, Poczta Polska's shared access works without it. Request your own access if you ship many parcels (statuses).

    Can I ship Pocztex abroad?

    No, Elbuz creates Pocztex Kurier shipments only for recipients in Poland.

    Where to find it and who has access

    Menu
    Account → System settings → Other settings → External services and integrations → Delivery → Poczta Polska (Pocztex)
    Other entry points
    Directories → Documents → Shipments → “Delivery services”; order card → “Delivery” section
    Access right
    connection — “API & access tokens”; waybill and courier — “Delivery waybill creation”; parcels — “Shipments”
    Prepare
    a contract with Poczta Polska, an e-Nadawca account, a bank account number for cash on delivery
    1. Create a WebAPI usere-Nadawca
    2. Enter the login, password, account and sizeExternal services and integrations → Poczta Polska
    3. Create a shipmentOrder card, “Delivery” section
    4. Send the zbiór to the post officee-Nadawca
    5. Call a courierView waybill

    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