Skip to main content

DHL Shipping (Versenden)

Setting up the DHL Shipping (Versenden) plugin

You need a plugin to link plentymarkets to DHL Shipping (Versenden). Visit the plentyMarketplace  to download the DHL Shipping (Versenden) plugin.

1. Registering with DHL

In order to set up the interface for DHL Shipping (Versenden) in your plentymarkets system and use the function Versenden (shipping) in the DHL business customer portal, you have to be registered with DHL . You receive the data from DHL that you need for the settings in plentymarkets.

2. Setting up DHL Shipping (Versenden) in plentymarkets

Simply setting up DHL Shipping (Versenden) with the help of assistants

You need a plugin to link plentymarkets to DHL Shipping (Versenden). Visit the plentyMarketplace  to download the DHL Shipping (Versenden) plugin.
Two DHL Shipping (Versenden) assistants that allow an easy setup are then available in the Setup » Assistants menu in the Integration area.

Before completing the two DHL Shipping (Versenden) assistants, you need to complete the Shipping settings assistant. This assistant is available in your plentymarkets system by default. You can find it in the Setup » Assistants menu in the Integration area. With this assistant, carry out the following settings:

  • determine a name for the shipping setting (i.e. the shipping profile)

  • activate existing regions or create a new region

  • determine the shipping costs and select the calculation type

  • Note: Afterwards, go to Setup » Orders » Shipping » Settings and click on the Shipping profiles tab to carry out further settings for the shipping profile. Further information on these settings are provided below on this manual page.

Afterwards, complete the two DHL Shipping (Versenden) assistants:

  • DHL Shipping (Versenden): Basic settings

    • In this assistant, prepare all the data that you later need in the DHL Shipping (Versenden): Settings combination assistant.

  • DHL Shipping (Versenden): Settings combination

    • In this assistant, link the settings that you saved in the DHL Shipping (Versenden): Basic settings assistant and select the product and the appropriate services.

Further down on this page, it is described which data you need to enter in the assistants.

3. Carrying out the preparatory settings

First, you have to carry out some preparatory settings in the plentymarkets back end:

  • Set up countries of delivery

    • You can set up the countries of delivery in the Shipping settings assistant or in the back end.

  • Create regions

    • You can create regions in the Shipping settings assistant or in the back end.

  • create the shipping service provider DHL Shipping (Versenden)

    • Currently, you can create the shipping service provider only in the back end and not in an assistant.

  • create a shipping profile and the table of shipping charges for DHL Shipping (Versenden)

    • You can set up some of the shipping settings in the Shipping settings assistant. The remaining settings have to be carried out in the back end in the Setup » Orders » Shipping » Settings menu in the Shipping profiles tab.
      Important: Not all functions and settings have been transferred from the shipping profile to the Shipping settings assistant yet. Note the explanations in the Completing the Shipping settings assistant chapter.

4. Completing the assistants

As soon as you have installed the plugin in a plugin set, the DHL Shipping (Versenden): Basic settings and the DHL Shipping (Versenden): Settings combination assistants are available in the Setup » Assistants menu in the Integration area.

Now complete the assistants in the following order:

  1. Shipping settings (this assistant is available by default in your plentymarkets system)

  2. DHL Shipping (Versenden): Basic settings

  3. DHL Shipping (Versenden): Settings combination

4.1. Completing the Shipping settings assistant

In this assistant, carry out the following settings:

  • Enter a back end and a front end name for the shipping setting. These names can be selected per language.

    • Link this name later in the DHL Shipping (Versenden): Settings combination assistant.

  • Select the plugin of the shipping service provider for which you want to set up shipping costs.

    • You have to download the DHL Shipping (Versenden) plugin in the plentyMarketplace  before you can see it here.

  • Select a region, enter the shipping costs and select the calculation type for the selected countries. Furthermore, you can determine the value of items from which no shipping costs will be calculated.

Carry out further settings for the shipping settings in the back end

If you have completed the Shipping settings assistant, the shipping profile also appears in the Setup » Orders » Shipping » Settings menu in the Shipping profile tab.
The following settings are available once the assistant has been completed:

  • the name of the shipping profile is saved

  • the shipping service provider is saved

  • the option Activate for new items is activated

  • all clients (stores) are activated

  • all order referrers are activated

  • the shipping costs are saved

  • the region is saved

If you want to carry out further settings such as blocking customer classes or payment methods or activating the option for the agreement upon data transmission to shipping service providers, you have to go to Setup » Orders » Shipping » Settings and carry out these settings in the Shipping profiles tab in the corresponding shipping profile.

This workaround is still necessary because not all functions and settings have been transferred from the shipping profile to the assistant yet. We will implement the missing settings in the assistant step by step.

When you completed the Shipping settings assistant and open it again, the following information is displayed:

  • In the tile view:

    • Back end name

    • Region

    • Shipping service provider

  • In the table overview:

    • Back end name

    • Region

    • Shipping service provider

    • Front end name

    • ID of the shipping profile

4.2. Completing the DHL Shipping (Versenden): Basic settings assistant

This assistant has several steps to complete. These steps are explained in the following.

Login details

In this step, save your login details for the DHL business customer portal. You can save multiple login details when you have multiple clients (shops) and/or concluded more than one contract with DHL. In the second assistant DHL Shipping (Versenden): Settings combination, you can link this data.

Furthermore, determine for each of your logins whether shipping labels should always be generated, also when shipping orders with non-codable addresses are created, e.g. when the address data is not complete or not available at all. DHL corrects the incorrect data and bills you for this service. Afterwards, the order can be registered successfully.

If the option Force label generation is not activated – i.e. the button is red –, non-codable shipping orders are rejected by DHL when trying to register them with DHL Versenden and an error message is displayed. The order is not registered and no shipping label is generated in your plentymarkets system.

Note:

  • The login name may not contain any umlauts. Even if a login name with umlauts is accepted by the website, the interface may still reject it.

  • The maximum password length is 20 characters. Although DHL technically allows you to use a longer password, you may only use a maximum of 20 characters via the plentymarkets interface. If you use a password that is longer than 20 characters, errors occur.

Shipper data

In this step, enter your shipper data. The data is shown as sender address on the shipping label.

Do you want to display your company logo on the shipping label? To do so, select the option Use shipper reference from the DHL business customer portal. DHL then uses both address data that you saved in the DHL business customer portal and the company logo that you uploaded there. Only the sender reference is transferred to DHL, but not the sender data from plentymarkets.

Note: If you activate the Show polling data area at the bottom of this assistant step, the Account reference and Sender reference fields are visible. Entering the account reference and the sender reference in this area is only necessary if you register your shipments via the polling format. The account reference and the sender reference are not relevant for the transmission via the interface.

Billing number

In this step, save your DHL billing number in accordance with your DHL contract.

The billing number consists of 14 digits in total and is composed of 3 components: EKP (customer number), product and subscription. The first 10 digits are the EKP, the 11th and 12th digit are the product and the 13th and 14th digit are the subscription.

Example of a billing number: 1234567890 53 01

  • 1234567890 is the EKP (customer number)

  • 53 is the product DHL Paket International

  • 01 is the subscription

The following DHL products are available in the assistant:

  • 01 - DHL Paket

  • 53 - DHL Paket International

  • 54 - DHL Europaket

  • 55 - DHL Paket Connect

  • 62 - DHL Warenpost

  • 86 - DHL Paket Austria

  • 87 - DHL Paket Connect (Austria)

  • 82 - DHL Paket Austria International

Reference on label

In this step, you can select the references as they should appear on the shipping label. The setting that you select from the drop-down list Reference per order will be shown on the shipping label once. The setting that you select from the drop-down list Reference per item position will be shown on the shipping label per item position.

Note: Both selected settings will be shown combined in one field on the label. The maximum number of characters is limited to 35. If the maximum number of characters is exceeded, the reference will be cut off after the last pipe and the sign » will be displayed.

You can select the following values for the order data:

  • Order ID

  • External order ID

  • Order ID + external order ID

You can select the following values for the item data:

  • Variation number

  • Variation name

  • Variation ID

  • External variation ID

  • Model

In this step, you can also select whether the number of items per position should be shown on the label and whether the number of packages should be added for this order if it is more than one package.

Summary

In this step, a summary of all entries that you made in the single steps is listed. You can check the settings, adjust them, if needed, and complete the assistant afterwards.

4.3. Completing the DHL Shipping (Versenden): Settings combination assistant

In this assistant, link the settings that you saved in the Shipping settings and DHL Shipping (Versenden): Basic settings assistants. Link your login details with the DHL billing number, the shipper address, the shipping region and the shipping setting and select the services based on the product and your DHL contract. Note that you may need to contact DHL to obtain additional activation for certain products and services.

DHL Wunschpaket services only visible after having purchased the DHL Wunschpaket plugin

The DHL Wunschpaket services Preferred day, Preferred location and Preferred neighbour are only available in this area once you have downloaded the DHL Wunschpaket plugin in the plentyMarketplace  and installed it in a plugin set.
Also for this plugin, there is an assistant available in the Setup » Assistants menu in the Integration area allowing you to simply and quickly set up the services.

Furthermore, you can determine in this assistant whether your customers can use a finder in your online store to select the address of a packstation or a post office as delivery address and whether you want to transfer a minimum package weight to DHL to register the order. In case of international deliveries, select in this assistant also the franking and the shipping type.

Checking the default shipping method and shipping profile

Check which options you have selected for Default shipping method and Default shipping profile in the Setup » Client » Select client » Orders menu.

When you completed the DHL Shipping (Versenden): Settings combination assistant and open it again, the following information is displayed:

  • In the tile view:

    • Shipping setting

    • Region

    • Billing number

  • In the table overview:

    • Shipping setting

    • Region

    • Billing number

    • Login name

    • Services

    • Shipping profile ID

5. Information about data transfer

If you activated the option Agreement upon data transfer in the DHL Shipping (Versenden) shipping profile in the Setup » Orders » Shipping » Setting menu in the Shipping profiles tab, a checkbox is visible for your customers in the checkout of your Ceres online store. Your customers decide whether they agree that their data is transferred to the shipping service provider or not.

  • If the customer agrees that their data is transferred, the email address of the customer is transferred to the shipping service provider.

  • If the customer does not agree that their data is transferred, the alternative email address that you entered in the shipping profile is transferred.

  • If the customer does not agree that their data is transferred and you did not enter an alternative email address in the shipping profile, an error message is displayed and the order cannot be registered with DHL.
    Therefore, it is important that you enter alternative values for the email address and the telephone number in the shipping profile. Otherwise, it is not possible to successfully register the order with DHL when selecting certain services (e.g. retail outlet routing).

Upload polling file in case of DHL failure

If there is a failure of the interface on the part of DHL, it is possible to use the polling format DHL Shipping (Versenden) as an alternative. Generate the polling file containing the orders that should be registered either with a process and plentyBase or go to the Orders » Shipping centre menu. Afterwards, you can upload this file to the DHL business customer portal via the template DHL plentymarkets Importformat.
Note that the following services cannot be transmitted to DHL via the polling format:

  • Return immediately, 2nd attempt of delivery, Verpackungsrücknahme, Unzustellbarkeitsnachricht (when selecting the product 01 - DHL Paket)

  • immediate, after deadline abandonment (when selecting the product 53 - DHL Paket International)

  • DHL Wunschpaket services

6. Using the Retail Outlet Routing service

Thanks to the Retail Outlet Routing service your undeliverable item (in case the recipient is unknown) gets a second change to reach the recipient: Rather than being returned immediately to you, the undeliverable item will be held at the nearest outlet that has a parcel collection point for collection by the recipient. Your recipient will be informed of this by email. If the item is collected by the recipient, the time and costs involved in returning it can be avoided.

In order that your customers can use the Retail Outlet Routing service, the following settings have to be carried out:

  • Go to Setup » Orders » Shipping » Settings and click on the Shipping profiles tab. Then activate the option Agreement upon data transfer in the shipping profile and select an option how the data (email address and phone number) is to be transferred.

  • Go to the DHL Shipping (Versenden): Basic settings assistant and activate the service Retail Outlet Routing in the Product and services selection step.

7. Using the Ident check service

Make sure that your parcels are only delivered to the recipient in person – after the DHL driver has checked the identity and - where applicable- the age against the identity card and documented it.

In order that your customers can use the Ident check service (minimum age 16 or 18), the following setting is important:

  • Go to the DHL Shipping (Versenden): Basic settings assistant and activate the service Ident check in the Product and services selection step.

8. Using DHL Warenpost

Many items are too small to send them in parcels or packages. If you send many of those items, DHL Warenpost might be a convenient solution for you. DHL Warenpost can only be used for deliveries within Germany.

In order that you can offer your customers DHL Warenpost, the item and package data have to be correctly saved and transmitted to the shipping service provider. According to DHL, the following dimensions have to be maintained:

  • Minimum dimension: Length: 10.0 cm, width: 7.0 cm, height: 0.1 cm

  • Maximum dimension: Length: 35.3 cm, width: 25.0 cm, height: 5.0 cm

  • Maximum weight: 1000 g

When registering the order, DHL checks the maximum dimensions and the maximum weight. The minimum dimensions are not checked by DHL when the order is registered.

The following sub-chapters describe the settings that you need to carry out in the plentymarkets back end, in the assistants and in the DHL business customer portal:

8.1. Settings in the back end

  • It is recommended to save the weight of the variations that you want to send with DHL Warenpost in the variation’s Dimensions area.

  • In order to ensure that the dimensions are not exceeded, you can use one of the two options that can be set up in the settings of the shipping package. You can find these options in the Setup » Orders » Shipping » Shipping packages menu in the drop-down list Volume.

dhl shipping warenpost shipping package
Figure 1. Shipping package for DHL Warenpost: Volume

The two options regarding the volume that you can select in the shipping package are explained in detail in the following:

take from the shipping package

In order that the packages in the shipping centre are always generated with the correct dimensions and the order can be successfully registered with DHL Warenpost, you can use the option take from the shipping package and save the permissible maximum dimensions (length, width, height) in cm.

dhl shipping warenpost shipping package dimensions
Figure 2. Shipping package for DHL Warenpost: Dimensions

If you select the settings mentioned above, the dimensions of the shipping package and the gross weight of all variations in the order are transferred to the shipping service provider.

take from the item data (total)

Note: If you select the option take from item data (total), the weight only is transferred to the shipping service provider. The logic does not transfer the other dimensions (length, width, height).

You can, however, have the volume calculated based on a volume limitation in the shipping profile. To do so, select in the region of the corresponding shipping profile the limitation type Maximum (cubic metres) and save the calculated volume from the maximum dimensions in m³ that is prescribed for Warenpost by DHL: 353 mm x 250 mm x 50 mm = 0,0044 m³.
Another possibility is to select the limitation type Maximum (g) in the region of the shipping profile and to save the calculated maximum weight of 1000 g that is prescribed for Warenpost by DHL.

You can select the shipping package as standard package in the corresponding region of the current shipping profile in the Table of shipping charges tab:

dhl shipping warenpost standard package
Figure 3. Shipping package for DHL Warenpost as standard package in the shipping profile

8.2. Settings in the assistants

  • Go to the DHL Shipping (Versenden): Basic settings assistant and select the product 62 - Warenpost in the Billing number step.

  • Go to the DHL Shipping (Versenden): Basic settings assistant and activate the product Warenpost in the Product and services selection step.

  • Go to the DHL Shipping (Versenden): Settings combination assistant and select the billing number for Warenpost and the appropriate services that you want to link with this shipping setting.

8.3. Settings in the DHL business customer portal

Go to the DHL business customer portal and select the appropriate size for the shipping labels:

dhl warenpost label size german
Figure 4. Label sizes required for Warenpost

In the DHL business customer portal, go to the section Ship > Basic settings > General settings and set up the printer settings for your shipping labels. You can activate that the label size 100 x 70 mm is used for Warenpost. Note that it is not possible to print the additional name information for this label size: Sender name 2, sender name 3 and recipient name 3 cannot be printed on the label.

You can also use the common label in the format of 100 x 200 mm for Warenpost.

For further information, refer to the DHL website .

9. Assigning user rights for back end users

In order to use the DHL Shipping plugin, you have to activate some rights for users with Back end access in their user account.

Note that the function Ship has to be activated for the user in the DHL business customer portal.

Assigning user rights for back end users:

  1. Go to Setup » Settings » User » Rights » User.

  2. Use the search function () and open the account that should be edited.

  3. In the Authorisations area, activate the rights as listed in Table 1.

  4. Save () the settings.

Table 1. Assigning user rights for back end users
Setting Explanation

Orders > Show

Authorises the back end user to see orders.

Orders > Update

Authorises the back end user to update orders.

Orders > Shipping > Shipping package

Authorises the back end user to see, update, create and delete the shipping packages as well as the items within the shipping package.

Orders > Shipping > Package type > Show

Authorises the back end user to see package types.

Orders > Order properties > Show

Authorises the back end user to see order properties.

Orders > Documents > Create

Authorises the back end user to create documents, such as shipping labels and export documents via a process and plentyBase.

10. Activating the test mode

By default, the productive mode is activated in the DHL Shipping (Versenden) plugin. You can activate the test mode for the plugin in order to check the settings.

Important: In order to be able to test the settings, login details for a test account (DHL developer portal) are required.

Proceed as described below to activate the test mode for the plugin.

Activating the test mode:

  1. Go to Plugins » Plugin set overview.

  2. Open the plugin set that contains the DHL Shipping (Versenden) plugin by clicking on the table row.

  3. Click on the table row DHL Shipping (Versenden).

  4. Click on Configuration > General.

  5. Select the setting Test from the drop-down list Mode.

  6. Save () the setting.

To top