Elbuz creates a DHL Parcel Polska shipment from the order card, opens the PDF label and updates the parcel status every 10 minutes — no DHL24 sign-in per shipment.
When you need this:
- You ship in Poland under a DHL contract — the recipient, address, weight and cash on delivery (COD) come from the order.
- The customer pays on delivery — an unpaid order gets the COD amount itself.
- Morning delivery — choose Domestic 09 or Domestic 12 once in the connection.
- Managers lack DHL24 access — label and status open in Elbuz.
Where to start: get a WebAPI key in DHL24 → enter it in the Elbuz DHL record.
What DHL Parcel Polska does in Elbuz
- A waybill from an order — door-to-door delivery within Poland with cash on delivery and declared value, one at a time or in bulk.
- Label — a PDF from the order card or from “Shipments”.
- Deleting a waybill — until a courier has been ordered for the parcel.
- Parcel statuses — every 10 minutes; your code table changes the parcel state and the order status.
- Test environment — you can create your first waybills in the DHL24 sandbox.
Courier pickup, delivery to DHL points and editing waybills — in DHL24.
How to connect DHL24 WebAPI
Where to get a DHL24 WebAPI login and password
The WebAPI login and password are a separate key, not your DHL24 account sign-in. DHL issues keys only to customers with an active contract and a SAP number.
- Sign in to DHL24 with the account linked to the contract.
- Open the “Integracje” (Integrations) page, “Klucze APIv2 / API PS” (API keys) section: the key and password reset are there.
- If the section is empty, request access through the DHL24 support form with the subject “WebAPI - uzyskanie dostępu” (WebAPI access request).
The SAP customer number is the payer's seven-digit number under the contract. DHL invoices parcels sent from Elbuz to it.
To test without real shipments, register at sandbox.dhl24.com.pl: the sandbox issues a separate login and password. The WebAPI description is in the DHL24 documentation; you don't need it to work in Elbuz.
Where to enter the key in Elbuz
Where: “External services and integrations”, “Delivery” group → the “DHL Parcel (Польша, DHL24)” record.
1
User and password2
Client number (SAP)3
Default product4
Sandbox environment5
Sender- User and Password — the DHL24 WebAPI login and password.
- Client number (SAP) — your DHL24 customer number.
- Default product — the DHL service used when a waybill is created, here the domestic parcel (AH).
- Sandbox environment — sends requests to the DHL test server instead of the live one.
- Sender — the company and address printed on every waybill as the sender.
| Field | What to enter |
|---|---|
| “User”, “Password” | the WebAPI login and password |
| “Client number (SAP)” | the payer number from the contract; without it, the waybill won't be created |
| “Default product” | “Przesyłka krajowa (AH)” — standard delivery; “Domestic 09” and “Domestic 12” — delivery by 9:00 or by 12:00. “Connect (EK, international)” is in the list, but the recipient from Elbuz is always in Poland |
| “Sandbox environment” | turn it on for a sandbox key; turn it off for production |
| “Sender” block | name, postcode, city, street, house, contact person, phone, email; the first four are required |
| “Active” | turn it on |
The “Token”, “API server URL” and “API ver” fields aren't used for DHL. There's no “Save” button: every field change is saved immediately.
After saving, the password is shown as dots. An empty field doesn't erase it; to replace it, type the new one over it.
How to create a DHL waybill from an order
The order's delivery method must be “DHL Parcel (PL)”. With the “DHL” method, the “Create waybill” link doesn't appear.
Where: order card → “Delivery” → “Create waybill”. If the form has been opened before, the link is called “Edit waybill”.
What the form fills in itself and what to check
1
Recipient address2
Total weight, kg3
Declared cost, zł4
Shipment description5
Return delivery (recipient)- Postcode, City, Street and House — the recipient address, filled in from the order.
- Total weight, kg — the parcel weight, taken from the order.
- Declared cost, zł — the declared value of the parcel, taken from the order total.
- Shipment description — the text of the contents, built from the order items.
- Return delivery (recipient) — cash on delivery; “Not required” because the order is already paid.
| Field | Prefilled with | What to check |
|---|---|---|
| “Last name”, “First name”, “Phone”, “E-Mail” | the customer from the order | DHL won't accept a waybill without a phone |
| “Postcode”, “City”, “Street” | the delivery address from the order | “House” and “Apartment” are empty — fill them in if the number isn't in the street line |
| “Total weight, kg” | product weight × quantity | if empty, the waybill gets 1 kg |
| “Length”, “Width”, “Height”, cm | empty | if empty, 30 × 20 × 10 cm is sent |
| “Declared cost, zł” | the order total | DHL insures the parcel for this amount; a cleared field also gives the order total |
| “Shipment description” | the product category, or the list of products if there's none | required; DHL receives 100 characters |
| “Return delivery (recipient)” | “Money” for the order total if the order is unpaid and the payment is cash on delivery; otherwise “Not required” | if the customer paid by card but the payment isn't marked, set “Not required” |
Amounts in the form are in złoty. If the order is in another currency, correct the cash on delivery amount and declared value manually.
The form takes the sender, SAP number and product from the connection. The order number goes into the parcel as a reference; the recipient is always in Poland. The shipping date is today; on Saturday and Sunday — the next Monday.
What happens after “Create waybill”
- The DHL parcel number goes to the “Delivery service: number” field, and “Waybill created, No.‹number›” appears. DHL uses this number for tracking too.
- The card shows “View waybill” instead of “Create waybill”.
- A second waybill for the same order won't be created: “Waybill already exists: ‹number› — skipped.”
- If DHL refused, “Error:” appears with the reason; the form stays open, and its values are saved in the order.
- If the “Tracking link” is filled in for the “DHL Parcel (PL)” delivery method, the tracking link is also saved to the order.
Waybills for dozens of orders at once — “Create waybill (shipping)” in the order list; more: waybills in bulk.
Label and waybill view
Where: order card → “View waybill” → print button; or “Shipments” → row → “Print waybill”.
Elbuz gets the BLP label in PDF from DHL itself and opens it in a new tab; the WebAPI password never reaches the browser. If DHL refused, the tab shows “print error:” with the reason. In “Shipments”, DHL labels print one at a time.
“View waybill” asks DHL for the status every time: at the top — “Status:” with DHL's text, at the bottom — “Detailed information API” with the status code.
Deleting a waybill
Where: order card → “View waybill” → “Delete waybill”; or “Shipments” → row → “Delete waybill”. You need the right to create waybills.
- Confirm “Delete waybill ‹number› at the carrier?”.
- DHL deletes the parcel, the number and tracking link disappear from the card → “Waybill deleted. You can ship the order again.”
DHL deletes a parcel until a courier has been ordered for it (DHL24 documentation). Otherwise Elbuz shows “The carrier did not delete the waybill:” with DHL's reply — cancel the courier in DHL24 first. Elbuz doesn't offer to delete a parcel that tracking already shows as in transit or delivered.
DHL parcel statuses
Elbuz asks DHL about each parcel every 10 minutes, up to 100 parcels per pass. Orders from the last 60 days and orders in checked statuses are tracked. All parcels are visible in “Shipments”.
DHL status codes
Elbuz determines the parcel state by your code table. Elbuz doesn't enter DHL codes itself, and DHL doesn't publish a full list.
- After the first parcels, open “View waybill”: in “Detailed information API”, the StatusCode line is the DHL code, and Status is its description.
- DHL connection → “Notification settings” → “Delivery statuses”. In the “Code (name) on site (API)” column, enter the code next to your status; separate several codes with commas.
- To have the order or payment status change automatically, fill in “Order statuses” and “Payment statuses” the same way. Check the order statuses in the “Order statuses for which to check the parcel status with the delivery service” block.
| Your delivery status | State in “Shipments” |
|---|---|
| “Awaiting sender”, “Picked” | Created |
| “On the way”, “At customs”, “Handed to courier” | In transit |
| “At destination” | At pickup point |
| “Delivered”, “Partially delivered” | Delivered — Elbuz stops asking DHL about this parcel |
| “Refused” | Refused |
| no code entered | Unknown — the parcel goes to the “Problems” filter |
When the order status changes by code, “Delivery status has changed: ‹code› ‹text› #‹number›” is written to the order history. For DHL Parcel Polska, the “Track on carrier site” button replies “This carrier has no public tracking page.”
What stays in DHL24
- Editing a waybill — in DHL24; from Elbuz, you can only delete a waybill and create it again.
- Calling a courier — in DHL24 or through a regular pickup under the contract.
- Delivery to a DHL point or locker, and shipping abroad — Elbuz creates DHL parcels only to an address in Poland.
Scenarios
First connection through the sandbox
Situation. You've just signed a contract with DHL and want to test waybills without real parcels.
What to do. Register at sandbox.dhl24.com.pl, enter the test login and password, turn on “Sandbox environment” and create a waybill from a test order. Then enter the production login and password over the test ones and turn off the sandbox.
The result. You'll see errors in the sender address or SAP number before your first real shipment.
Daily shipping
Situation. In the morning, there are 30 orders with the “DHL Parcel (PL)” method.
What to do. Select them in the order list → “Create waybill (shipping)”. Then print the labels one at a time in “Shipments” and hand the parcels to the DHL courier.
The result. The parcel numbers are in the orders, and each parcel's state updates automatically.
A mix of cash on delivery and prepayment
Situation. Some orders were paid by card, others will be paid on delivery.
What to do. Mark the payment in the order before creating the waybill.
The result. Unpaid cash on delivery orders go with the cash on delivery amount, paid ones without it.
What to do when something goes wrong
| What you see | Why | What to do |
|---|---|---|
| “The delivery service is not connected: fill in its API settings…” in the waybill window | The password isn't entered, or “Active” is off | Enter the WebAPI login and password, turn on “Active” (where to enter them) |
| The order card has neither “Create waybill” nor “Edit waybill” | The delivery method is “DHL”, not “DHL Parcel (PL)” | Change the delivery method to “DHL Parcel (PL)” (a waybill from an order) |
| “Error: login/password is required (API settings)” | The WebAPI login isn't entered | Fill in “User” in the connection |
| “Error: account_number is required (API settings)” | The SAP customer number isn't entered | Fill in “Client number (SAP)” in the connection |
| “Error: sender address is required (API settings)” | The name, postcode, city or street in the “Sender” block is empty | Fill in the sender address in the connection |
| “Error: phone is required for recipient” (or postcode, city, street) | The order has no recipient phone or address | Enter them in the waybill form and create it again |
| “Error: content is required for shipment” | The “Shipment description” is empty | Enter what's in the parcel |
| “Error:” with an authorization failure from DHL | A wrong WebAPI key, or a sandbox key with “Sandbox environment” off, or the other way around | Check the key in DHL24 and the sandbox switch (WebAPI key) |
| DHL parcels in “Shipments” are in the “Unknown” state | DHL codes aren't entered in “Delivery statuses” | Enter the codes (status codes) |
| “Waybill already exists: ‹number› — skipped.”, even though the parcel was deleted in DHL24 | The parcel was deleted in DHL24, not from Elbuz, so the order still has its number | Clear the “Delivery service: number” field and create the waybill again; next time, delete from Elbuz (deleting) |
FAQ
How much does the DHL integration cost?
Elbuz doesn't charge anything for waybills or statuses. You pay DHL for parcels under your contract, to your SAP customer number.
Can I send a DHL parcel to a pickup point or locker?
Not from Elbuz — only to the recipient's address. A parcel to a DHL point is created in DHL24 or through Apaczka.
Can I ship DHL abroad?
No: in a waybill from Elbuz, the recipient is always in Poland. Create international parcels in DHL24.
Can I call a DHL courier from Elbuz?
No. Order a courier in DHL24 or arrange a regular pickup with DHL.
The password shows as dots in the form — is it saved?
Yes: the dots appear only when a password is saved. An empty field doesn't erase it.
Why does the status in Elbuz lag behind DHL?
Elbuz asks DHL every 10 minutes and takes up to 100 parcels per pass. “View waybill” shows the current status — it asks DHL every time.
Where to find it and who has access
- Menu
- Account → System settings → Other settings → External services and integrations → Delivery
- Other entry points
- Directories → Documents → Shipments → “Delivery services”; order card → “Delivery” section
- Access right
- connection — “API & access tokens”; waybill — the “Delivery waybill creation” window; parcels — “Shipments”
- Prepare
- a contract with DHL Parcel Polska, a SAP customer number, a WebAPI login and password
A waybill can be created only for an order the user can see under the “Data scope” setting.
- Get a WebAPI login and passwordDHL24 → Integracje
- Enter the key, SAP number and sender addressExternal services and integrations → DHL Parcel
- Enter DHL status codesSame place, “Notification settings”
- Create a waybillOrder card, “Delivery” section
- Print the label“View waybill” or “Shipments”
- Delete the waybill if needed“View waybill” or “Shipments”
Related topics
- If you need parcels from all carriers in one list — Shipments.
- If you need waybills for dozens of orders — waybills in bulk.
- If you don't have a DHL contract but need DHL parcels — Apaczka.
- If you ship with another carrier — how to create a waybill from an order.
