Logistics

How to connect DPD with easySales: a complete setup guide

How to connect DPD with easySales: a complete setup guide

Connect DPD to easySales: the credentials and the Get Details step, what the two service codes do, extra services, advanced options, return labels, several pickup points, and how DPD HU and DPD PL differ.

What connecting DPD gives you

With DPD connected, easySales creates the shipping label for an order, prints it, follows the parcel, cancels a label you no longer need, books the courier for the pickup and produces return labels — without you opening DPD's own application.

This guide covers the whole connection. Most of its attention goes to the two fields that decide whether a label is produced at all: National Service Code and Local Service Code, which the form shows with no explanation beyond an example.

Before you start

A DPD account with API access

API access is requested from DPD and is separate from your ordinary DPD login. In Romania the address for it is api.support@dpd.ro.

Your service codes

DPD's numeric service ids for the services your contract carries — one for shipments between localities and one for local shipments.

The right card

DPD, DPD HU and DPD PL are different integrations. Pick the one for the country you ship from.

Step 1 — Find the right DPD card

Go to Integrations → Couriers and search for dpd. You will find three cards.

The Couriers page in easySales filtered to DPD, showing a connected DPD Romania card and not-connected DPD HU and DPD PL cards.
Integrations → Couriers filtered to `dpd`: three cards, three integrations.

Press Connect on the card for your country, or Edit if you have connected it before. The rest of this guide follows the Romanian card; the Hungarian and Polish ones are covered at the end.

Step 2 — Credentials, and the Get Details button

The top of the DPD connection form in easySales, showing Connection Name, Account ID, Password and a Get Details button.
Only these three fields appear until Get Details succeeds.

Account ID and Password are the API credentials DPD issues for your account — not your DPD web login. Connection Name is what you will see inside easySales when you pick between connections.

Step 3 — Label format, payer and the two service codes

The DPD connection form after Get Details, showing AWB Format A4, Courier Service Payer Sender, National Service Code 2002, Local Service Code 2113 and the Contract list.
The two service codes are DPD's own ids, taken from your contract.
Field What it does
AWB Format The layout DPD renders the label in: A4 (a full page), A6 (a single label for a thermal printer) or A4_4xA6 (four labels on one A4 sheet).
Courier Service Payer Who DPD invoices for the shipment — Sender, Recipient or Third Party. On a return connection it is fixed to Third Party.
National Service Code The DPD service id used when the parcel travels between localities.
Local Service Code The DPD service id used when DPD confirms that service for the destination — typically a parcel staying inside the same locality.
Contract Which of the contracts on your DPD account this connection ships under. It also fixes the pickup address.
The delivery fields, and what each one does

Step 4 — Contract, extra services and references

The DPD connection form showing the Contract dropdown, Additional Services, Insured delivery, Fragile and Send order ID as internal reference.
Everything chosen here applies to every parcel created on this connection.

Contract is the list DPD returned. Choosing one also fixes the pickup address for this connection — which is why a second pickup point means a second connection rather than a setting.

Setting What it does
Additional Services Saturday delivery, open on delivery and palletised shipment. Whatever you choose is added to every parcel created on this connection, so a connection with Saturday delivery on it is a connection for Saturday parcels.
Insured delivery Declares the parcel's value to DPD. With it on, a second option appears — Fragile — which declares the contents as fragile as well.
Send order ID as internal reference Sends the easySales order number with the shipment, so the parcel can be matched to the order on DPD's invoice. Worth turning on.
Cash on delivery Not a field on this form. easySales adds the amount to collect by itself when the order has one, together with the order number as the reference.
Extra services and references

Step 5 — The notes template

The notes template of a DPD connection in easySales, with the Order and Products variable buttons above a box containing an order number and a quantity and SKU list.
What the template produces is printed on the label.

Whatever the template produces travels with the parcel and is printed on the label, so keep it to what a driver or a warehouse needs to read. The buttons above the box insert values from the order and from its products — order number, invoice series, quantity and SKU, warehouse location.

Step 6 — Printing settings and advanced options

Both sections are collapsed and neither is required, but two of the advanced options save real work.

The expanded printing settings and advanced options of a DPD connection, showing Paper size, Scale type, Auto call courier, Fallback email, R-Create returnable packaging, Swap service code, package dimensions, Return voucher and Open package return payer.
Both sections are collapsed by default; Auto call courier is the one worth opening them for.
Setting What it does
Auto call courier Books the DPD pickup for each label as it is created, at the latest by 16:00.
Fallback email Used when the order has no e-mail address, so the label can still be produced instead of being refused.
Generate packages based on the number of packages of the product Counts the parcels on the label from the package count set on each product, instead of always sending one.
Package width / length / height Sent with the shipment when it is a single parcel. DPD uses them for volumetric weight.
AWB with R-Create returnable packaging Marks the shipment as using DPD's returnable packaging service.
Swap service code For a service that exchanges something at delivery, such as a document swap. Another DPD service id, optional.
Return voucher Creates a return voucher alongside the label, with its own service code, payer and number of days it stays valid.
Open package return payer Who pays when a returned parcel is opened at delivery.
Printing settings Paper size and scale, used only when you print through the easySales Printer connection, and only for this courier. This is not AWB Format: DPD decides what the label looks like, these decide how it lands on paper.
Advanced options

Step 7 — Return labels

The connection form has two tabs, Delivery account and Return account. A return connection is a separate connection with its own credentials, and it carries the address the parcel comes back to.

The Return account tab of a DPD connection, showing the Delivery address block with name, phone, email address, address, postal code, country, county and locality.
A return connection carries the address the parcel comes back to.

More than one pickup point

The three-dot menu open on the DPD card in easySales, showing Connect another courier account, Documentation and Register.
A second pickup point is a second connection.

Open the ⋮ menu on the DPD card and choose Connect another courier account, or open an existing connection and press Clone to copy all of its settings. Each connection has its own contract, pickup address, service codes and format, and you choose between them by Connection Name when you create a label.

DPD Hungary and DPD Poland

They are separate cards because they are separate integrations, with their own credentials and their own forms.

DPD (Romania) DPD HU DPD PL
Credentials Account ID + Password Username + Password Account ID + Password + FID
Contract lookup Yes — Get Details No No
Service selection National and Local service codes None Service type: Domestic or International
Sender address From the selected contract From your DPD account Typed into the form
Extra services Saturday delivery, open on delivery, palletised Saturday, next business day, same day, delivery until 09:30, delivery until 12:00
Label formats A4, A6, A4_4xA6 One format A4, printer label format
Return account tab Yes No No
Only on this card Return vouchers, swap service, R-Create packaging SMS notification to a number you set Food delivery with a shelf-life limit in days
The three DPD cards side by side

When DPD refuses a label

The message DPD returns is shown on the order, in DPD's own words. These are the ones worth recognising.

Message What it means
Serviciu: Serviciul nu este permis The service code on the connection is not one your contract may use, or not for that destination. The commonest DPD failure by a wide margin — check both codes with DPD.
Destinatar Nume: Numele clientului individual trebuie sa contina cel putin 2 cuvinte DPD requires a recipient name of at least two words. Orders that arrive with a single-word name have to be completed before the label can be made.
Destinatar: Este necesar telefonul 1 / Numar telefon nevalid No phone number on the order, or one DPD does not accept.
Destinatar Email The recipient's e-mail is empty. Fill it on the order, or set a Fallback email on the connection.
Cod postal The destination postal code is missing or not one DPD recognises for that address.
Limita maxima de expedieri a fost depasita pentru serviciul selectat The number of parcels on this label is outside what the chosen service allows.
Greutatea coletului … depaseste greutatea maxima A parcel is over the service's weight limit — 31.5 kg on the usual ones. Split it across parcels.
What DPD's refusals mean

Frequently asked questions

The one for the country you ship from: **DPD** for Romania, **DPD HU** for Hungary, **DPD PL** for Poland. They are separate integrations with separate credentials and different forms — a Romanian account will not connect the Hungarian card. Where the parcel goes does not matter; a DPD Romania connection can ship abroad.

The API credentials DPD issues for your account, not the user name and password you use on DPD's own website. In Romania you request them from DPD at `api.support@dpd.ro`.

Press **Get Details** first. It signs in to DPD and reads the contracts on your account, and the rest of the form — including Save — only appears once that succeeds. If it returns an error, the credentials are wrong or API access has not been enabled for the account yet.

They are DPD's own numeric service ids, taken from your contract. For every shipment easySales asks DPD which services serve the destination and sends the Local code if DPD confirms it, or the National code if it does not. Both are required because one field cannot cover both cases.

DPD is telling you the service id on the connection is not one your contract may use for that shipment. Ask DPD which service ids your account carries and correct the National and Local codes on the connection. It is the most common reason a DPD label is refused.

No. When the order has an amount to collect, easySales sends it with the shipment by itself, along with the order number as the reference. There is no cash-on-delivery field on the connection.

Open the ⋮ menu on the DPD card and choose **Connect another courier account**, or open an existing connection and press **Clone**. The pickup address follows the contract you select under **Contract**, so a second pickup point is a second connection.

If you ask it to. Open **Show advanced options** and set **Auto call courier** to Yes — each label then books its own collection, in the next available window and no later than 16:00. Left off, you arrange collections yourself as before.

AWB Format is sent to DPD and decides the layout of the label DPD produces — a full A4 page, a single A6 label, or four A6 labels on one A4 sheet. Paper size under Printing settings only applies when you print through the easySales Printer connection, and it overrides your printer's default for this courier alone.

Yes, from a separate connection saved under the **Return account** tab. It has its own credentials and its own **Delivery address** — the address the parcel comes back to, which does not have to be the one you ship from. The payer on a return connection is always Third Party.

Was this guide helpful?