DPD and WooCommerce: integration step by step
DPD and WooCommerce, setup step by step: the WP Desk plugin and Flexible Shipping, DPD Services credentials, DPD Pickup points, labels, cash on delivery and typical errors.
A DPD WooCommerce integration lets you send parcels, download labels and pass tracking numbers to customers directly from the store admin. To set it up you need your own contract with DPD, credentials for the API services and the right plugins.
In this guide I go through the whole process: from preparing the credentials to a test order and the first label. You can set the integration up yourself if you have access to the WordPress and WooCommerce settings and to your DPD account.
How a DPD WooCommerce integration works
AI-generated image
The plugin connects WooCommerce to DPD’s services through the API. This lets you handle shipments from the order itself: you create the shipment, download the label, generate the manifest and give the customer the tracking number.
DPD Polska (the Polish DPD company) does not offer a free official plugin in the WordPress directory. The modules you find there by typing “DPD” serve the Baltic and Slovak markets, among others. Do not treat them as an integration with DPD Polska’s services.
The standard solution for a Polish store is the paid DPD WooCommerce plugin from WP Desk. It supports the DPD Classic, Classic COD, Classic International and DPD Pickup services. For delivery to a pickup point the customer can pick the place on a map or choose it from a list in the basket.
It also needs the free Flexible Shipping plugin, available in the WordPress directory. Its author is Octolize. Flexible Shipping is where you add delivery methods, set prices and assign the DPD integration.
Another route is courier platforms such as Furgonetka or Apaczka (Polish courier brokers). They let you send DPD parcels at the intermediary’s prices, without your own contract with the carrier. If you also sell on marketplaces, BaseLinker can play a similar role.
Before you start: the DPD contract and credentials
AI-generated image
For a direct integration you need a business contract with DPD and credentials for the API services called DPD Services, also known as WebAPI2. These are a login, a password and a customer number issued by your DPD account manager.
The details used to log in to the DPD Online web client will not work in the plugin. This is a frequent cause of a connection error, so when you talk to your account manager, ask specifically for access to DPD Services or WebAPI2.
You also need a subscription to the DPD WooCommerce plugin from WP Desk. It costs about PLN 229 net a year. You can download Flexible Shipping for free from the WordPress directory.
Before you start, prepare:
- the login and password for DPD Services,
- the DPD customer number,
- the installation file of the DPD WooCommerce plugin,
- the WP Desk licence key,
- administrator access to WordPress.
The price of a single parcel depends on your contract and monthly volume. You agree the specific rates with your DPD account manager. Delivery costs and plugin licences are fixed items in a store’s budget. You will find a full breakdown in the article on how much an online store costs.
Setting up DPD in WooCommerce step by step
The whole setup covers installing two plugins, connecting to the API, adding delivery methods and a trial order. Also set aside a moment to check the label and the choice of a DPD Pickup point in the basket.
Step 1. Install Flexible Shipping and the DPD WooCommerce plugin
Start by installing Flexible Shipping.
- In the WordPress admin go to Plugins → Add New, type “Flexible Shipping” in the search box, then install and activate the plugin by Octolize.
- You download the DPD WooCommerce plugin from your WP Desk account as a ZIP file.
- Go to Plugins → Add New again, choose “Upload Plugin” and select the downloaded file.
- After installation, activate the plugin and activate the subscription with the licence key.
Both plugins have to be active. Flexible Shipping is responsible for the delivery methods and their prices, and the DPD WooCommerce module passes the shipment data to the carrier’s system.
Step 2. Enter the DPD credentials and check the connection status
Go to WooCommerce → Settings → Shipping → DPD. Enter the login, password and customer number you received from your account manager.
Look at the “Connection status” field. A correct status confirms that the store can talk to the API. If a login error appears, first check which kind of details you used. Access to DPD Online and access to DPD Services are separate sets.
The settings also have a “Test mode” checkbox. When it is ticked, the plugin uses the test environment, which has separate credentials. You will find the details meant for testing in the plugin documentation.
Step 3. Add DPD delivery methods in shipping zones
- Open WooCommerce → Settings → Shipping and choose the zone that covers Poland.
- Click “Add shipping method”, choose Flexible Shipping and go to the settings of the new method.
- In the integration field select DPD.
- Set the name shown in the basket, the price and the expected delivery time.
You can base the price conditions on the order value or the weight, depending on the Flexible Shipping configuration.
Courier to an address and DPD Pickup should work as separate methods. For delivery to a point, switch on the “Delivery to a pickup point” option. The customer will then see a map and a list of available DPD Pickup points while placing the order.
After saving the settings, check the basket with an address that belongs to the right zone. That way you see straight away whether both methods are available.
Step 4. Set up labels, parcel dimensions and cash on delivery
In the integration settings choose a label format that fits the equipment used in the store. PDF, ZPL and EPL are available. You can print one label on an A4 page, several labels on a sheet, or use a layout prepared for a label printer.
Fill in the default dimensions and weight of a parcel too. With similar orders this cuts the number of fields you fill in for each shipment. You can still correct the shipment details in a particular order.
For cash on delivery shipping, tick the “Cash on delivery” checkbox in the Flexible Shipping method. If your contract and the way you handle shipments require it, you can also switch on “Declared value”.
Step 5. Place a test order in test mode
Switch on test mode and go through the full purchase path.
- Add a product to the basket, enter an address, choose the DPD courier or DPD Pickup, pick a point on the map and finish the order.
- Open the order in the WooCommerce admin. In the DPD metabox use the “Create” button to create the shipment, then click “Get label”.
- Check the recipient’s details, the weight, the service and the file format.
- After a successful test, switch off test mode and enter the production DPD Services credentials.
- Finally, place a short control order.
A test like this lets you check the delivery method, the pickup point and the documents in production conditions.
Sending parcels, labels and manifests from the orders panel
You can create a shipment one at a time in the order or in bulk from the order list. In the same panel you download labels and prepare the shipping manifest for the courier.
When handling a single order, open the DPD metabox and check the shipment details. The “Create” button registers the parcel in the carrier’s system. Once the shipment is created, the option to download the label appears.
With a larger number of parcels, select the orders on the list, open “Bulk actions” and choose “Send shipments”. You generate the manifest for the courier with the “Create shipping manifest” action. You will find the finished documents under WooCommerce → Shipping manifests.
A DPD WooCommerce integration can create a shipment automatically when a chosen order status is set. Changing the status to “Completed” after sending is also available. The tracking number goes into the email and the customer’s account, so the buyer can check the parcel’s route themselves.
Cash on delivery (COD) in DPD shipments
Cash on delivery shipments are handled by the Classic COD service. The order amount is passed into the shipment data once the “Cash on delivery” option is ticked in the relevant Flexible Shipping method.
You can also set a declared value for the parcel. Check the terms of your contract with DPD and the rules that apply to the products you send beforehand.
You switch on the cash on delivery payment gateway separately in WooCommerce, in the payment settings. It should be available for the shipping method configured as Classic COD. After switching it on, place a trial order and check whether the cash on delivery amount appears in the data of the created shipment.
I have described setting up online payments in the same store in the guides to integrating Przelewy24 with WooCommerce, integrating PayU and integrating Tpay (three Polish payment gateways).
Typical DPD integration errors and how to fix them
Most problems come from wrong credentials, mixing up the test environment with production, or shipping zone settings. Start the diagnosis with the “Connection status” field and a trial address in the basket.
| Symptom | Cause | What to do |
|---|---|---|
| login error | details from the DPD Online web client | ask your account manager for the login, password and customer number |
| the details work in only one mode | the test environment mixed up with production | check the whole set, including the customer number |
| SOAP-ERROR: Parsing WSDL | a server problem with access to DPD’s services | check the two filters from the plugin documentation: SSL verification and WSDL cache; consult the administrator about applying them |
| no DPD methods in the basket | the shipping zone, the customer’s address, Flexible Shipping conditions or free shipping | check the zone, the address, the weight or basket value limits and the free shipping configuration |
Courier, DPD Pickup or cash on delivery: what to offer in the basket
To start with, two or three delivery methods matched to your store’s products and customers are enough. A list that is too long makes the choice harder and lengthens the basket, especially on a phone.
| Service | When it makes sense | Name in the basket |
|---|---|---|
| Courier to an address (DPD Classic) | the basic option, customers know it | DPD courier to your address |
| DPD Pickup | when the customer prefers to collect the parcel on the way | DPD Pickup: collection at a point |
| Classic COD | when the store allows payment on delivery | DPD courier: payment on delivery |
| Classic International | when you sell abroad | DPD courier: international shipping |
If your customers also ask about Paczkomat (InPost parcel locker) delivery, see the guide to integrating InPost with WooCommerce.
You configure each of these options as a separate Flexible Shipping method. You can give it its own name and set the price and conditions that depend, for example, on the basket value or the weight. The names should tell the customer straight away where the parcel will go: “DPD courier to your address”, “DPD Pickup: collection at a point” or “DPD courier: payment on delivery”. That way the choice takes a moment.
In the method’s conditions you can also set free delivery from a chosen order value. You enter the specific parcel prices according to your contract with DPD.
Start with the courier and DPD Pickup. Add further options after the first weeks of sales, when you see what your customers actually need.
Dedicated plugin or courier broker: which to choose
Your own contract with DPD and the dedicated plugin give you the rates negotiated with your account manager and shipment handling inside WooCommerce. A broker makes it easier to start without signing a separate contract with the carrier.
| Criterion | Dedicated WP Desk plugin | Courier broker |
|---|---|---|
| contract with the carrier | your own contract with DPD | no contract of your own with the carrier |
| rates | rates negotiated with the account manager | the intermediary’s price list |
| shipment handling | labels, manifests and tracking numbers in the store admin | access to several carriers |
| fixed cost | plugin subscription, about PLN 229 net a year | a fee according to the broker’s price list |
| who it is for | regular shipping | a young store or a company that sends parcels irregularly |
With a few dozen parcels a month, compare the cost of the DPD WooCommerce subscription, the rates from your own contract and the broker’s price list. Take into account the time needed to send parcels every day as well.
FAQ
Is there a free official DPD plugin for WooCommerce?
There is no free official DPD Polska plugin in the WordPress directory. The dedicated solution is the paid DPD WooCommerce plugin from WP Desk, which works with Flexible Shipping. Courier brokers are the alternative.
What details are needed to connect the store to DPD?
You need a login, a password and a customer number for DPD Services, that is WebAPI2. The details are issued by your DPD account manager. The login used in the DPD Online web client will not work in this integration.
Can the customer collect the parcel at a DPD Pickup point?
Yes. The method with delivery to a pickup point shows a map and a list of DPD Pickup points in the basket. The chosen point is saved with the order.
Can I test the DPD integration before the store launches?
Yes. The plugin has a test mode that uses a separate environment and separate credentials. Before the launch, go through a whole trial order, create a shipment and download the label.
Does the DPD WooCommerce plugin support cash on delivery?
Yes, through the Classic COD service. In the Flexible Shipping method tick the “Cash on delivery” option, and configure the cash on delivery payment separately in the WooCommerce settings.