DHL Express Setup Card
Zentrale Einrichtungsseite für den DHL Express Shipping Connector. Hier werden API-Zugangsdaten, Account-Nummern, Absenderadresse, Standardeinstellungen, Labelformate, Pickup-Konfiguration, Paperless Trade und Zolldaten konfiguriert.
Seite öffnen
- Über die Suche: DHL Express Setup
- Über das merchantCENTRAL Dashboard → Versanddienstleister → DHL Express → Setup
Felder
API Settings
Zugangsdaten und Umgebungs-Einstellungen für die DHL Express MyDHL API.
| Feld | Beschreibung |
|---|---|
| API Base URL | Basis-URL der MyDHL API. Produktiv: https://express.api.dhl.com/mydhlapi, Sandbox: https://express.api.dhl.com/mydhlapi/test |
| Sandbox Mode | Aktiviert den Sandbox-Modus für Testumgebungen. Die URL wechselt automatisch |
| Username | DHL Express API-Benutzername (Klicken zum Einrichten). Status: „Configured" (grün) oder „Not configured" (rot) |
| Password | DHL Express API-Passwort (Klicken zum Einrichten). Status: „Configured" (grün) oder „Not configured" (rot) |
Authentifizierung
DHL Express MyDHL API verwendet HTTP Basic Authentication. Username und Password werden base64-codiert im Authorization-Header jedes Requests übermittelt. Die Credentials werden verschlüsselt im IsolatedStorage (Company Scope) gespeichert.
Account Numbers
DHL Express Account-Nummern für Versand und Abrechnung.
| Feld | Beschreibung |
|---|---|
| Shipper Account No. | 9-stellige DHL Express Versendernummer. Identifiziert den Absender bei DHL |
| Billing Account No. | 9-stellige Abrechnungsnummer. Wird für die Kostenabrechnung verwendet (oft identisch mit Shipper) |
| Duties Account No. | 9-stellige Zoll-/Steuer-Abrechnungsnummer. Nur relevant bei DDP-Sendungen (Absender zahlt Zölle) |
Duties Account
Das Feld Duties Account No. wird nur benötigt, wenn Sie den Incoterm DDP (Delivered Duty Paid) verwenden. Bei DAP zahlt der Empfänger die Zölle — ein Duties Account ist dann nicht erforderlich.
Defaults
Standardeinstellungen für neue Sendungen. Diese Werte werden als Voreinstellung verwendet und können pro Sendung überschrieben werden.
| Feld | Beschreibung | Default |
|---|---|---|
| Default Product | Standard-Expressprodukt (P = Worldwide, T = 12:00, K = 9:00, H = Economy, etc.) | P (EXPRESS WORLDWIDE) |
| Default Incoterm | Standard-Lieferbedingung (DAP, DDP, DDU, DAT, EXW, FCA) | DAP |
| Default Package Type | Standard-Pakettyp (YP = Eigene Verpackung, BOX, FLY, EE, etc.) | YP (Your Packaging) |
| Default Weight (kg) | Fallback-Gewicht in Kilogramm, wenn kein Gewicht angegeben ist | 1.0 |
Shipper Address
Absenderadresse, die auf allen DHL Express Labels erscheint.
| Feld | Beschreibung | Pflicht? |
|---|---|---|
| Shipper Name | Firmenname des Absenders | ✅ |
| Shipper Street | Straße des Absenders | ✅ |
| Shipper House No. | Hausnummer | ✅ |
| Shipper Post Code | Postleitzahl | ✅ |
| Shipper City | Stadt | ✅ |
| Shipper Country Code | ISO 3166-1 alpha-2 Ländercode (z. B. DE, AT, CH) |
✅ |
| Shipper Contact Name | Ansprechpartner beim Absender | ✅ |
| Shipper Phone | Telefonnummer (DHL Express Pflichtfeld!) | ✅ |
| Shipper Email | E-Mail-Adresse des Absenders | Empfohlen |
Telefonnummer
DHL Express erfordert zwingend eine gültige Telefonnummer des Absenders. Ohne dieses Feld wird die API-Anfrage von DHL abgelehnt (HTTP 400).
Label Format
Konfiguration der Dokumentformate und Labelgrößen für Versand- und Retourenlabels.
| Feld | Beschreibung | Default |
|---|---|---|
| Doc Format | Dokumentformat für Versandlabels (PDF, ZPL2, EPL2) | |
| Label Format | Labelgröße für Versandlabels (4x6, 4x8, 8x4, 6x4, A4) | 4x6 inch |
| Retoure Doc Format | Dokumentformat für Retourenlabels | |
| Retoure Label Format | Labelgröße für Retourenlabels | 4x6 inch |
Getrennte Formate
Versand- und Retourenlabels können unterschiedliche Formate verwenden. Typisch: ZPL2 auf dem Thermodrucker für den Packvorgang, PDF auf dem Laserdrucker für Retouren-Beilagen.
Pickup
Einstellungen für die automatische und manuelle Abholbuchung.
| Feld | Beschreibung | Default |
|---|---|---|
| Auto Pickup | Automatisch Abholung buchen bei jeder Sendungserstellung | Aktiviert |
| Pickup Ready Time | Frühester Zeitpunkt, ab dem DHL abholen darf (z. B. 09:00) | — |
| Pickup Close Time | Spätester Zeitpunkt für die Abholung (z. B. 17:00) | — |
| Pickup Location | Beschreibung des Abholorts (z. B. „Laderampe Tor 3") | — |
Auto Pickup deaktivieren
Deaktivieren Sie Auto Pickup, wenn Sie Sendungen über einen DHL Express ServicePoint aufgeben oder die Abholung manuell über das Dashboard steuern möchten.
Paperless Trade
Elektronische Zolldokumente für internationale Sendungen.
| Feld | Beschreibung | Default |
|---|---|---|
| Paperless Trade Enabled | PLT aktivieren (elektronische Zollerklärung statt Papier) | Deaktiviert |
| Default Export Description | Standard-Warenbeschreibung für die Zollerklärung (z. B. „Electronic equipment") | — |
Vorteile
Paperless Trade (PLT) beschleunigt die Zollabfertigung erheblich. DHL kann die elektronische Zollerklärung vorab prüfen — Ihre Sendung wartet nicht auf Papierdokumente am Zoll.
Customs
Zolldaten des Absenders für internationale Sendungen.
| Feld | Beschreibung |
|---|---|
| Shipper EORI | EORI-Nummer des Absenders (EU-Wirtschaftsbeteiligtennummer) |
| Shipper Tax ID | Steuernummer / USt-IdNr. des Absenders |
Wann benötigt?
EORI und Tax ID sind für kommerzielle Sendungen in Drittländer (außerhalb der EU) erforderlich. Für innereuropäische Sendungen sind diese Felder optional.
Status Tracking
Schreibgeschützte Statusfelder (automatisch aktualisiert).
| Feld | Beschreibung |
|---|---|
| Last Label Created | Datum/Uhrzeit der letzten erfolgreichen Label-Erstellung |
| Labels Created Today | Anzahl der heute erstellten Labels |
| Last Error Message | Letzte Fehlermeldung der API |
| Last Error DateTime | Datum/Uhrzeit des letzten Fehlers |
Aktionen
Processing
| Aktion | Beschreibung |
|---|---|
| Test Connection | Testet die Verbindung zur MyDHL API. Prüft Credentials und Erreichbarkeit. Bei Erfolg: grüne Bestätigung. Bei Fehler: strukturierte Fehlermeldung mit Lösungshinweisen |
| Load from Company | Übernimmt die Absenderadresse aus den BC-Firmendaten (Firmeninformation) |
Navigation
| Aktion | Beschreibung |
|---|---|
| Shipment Labels | Öffnet die Liste aller DHL Express Labels (gefiltert auf Provider DHLX) |
| Dashboard | Öffnet das DHL Express Dashboard |
License
| Aktion | Beschreibung |
|---|---|
| Register Demo | Startet den Demo-Registrierungswizard für eine 30-tägige Testlizenz |
| Refresh License | Aktualisiert den Lizenzstatus vom Lizenzserver |