Einrichtung

DHL-Systembenutzer anlegen

So legst du im DHL Geschäftskundenportal einen Systembenutzer für die Returns Engine an und findest deinen Retourenempfänger. Orientierung nach Angaben von DHL und Versandsoftware-Anbietern.

Wofür ist das gedacht?

Damit die Returns Engine DHL-Retourenlabels erstellen kann, braucht sie Zugangsdaten für dein DHL-Geschäftskundenkonto. Dafür empfiehlt DHL einen Systembenutzer: einen eigenen technischen Benutzer, der sich nicht im Portal anmelden kann und nur für die Anbindung von Software gedacht ist. So musst du keine persönlichen Zugangsdaten in der App hinterlegen.

Die DHL-Anbindung ist optional – die Returns Engine funktioniert auch ohne DHL. Wie du die Zugangsdaten anschließend in der App einträgst, steht in der Anleitung: Versand und DHL.

Hinweis: Die Schritte unten beruhen auf den Angaben von DHL und Anleitungen von Versandsoftware-Anbietern. DHL kann Menünamen im Portal ändern. Wenn etwas bei dir anders aussieht, hilft dir der DHL-Geschäftskundenservice weiter – oder du schreibst uns.

Voraussetzungen

• Ein Geschäftskundenvertrag mit DHL Paket für DHL Retoure Online (bzw. DHL Retoure International).
• Zugang zum DHL Geschäftskundenportal mit Berechtigung für Retouren.
• Ein Retourenempfänger mit Abrechnungsnummer.

Wo findest du die Einstellung?

Im DHL Geschäftskundenportal: Klicke oben auf den Pfeil neben deinem Namen und öffne Benutzer verwalten. Den Retourenempfänger findest du im Bereich Retoure unter Einstellungen.

Was stellst du ein?

Systembenutzer anlegen:

1. Melde dich im DHL Geschäftskundenportal an.
2. Öffne über den Pfeil neben deinem Namen Benutzer verwalten.
3. Wähle Neuen Benutzer anlegen.
4. Stelle als Benutzertyp Systembenutzer ein. Ein eindeutiger Name hilft, ihn später wiederzufinden, zum Beispiel „Returns Engine“.
5. Vergib unter Berechtigungen mindestens das Recht für Retoure (Beauftragen).
6. Speichere den Benutzer. DHL sendet dir anschließend eine E-Mail mit einem Link, über den du das Passwort festlegst.

Retourenempfänger heraussuchen:

1. Öffne im Portal den Bereich Retoure und dort Einstellungen.
2. Notiere den Retourenempfänger (Receiver ID). Für Labels über die Schnittstelle eignen sich nur Empfänger mit Abrechnungsnummer. Empfänger ohne Abrechnungsnummer gehören zu „DHL Retoure Selbstzahler“ und funktionieren dafür nicht.
3. Neue Retourenempfänger kannst du nicht selbst anlegen – das übernimmt der DHL-Vertrieb.

Danach trägst du Benutzername und Passwort in der Returns Engine unter Versand → DHL verbinden ein, klickst auf Verbindung testen und wählst den Retourenempfänger aus.

Was sieht der Kunde?

Nichts davon – der Systembenutzer arbeitet im Hintergrund. Ist die Verbindung eingerichtet und freigegeben, erhalten deine Kund:innen nach der Freigabe ihrer Retoure das DHL-Label mit QR-Code.

So testest du es

• In der Returns Engine zeigt der Status Verbunden, dass die Zugangsdaten geprüft wurden.
• Mit Sandbox (Testsystem) verwenden und DHL Sandbox testen (Diagnose) erzeugst du ein klar gekennzeichnetes Test-Label.
• Die DHL-Anbindung der Returns Engine selbst ist bereits getestet. Eine Freigabe für echte Labels brauchst du nur, wenn du bisher noch keine DHL-Labels über eine Anbindung erstellt hast.

Typische Fehler

• Falscher Benutzertyp: Es wurde ein normaler Portalbenutzer statt eines Systembenutzers angelegt.
• Fehlende Berechtigung: Das Recht für Retoure fehlt – dann lehnt DHL die Anfrage ab.
• Passwort abgelaufen: Laut Anbieteranleitungen ist das Passwort eines Systembenutzers nur begrenzt gültig. Setze im Portal ein neues Passwort und trage es in der Returns Engine erneut ein.
• Retourenempfänger ohne Abrechnungsnummer: Dieser Empfänger kann keine Labels über die Schnittstelle erzeugen.

Das kannst du selbst prüfen

1. Ist der Benutzer als Systembenutzer angelegt und hast du das Passwort über den Link aus der DHL-E-Mail gesetzt?
2. Hat er die Berechtigung für Retoure?
3. Hat dein Retourenempfänger eine Abrechnungsnummer?
4. Zeigt die Returns Engine den Status Verbunden?

Wenn du nicht weiterkommst

Bei Fragen zu deinem DHL-Vertrag, zu Berechtigungen im Portal oder zu neuen Retourenempfängern hilft dir der DHL-Geschäftskundenservice. Bei Fragen zur Verbindung in der Returns Engine helfen wir dir direkt weiter – bitte schick uns dabei keine Passwörter.

Weitere Informationen von DHL: DHL Parcel DE Returns API im DHL Developer Portal.