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 Base 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 Mode | Aktiviert den Sandbox-Modus für Testumgebungen. URLs wechseln automatisch auf api-sandbox.dhl.com |
| API Key | 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 Authentication (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 Expiry | Ablaufzeitpunkt des aktuell gecachten Access Tokens (schreibgeschützt, grün wenn Token vorhanden) |
Basic Authentication:
| Feld | Beschreibung |
|---|---|
| Username (GKP) | Benutzername des DHL-Geschäftskundenportals (Klicken zum Einrichten) |
| Password (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 Configured (grün) oder Not configured (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 |
|---|---|
| Default Profile | 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 |
|---|---|
| Use Shipper Reference | Wenn aktiviert, wird eine bei DHL hinterlegte Referenzadresse verwendet statt der manuellen Eingabe |
| Shipper Reference | DHL-Absenderreferenz (nur sichtbar wenn Use Shipper Reference aktiv) |
| Shipper Name | Name des Absenders (Zeile 1) |
| Shipper Name 2 | Zusätzlicher Absendername (Zeile 2) |
| Shipper Name 3 | Zusätzlicher Absendername (Zeile 3) |
| Shipper Street | Straße des Absenders |
| Shipper House No. | Hausnummer des Absenders |
| Shipper Post Code | Postleitzahl des Absenders |
| Shipper City | Stadt des Absenders |
| Shipper Country Code | Ländercode des Absenders (ISO alpha-3, z.B. DEU) |
| Shipper Contact Name | Ansprechpartner beim Absender |
| Shipper Email | E-Mail-Adresse des Absenders |
| Shipper Phone | 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 |
|---|---|
| Default Weight (g) | Standardgewicht in Gramm, wenn kein Gewicht am Paket angegeben ist |
| Include Labels as | Art der Label-Einbindung in der API-Antwort (URL oder Base64) |
| Combine Labels | 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) |
| Print DHL Logo | DHL-Logo auf Versandlabels drucken (Standard: aktiv). Deaktivieren spart Tinte/Toner auf Thermodruckern. |
| Print DHL Logo (Return) | 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 |
| Default Endorsement | 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 Enabled | Aktiviert die DHL Returns API für Standalone-Retourenlabels |
| Retoure API Base URL | Basis-URL der DHL Returns API. Sandbox: https://api-sandbox.dhl.com/parcel/de/shipping/returns/v1 |
| Retoure Receiver 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 |
|---|---|
| License Status | Aktueller Lizenzstatus: Active (grün), Demo (gelb), Unregistered / Expired (rot) |
| Demo Expiry | Ablaufdatum der Demo-Lizenz (nur bei Demo-Status) |
| Remaining Demo Days | Verbleibende Demo-Tage (nur bei Demo-Status) |
| Licensed Since | 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 |
| Labels Created Today | Anzahl der heute erstellten Labels (grün hervorgehoben) |
| Last Error Message | Letzte Fehlermeldung der DHL API (rot bei Fehler) |
| Last Error DateTime | Zeitpunkt des letzten Fehlers |
Aktionen
| Aktion | Beschreibung |
|---|---|
| Test Connection | Testet die Verbindung zur DHL API mit den aktuellen Zugangsdaten. Sendet eine Test-Anfrage an GET / und zeigt das Ergebnis an |
| Register Demo | Startet die kostenlose 30-Tage-Demo-Registrierung |
| Refresh License | 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.