DHL Preferred Delivery

1. General information

The DHL Preferred Delivery plugin allows you to show the DHL Preferred Delivery services in your plentyShop.

New plugin version 2.0.0

Plugin versions 2.0.0 and higher were developed as an extension of the core integration DHL Shipping.
Versions prior to 2.0.0 reached their end of life (EOL) on 13 August 2025, and can no longer be used.
To ensure that DHL Preferred Delivery continues to function without restrictions and reliably, it is essential to update to the new version 2.0. 0 of the DHL Preferred Delivery plugin.

You can find the settings for DHL Preferred Delivery under Setup » Orders » Shipping » Shipping service provider » DHL Shipping → Preferred delivery settings. Select your preferred delivery services and the Packstation/Postfiliale finder display here.

Tracking pixel for reporting purposes

Note that the DHL Preferred Delivery plugin contains a tracking pixel. This is due to reporting purposes. The pixel returns the URL where the plugin is used as well as the total number of plugin calls. No person-related data or data that could be related to persons will be collected or processed.

2. Prerequisites

In order that you can offer your customers the DHL Preferred Delivery services in your plentyShop, the following requirements have to be met.

2.1. Registering with DHL

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

Note that the DHL Preferred Delivery services are only available for deliveries within Germany.

2.2. Installing the plugin

To use the DHL Preferred Delivery services, you need plugin version 2.0.0 or higher.

2.3. Selecting DHL Shipping as shipping service provider

DHL Shipping has to be selected as shipping service provider in the Setup » Orders » Shipping » Settings menu in the Shipping service provider tab.

3. Preferred delivery settings

Carrying out Preferred delivery settings:

  1. Go to Setup » Orders » Shipping » Shipping service provider » DHL Shipping » Preferred delivery settings.

  2. Under Additional charge, specify the surcharge your customers should pay for the Preferred day service.
    The amount you enter is the gross price and will be charged to your customers when they select the service.
    Enter 0 if you want to offer the service free of charge.

  3. Select the cut-off time. This is the latest possible order time at which the minimum desired delivery date (order date + 2 business days) can be guaranteed. If the deadline has passed, the earliest possible delivery date displayed in the front end is postponed by one day (order date + 3 business days).

  4. Under Exclusion of transfer days, you can optionally activate weekdays on which you are unable to hand over items to DHL.
    Note: Sundays and public holidays are automatically filtered out by the DHL API.

  5. Enter your Google Maps API key so that the Finder can be used correctly. You can enable the finder under Setup » Orders » Shipping » Shipping service provider » DHL Shipping » Shipping settings.

  6. Activate the toggle if the DHL postal code is to be a mandatory field when a post office is selected in the Finder.

  7. Save (save) your settings.

4. DHL Packstation/Filiale finder

Your customers can use the DHL Packstation/Postfiliale finder during the order process in your plentyShop to search for a packstation or post office nearby and select this address as delivery address. This way, your customers can pick up your parcels when it suits them best. To do so, they select an appropriate Packstation or post office during the order process from the results list. This address is then saved as the delivery address.

Note: Your customers can enter the street, postcode or town. If the street is entered, it is required for the search to display results that in addition at least the postcode or the town is entered.

Google Maps API key required

In order that the DHL Packstation/Postfiliale finder is available for your customers in the checkout of your plentyShop, you need a Google Maps API key.
Notice Regarding the Required Consent of Users in the EU

When using Google Maps, you are obligated to inform users about the nature of the data usage. We would like to point out that when using services that transmit personal data to a third country (e.g., the USA), the requirements for permissible data transfer pursuant to Articles 44 et seq. of the GDPR must be met. This applies, for example, when Google Maps is used.

Setting the visibility of the DHL Packstation/Postfiliale finder in the plentyShop

In order that your customers can use the DHL Packstation/Postfiliale finder during the order process in your plentyShop, you have to activate some options in the plugin’s Container links area.

Setting the visibility of the DHL Packstation/Postfiliale finder in the plentyShop:

  1. Go to Plugins » Plugin overview.

  2. Click on the table row of the plugin set that contains the DHL Preferred delivery plugin.

  3. Click on the table row DHL Preferred delivery.

  4. Go to Container links.

  5. Expand the area Container links.

  6. Select from the drop-down list Data provider the option DHL Packstation/Postfiliale Checkout View.

  7. Select from the drop-down list plentyShop LTS on the right the option Checkout: After shipping method.

  8. Select from the drop-down list Data provider the option DHL Packstation/Postfiliale Scripts.

  9. Select from the drop-down list plentyShop LTS on the right the option Checkout: After scripts loaded.

  10. Select from the drop-down list Data provider the option DHL Packstation/Postfiliale Styles.

  11. Select from the drop-down list plentyShop LTS on the right the option Checkout: After shipping method.

  12. Save () the settings.

5. Examples of possible options of preferred days during the checkout

In the following, you find examples of the settings of preferred days and cut-off times and how these settings affect the options your customers can choose from during the checkout.

Note that the time of registering the shipment in the following examples does not refer to the exact time when the customer completes the order process. The possible preferred days that can be selected by the customer is updated when the customer opens the checkout or updates the address.

Example 1: Time of registering the shipment: Tuesday, 19 August 2025, 12:00pm, without exclusion of transfer days

  • Setting for Cut-off time: 1:00pm

  • Setting for Exclusion of transfer days: none

Days the customer can select in the checkout:

  • Thursday (21 August 2025)

  • Friday (22 August 2025)

  • Saturday (23 August 2025)

  • Monday (25 August 2025)

  • Tuesday (26 August 2025)

  • Wednesday (27 August 2025)

Example 2: Time of registering the shipment: Tuesday, 19 August 2025, 14:00pm, without exclusion of transfer days

  • Setting for Cut-off time: 1:00pm

  • Setting for Exclusion of transfer days: none

Days the customer can select in the checkout:

  • Friday (22 August 2025)

  • Saturday (23 August 2025)

  • Monday (25 August 2025)

  • Tuesday (26 August 2025)

  • Wednesday (27 August 2025)

  • Thursday (28 August 2025)

Example 3: Time of registering the shipment: Tuesday, 19 August 2025, 2:00pm, with exclusion of transfer days

  • Setting for Cut-off time: 1:00pm

  • Setting for* Exclusion of transfer days*: Tuesday, Wednesday

Days the customer can select in the checkout:

  • Saturday (23 August 2025)

  • Monday (25 August 2025)

  • Tuesday (26 August 2025)

  • Wednesday (27 August 2025)

  • Thursday (28 August 2025)

  • Friday (29 August 2025)