DHL Shipping

DHL Shipping

by DHL
Technology Partner Premier
Compatible With: Community 1.7, 1.8, 1.8.1, 1.9, 1.9.1, 1.9.2, 1.9.3

Tech Specifications

Current Version:
Stable Build
03 May, 2018
Extensions, Shipping & Fulfillment
License Type:
Open Software License 3.0 (OSL-3.0)


Give your customers the chance to choose between a number of flexible DHL delivery services and use the integrated shipping logistics system to manage the orders.



Back to top

DHL is part of the world’s leading postal and logistics company Deutsche Post DHL Group, and encompasses the business units DHL Express, DHL Parcel, DHL eCommerce, DHL Global Forwarding, DHL Freight and DHL Supply Chain. DHL offers a complete range of individual services tailored to the customer's needs: from express document shipment to supply chain management.

The available extension is designed as a solution for your parcel shipping with DHL Parcel.

DHL Parcel is the number one parcel delivery company in Germany and the partner of choice in e-commerce. DHL offers a unique infrastructure and as the innovative leader in this area keeps developing new, customer-oriented solutions for professional parcel shipping and individual parcel reception. With this DHL creates the logistics foundation for more online trade – in Germany and many European markets.

Account & Pricing

In order to use this extension, you need DHL Shipping credentials and therefore an business customer contract with DHL Parcel. If you are not a business customer of DHL Parcel yet, you can register at Further information regarding the credentials can be found in the Knowledge Base. This extension is solely a technical solution in order to create shipping labels and to offer preferred services in the frontend. The conditions of your business customer contract apply. Furthermore there are no additional costs.


DHL Shipping incl. Preferred Services

With the official DHL plugin you profit from a quick and easy parcel dispatch. To make your life easy the official DHL plugin extends the feature set of your shop's backend by adding manual und automatic label generation functions. At the same time it enables your customers to decide when and where they want to receive their parcels by adding additional delivery options like "Preferred Time" or "Preferred Day" in your shop's checkout. 

This module requires PHP 5.5 or higher to run correctly. See also the documentation.

Detailed presentation of the features:

DHL Shipping

With the integrated shipping logistics system “DHL Shipping”, you create and organize shipping labels directly in the backend of Magento® for the products “DHL Paket”, DHL Paket International” and “DHL Paket Austria”. It can be used with the business customer API 2.2 (GK-API) and offers the booking of additional delivery services e. g. the Visual Age Check.
Note: The plugin does not support DHL Intraship.

Preferred Services

The feature „DHL Wunschpaket“ allows you to offer your customers additional services for an individual parcel delivery directly in your web shop. It adds alternative delivery options to all address forms in the front end. If the customer enters his home address and chooses a preferred location or preferred neighbor, the parcel can also be delivered in his absence. Besides, your customers can indicate a preferred day or time for the delivery. The services chosen by your customer in the frontend are automatically transmitted to the backend and are then forwarded to DHL alongside with the electronic shipment data.

The following services are included:

● Preferred Day
● Preferred Time (evening time windows 18-20 p.m. and 19-22 p.m.)
● Preferred Location
● Preferred Neighbor


● Magento CE 1.7.x, 1.8.x, 1.9.x
● PHP 5.5 or higher

Contact your DHL Service Center

If you need help setting up your login or implementing the services of DHL Paket, please contact our service center and ask for the “DHL Ship web service”:
● Telephone: +49 (0)180 6 00 3321 (€0.20 per call from German landline phones; €0.60 per call from cell phones)
● Mo. -Fr. 8:00 am until 06:00 pm CEST

Extension support

If you have questions or problems concerning the integration of the plugin, take a look at our Knowledge Base (FAQ) on
The documentation is also available in the FAQ.
For technical support please contact



DHL ist Teil des weltweit führenden Logistikkonzerns Deutsche Post DHL Group und besteht aus den Unternehmensbereichen: DHL Paket, DHL Express, DHL Global Forwarding, Freight und DHL Supply Chain. DHL bietet integrierte Dienstleistungen und maßgeschneiderte, kundenorientierte Lösungen für den Transport von Briefen, Waren und Informationen.

Die vorliegende Extension ist eine Lösung für Ihren Paketversand mit DHL Paket.

DHL Paket ist der Paketdienstleister Nr. 1 in Deutschland und Partner erster Wahl im E-Commerce. DHL bietet eine einzigartige Infrastruktur und entwickelt als Innovationsführer der Branche stets neue, kundenorientierte Lösungen für professionellen Paketversand und individuellen Paketempfang. Damit schafft DHL die logistische Basis für noch mehr Online-Handel – in Deutschland und in vielen europäischen Märkten.

HINWEIS: Um diese Extension nutzen zu können, benötigen Sie Zugangsdaten zum DHL Geschäftskundenportal und somit einen Geschäftskundenvertrag mit DHL Paket. Falls Sie noch kein Geschäftskunde von DHL Paket sind, registrieren Sie sich unter Weitere Informationen zu den Zugangsdaten finden Sie in der Wissensdatenbank. Diese Extension stellt lediglich eine technische Lösung zur Erstellung Ihrer Versandlabel und dem Angebot von Empfängerservices im Frontend dar. Es gelten die jeweils aktuellen Konditionen Ihres Geschäftskundenvertrags. Darüber hinaus entstehen keine weiteren Kosten.


DHL Versenden inkl. Wunschpaket

Das offizielle Modul von DHL Paket ermöglicht Ihnen eine schnelle und unkomplizierte Abwicklung Ihres Paketversands und gibt Ihren Kunden die Möglichkeit, den Paketempfang mit DHL flexibel zu gestalten.

Dieses Modul erfordert PHP 5.5 oder höher, siehe auch die Dokumentation.

Die Funktionen im Detail:

DHL Versenden

Über das integrierte Versandlogistiksystem DHL Versenden können Sie Ihre Versandlabel für die Produkte „DHL Paket“ und „DHL Paket International“ sowie „DHL Paket Austria“ direkt aus dem Magento® Backend heraus generieren und verwalten. Das Modul unterstützt die Geschäftskunden-API 2.2 (GK-API) und ermöglicht dadurch das Hinzubuchen zusätzlicher Services wie z.B. die Alterssichtprüfung durch den Zusteller.
Wichtig: DHL Intraship wird von diesem Modul nicht unterstützt.


DHL Wunschpaket

Bieten Sie Ihren Kunden mit „DHL Wunschpaket“ zusätzliche Services rund um den individuellen Paketempfang. Das Plugin erweitert hierzu das Frontend zur Eingabe der Lieferadresse um Alternativen für die Zustellung zu Hause. Bei Angabe der Hausadresse mit zusätzlichem Wunschort oder Wunschnachbarn werden Sendungen selbst in Abwesenheit Ihrer Kunden zugestellt. Außerdem haben Ihre Kunden die Möglichkeit, den für sie passenden Wunschtag oder die für sie passende Wunschzeit auszuwählen. Die im Frontend gewählten Wunschpaket-Services werden automatisch an das erweiterte Backend geleitet und mit den elektronischen Sendungsdaten an DHL übermittelt.
Folgende Services können im Frontend abgebildet und durch den Endkunden gebucht werden:

● Wunschtag
● Wunschzeit (aktuell beschränkt auf die Abendzeitfenster 18-20 Uhr und 19-21 Uhr)
● Wunschort
● Wunschnachbar


Kompatible Versionen

● Magento CE 1.7.x, 1.8.x, 1.9.x
● PHP 5.5 oder höher


Kontakt zum Service-Center von DHL
Wenn Sie Hilfe bei der Einrichtung der Zugangsdaten und den Serviceleistungen von DHL Paket benötigen, wenden Sie sich bitte mit dem Stichwort „Versenden Webservice“ an:
● Telefon: 0180 6 00 3321 (20 Cent/Anruf aus dem deutschen Festnetz, aus den deutschen Mobilfunknetzen 60 Cent/Anruf)
● Mo. -Fr. 8:00 bis 18:00 Uhr



Bei Fragen oder Problemen werfen Sie einen Blick in die Wissensdatenbank (FAQ):
Die Dokumentation ist ebenfalls in der Wissensdatenbank verfügbar. Technischen Support zum Modul erhalten Sie unter


Release Notes

Back to top


  • Compatible with CE: 1.7 1.8 1.8.1 1.9 1.9.1 1.9.2 1.9.3
  • Stability: Stable Build
  • Description:

    Information about Shipment Overview feature added to documentation
    Various documentation improvements and clarifications
    Expanded help texts on shipping method configuration page
    The maximum length of Street numbers is now 7 characters instead of 5
    Insurance and CoD amounts of over 1000 units are now possible
    DHL status icons in order grid are now properly updated by Autocreate
    Checkout now does not show a DHL section if no services are available.
    Order emails sent from Autocreate now include the shipment ID
    Magento will no longer crash when changing the display currency in checkout
    Added some missing german translation strings


  • Compatible with CE: 1.7 1.8 1.8.1 1.9 1.9.1 1.9.2 1.9.3
  • Stability: Stable Build
  • Description:

    1.3.0 19.01.18
    · Display shipping label status in orders grid
    · Code style improvements for Magento Marketplace

    1.2.0 (15.12.17)
    • Create shipping labels via order grid mass action
    • Encrypt API password in database
    • Send shipment confirmation email during cron autocreate
    • Remove receiver email address from request if parcel announcement service is disabled
    • Fall back to order email address if it is not available at shipping address
    • Improve address split for Austrian street numbers
    • Re-calculate service fee on shipping method or service selection changes in checkout
    • Consider Sundays in preferred day service options calculation
    • Log webservice errors during cron autocreate

    1.1.1 (29.09.17)
    • Improve autoloading of namespaced classes
    • No longer terminate cron on shipment validation errors, continue processing
    • Apply correct unit of measure for item weight in export declarations
    • Display service validation errors in checkout that remained hidden under certain circumstances

    1.1.0 (10.05.17)
    • Demand fees for Preferred Day / Preferred Time checkout services
    • Missing array key for preferred day
    • Fix authentication errors not being shown
    • Fix label creation for partial shipments
    • Make participation number required
    • DB prefix will now be recognized

    1.0.0 (17.10.16)
    Initial Release


Back to top
The best place to start if you need help with a specific extension is to contact the developer. All Magento developers have both a contact email and a support email listed.

Q & A

Back to top


Back to top