Zum Inhalt

DHL Ersteinrichtung

Schritt-für-Schritt-Anleitung zur initialen Einrichtung des DHL Paket DE Connectors.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:

  • [ ] DHL Geschäftskundenportal (GKP) — Aktiver Account unter geschaeftskunden.dhl.de
  • [ ] DHL Developer Portal — Registrierung unter developer.dhl.com mit einer App (API Key + Secret)
  • [ ] EKP-Nummer — 10-stellige DHL-Kundennummer aus Ihrem Vertrag
  • [ ] merchantCENTRAL Hub — Installiert und aktiv
  • [ ] Modul-Lizenz — Mindestens Demo-Lizenz für MCDHL

Einrichtungsassistent

Der Einrichtungsassistent führt Sie in 6 Schritten durch die Konfiguration:

Schritt 1: Willkommen

Übersicht der Voraussetzungen. Prüfen Sie, ob alle Zugangsdaten bereit liegen.

Schritt 2: Authentifizierung

Wählen Sie die Authentifizierungsart und geben Sie die Zugangsdaten ein.

Einstellung Empfehlung
Auth Type OAuth2 (ROPC) — von DHL empfohlen und zukunftssicher
Sandbox Mode Für den Ersttest aktivieren, später deaktivieren

OAuth2 (ROPC) — empfohlen:

  1. Klicken Sie auf API Key → Eingabedialog → API Key aus developer.dhl.com eintragen
  2. Klicken Sie auf API Secret → Eingabedialog → Client Secret aus developer.dhl.com eintragen

Basic Authentication (Legacy):

  1. Klicken Sie auf Username (GKP) → GKP-Benutzername eintragen
  2. Klicken Sie auf Password (GKP) → GKP-Passwort eintragen
  3. API Key muss trotzdem separat eingetragen werden

OAuth2 vs. Basic Auth

DHL empfiehlt OAuth2 (ROPC) für neue Installationen. OAuth2 verwendet einen Token-basierten Mechanismus — der Token wird automatisch angefordert und bis zu seinem Ablauf gecacht. Basic Auth überträgt bei jedem Request Benutzername/Passwort.

Schritt 3: Verbindungstest

Klicken Sie Test Connection. Bei Erfolg erscheint eine grüne Bestätigung mit der API-Version.

Mögliche Fehler:

Fehler Ursache Lösung
HTTP 401 Ungültige Credentials API Key und Secret prüfen
HTTP 403 App nicht freigeschaltet App auf developer.dhl.com aktivieren
Timeout Netzwerkproblem Firewall/Proxy prüfen, api-eu.dhl.com muss erreichbar sein

Schritt 4: Absenderadresse

Die Absenderadresse erscheint auf allen DHL-Labels.

  • Klicken Sie Load from Company, um die Daten aus der BC-Firmeninformation zu übernehmen
  • Passen Sie die Felder bei Bedarf an (z.B. abweichende Versandadresse)
  • Pflichtfelder: Name, Straße, Hausnummer, PLZ, Ort, Ländercode

Absenderreferenz

Alternativ können Sie eine im DHL GKP hinterlegte Absenderreferenz verwenden. Aktivieren Sie dazu Use Shipper Reference und tragen Sie den Referenzcode ein.

Schritt 5: Standard-Einstellungen

Einstellung Empfehlung Beschreibung
Default Weight (g) 1000 Wird verwendet, wenn kein Gewicht am Paket angegeben ist
Label Print Format 910-300-600 DHL-Standard-Etikett (105×205mm)
Doc Format PDF Für Laserdrucker. ZPL2 für Thermodrucker.

Schritt 6: Abschluss

Zusammenfassung aller Einstellungen. Klicken Sie Finish um die Konfiguration abzuschließen und den Connector zu aktivieren.

Nach der Ersteinrichtung

Profile & Vertragspositionen einrichten

Nach dem Assistenten müssen Sie mindestens ein Profil mit Vertragspositionen anlegen:

  1. Öffnen Sie DHL Shipment Setup → Klick auf Default Profile
  2. Erstellen Sie ein neues Profil (z.B. STANDARD_GRUPPENPROFIL)
  3. Fügen Sie Vertragspositionen hinzu:
  4. EKP: Ihre 10-stellige DHL-Kundennummer
  5. Produkt: V01PAK für Inland, V53WPAK für International
  6. Participation: 2-stelliger Code aus Ihrem DHL-Vertrag (üblicherweise 01)
  7. Zone: Domestic / EU / International
  8. Markieren Sie das Profil als Default

→ Details: Profile & Abrechnung

Versandart in Business Central verknüpfen

Damit merchantCENTRAL den DHL-Connector bei Sendungen automatisch verwendet:

  1. Öffnen Sie Versandarten (Shipping Agents) in BC
  2. Wählen Sie Ihre DHL-Versandart
  3. Stellen Sie sicher, dass der Code mit dem Shipment Provider in merchantCENTRAL übereinstimmt

Testlabel erstellen

  1. Stellen Sie sicher, dass Sandbox Mode aktiviert ist
  2. Erstellen Sie eine Testlieferung (Verkaufsauftrag → Buchen mit Liefern)
  3. Öffnen Sie die gebuchte Verkaufslieferung → Label erstellen
  4. Prüfen Sie das generierte Label

→ Details: Label erstellen

Nächste Schritte