🔧DHL (Integration)
DHL Paket mit ETRON onRetail verknüpfen, Anbindung und Einrichtung von DHL Paketdienst
Modul: ETRON onRetail DHL
Konfiguration -> Lager -> DHL Integration

Über die DHL Integration kann DHL Paket mit ETRON onRetail verknüpft werden um Pakete über DHL zu versenden.
DHL Integration einrichten
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
Vor dem Veröffentlichen kann die DHL Integration noch getestet werden: DHL Anbindung im Testmodus testen
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.
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.

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.

Retouren mit DHL abwickeln
Die DHL-Extension unterstützt keine automatische Erstellung von Retourenlabels. Retourenlabels sowie das Rücksendungsporto müssen direkt im DHL-Geschäftskundenportal erstellt und verwaltet werden.
Retoure im System vorbereiten
Wenn der Endkunde eine Retoure ankündigt:
Zum entsprechenden LIeferschein wechseln Tipp für schnelles Finden: Lieferschein-Referenz in die Lupe oben rechts eintragen

Button "Retoure ausführen" auswählen
Im Fenster: Alle Produkte löschen, die nicht retourniert werden und anwenden
Ein neuer Lieferschein wird erstellt, welcher noch nicht validiert werden soll
Der Retouren-Lieferschein dient als Vorbereitung und bleibt offen, bis die Ware physisch eingelangt ist.
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
Tipp: Die Vorlage "Versand: Per E-Mail senden" kann dupliziert und angepasst werden, da die passenden Felder bereits inkludiert sind.
Gutschrift erstellen
Falls eine Rückerstattung erforderlich ist:
Zum ursprünglichen Auftrag wechseln Tipp: Über den Chatter im Retouren-Lieferschein kann in den ursprünglichen Lieferschein gewechselt werden. Dieser hat dann den Auftrag im Chatter hinterlegt.

Zur hinterlegten Rechnung navigieren
Button "Gutschrift hinzufügen" auswählen
Option "Stornieren" wählen
Alle Positionen löschen, die nicht erstattet werden
Bestätigen
Zahlung registrieren, die dem Kunden rückerstattet wird.
Dem Kunden mit "Senden und Drucken" Bescheid geben, dass die Rückerstattung durchgeführt wurde.
Last updated