Overview

Integrate with Magento to import your orders, create shipment labels and show live DHL Express rates at your checkout. 

The integration can also write back tracking information to these after printing your shipment labels. 

There are two ways to connect your Magento2 store with DHL Express Commerce. Token based authentication is recommended especially if you are using two-factor authentication on your store.

As of Magento 2.4 two-factor authentication is enabled by default on Magento2. This means you will need to use token authentication to connect with DHL Express Commerce.

Magento 2.4.4 users will need to enable token access in the Admin by setting the Stores > Configuration > Services > OAuth > Consumer Settings > Allow OAuth Access Tokens to be used as standalone Bearer tokens option to Yes. 

1. Set up access for DHL Express Commerce to Magento2

Token Authentication (recommended)

Create an access token.

1. Log into your Magento2 admin page.
2. At the very bottom left of the sidebar click System > Extensions > Integrations.
3. Click Add New Integration.
   • Enter DHL in the Name field.
   • Enter your admin password in the Your Password field. Leave all other fields blank.
   • Click the API tab.
   • Under the Resource Access dropdown select All.
   • Click Save in the top right of the screen.
4. You will then be taken back to the Integrations page.
5. Click Allow.
6. A dialog will appear with a Consumer Key, Consumer Secret, Access Token, and Access Token Secret.
7. Only the Access Token is required. Copy your Access Token and click Done.

User Authentication 

Note: Skip this section if you have completed the steps above for Token Authentication

Create a new role

1. Go to your Magento Admin Dashboard and select System.
2. Under Permissions, select User Roles.
3. Click Add New Role.
4. In Role Name, enter Integration, then select the Role Resources tab.
5. From the Resource Access dropdown, select All.
6. Click Save Role.

Assign your new role to a user

1. From the Dashboard panel, select System.
2. Under Permissions, select All Users.
3. From the Users page, click Add New User.
4. Enter the required user information. We recommend you note your username and password for later use.
5. Select the User Role tab, then select the Integration role you previously created.
6. Click Save User.

2. Enter your Magento 2 details

1. Log into DHL Express Commerce
2. In your account select Settings, then select Integrations.
3. Click Add a new integration, and select Magento 2.
4. Select your Authentication Method from step 1.
5. Click the Enable Magento 2 checkbox.
6. Enter the URL of your site eg https://www.myShop.com
7. Enter your Access Token or Username and Password.
8. Select your Import status.
9. Test your connection, and then click Save.

Troubleshooting

Error: "The Consumer isnt authorized to access %resources%"

If you encounter this error then navigate to

Stores > Configuration > Services > OAuth > Consumer Settings > Allow OAuth Access Tokens to be used as standalone Bearer tokens option to Yes

Additional Configuration

Importing HS Codes and Country Of Manufacturer

As these fields do not exist natively in the Magento system, custom product attributes have to be created so it can be imported into DHL Express Commerce.

• DEC will automatically import an HS Code for each item if present as a product attribute. The product attribute code name must be set to hs_code.
  
  
• DEC will automatically import Country of Manufacture for each item if present as a product attribute. The product attribute code name must be set to country_of_manufacture or country_of_origin.