DHL Express Ersteinrichtung
Diese Anleitung führt Sie Schritt für Schritt durch die vollständige Einrichtung des DHL Express Connectors.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass:
- [x] AD merchantCENTRAL Hub installiert und aktiv ist
- [x] Sie Ihre DHL Express API-Zugangsdaten haben (Username + Password)
- [x] Ihre 9-stellige DHL Express Account-Nummer bereit liegt
- [x] Die Absenderadresse Ihres Unternehmens inkl. Telefonnummer bekannt ist
API-Zugangsdaten
Die Zugangsdaten (Username und Password) für die MyDHL API erhalten Sie von Ihrem DHL Express Vertriebsberater. Für die Sandbox (Testumgebung) werden separate Credentials bereitgestellt.
Schritt 1: Setup öffnen
- Öffnen Sie die Suche (Alt+Q) in Business Central
- Geben Sie DHL Express Setup ein
- Wählen Sie DHL Express Setup Card aus den Ergebnissen
Alternativ: Über das merchantCENTRAL Dashboard → Versanddienstleister → DHL Express
Schritt 2: Sandbox-Modus aktivieren (empfohlen für Ersteinrichtung)
| Umgebung | Wann verwenden |
|---|---|
| Sandbox | Zum Testen — keine echten Sendungen, keine Kosten |
| Production | Für den Echtbetrieb — echte Labels, echte Sendungen |
Empfehlung
Beginnen Sie immer mit der Sandbox-Umgebung. Erst wenn alle Tests erfolgreich sind, deaktivieren Sie den Sandbox-Modus für den Produktivbetrieb.
- Aktivieren Sie das Feld Sandbox Mode
- Die API Base URL wechselt automatisch auf
https://express.api.dhl.com/mydhlapi/test
Schritt 3: API-Zugangsdaten eingeben
Username eingeben
- Klicken Sie auf das Feld Username (zeigt „Not configured" in rot)
- Im Eingabedialog: Geben Sie Ihren DHL Express API-Benutzernamen ein
- Klicken Sie OK
- Das Feld zeigt nun „Configured" in grün
Password eingeben
- Klicken Sie auf das Feld Password (zeigt „Not configured" in rot)
- Im Eingabedialog: Geben Sie Ihr DHL Express API-Passwort ein
- Klicken Sie OK
- Das Feld zeigt nun „Configured" in grün
Sicherheit
Die Zugangsdaten werden verschlüsselt im IsolatedStorage gespeichert (Company Scope). Die tatsächlichen Werte sind auf der Setup-Seite nicht sichtbar — nur der Status „Configured" oder „Not configured".
Schritt 4: Account-Nummern konfigurieren
| Feld | Beschreibung | Format |
|---|---|---|
| Shipper Account No. | Ihre DHL Express Versendernummer | 9 Stellen |
| Billing Account No. | Abrechnungsnummer (oft identisch mit Shipper) | 9 Stellen |
| Duties Account No. | Nur bei DDP-Sendungen (Absender zahlt Zölle) | 9 Stellen |
- Tragen Sie Ihre Shipper Account No. ein
- Tragen Sie Ihre Billing Account No. ein (in der Regel identisch)
- Optional: Tragen Sie die Duties Account No. ein (nur benötigt, wenn Sie DDP-Sendungen planen)
Wo finde ich meine Account-Nummern?
Die Account-Nummern finden Sie in Ihrem DHL Express Vertrag oder in Ihrem DHL Express Online-Portal (MyDHL+). Bei Fragen wenden Sie sich an Ihren DHL Express Ansprechpartner.
Schritt 5: Absenderadresse ausfüllen
Die Absenderadresse erscheint auf allen DHL Express Labels und muss vollständig sein.
| Feld | Pflicht? | Beschreibung |
|---|---|---|
| Shipper Name | ✅ | Firmenname des Absenders |
| Shipper Street | ✅ | Straße |
| Shipper House No. | ✅ | Hausnummer |
| Shipper Post Code | ✅ | Postleitzahl |
| Shipper City | ✅ | Stadt |
| Shipper Country Code | ✅ | ISO alpha-2 Ländercode (z. B. DE) |
| Shipper Contact Name | ✅ | Ansprechpartner |
| Shipper Phone | ✅ | Telefonnummer (DHL Express Pflicht!) |
| Shipper Email | Empfohlen | E-Mail-Adresse |
Telefonnummer ist Pflicht
DHL Express erfordert zwingend eine Telefonnummer des Absenders. Ohne Telefonnummer schlägt die Sendungserstellung fehl.
Schritt 6: Standard-Einstellungen festlegen
| Einstellung | Empfehlung | Beschreibung |
|---|---|---|
| Default Product | P (EXPRESS WORLDWIDE) | Standard-Expressprodukt für internationale Sendungen |
| Default Incoterm | DAP | Empfänger zahlt Zölle (Standard für EU) |
| Default Package Type | YP (Your Packaging) | Eigene Verpackung |
| Default Weight (kg) | 1.0 | Wird verwendet, wenn kein Gewicht am Paket angegeben ist |
Schritt 7: Label-Format konfigurieren
Versandlabels
| Einstellung | Empfehlung | Beschreibung |
|---|---|---|
| Doc Format | Für Laserdrucker. ZPL2/EPL2 für Thermodrucker | |
| Label Format | 4x6 inch | Standard-Thermolabel (102×152mm) |
Retourenlabels
| Einstellung | Empfehlung | Beschreibung |
|---|---|---|
| Retoure Doc Format | Retouren als PDF (z. B. für Beilage im Paket) | |
| Retoure Label Format | 4x6 inch | Standard-Format |
Thermodrucker?
Wenn Sie einen Thermodrucker (Zebra, TSC) verwenden, wählen Sie ZPL2 als Doc Format und 4x6 inch als Label Format.
Schritt 8: Pickup-Einstellungen (optional)
| Einstellung | Beschreibung | Default |
|---|---|---|
| Auto Pickup | Bei Sendungserstellung automatisch Abholung buchen | Aktiviert |
| Pickup Ready Time | Frühester Abholzeitpunkt (z. B. 09:00) | — |
| Pickup Close Time | Spätester Abholzeitpunkt (z. B. 17:00) | — |
| Pickup Location | Beschreibung des Abholorts (z. B. „Laderampe Halle 2") | — |
Auto Pickup
Wenn Auto Pickup aktiviert ist, wird bei jeder Sendungserstellung automatisch eine Abholung gebucht. Deaktivieren Sie diese Option, wenn Sie Sendungen selbst bei DHL abgeben oder die Abholung manuell buchen möchten.
Schritt 9: Verbindungstest
- Klicken Sie die Aktion Test Connection (oben in der Aktionsleiste)
- Bei Erfolg erscheint eine grüne Bestätigung
- Bei Fehler wird eine detaillierte Fehlermeldung mit Lösungshinweisen angezeigt
Mögliche Fehler:
| Fehler | Ursache | Lösung |
|---|---|---|
| HTTP 401 | Ungültige Credentials | Username und Password prüfen |
| HTTP 403 | Account nicht freigeschaltet | DHL Express Vertrieb kontaktieren |
| Timeout | Netzwerkproblem | Firewall/Proxy prüfen, express.api.dhl.com muss erreichbar sein |
| HTTP 500 | DHL-Server-Fehler | Später erneut versuchen |
Schritt 10: Connector aktivieren
Nach erfolgreichem Verbindungstest:
- Stellen Sie sicher, dass mindestens eine Demo-Lizenz registriert ist (siehe Lizenz-Gruppe auf der Setup Card)
- Deaktivieren Sie ggf. den Sandbox Mode für den Produktivbetrieb
- Der Connector ist jetzt einsatzbereit
Nach der Ersteinrichtung
Paperless Trade einrichten (optional, empfohlen für internationale Sendungen)
Wenn Sie regelmäßig international versenden:
- Aktivieren Sie Paperless Trade Enabled
- Tragen Sie eine Default Export Description ein (z. B. „Electronic components")
- Füllen Sie Shipper EORI und Shipper Tax ID aus
Vorteile von Paperless Trade
Elektronische Zolldokumente beschleunigen die Zollabfertigung erheblich. DHL Express kann die Zollerklärung direkt verarbeiten — ohne auf Papierdokumente an der Sendung warten zu müssen.
Demo-Lizenz registrieren
Falls der Connector noch nicht lizenziert ist:
- Klicken Sie auf Register Demo in der Lizenz-Gruppe auf der Setup Card
- Füllen Sie den Demo-Registrierungswizard aus
- Nach Registrierung haben Sie 30 Tage kostenlosen Zugang
Zusammenfassung der Pflichtfelder
| Bereich | Pflichtfelder |
|---|---|
| API | Username, Password |
| Account | Shipper Account No. |
| Absender | Name, Straße, Hausnr., PLZ, Ort, Ländercode, Kontaktperson, Telefon |
Minimale Konfiguration
Ohne die oben genannten Pflichtfelder kann keine Sendung erstellt werden. Die Setup-Validierung prüft alle Felder vor der ersten Sendungserstellung automatisch.