The DHL Shipping extension for Magento® 2 integrates the DHL business customer shipping API or the DHL eCommerce Global Label API into the order processing workflow.

This extension enables merchants to request shipping labels for incoming orders via the DHL business customer shipping API (DHL Geschäftskundenversand-API) or the DHL eCommerce Global Label API.

For more details on the API connections, see the documentation.

• PHP 5.6.5
• PHP >= 7.0.6
• PHP >= 7.1.0
• PHP >= 7.2.0

• Magento >= 2.1.4+
• Magento >= 2.2.0+
• Magento >= 2.3.0+

The DHL Shipping module for Magento® 2 is distributed in two formats:

• Composer Artifact
• Composer VCS

The following sections describe how to install the module source files, depending on the distribution format, to your Magento® 2 instance.

If you received multiple ZIP files with composer.json files included, move them to a common directory on the server. The directory /var/www/share/marketplace/dhl is used in the following examples. Please replace this path with the actual artifact directory of choice.

/var
└── www
    └── share
        └── marketplace
           └── dhl
                ├── Dhl_Shipping_Lib-x.xx.x.zip
                └── Dhl_Shipping_Module_M2-x.xx.x.zip

Then navigate to the project root directory and run the following commands:

composer config repositories.dhl-shipping-m2 artifact /var/www/share/marketplace/dhl/
composer require dhl/module-shipping-m2:0.10.2

If you prefer to install the module using git, run the following commands in your project root directory:

composer config repositories.dhl-shipping-m2 vcs https://github.com/netresearch/dhl-module-shipping-m2.git
composer require dhl/module-shipping-m2:0.10.2

Once the source files are available, make them known to the application:

./bin/magento module:enable Dhl_Shipping
./bin/magento setup:upgrade

Last but not least, flush cache and compile.

./bin/magento cache:flush
./bin/magento setup:di:compile

The following sections describe how to uninstall the module from your Magento® 2 instance.

To unregister the shipping module from the application, run the following command:

./bin/magento module:uninstall --remove-data Dhl_Shipping
composer update

This will automatically remove source files, clean up the database, update package dependencies.

Please note that automatic uninstallation is only available on Magento version 2.2 or newer. On Magento 2.1 and below, please use the following manual uninstallation method.

To uninstall the module manually, run the following commands in your project root directory:

./bin/magento module:disable Dhl_Shipping
composer remove dhl/module-shipping-m2

To clean up the database, run the following commands:

DROP TABLE `dhlshipping_quote_address`;
DROP TABLE `dhlshipping_order_address`;
DELETE FROM `eav_attribute` WHERE `attribute_code` = 'dhl_dangerous_goods_category';
DELETE FROM `eav_attribute` WHERE `attribute_code` = 'dhl_tariff_number';
DELETE FROM `eav_attribute` WHERE `attribute_code` = 'dhl_export_description';
DELETE FROM `core_config_data` WHERE `path` LIKE 'carriers/dhlshipping/%';
DELETE FROM `setup_module` WHERE `module` = 'Dhl_Shipping';

In case of questions or problems, please have a look at the Support Portal (FAQ) first.

If the issue cannot be resolved, you can contact the support team via the Support Portal or by sending an email to [email protected].

• Christoph Aßmann | Netresearch GmbH & Co. KG | @mam08ixo
• Sebastian Ertner | Netresearch GmbH & Co. KG
• Benjamin Heuer | Netresearch GmbH & Co. KG
• Paul Siedler | Netresearch GmbH & Co. KG

OSL - Open Software Licence 3.0

(c) 2019 DHL Paket GmbH