The following error message occurs:

Anmeldung fehlgeschlagen

login failed

Der Nutzer des Webservice konnte nicht authentifiziert werden


This means the DHL server has rejected the login credentials (username / password).

The login must be configured correctly, or the password might have to be renewed.

Solution: Login configuration for DHL Business Customer Shipping

  1. Create a special System User in the DHL Business Customer Portal. The password for System Users will be valid for a longer time.
  2. Store the System User's name and password (signature) in the Magento configuration.
  3. Make absolutely sure to use the correct upper / lowercase for the username.

If you encounter problems or the login does not work, check if there are additional DHL logins / sub-users.

Note that the password will always expire after some time (see also this article). This applies to System Users, too. The password must be renewed regularly at DHL. The validity period is defined by DHL.

Additional notes

Technically, it is possible to use the standard login data to the DHL Business Customer Portal in Magento, but the password will expire much quicker. Therefore it is strongly recommended to create a separate System User instead (see above), so the password has to be renewed less often.

If the login has worked for some time and now stopped working, please check this article: Why did the login credentials suddenly stop working?