> For the complete documentation index, see [llms.txt](https://helpcenter.etron.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.etron.info/verwaltungsoberflache/konfiguration/auftragswesen/versandmethoden/dhl-anbindung.md).

# 🔧DHL Anbindung

{% hint style="success" %}
*M*o*dul: ETRON onRetail DHL*                                                             
{% endhint %}

> *Konfiguration -> Auftragswesen -> Versandmethoden*

Über die Versandmethode mit dem Anbieter "DHL Paket (REST)" kann DHL Paket mit ETRON onRetail verknüpft werden um **Pakete über DHL Paket** (Post & Parcel Germany) **zu versenden**. 

## DHL Anbindung einrichten

{% stepper %}
{% step %}

### DHL Versandmethode erstellen und konfigurieren

**Voraussetzungen:**

* *Modul "ETRON onRetail DHL" ist aktiviert*
* *DHL-Geschäftskundenkonto mit DHL Post\&Parcel Germany*
* [*DHL Developer Portal App*](https://developer.dhl.com/user/login?destination=/node/102\&lang=de) *mit API "Parcel DE Shipping (Post & Parcel Germany)"*
* *Für die Anbindung wird ein Benutzer mit der Systemrolle "Manager" und der Rolle "DHL - Administrator" und "Auftragswesen - Administrator" benötigt*
* *DHL Paket benötigt eine deutsche Absenderadresse bzw. Lageradresse*

Unter [*Konfiguration -> Auftragswesen-> Versandmethoden*](/verwaltungsoberflache/konfiguration/auftragswesen/versandmethoden.md) den Button ![](/files/c2eLqa6MLzvAsrBjvcFJ) auswählen um eine **neue Versandmethode mit DHL Anbindung zu erstellen**.

<figure><img src="/files/QOTt5rMKqt96lAwWHSqS" alt="Versandmethode mit dem Anbieter &#x22;DHL PAKET (REST)"><figcaption><p>Versandmethode mit dem <strong>Anbieter "DHL PAKET (REST)"</strong></p></figcaption></figure>
{% endstep %}

{% step %}

### Name und Anbieter

Als **Name "DHL Paket"** eintragen und als **Anbieter "DHL Paket (REST)"** auswählen.\
Dadurch wird der Reiter "DHL Paket Versand (Rest)" angezeigt.

<div data-with-frame="true"><figure><img src="/files/yxEqhvXWtRRApBwGXanl" alt="Reiter &#x22;DHL Paket Versand (Rest)&#x22; "><figcaption><p>Reiter "DHL Paket Versand (Rest)" </p></figcaption></figure></div>
{% endstep %}

{% step %}

### Lieferprodukt

<div data-with-frame="true"><figure><img src="/files/IXBcyH0VKhaPg8mKFQqi" alt="DHL Einstellung: Lieferprodukt"><figcaption></figcaption></figure></div>

Als **Lieferprodukt** kann ein bereits vorhandenes **Versandprodukt mit der Produktart "Dienstleistung"** gewählt, oder ein neues Produkt erstellt werden, z.B. "Versand DHL".
{% endstep %}

{% step %}

### Zugangsdaten

Im **Reiter "DHL Paket Versand (Rest)"** unter **Benutzer und DHL Passwort** die **Zugangsdaten des DHL Geschäftskundenkontos** eintragen.\
Unter **DHL API Key und DHL API Secret** werden die **API-Verbindungsdaten aus der** [DHL Developer Portal App](https://developer.dhl.com/user/login?destination=/node/102\&lang=de) eingegeben (kann beim ETRON Support eingeholt bzw. von diesem erstellt werden).

<div data-with-frame="true"><figure><img src="/files/7V2209np3XLZ2K3feACP" alt="Reiter &#x22;DHL Paket Versand (Rest)&#x22; in dem die Zugangsdaten und Versand-Einstellungen vorgenommen werden"><figcaption><p>Reiter "DHL Paket Versand (Rest)" in dem die Zugangsdaten und Versand-Einstellungen vorgenommen werden</p></figcaption></figure></div>
{% endstep %}

{% step %}

### Produkt, EKP-Nummer, Teilnahme Nr.

Als **Produkt** die **DHL-Dienstleistung** eintragen, **z.B. Paket International** (wenn auch an Kunden außerhalb DE versendet wird).

<div data-with-frame="true"><figure><img src="/files/igIgqAkbOjVjpdOa8myp" alt="Verfügbare DHL Produkte"><figcaption><p>Verfügbare DHL Produkte</p></figcaption></figure></div>

Die **EKP-Nummer** setzt sich aus den **ersten 10 Stellen der DHL-Kunden-/Abrechnungsnumme**r zusammen.

Die **Teilnahme Nr.** ist **2-stellig** und zumeist 01.

<div data-with-frame="true"><figure><img src="/files/hMtdHIoOjy6QivXXbg2W" alt="DHL: EKP Nummer und Teilnahme Nummer"><figcaption></figcaption></figure></div>

**EKP- und Teilnahmenummer sind im DHL-Geschäftskundenportal einsehbar** und sollten aus diesem übernommen und eingetragen werden.
{% endstep %}

{% step %}

### Lageradresse als Absenderadresse verwenden

Bei aktivierter Einstellung wird die beim [Lager hinterlegte Adresse](/verwaltungsoberflache/konfiguration/lager/gesamtlager.md#adresse) als Versandadresse übernommen.\
Bei deaktivierter Einstellung muss ein Stammdatenkontakt als **Absenderadresse** eingetragen werden.

<div align="left" data-with-frame="true"><figure><img src="/files/8f3GVuLP89IFCLD1G9Os" alt="DHL Einstellung: Lageradresse als Absenderadresse verwenden"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Benutzerdefinierter Tariftyp, Benutzerdefinierte Tarife

Als **Benutzerdefinierter Tariftyp "Festpreis"** auswählen, um einen fixen Preis zu setzen, **oder "Basierend auf Regeln"** wählen, um den Preis über Bedingungen, wie z.B. dem Versandgewicht, zu setzen. Der Festpreis bzw. die Preisregeln werden im **Reiter "Benutzerdefinierte Tarife"** eingestellt.&#x20;

<div data-with-frame="true"><figure><img src="/files/rXKTEKcZQnMDcP3fz20V" alt="DHL Einstellungen: Benutzerdefinierte Tariftyp und benutzerdefinierte Tarife"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Abrechnungspolitik

Bei der **Abrechnungspolitik "Geschätzte Kosten"** auswählen, damit der Preis der Versandmethode in Aufträgen und Bestellungen **anhand der benutzerdefinierten Tarife gesetzt** wird.
{% endstep %}

{% step %}

### Internationale Sendung

<div data-with-frame="true"><figure><img src="/files/Z0SNK4Vt3KsQwZTMyb9b" alt="DHL Einstellungen für internationalen Versand"><figcaption></figcaption></figure></div>

Handelt es sich um einen **Internationalen Versand den Toggle "Internationale Sendung"  aktivieren** und den **Exporttyp** sowie die **Handelsbedingungen**, z.B. DDP - Verzollt geliefert **einstellen**.
{% endstep %}

{% step %}

### DHL Paket Sendung, Gewichtseinheit, Etikettenformat und Etikettentyp

<div data-with-frame="true"><figure><img src="/files/32b7EltLnhver0ifXKKB" alt="DHL Einstellungen: Paket, Gewichtseinheit, Labelformat, Labeltyp"><figcaption></figcaption></figure></div>

Als **DHL Paket Sendung** ein **Paket hinterlegen** und für dieses die Maße, das Gewicht usw. einstellen. Das Gewicht des Pakets wird automatisch zum Versandgewicht dazugerechnet (Versandgewicht = Paketgewicht + Produktgewicht)

<div data-with-frame="true"><figure><img src="/files/qr5O5Ax24qMldXH1GlBB" alt=""><figcaption></figcaption></figure></div>

Bei der **Gewichtseinheit "Kilogramm"** einstellen.

Beim **Etikettenformat** für das Versandetikett das benötigte Druck-Format einstellen.

<div data-with-frame="true"><figure><img src="/files/dbYbrzuqTWWxyScL7VSA" alt="Einstellung DHL: Etikettenformat"><figcaption></figcaption></figure></div>

Beim **Etikettentyp** kann zwischen **"PDF"** und **"ZPL"** gewählt werden.

<div data-with-frame="true"><figure><img src="/files/ADsAVoxDJROgjPl2CWQ1" alt="Einstellung DHL: Etikettentyp"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Standardtelefonnummer für Kunden

<div align="left" data-with-frame="true"><figure><img src="/files/FJ58PNLDORr0xra0S7jP" alt="Standardtelefonnummer für Kunden"><figcaption></figcaption></figure></div>

DHL benötigt eine Telefonnummer vom Empfänger. Wird diese nicht angegeben, kann kein Label erstellt werden.\
Daher kann eine Standardtelefonnummer für Kunden angegeben werden, die verwendet wird, wenn beim [Empfänger-Kontakt](/verwaltungsoberflache/stammdaten/kontakte.md) keine Telefonnummer hinterlegt ist.&#x20;
{% endstep %}

{% step %}

### Automatische Versandbestätigungs-Email aktivieren

Damit beim Versand der Bestellung ([Validieren des Transfers](/verwaltungsoberflache/lager/vorgange/transfers.md)) automatisch eine **Versandbestätigungs-Email mit Sendungsverfolgungslink** an den Kunden gesendet wird, muss unter [Einstellungen -> Lager -> Versand die Einstellung "E-Mail-Bestätigung" aktiviert](/verwaltungsoberflache/einstellungen/allgemeine-einstellungen/lager/versand.md#e-mail-bestatigung) sein.  Als **E-Mail-Vorlage** für die Verstandbestätigung-E-Mail wird die Vorlage **"Versand: Per E-Mail senden"** verwendet.

<figure><img src="/files/CHsOG0EThN1aFAEZij4e" alt="Einstellung &#x22;Lager -> Versand -> E-Mail-Bestätigung&#x22; aktivieren, um automatisch eine Versandbestätigungs-Email an den Kunden zu senden"><figcaption><p>Einstellung "Lager -> Versand -> E-Mail-Bestätigung" aktivieren, um automatisch eine Versandbestätigungs-Email an den Kunden zu senden</p></figcaption></figure>
{% endstep %}

{% step %}

### DHL Testmodus zu Livemodus  umschalten

Um die DHL Integration vom Test-Modus in den **Live-Modus** zu schalten, den Button ![Button Test-Umgebung](/files/WCxOOPzUjOu19qp4V2R9) auswählen. \
Bei aktivem Live-Modus wird der Button so angezeigt: ![Produktions-Umgebung](/files/eUDoB0cFYXW9sGSx4sTO)&#x20;
{% endstep %}

{% step %}

### Veröffentlichen

{% hint style="info" %}
*Vor dem Veröffentlichen kann die DHL Integration noch getestet werden:* [*DHL Anbindung im Testmodus testen*](#dhl-anbindung-im-testmodus-testen)
{% endhint %}

Wenn die **Versandmethode im Onlineshop verfügbar** sein soll, den Button <img src="/files/CpQMGWdDtndCmK4dIMmh" alt="" data-size="line"> auswählen, so dass diese <mark style="color:green;">Veröffentlicht</mark> ist. Dadurch wird der die Versandmethode im Checkout des Onlineshops angezeigt.
{% endstep %}

{% step %}

### Wichtig betreffend Datenschutz: AGBs/DSGVO anpassen

In den AGBs bzw. DSGVO der Verwaltungsoberfläche und des Onlineshops muss angegeben werden, dass die Adressdaten sowie die Telefonnummer an DHL weitergegeben werden.

z.B. in der Verwaltungsoberfläche unter [Einstellungen -> Allgemeine Einstellungen -> Allgemeine Geschäftsbedingungen](/verwaltungsoberflache/einstellungen/allgemeine-einstellungen/allgemeine-einstellungen/unternehmen.md#allgemeine-geschaftsbedingungen)

und unter [E-Commerce -> Editor -> Seiten](/verwaltungsoberflache/e-commerce/editor/seiten.md) -> Seite: /datenschutzerklaerung

<figure><img src="/files/XECjdtsThJLqpwBmjVDY" alt="unter E-Commerce -> Editor -> Seiten die Seite &#x22;/datenschutzerklaerung&#x22; anpassen"><figcaption><p>unter E-Commerce -> Editor -> Seiten die Seite "/datenschutzerklaerung" anpassen</p></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
*Damit ist die Konfiguration und Verknüpfung der Versandmethode mit der DHL Integration abgeschlossen.*
{% endhint %}

## DHL Anbindung im Testmodus testen

1. Um die DHL Anbindung zu testen, muss in der Verwaltungsoberfläche von ETRON onRetail die **Versandmethode** mit dem Anbieter "**DHL Paket**" in den **Testmodus** geschalten werden.
2. Bei der Versandmethode muss folgender Benutzername und Passwort eingegeben werden:\
   **Benutzer: user-valid**\
   **Passwort: SandboxPasswort2023!**

<div data-with-frame="true"><figure><img src="/files/UzwpZ7MJm0uEToy0Hn7p" alt="DHL-Versandmethode für den Testmodus: Test-Benutzer und Test-Passwort eingeben und die &#x22;Test-Umgebung&#x22; aktivieren"><figcaption><p>DHL-Versandmethode für den Testmodus: Test-Benutzer und Test-Passwort eingeben und die "Test-Umgebung" aktivieren</p></figcaption></figure></div>

3. Auf der [DHL Developer Portal App](https://developer.dhl.com/user/login?destination=/node/102\&lang=de) muss die API "**Parcel DE Shipping  - Customer (Integration) Testing**"  hinzugefügt werden, um über die Sandbox testen zu können.

<div data-with-frame="true"><figure><img src="/files/DiGNl3easbuvqDKxE7fK" alt="DHL-Test-API in der DHL-Entwickler-App"><figcaption><p>DHL-Test-API in der DHL-Developer-Portal-App</p></figcaption></figure></div>

## Bestellung mit DHL Paket versenden

**Voraussetzungen:**

* *In den Produkt-Stammdaten ist für die* [*Produkte im Reiter "Lager" ein Gewicht*](/verwaltungsoberflache/stammdaten/produkte/produkte-produktstammblatt/lager.md#gewicht) *hinterlegt. Dieses wird für die Berechnung des Versandgewichts benötigt.*&#x20;
* *Beim Empfänger der Sendung muss eine Telefonnummer hinterlegt sein.*&#x20;
  * *in der Verwaltungsoberfläche kann die Einstellung* [*Telefonnummer erforderlich*](/verwaltungsoberflache/einstellungen/allgemeine-einstellungen/website/shop-kassiervorgang.md#telefonnummer-erforderlich) *aktiviert werden, dadurch müssen Kunden bei der Registrierung im Onlineshop eine Telefonummer angeben. Als Alternative kann in der Versandmethode eine* [*Standardtelefonnummer für Kunden*](#standardtelefonnummer-fur-kunden) *eingetragen werden, die verwendet wird, wenn beim Empfänger-Kontakt keine Telefonnummer hinterlegt ist.*&#x20;

### Beispiel: Bestellung im Onlineshop mit DHL Paket versenden

Im Onlineshop wird eine **Bestellung aufgegeben**, und dabei die für den Onlineshop veröffentlichte **Versandmethode "DHL"** ausgewählt.

<div data-with-frame="true"><figure><img src="/files/gPEXC25hI7VAqYkWHyyK" alt=""><figcaption></figcaption></figure></div>

### Beispiel: Auftrag im Auftragswesen mit DHL Paket versenden

Im Auftragswesen ein neues Angebot erstellen, und um die Versandmethode hinzuzufügen den Button <img src="/files/Io45uBpnN9FVU0V86T0h" alt="Versand hinzufügen" data-size="line">auswählen.

<div data-with-frame="true"><figure><img src="/files/rtmzh7YWrdddW1MUKo8c" alt=""><figcaption></figcaption></figure></div>

In dem Popup die Versandmethode "DHL" und "Preis erhalten" auswählen. Dadurch wird der über die Versandmethode festgelegte Preis übernommen. Über den Button <img src="/files/81Y2Jj6xvw6ncWfqT0Np" alt="" data-size="line">  die Versandmethode zum Auftrag hinzufügen.

<div data-with-frame="true"><figure><img src="/files/R2zx0XfcHjOGw8Q0y2q9" alt=""><figcaption></figcaption></figure></div>

Anschließend das Angebot bestätigen.

<div data-with-frame="true"><figure><img src="/files/ng92SkKsO2lY79ZgQK8I" alt=""><figcaption></figcaption></figure></div>

### Lieferung validieren und mit DHL versenden

Den zur Onlineshop-Bestellung bzw. Auftrag **zugehörigen Liefervorgang** bzw. Transfer nun **validieren**.&#x20;

<div data-with-frame="true"><figure><img src="/files/YhKtflJdY6WRdDwwX7Fk" alt=""><figcaption></figcaption></figure></div>

Nach der Validierung ist im **Reiter "Zusätzliche Infos"** im **Feld "Sendungsverfolgungsnummer"**  die **DHL-Sendungsnummer** ersichtlich. Über den **Button "-> Abbrechen"** daneben kann die DHL-Sendung storniert werden.

<figure><img src="/files/i5a0L5y2sZUKSWb0p2DY" alt=""><figcaption></figcaption></figure>

Die **Versandbestätigungs-E-Mail** wird **automatisch** an den Kunden **versendet.**&#x20;

<div data-with-frame="true"><figure><img src="/files/tewVeyUDYrbQXLMryHca" alt=""><figcaption></figcaption></figure></div>

Diese beinhaltet auch einen **Link**, der zur **Sendungsverfolgung** führt

Das **DHL-Versandlabel** für die Sendung befindet sich **im Chatter**

<div data-with-frame="true"><figure><img src="/files/9PMohWezd7ra62QT7Hme" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/dGvFl8yqYbWTTo1HCF04" alt=""><figcaption></figcaption></figure></div>

{% file src="/files/zkhzQteLS5AHbnjLNKRh" %}

Es können auch mehrere Versandlabels auf einmal über die Transfer-Ansicht ([Lager -> Vorgänge -> Transfers](/verwaltungsoberflache/lager/vorgange/transfers.md)) heruntergeladen werden.&#x20;

Dafür werden in der Listenansicht mehrere Transfers über die Checkbox markiert und anschließend im **Aktion**s-Menü der Menüpunkt **Download DHL Label(s)** ausgewählt.

<div data-with-frame="true"><figure><img src="/files/FTiZoLUQELU6biKNRvkR" alt=""><figcaption></figcaption></figure></div>

## Retouren mit DHL abwickeln

{% hint style="warning" %}
*Das DHL-Modul unterstützt keine automatische Erstellung von Retourenlabels.*\
*Retourenlabels sowie das Rücksendungsporto müssen direkt im DHL-Geschäftskundenportal erstellt und verwaltet werden.*
{% endhint %}

{% stepper %}
{% step %}

### Retoure im System vorbereiten

Wenn der Endkunde eine Retoure ankündigt:

1. Zum entsprechenden LIeferschein wechseln\
   \&#xNAN;*<mark style="color:$tint;">Tipp für schnelles Finden:</mark> Lieferschein-Referenz in die* [*Lupe*](/schnelles-wissen/verwaltungsoberflache/allgemeine-funktionen/menuleiste-and-benutzermenu.md#lupe-suchen) *oben rechts eintragen*<br>

   <div data-with-frame="true"><figure><img src="/files/PII0FlLcKsOXloIZkKiJ" alt=""><figcaption></figcaption></figure></div>

2. Button "Retoure ausführen" auswählen

3. Im Fenster: Alle Produkte löschen, die **nicht** retourniert werden und anwenden

4. Ein neuer Lieferschein wird erstellt, welcher **noch nicht** validiert werden soll

{% hint style="info" %}
*Der Retouren-Lieferschein dient als Vorbereitung und bleibt offen, bis die Ware physisch eingelangt ist.*
{% endhint %}
{% endstep %}

{% step %}

### Retourenlabel in DHL erstellen

Die Erstellung des Retourenlabels erfolgt direkt in DHL.

1. Im DHL Geschäftskundenportal einloggen
2. Retourenlabel erstellen
3. Rücksendungsporto dort festlegen bzw. verrechnen
   {% endstep %}

{% step %}

### Empfohlen: E-Mail in ETRON onRetail an Kunden schicken

Eine eigene E-Mail-Vorlage "Retourenlabel Versand" für "Transfer" erstellen und dem Kunden das Label als Anhang mitsenden.

Erstellung einer E-Mail-Vorlage: [*Konfiguration -> Kommunikation -> Vorlagen*](/verwaltungsoberflache/konfiguration/kommunikation/vorlagen.md)

{% hint style="info" %}
*Tipp: Die Vorlage "Versand: Per E-Mail senden" kann dupliziert und angepasst werden, da die passenden Felder bereits inkludiert sind.*
{% endhint %}
{% endstep %}

{% step %}

### Wareneingang der Retoure

Sobald die Ware wieder im Lageer eintrifft:

1. Retouren-Lieferschein öffnen
2. Wareneingang prüfen
3. Retouren-Lieferschein validieren
4. Optional: Informations-E-Mail an den Kunden senden\
   -> Eigene E-Mail-Vorlage für "Retoure eingelangt" erstellen
   {% endstep %}

{% step %}

### Gutschrift erstellen

Falls eine Rückerstattung erforderlich ist:

1. Zum ursprünglichen **Auftrag** wechseln\
   \&#xNAN;*<mark style="color:$tint;">Tipp:</mark>* *Über den Chatter im Retouren-Lieferschein kann in den ursprünglichen Lieferschein gewechselt werden. Dieser hat dann den Auftrag im Chatter hinterlegt.*<br>

   <div data-with-frame="true"><figure><img src="/files/GtiaTkuWdNwMKKzTJENs" alt=""><figcaption></figcaption></figure></div>

2. Zur hinterlegten Rechnung navigieren

3. Button "Gutschrift hinzufügen" auswählen

4. Option "Stornieren" wählen

5. Alle Positionen löschen, die **nicht** erstattet werden

6. Bestätigen

7. Zahlung **registrieren**, die dem Kunden rückerstattet wird.

8. Dem Kunden mit "Senden und Drucken" Bescheid geben, dass die Rückerstattung durchgeführt wurde.
   {% endstep %}
   {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://helpcenter.etron.info/verwaltungsoberflache/konfiguration/auftragswesen/versandmethoden/dhl-anbindung.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.