DHL Shipment Setup
Zentrale Einrichtungsseite für den DHL Paket DE Shipping Connector. Hier werden API-Zugangsdaten, Authentifizierungsart, Profile & Abrechnungsnummern, Absenderadresse, Standardeinstellungen und Zollvorgaben konfiguriert.
Seite öffnen
- Über die Suche: DHL Shipment Setup
- Über das merchantCENTRAL Dashboard → Versanddienstleister → DHL
Felder
API Credentials
Zugangsdaten und Authentifizierungseinstellungen für die DHL Parcel DE Shipping API v2.
| Feld | Beschreibung |
|---|---|
| API-Basis-URL | Basis-URL der DHL API. Produktiv: https://api-eu.dhl.com/parcel/de/shipping/v2, Sandbox: https://api-sandbox.dhl.com/parcel/de/shipping/v2 |
| Sandbox-Modus | Aktiviert den Sandbox-Modus für Testumgebungen. URLs wechseln automatisch auf api-sandbox.dhl.com |
| API-Schlüssel | DHL API-Schlüssel (Klicken zum Einrichten). Wird im Header dhl-api-key übermittelt. Erhältlich über developer.dhl.com → My Apps |
| Auth Type | Authentifizierungsart: Basic-Authentifizierung (GKP-Benutzername/Passwort) oder OAuth2 (ROPC) (empfohlen). Wechselt die darunter angezeigten Credential-Felder. |
Abhängig von der gewählten Authentifizierungsart werden folgende Felder eingeblendet:
OAuth2 (ROPC) — empfohlen:
| Feld | Beschreibung |
|---|---|
| API-Secret | Client Secret für den OAuth2 ROPC Token-Endpoint (Klicken zum Einrichten). Erhältlich über developer.dhl.com → My Apps |
| OAuth2-Token-URL | Token-Endpoint-URL. Sandbox: https://api-sandbox.dhl.com/parcel/de/account/auth/ropc/v1/token, Produktion: https://api-eu.dhl.com/parcel/de/account/auth/ropc/v1/token |
| Token-Ablaufzeit | Ablaufzeitpunkt des aktuell gecachten Access Tokens (schreibgeschützt, grün wenn Token vorhanden) |
Basic Authentication:
| Feld | Beschreibung |
|---|---|
| Benutzername (GKP) | Benutzername des DHL-Geschäftskundenportals (Klicken zum Einrichten) |
| Kennwort (GKP) | Passwort des DHL-Geschäftskundenportals (Klicken zum Einrichten) |
Empfohlene Authentifizierung
DHL empfiehlt und wird zukünftig auf OAuth2 migrieren. Verwenden Sie OAuth2 (ROPC) für neue Installationen. Bei OAuth2 wird automatisch ein Access Token angefordert und bis zu seinem Ablauf gecacht.
Credential-Eingabe
Alle Zugangsdaten werden über einen gesicherten Dialog eingegeben. Auf der Einrichtungsseite selbst werden nur Konfiguriert (grün) oder Nicht konfiguriert (rot) angezeigt — die tatsächlichen Werte sind nicht sichtbar.
Profiles & Billing
Die Abrechnungsnummer wird nicht mehr statisch eingegeben, sondern über Profile und Vertragspositionen automatisch aufgelöst.
| Feld | Beschreibung |
|---|---|
| Standardprofil | Zeigt das aktuell als Standard markierte DHL-Profil. Klicken öffnet die Profilliste. |
Profile & Vertragspositionen
Über die DHL Profile List werden DHL-Benutzergruppen-Profile (aus dem DHL Geschäftskundenportal) und deren zugehörige Vertragspositionen gepflegt. Jede Vertragsposition enthält: EKP (10-stellige Kundennummer), DHL-Produkt, Participation-Code (2-stellig), Service-Variante (Standard / With Services / GoGreen / With Services + GoGreen), Versandzone (Inland/EU/International), und ein optionales Maximalgewicht.
Der Contract Resolver bestimmt bei jeder Sendung automatisch die passende Vertragsposition anhand von Zielland (→ Zone), gewählten VAS (→ Service-Variante) und Versandart-Code. Die Abrechnungsnummer wird daraus berechnet: EKP + Verfahrenscode + Participation.
DHL vergibt für Sendungen mit Sperrgut, Nachnahme, Versicherung etc. eine eigene Teilnahme (Participation). Diese muss als separate Vertragszeile mit Service Variant = With Services hinterlegt werden.
→ Weitere Informationen: DHL Profile einrichten
Shipper Address
Absenderadresse, die auf allen DHL-Labels erscheint.
| Feld | Beschreibung |
|---|---|
| Absenderreferenz verwenden | Wenn aktiviert, wird eine bei DHL hinterlegte Referenzadresse verwendet statt der manuellen Eingabe |
| Absenderreferenz | DHL-Absenderreferenz (nur sichtbar wenn Use Shipper Reference aktiv) |
| Absendername | Name des Absenders (Zeile 1) |
| Absendername 2 | Zusätzlicher Absendername (Zeile 2) |
| Absendername 3 | Zusätzlicher Absendername (Zeile 3) |
| Absender Straße | Straße des Absenders |
| Shipper House No. | Hausnummer des Absenders |
| Absender PLZ | Postleitzahl des Absenders |
| Absender Stadt | Stadt des Absenders |
| Absender Ländercode | Ländercode des Absenders (ISO alpha-3, z.B. DEU) |
| Absender Kontaktname | Ansprechpartner beim Absender |
| Absender E-Mail | E-Mail-Adresse des Absenders |
| Absender Telefon | Telefonnummer des Absenders |
Absenderreferenz
Bei Nutzung der Absenderreferenz werden die Adressfelder deaktiviert. DHL verwendet dann die im Geschäftskundenportal hinterlegte Adresse.
Default Settings
Standardwerte für die Label-Erstellung.
| Feld | Beschreibung |
|---|---|
| Standardgewicht (g) | Standardgewicht in Gramm, wenn kein Gewicht am Paket angegeben ist |
| Etiketten einbeziehen als | Art der Label-Einbindung in der API-Antwort (URL oder Base64) |
| Etiketten zusammenführen | Versand- und Retourenlabel in einem PDF zusammenfassen |
| Doc Format | Dokumentformat für Versandlabels (PDF oder ZPL2 für Thermodrucker). Wechselt das verfügbare Druckformat. |
| Label Print Format | Druckformat für Versandlabels. Werte: A4, 100x70mm, 910-300-600 (105×205mm), 910-300-610 (105×208mm), 910-300-700, 910-300-700-oz, 910-300-710, 910-300-300 (105×148mm), 910-300-300-oz, 910-300-400 |
| Retoure Doc Format | Dokumentformat für Retourenlabels (PDF oder ZPL2). Kann sich vom Versandformat unterscheiden — z.B. ZPL2 für den Thermodrucker beim Packvorgang, PDF für den Laserdrucker am Empfang. |
| Retoure Label Print Format | Druckformat für Retourenlabels (separate Auswahl) |
| DHL-Logo drucken | DHL-Logo auf Versandlabels drucken (Standard: aktiv). Deaktivieren spart Tinte/Toner auf Thermodruckern. |
| DHL-Logo drucken (Retoure) | DHL-Logo auf Retourenlabels drucken (Standard: aktiv). |
ZPL2 und Druckformat
Bei Auswahl von ZPL2 als Dokumentformat wird das Druckformat automatisch auf 100×70mm gewechselt (Standard für Thermodrucker). A4 ist nicht mit ZPL2 kompatibel.
Return Labels
| Feld | Beschreibung |
|---|---|
| Include Return Label | Automatisch ein Retourenlabel bei jeder Sendung erstellen (via VAS dhlRetoure) |
Advanced
| Feld | Beschreibung |
|---|---|
| Creation Software | Software-Kennung, die an DHL übermittelt wird (nur für DHL-Partner) |
Customs Defaults
Standardwerte für Zollerklärungen bei internationalen Sendungen.
| Feld | Beschreibung |
|---|---|
| Default Shipper EORI | Standard-EORI-Nummer des Versenders für Zollanmeldungen |
| Default Export Type | Standard-Exportart: COMMERCIAL_GOODS, OTHER, PRESENT, COMMERCIAL_SAMPLE, DOCUMENT, RETURN_OF_GOODS |
| Standard-Vorausverfügung | Standard-Behandlung bei Unzustellbarkeit: RETURN (sofort zurück) oder ABANDON (aufgeben) |
DHL Retoure API
Einstellungen für die separate DHL Returns API v1 (für Standalone-Retourenlabels, z.B. für Kunden-Retouren-QR-Codes).
| Feld | Beschreibung |
|---|---|
| Retoure aktiviert | Aktiviert die DHL Returns API für Standalone-Retourenlabels |
| Retoure API-Basis-URL | Basis-URL der DHL Returns API. Sandbox: https://api-sandbox.dhl.com/parcel/de/shipping/returns/v1 |
| Retoure Empfänger-ID | Empfänger-ID für Retouren (z.B. deu für Deutschland) |
| Retoure GoGreen Plus | CO2-neutraler Versand für Retouren aktivieren |
Lizenz
| Feld | Beschreibung |
|---|---|
| Lizenzstatus | Aktueller Lizenzstatus: Active (grün), Demo (gelb), Unregistered / Expired (rot) |
| Demo-Ablauf | Ablaufdatum der Demo-Lizenz (nur bei Demo-Status) |
| Verbleibende Demo-Tage | Verbleibende Demo-Tage (nur bei Demo-Status) |
| Lizenziert seit | Datum der ersten Lizenzierung (nur bei Active-Status) |
Status
Aktuelle Statusinformationen zur DHL-Integration.
| Feld | Beschreibung |
|---|---|
| Last Label Created | Datum und Uhrzeit des zuletzt erstellten Labels |
| Heute erstellte Etiketten | Anzahl der heute erstellten Labels (grün hervorgehoben) |
| Letzte Fehlermeldung | Letzte Fehlermeldung der DHL API (rot bei Fehler) |
| Last Error DateTime | Zeitpunkt des letzten Fehlers |
Aktionen
| Aktion | Beschreibung |
|---|---|
| Verbindung testen | Testet die Verbindung zur DHL API mit den aktuellen Zugangsdaten. Sendet eine Test-Anfrage an GET / und zeigt das Ergebnis an |
| Demo registrieren | Startet die kostenlose 30-Tage-Demo-Registrierung |
| Lizenz aktualisieren | Prüft den Lizenzstatus vom Lizenzserver erneut |
Hinweise
API-Schlüssel
Der API-Schlüssel wird über das DHL Developer Portal erstellt. Für den produktiven Betrieb ist eine Freischaltung durch DHL erforderlich.
Warenpost (V62WP) eingestellt
DHL hat Warenpost (V62WP) zum 31.05.2026 abgeschaltet. Der Connector migriert bestehende V62WP-Konfigurationen automatisch auf DHL Kleinpaket (V62KP). Neue Sendungen bitte ausschließlich mit V62KP konfigurieren.
Singleton-Seite
Diese Seite hat genau einen Datensatz. Beim ersten Öffnen wird der Datensatz automatisch angelegt.