🔧DHL (Integration)
DHL Paket mit ETRON onRetail verknüpfen, Anbindung und Einrichtung von DHL Paketdienst
Modul: ETRON onRetail DHL
Über die DHL Integration kann DHL Paket mit ETRON onRetail verknüpft werden um Pakete über DHL zu versenden.
DHL Integration erstellen und konfigurieren
Voraussetzungen:
Modul "ETRON onRetail DHL" ist aktiviert
Für die Integration wird ein Benutzer mit der Systemrolle "Manager" und der Rolle "DHL - Administrator" und "Lager - Administrator" benötigt
DHL Paket benötigt eine deutsche Absenderadresse (Lageradresse)
Unter Konfiguration -> Lager -> DHL Integration den Button 
auswählen um eine neue DHL Integration zu erstellen.
Als Name "DHL Paket Integration" eintragen und als Versanddienstleister "DHL Paket" auswählen. Dadurch wird der Reiter "Zugangsdaten" angezeigt.
Im Reiter "Zugangsdaten" unter Benutzer und Passwort die Zugangsdaten des DHL Geschäftskundenkontos eintragen. Unter App ID und App Passwort werden die API-Verbindungsdaten aus der DHL-Developer-App eingegeben (kann beim ETRON Support eingeholt bzw. von diesem erstellt werden).
Im Reiter "Konfiguration" erfolgt die Einstellung von Absenderadresse, Tarifen und Mailversand.
Lageradresse als Absenderadresse verwenden
Bei aktivierter Einstellung wird die beim Lager hinterlegte Adresse als Versandadresse übernommen. Bei deaktivierter Einstellung muss ein Stammdatenkontakt als Absenderadresse eingetragen werden.
Individuelle Tarife
Der Toggle "Individuelle Tarife" ist zu aktivieren, wenn für den Versand ein Fixpreis festgelegt oder der Preis abhängig von Bedingungen wie z.B. Gewicht sein soll.
Versandbestätigungs-Mail senden, E-Mail-Vorlage (Versand)
Bei aktiviertem Toggle "Versandbestätigungs-Mail senden" wird beim Versand der Bestellung (Validieren des Transfers) automatisch eine Versandbestätigungs-Email mit Sendungsverfolgungslink an den Kunden gesendet. Als E-Mail-Vorlage für diese E-Mail sollte die Vorlage "Versand: Per E-Mail senden" verwendet werden.
DHL Testmodus zu Livemodus umschalten
Um die DHL Integration vom Test-Modus in den Live-Modus zu schalten, den Button 
auswählen.
Bei aktivem Live-Modus wird der Button so angezeigt 
Damit ist die Konfiguration der DHL Integration abgeschlossen. Sie muss nun mit einer Versandmethode verknüpft werden.
DHL-Versandmethode erstellen und mit DHL Integration verknüpfen
Voraussetzungen:
Für die Konfiguration der DHL Versandmethode wird ein Benutzer mit der Systemrolle "Manager" und der Rolle "Auftragswesen - Administrator" und "DHL - Benutzer/ DHL -Administrator" benötigt
Um die für die DHL Integration benötigte Versandmethode zu erstellen das Menü Konfiguration -> Auftragswesen -> Versandmethoden öffnen, oder in der DHL Integration den Button 
auswählen.
Den Button auswählen um eine neue Versandmethode zu erstellen.
Anbieter, Versanddienstleister und Lieferprodukt
Als Anbieter "DHL Paket" auswählen und als Versanddienstleister die zuvor erstellte Integration "DHL Paket Integration" auswählen.
Als Lieferprodukt kann ein bereits vorhandenes Versandprodukt mit der Produktart "Dienstleistung" gewählt, oder ein neues Produkt erstellt werden, z.B. "DHL Versand".
Preiskalkulation
Als Preiskalkulation "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 "Individuelle Tarife" eingestellt.
Abrechnungspolitik
Bei der Abrechnungspolitik "Geschätzte Kosten" auswählen, damit der Preis der Versandmethode in Aufträgen anhand der individuellen Tarife gesetzt wird. Wird als Abrechnungspolitik "Tatsächliche Kosten" gewählt, ist der individuelle Preis nur in der Beschreibung der Versandprodukt-Zeile im Auftrag/Lieferschein angegeben, und der Preis bleibt 0, bis die tatsächlichen Versandkosten von DHL abgerufen werden.
Reiter "DHL Paket Versand"
Im Reiter "DHL Paket Versand" wird der Paketdienst konfiguriert.
Produkt, EKP-Nummer, Teilnahme Nr.
Als Produkt die DHL-Dienstleistung eintragen, z.B. Paket International (wenn auch an Kunden außerhalb DE versendet wird).
Die EKP-Nummer setzt sich aus den ersten 10 Stellen der DHL-Kunden-/Abrechnungsnummer zusammen.
Die Teilnahme Nr. ist 2-stellig und zumeist 01. EKP- und Teilnahmenummer sind im DHL-Geschäftskundenportal einsehbar und sollten aus diesem übernommen und eingetragen werden.
Internationaler Versand
Handelt es sich um einen Internationalen Versand den Toggle aktivieren und den Exporttyp sowie die Handelsbedingungen, z.B. DDP - Verzollt geliefert einstellen.
DHL Paket Sendung, Gewichtseinheit, Labelformat und Labeltyp
Als DHL Paket Sendung ein Paket hinterlegen und für dieses die Maße, das Gewicht usw. einstellen.
Bei der Gewichtseinheit "Kilogramm" einstellen und als Labelformat für das Versandetikett das benötigte Druck-Format einstellen.
Als Labeltyp "PDF" oder "ZPL" auswählen.
Veröffentlichen
Wenn die Versandmethode im Onlineshop verfügbar sein soll, den Button 
auswählen.
Damit ist die Konfiguration und Verknüpfung der Versandmethode mit der DHL Integration abgeschlossen.
Bestellung mit DHL Paket versenden
Voraussetzungen:
In den Produkt-Stammdaten ist für die Produkte im Reiter "Lager" ein Gewicht hinterlegt. Dieses wird für die Berechnung des Versandgewichts benötigt.
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.
Beispiel: Auftrag im Auftragswesen mit DHL Paket versenden
Im Auftragswesen ein neues Angebot erstellen, und um die Versandmethode hinzuzufügen den Button 
auswählen.
In dem Popup die Versandmethode "DHL" und "Preis erhalten" auswählen, und den Versand über den Button 
zum Auftrag hinzufügen.
Anschließend das Angebot bestätigen.
Lieferung validieren und mit DHL versenden
Den zur Onlineshop-Bestellung bzw. Auftrag zugehörigen Liefervorgang bzw. Transfer nun validieren.
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.
Die Versandbestätigungs-E-Mail wird automatisch an den Kunden versendet.
Diese beinhaltet auch einen Link, der zur Sendungsverfolgung führt
Das DHL-Versandlabel für die Sendung befindet sich im Chatter
Es können auch mehrere Versandlabels auf einmal über die Transfer-Ansicht (Lager -> Vorgänge -> Transfers) heruntergeladen werden.
Dafür werden in der Listenansicht mehrere Transfers über die Checkbox markiert und anschließend im Aktions-Menü der Menüpunkt Download DHL Label(s) ausgewählt.
DHL Anbindung im Testmodus testen
Um die DHL Anbindung zu testen, muss in ETRON onRetail die Versandmethode mit dem Anbieter "DHL Paket" in den Testmodus geschalten werden.
Bei der DHL Integration muss folgender Benutzername und Passwort eingegeben werden: Benutzer: user-valid Passwort: SandboxPasswort2023!
Auf der DHL Developer App muss die API "Parcel DE Shipping - Customer (Integration) Testing" hinzugefügt werden, um die Sandbox zu testen.
Last updated