DHL Shipping

With the extension you have the possibility to process orders directly from the administration via DHL shipping. Offer your customers a DHL location search and easily create DHL labels with Shopware.


You can download DHL Shipping for free from the Store and install it in the Administration
(Settings > My Extensions).

General configuration

Under Extensions > My Extensions > DHL Shipping you can access the general configuration (1) of the extension.

Map configuration

Sales channel (1): First define for which sales channel you want to store the settings.
Google Maps API Key (2): Enter the Google Maps API Key here. This is necessary for the display of the packing stations in the storefront to work.
You can find out how to get a Google Maps API Key here.
Country code (3): Enter the ISO code for the country here.

Default values for package dimensions

To be able to create a DHL label, the width, height, depth and weight of the parcel are required. The default values stored here are automatically transferred to the order in the label generation area. No values are stored in the standard of the app, with the exception of weight = 0.1 kg. Since each package can have different dimensions, you can of course also store individual values per package. You can find more about this in the last section DHL Label Generation.

Depth (4): Enter the default value for the depth of the package in centimeters.
Weight (5): Enter the default value for the weight of the package in kilograms.
Width (6): Enter the default value for the width of the package in centimeters.
Height (7): Enter the default value for the height of the package in centimeters.


After you have installed and activated the extension, the extension gets its own menu item "DHL Shipping - DHL Labels" in the administration under settings. In the overview you will first see all shipping labels.

Generated labels

If you have not yet created a label, you can jump directly to the order via Show orders and create a label there. How to create a label is explained in the section DHL Label Generating below.

If you have already created  labels, you can view the shipping labels for the orders here (1). You can also edit the shipment details again, print the shipping label or cancel it completely (2).
You can transfer the order data to DHL via the End of the day process (3).

Shipping methods

Under shipping methods you can link your shipping methods to a DHL product. To do this, click on the 'Edit' icon (1) for the corresponding shipping method.

Mapping of the shipping method

DHL product (1): Select here which DHL product should be used. In the dropdown you can choose between DHL Paket, DHL Paket International, DHL Warenpost and DHL Warenpost International.
Participation number (2): Enter the last two digits of your DHL invoice number. Normally this is "01".
Personal handover (3): Activate this option if you want to offer a personal delivery.
Retail Outlet Routing(4): Activate this option if you want to offer a routing.
The service is described here.
Ident-Check (5): Activate this option if you want to offer an ident-check.
The service is described here.
No delivery in the neighborhood (6): Activate this option if you want to prevent delivery in the neighborhood. The service is described here.
Cash on delivery (7): Check this option if you want to offer cash on delivery.
Visual age check (8): Choose from the options None (no check), A16 (from 16 years) and A18 (from 18 years).
Transport insurance (9): Activate this option if you want to offer transport insurance.
The service is described here.
Bulky goods (10): Activate the option if you want to offer the bulk service.


Manage DHL account (1): This takes you to the DHL business customer portal page.
Connect DHL (2): Here you can connect an existing DHL account.
Status (3): The display shows you whether a connection exists or not.

Connect DHL

DHL Username (1): Enter the username of your DHL account here.
DHL password (2): Enter the password of your DHL account here.
EKP number (3): Enter the EKP number here, which corresponds to the invoice number. You will also find it in your DHL business customer account.
Become a member (4): Click here and you will be redirected to the page Become a DHL business customer.

Company (1): Enter the company name here.
Name (2): Enter the full name here.
Street (3): Enter the street name here.
Postal code (4): Enter the postal code here.
City (5): Enter the city that matches the postal code.
Country (6): Select the corresponding country here.

DHL location in the storefront

As soon as you have entered all basic settings and the connection with the DHL account was successful, your customers can use the DHL location search in the storefront.

To select a DHL location, the customer must enter a different delivery address (1). As soon as a check mark is set there, the DHL location option appears (2). If this option is also activated, the button Find DHL location (3) appears in the address entry.

Example in the storefront

DHL Label Generation

To generate labels for a placed order, call up the order details in the administration.

In the order details you will also find the DHL label Generation in the additional fields section. Enter the data for the package (width, height, depth and weight). You can only enter data there if you are in edit mode. Afterwards click on Save.

After setting the label settings you can start the process Generating DHL Label (1).


Error message: "Could not sign payload with store secret for app: "SwagDhlApp"".

This error can occur if you have downloaded the DHL app from a domain that is not licensed with Shopware. If you get this error message, first check if the extension is also associated with your license domain.

Label creation failed

If there is an error while creating the label in the order details, check the following:
Check under Settings > DHL Shipping - DHL Labels > Shipping types the participation number (1). This field is mandatory and necessary for the creation of parcel labels. Enter the last two digits of your DHL invoice number in this field. In most cases this is the number "01".

Was this article helpful?