DHL Retoure

DHL Retoure (DHL Paket DE Returns): So bekommst du die Zugangsdaten in der DHL-Plattform

Damit wir für dich DHL-Retourenlabels per API erstellen können, brauchen wir (je nach Setup) diese Werte aus deiner DHL-/DHL-Developer-Umgebung:

• dhl_api_key (wird als Header DHL-API-Key / dhl-api-key genutzt)

• auth_token (Bearer Token im Header Authorization: Bearer …)

• receiverId (Retouren-Empfänger-ID; bestimmt die Rücksendeadresse)

Unsere technische Anbindung nutzt genau diese Header und den Returns-Endpoint.

---

1) Voraussetzungen (damit du überhaupt Zugriff bekommst)

Du brauchst typischerweise:

• einen gültigen DHL Geschäftskundenvertrag für DHL Retoure Online und/oder DHL Retoure International

• Zugriff aufs Post & DHL Geschäftskundenportal mit Berechtigung für die Funktion „Retoure“ (developer.dhl.com)

---

2) dhl_api_key im DHL Developer Portal holen (API registrieren → App → Key)

1. Öffne das DHL Group API Developer Portal und logge dich ein. (developer.dhl.com)

2. Suche im API-Katalog nach „DHL Paket DE Retoure / DHL Parcel DE Returns“. (developer.dhl.com)

3. Klicke dort auf „Zugang erhalten“:

   • dabei wird entweder eine neue App erzeugt oder du fügst die API einer bestehenden App hinzu. (developer.dhl.com)

4. Wichtig: Sandbox geht i.d.R. direkt, Produktion wird von DHL explizit freigeschaltet (Status „Approved“). (developer.dhl.com)

5. In deiner App findest du dann den API Zugriffsschlüssel / API Key → das ist dein dhl_api_key. (developer.dhl.com)

---

3) auth_token (Bearer Token) bekommen (Authentication API)

Für viele Parcel-DE APIs ist der Token-Schritt „vorne dran“: Du holst dir über die Authentication API (Post & Parcel Germany) ein Token und nutzt es danach als Bearer im Authorization-Header. (developer.dhl.com)

Typisches Prinzip:

• Token holen → access_token

• Danach bei Returns-Aufrufen senden: Authorization: Bearer <access_token> (developer.dhl.com)

In den offiziellen Spezifikationen ist außerdem erwähnt, dass (je nach API/Setup) auch “alte” Auth-Varianten (API-Key + Basic Auth / bzw. Password Flow) möglich sind, aber für euren Fall passt das Bearer-Token-Schema. (developer.dhl.com)

---

4) receiverId (Retouren-Empfänger-ID) finden

Die receiverId ist deine DHL-Retoure-Empfängerkennung (damit steht fest, wohin retourniert wird). Die bekommst du üblicherweise im Rahmen deines DHL Retoure Setups/Vertrags bzw. im Umfeld der Retoure-Funktion im Geschäftskundenportal (sie wird auch explizit als Parameter für die Returns-Label-Erstellung verwendet). (developer.dhl.com)

---

5) Bitte schick uns diese Werte (Copy/Paste)

Sende uns bitte:

• dhl_api_key: ...

• auth_token: ... (oder alternativ: die Infos, damit wir ihn über die Authentication API für dich ziehen können – je nach vereinbartem Verfahren)

• receiverId: ...