Elbuz creates a DPD Polska parcel from the order card, prints the label, orders a courier and updates the status every 10 minutes. No DPD account needed day to day.
When you need this:
- You ship in Poland under a DPD contract — recipient, address, weight and COD come from the order.
- The customer collects at a point — the DPD Pickup code goes into the waybill.
- No daily courier — order a pickup from the same waybill.
- Thermal printer — labels come in printer format, not A4.
Where to start: get DPDServices access from DPD → enter it in the DPD Polska record.
What DPD Polska does in Elbuz
- Waybill from an order — to an address or a DPD Pickup point, with COD, one at a time or in bulk.
- Label — a PDF on A4 or for a thermal printer, from the order card or from “Shipments”.
- Courier pickup — for the date and hours DPD offers for your postcode.
- Parcel statuses — every 10 minutes; your code table drives the parcel state and the order status.
You can't cancel or change a parcel from Elbuz — what stays in DPD.
How to connect DPD Polska
Where to get the login, password and FID
Elbuz works with DPD through the DPDServices web service. DPD sets up access for a customer on request — contact your DPD account manager.
- DPDServices login and password — for waybills, labels and courier pickup.
- FID customer number — your contract number; DPD accepts every request with it.
- DPDInfoServices access — login, password and channel for statuses. DPD issues it separately; without it, Elbuz tries to get statuses with the DPDServices access.
DPD has a demo environment for testing; the test credentials are published in the DPDServices documentation. The DPD page about web services is dpd.com/pl.
Where to enter the access in Elbuz
Where: “External services and integrations”, “Delivery” group → the “DPD Polska” record.
1
User and Password2
Customer number (FID)3
DPDInfoServices login and channel4
Thermal printer label5
Sender block- User and Password — your DPDServices access.
- Customer number (FID) — your DPD customer number.
- DPDInfoServices login and channel — separate tracking access; its password goes in the Token field.
- Label for a thermal printer (instead of A4) — switches the label format.
- Sender — the company and address printed on the waybill.
| Field | What to enter |
|---|---|
| “User”, “Password” | the DPDServices login and password |
| “Customer number (FID)” | the FID number; without it the waybill won't be created |
| “DPDInfoServices login”, “DPDInfoServices channel” | access for statuses; its password goes in the “Token” field |
| “Label for a thermal printer (instead of A4)” | turn on if you print on a label printer |
| “Sandbox environment” | turn on for DPD demo access; turn off for real work |
| “Sender” block | name, postcode, city, “Street and number” in one line, phone, email; without a phone you can't order a courier |
| “Active” | turn on |
“API server URL” and “API ver” are left empty for DPD. There is no “Save” button: each field change is saved right away. After saving, the password and “Token” show as dots; an empty field doesn't erase them.
How to create a DPD waybill from an order
The order's delivery method must be “DPD Polska”. With the “DPD” 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
Street, House, Apartment2
DPD Pickup point (code)3
Weight and dimensions4
Return delivery (recipient)- Street, House and Apartment — the recipient's delivery address.
- DPD Pickup point (code) — fill in to deliver to a pickup point.
- Total weight and the length, width and height fields describe the parcel.
- Return delivery (recipient) set to Money, with the amount to collect.
| Field | Filled in from the start | What to check |
|---|---|---|
| “Last name”, “First name”, “Phone”, “E-Mail” | the customer from the order | DPD won't accept a waybill without a phone |
| “Postcode”, “City”, “Street” | the delivery address from the order | “House” and “Apartment” are appended to the street: “Street House/Apartment”, up to 100 characters |
| “DPD Pickup point (code)” | the point the customer chose, if the order has one | a code like PL12345 — the parcel goes to the point, not to the address |
| “Total weight, kg” | product weight × quantity | if empty, 1 kg goes into the waybill |
| “Length”, “Width”, “Height”, cm | empty | DPD gets dimensions only if all three are filled in |
| “Shipment description” | the product category, or the list of products if there is none | DPD receives 300 characters |
| “Return delivery (recipient)” | “Money” for the order total if the order is unpaid and the payment is cash on delivery; otherwise “Not required” | 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 COD amount manually. The form takes the sender and FID from the connection; the recipient is always in Poland.
The order number is printed on the label as a reference.
Look up point codes on the blisko.dpd.com.pl map: Elbuz has no list of DPD points. COD to a DPD Pickup point is up to 6,500 zł, to an address up to 15,000 zł (DPD terms, section 15.2).
What happens after “Create waybill”
- The DPD parcel number goes into the “Delivery service: number” field, and you see “Waybill created, No.‹number›”.
- 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 DPD refuses, you see “Error:” with DPD's reason and its code in brackets; the form values are saved in the order.
- If the “DPD Polska” delivery method has a “Tracking link”, the tracking link is written to the order.
Waybills for dozens of orders at once — “Create waybill (shipping)” in the order list; more in bulk waybills.
Label and courier pickup
Where: order card → “View waybill”. At the top are “Status:” with DPD's text and the print button; below is the “Courier pickup” block. The window asks DPD for the status every time.
The print button opens the PDF label in a new tab: A4 or for a thermal printer, as set in the connection. The password never reaches the browser. In “Shipments”, DPD labels print one at a time: row → “Print waybill”.
Ordering a DPD courier
- In “View waybill”, check “Pickup date”: it's set to tomorrow, and on Friday and weekends to Monday.
- Leave “Pickup from” and “to” empty — Elbuz takes the first window DPD offers for the sender's postcode. Your own window can't start earlier than the current hour.
- Enter “Parcels, pcs” and “Total weight, kg” for all the parcels the courier collects.
- Click “Order a courier” → “Courier ordered #‹request number›”. The request number is saved in the order.
The courier comes to the address from the connection's “Sender” block. If DPD returns no windows for your postcode, Elbuz shows an error — then enter “Pickup from” and “to” yourself.
DPD parcel statuses
Elbuz asks DPD about each parcel every 10 minutes, up to 100 parcels per run. It tracks orders from the last 60 days and orders in the marked statuses. All parcels are visible in “Shipments”; the DPD status text is in Polish.
DPD status codes
Elbuz determines the parcel state from your code table and enters the DPD codes from the table below itself. A code is DPD's six-digit event code.
Where: DPD Polska connection → “Notification settings” → “Delivery statuses”, the “Code (name) on site (API)” column. Several codes — comma-separated.
1
Code column2
Delivered = 1901013
Refused = 230403,230408- Code (name) on site (API) — the DPD status codes mapped to each delivery status.
- Delivered is matched by code 190101.
- Refused is matched by two codes, 230403 and 230408.
| Your delivery status | DPD code | What it means |
|---|---|---|
| “Handed to courier” | 170101 | Wydanie przesyłki do doręczenia — the parcel is out for delivery with the courier |
| “Delivered” | 190101 | Przesyłka doręczona — delivered; Elbuz stops asking DPD |
| “Refused” | 230403, 230408 | the parcel is returning to the sender |
The codes come from the DPDInfoServices documentation. DPD doesn't publish a full list: you can see another code in “View waybill”, under “Detailed information API”, the StatusCode line. A parcel with a code that isn't in the table is “Unknown” in “Shipments” and falls into the “Problems” filter.
To have the order or payment status change by itself, fill in “Order statuses” and “Payment statuses” the same way. Mark order statuses in the “Order statuses for which to check the parcel status with the delivery service” block. The change is written to the order history: “Delivery status has changed: ‹code› ‹text› #‹number›”.
What stays in DPD
- Canceling a parcel. DPDServices has no cancellation of a parcel number, and you can't delete a parcel from Elbuz. If a parcel wasn't handed to the courier, simply don't send it. To create a new one, clear the “Delivery service: number” field in the order.
- Changing or canceling a courier request — in DPD.
- Shipping abroad — Elbuz creates DPD parcels only for recipients in Poland.
The “Track on carrier site” button in “Shipments” answers for DPD Polska with “This carrier has no public tracking page.”
Scenarios
First connection
Situation. DPD has issued a login, password and FID.
What to do. Enter them and the sender address with a phone, turn on “Active”. In “Delivery statuses”, enter 170101, 190101 and 230403, 230408, then create a waybill from the first order.
What you get. In “Shipments”, the parcel moves through “In transit” → “Delivered” without your involvement.
The customer chose a DPD Pickup point
Situation. The order has an address and a pickup point chosen on the website.
What to do. In the waybill form, check “DPD Pickup point (code)”. If it's empty, find the point on the DPD map and enter the code.
What you get. The parcel goes to the point; COD up to 6,500 zł.
Pickup every few days
Situation. There's no regular pickup, and parcels pile up.
What to do. Create waybills in bulk and print the labels. In the day's last waybill, order a courier for all parcels: enter their number and total weight.
What you get. One request — the courier collects all parcels in the window DPD offered.
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 DPDServices access, turn on “Active” (where to enter it) |
| The order card has neither “Create waybill” nor “Edit waybill” | The delivery method is “DPD”, not “DPD Polska” | Change the delivery method to “DPD Polska” |
| “Error: login/password is required (API settings)” | The DPDServices login or password isn't entered — only “Token” is filled in | Fill in “User” and “Password” |
| “Error: FID is required (API settings)” | The FID customer number isn't entered | Fill in “Customer number (FID)” |
| “Error: sender address is required (API settings)”; when ordering a courier — “sender address and phone are required” | The name, postcode, city, street or phone is empty in the “Sender” block | Fill in the sender address and phone 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 |
| “Error: DPD: no courier time ranges for ‹postcode›” | DPD returned no pickup windows for the sender's postcode | Enter your own “Pickup from” and “to” window (courier pickup) |
| DPD parcels are “Unknown” in “Shipments” | The DPD code isn't entered in “Delivery statuses” | Enter the codes (status codes) |
| The status in “View waybill” is empty, and in “Shipments” the parcel is under the “Not tracked” filter | DPD provides statuses under separate DPDInfoServices access, and it isn't entered | Ask DPD for DPDInfoServices access and enter the login, channel and password (connection fields) |
FAQ
How much does the DPD integration cost?
Elbuz charges nothing for waybills, courier pickup or statuses. You pay DPD for parcels and pickups under your own contract.
Can I pick a DPD Pickup point from a list?
No, the point code is entered manually. You can find it on the blisko.dpd.com.pl map (waybill form).
Can I cancel a DPD parcel from Elbuz?
No, a parcel number can't be canceled in DPD. A parcel not handed to the courier goes nowhere (what stays in DPD).
Why the “Token” field if I enter a login and password?
“Token” holds the DPDInfoServices password — separate access for statuses. The DPDServices login and password go in “User” and “Password”.
Can I ship DPD abroad?
No: in a waybill from Elbuz, the recipient is always in Poland. Arrange international parcels in DPD.
Why does the status in Elbuz lag behind DPD?
Elbuz asks DPD every 10 minutes and takes up to 100 parcels per run. “View waybill” shows the current status.
Where to find it and who has access
- Menu
- Account → System settings → Other settings → External services and integrations → Delivery
- Other ways in
- Directories → Documents → Shipments → “Delivery services”; order card → “Delivery” section
- Access right
- connection — “API & access tokens”; waybill and courier — the “Delivery waybill creation” window; parcels — “Shipments”
- Prepare
- a contract with DPD Polska, the DPDServices login, password and FID number
A waybill and courier can be arranged only for an order the user can see under the “Data scope” setting.
- Get DPDServices accessDPD account manager
- Enter the access, FID and sender addressExternal services and integrations → DPD Polska
- Enter the DPD status codesSame place, “Notification settings”
- Create a waybillOrder card, “Delivery” section
- Print the label, order a courier“View waybill”
Related topics
- If you need to see parcels from all carriers in one list — Shipments.
- If you need waybills for dozens of orders — bulk waybills.
- If you don't have your own DPD contract — Apaczka ships DPD parcels under its own.
- If you ship with another carrier — how to create a waybill from an order.
