EasyStore integrates with DHL, one of the world's most popular shipping carriers, enabling merchants to offer it as a reliable shipping option at checkout. After setup, they can manage shipping rates and generate shipping labels directly from EasyStore.

Before You Begin

To integrate DHL, ensure you have the following:

• An active DHL merchant account
• API credentials (Account Number and Password for both Live and Test modes)
• Shipping regions configured in EasyStore

Adding DHL As Your Shipping Carrier

1. Log in to your Joomla Dashboard and navigate to Components > EasyStore > Settings > Shipping.
   

   
   

2. If your region is already set up, click the three-dot icon next to it and select Edit. If you haven't set up your regions yet, you'll need to configure them first before you can add any shipping carriers.
   
   

   

3. Scroll down to the Add Shipping Carrier section and click on the Add Carrier button to open the list of available shipping providers.
   
   

   

4. Locate DHL in the list and click the Add button.
   
   

   

5. After completing the setup, click the "Back to the list" button. DHL will now be added to your store’s available shipping options. 
   
   

   

Enable the toggle switch to make DHL visible as a shipping option on the checkout page. 

Note: For the shipping carrier to appear at checkout, make sure your Store Address in General Settings is complete and includes the correct Country and ZIP Code.

Configuring DHL Shipping Carrier

After adding DHL as your preferred shipping carrier, locate it in the list and click the "Setup" button next to it.

This will open a pop-up window where you can configure the DHL settings for smooth integration with your store’s shipping process.

Title

Give your integration a title (e.g., "DHL"). This is a user-defined title that helps you identify this integration within your Joomla Dashboard.

Environment

Choose between "Mock", “Test”, or "Live" mode based on your needs. By default, it is set to the “Mock” environment. Select "Live" to process actual shipments in a production environment, or "Test" to simulate shipping for setup and testing purposes.

Test/Live API Key

Insert your API key that you received while creating your DHL account.

Test/Live Secret Key

Enter the secret key that you received when creating your DHL account.

Test/Live Account Number

Enter the account number of your DHL account.

Default Weight

Set the default package weight.

Default Length

Set the default package length.

Default Width 

Set the default package width.

Default Height 

Set the default package height.

Handling Fee 

A handling fee can be set, which will be added to the shipping cost during checkout.

Is Customs Declarable

Set whether the customs declaration can be set on the package.

Unit of Measurement

By default, the unit of measurement is set to “Metric”. However, you can choose to change it to the “Imperial” system.

Currency

By default, the US currency rate will be set for the products. However, if you are shipping internationally, you can set the rates. Refer to the DHL official website to learn more about shipping rate changes.After configuring the DHL shipping carrier, click "Save and Close" to apply and save your changes.

Displaying DHL as the Shipping Method on the Checkout

Once DHL is selected as the shipping carrier, customers will be able to choose a shipping method based on the enabled services.

For example, if a customer selects New York as their city and enters the zip code 10001, the available pickup points corresponding to that location will be displayed in the pickup point list. 

Please note that for DHL to appear as a shipping method during checkout, customers must select a city and provide a valid zip code.

How To Get API Key, Secret Key, and Account Number

To get your Client API Key, Secret Key, and Account Number, you will need to head over to the official DHL Developers website and sign up for a DHL account or log in to an existing account. Then, you will have to follow the given steps:

• You particularly require the MyDHL API. From your DHL Developers User Dashboard, go to APIs > Shipping APIs. From the filter options, select DHL Express as the division and locate DHL Express - MyDHL API. Click on Get Access, then fill in the required details.
• From your Dashboard again, navigate to Apps and click on Create App.
• Fill out the required details, such as “App name”, and select the APIs. Once you create your app, you will be returned to the Apps section. You need to wait for the approval of your app. 
• Once the status becomes approved, click on the app. This is where you will find your API Key and API Secret.

To learn more about how to acquire your API credentials, please refer to the official DHL documentation.