Diese Anleitung beschreibt Schritt für Schritt, wie im DHL Developer Portal eine App für die API "Parcel DE Returns" anlegt und die dazugehörigen Client Credentials (API Key und API Secret) erzeugt. Diese Credentials werden anschließend im CarrierAPI-Konfigurator hinterlegt – entweder selbst oder durch den Heidler Support nach Übermittlung der Daten in der CarrierAPI hinterlegt.
Hintergrund dazu: Für die Abwicklung der DHL RETOURE / Parcel DE Returns ist ein Zugang zum Geschäftskundenportal erforderlich, wo auch die ReceiverIDs gespeichert / festgelegt sind. Zudem wird die Ansprache des API KEY und API Secret zur Authentifizierung benötigt. Diese Informationen erhält man ausschließlich über den Developer Account / Portal, wie hier beschrieben. Der Begriff Developer kann hier möglicherweise irreführend sein, da es sich einfach um den zentralen Anlaufpunkt des Kunden für alle DHL APIs handelt.
Schritt 1: DHL Developer Portal aufrufen und Account anlegen
Folgenden Link im Browser öffnen. Über diesen Link wird direkt der API-Zugang für "Parcel DE Returns (Post & Parcel Germany)" vorausgewählt:
https://developer.dhl.com/user/login
Auf der Zielseite oben rechts auf das Profil-Symbol klicken, um sich zu registrieren oder einzuloggen. Nach erfolgreicher Registrierung wird eine Bestätigungsmail mit Aktivierungslink versendet.
Schritt 2: Account aktivieren und einloggen
Nach Klick auf den Aktivierungslink in der E-Mail ein Passwort vergeben und im Developer Portal einloggen. Anschließend erneut oben rechts auf das Profil-Symbol klicken, um in den Account-Bereich zu gelangen.
Schritt 3: Neue App anlegen
Im Menü links auf "Apps" gehen und auf den roten Button "+ Create App" klicken. Falls bereits eine App existiert und nur ergänzt werden soll, stattdessen rechts neben der App auf "Edit" klicken.
Schritt 4: App anlegen – Daten ausfüllen
Im Formular "Create App" folgende Felder ausfüllen:\nApp name: ein eindeutiger Name (z. B. Firmenname + "Returns").\nDescription: kurze Beschreibung des Einsatzzwecks.\nAPI's name: im Dropdown "Parcel DE Returns (Post & Parcel Germany)" auswählen. Die API erscheint dann unter "Selected APIs".\nAnschließend unten auf "Create app" klicken.
Schritt 5: Status prüfen und Client Credentials abrufen
Nach dem Speichern wird die App in der App-Liste angezeigt. Der Status zeigt zunächst "Pending". Sobald DHL die App freigegeben hat (Status "Approved"), die App öffnen – API Key (Client ID) und API Secret werden angezeigt und können kopiert werden.
Schritt 6: Client Credentials im CarrierAPI hinterlegen
Für die Anbindung an unsere CarrierAPI werden API Key (Client ID) und API Secret benötigt. Es gibt zwei Möglichkeiten: 
Option A – Selbst eintragen: Der Kunde trägt API Key und API Secret eigenständig im CarrierAPI-Konfigurator unter dem Carrier "DHL Parcel DE Returns" ein.
Option B – Durch uns eintragen lassen: Der Kunde sendet uns API Key und API Secret (verschlüsselt, z. B. per Passwort-Manager-Link) zu, wir hinterlegen die Credentials im CarrierAPI-Konfigurator.
Hinweis: Das API Secret wird im DHL Developer Portal nur einmal vollständig angezeigt – bitte direkt sicher speichern. Bei Verlust muss ein neues Secret generiert werden.