Fehlerbehebung

Häufige Fehler und deren Lösungen bei der Nutzung des DHL Express Connectors.

Verbindungsfehler

HTTP 401 — Unauthorized

Ursache: API-Credentials (Username oder Password) sind ungültig oder abgelaufen.

Lösung:

Öffnen Sie das DHL Express Setup
Klicken Sie auf das Username-Feld und geben Sie den Benutzernamen erneut ein
Klicken Sie auf das Password-Feld und geben Sie das Passwort erneut ein
Führen Sie Test Connection aus

Sandbox vs. Produktion

Sandbox und Produktion verwenden unterschiedliche Credentials. Stellen Sie sicher, dass Sie die korrekten Zugangsdaten für die aktive Umgebung verwenden.

HTTP 403 — Forbidden

Ursache: Ihr DHL Express Account hat keine Berechtigung für die angeforderte Operation oder den API-Endpunkt.

Lösung:

Prüfen Sie bei DHL Express, ob Ihr API-Zugang für die gewünschten Endpoints freigeschaltet ist
Stellen Sie sicher, dass der API-Benutzer Berechtigungen für Shipment, Tracking und Pickup hat
Kontaktieren Sie Ihren DHL Express Ansprechpartner

HTTP 408 / Timeout

Ursache: Die MyDHL API antwortet nicht innerhalb des Zeitlimits.

Lösung:

Versuchen Sie die Operation erneut (temporäres Netzwerkproblem)
Prüfen Sie Ihre Internetverbindung
Prüfen Sie den DHL Express API-Status

Label-Erstellung

HTTP 400 — „Missing phone number"

Ursache: DHL Express erfordert zwingend eine Telefonnummer — sowohl für Absender als auch Empfänger.

Lösung:

Prüfen Sie, ob das Feld Shipper Phone im Setup ausgefüllt ist
Prüfen Sie, ob die Empfänger-Telefonnummer in der Sendung angegeben ist

HTTP 400 — „Invalid account number"

Ursache: Die angegebene Account-Nummer ist ungültig oder hat nicht das korrekte Format.

Lösung:

DHL Express Account-Nummern sind 9-stellig
Prüfen Sie die Felder Shipper Account No. und Billing Account No. im Setup
Stellen Sie sicher, dass keine Leerzeichen oder Sonderzeichen enthalten sind

HTTP 400 — „Invalid postal code"

Ursache: Das PLZ-Format stimmt nicht mit dem Zielland überein.

Lösung:

Land	PLZ-Format	Beispiel
Deutschland (DE)	5 Ziffern	90402
Großbritannien (GB)	Alphanumerisch	SW1A 1AA
USA (US)	5 oder 9 Ziffern	10001 / 10001-7890
Frankreich (FR)	5 Ziffern	75001
Niederlande (NL)	4 Ziffern + 2 Buchstaben	1012 AB

HTTP 422 — „Product not available"

Ursache: Das gewählte DHL Express Produkt ist für diese Route (Absender → Empfänger) nicht verfügbar.

Lösung:

Verwenden Sie die Frachtraten-Abfrage, um verfügbare Produkte für die Route zu ermitteln
Express 9:00 (K) und Express 12:00 (T) sind nicht auf allen Routen verfügbar
Economy Select (H) ist nur für bestimmte Länder verfügbar

HTTP 400 — „Weight exceeds maximum"

Ursache: Das angegebene Gewicht überschreitet das Maximum für den gewählten Pakettyp oder die Route.

Lösung:

DHL Express Standard-Maximum: 70 kg pro Paket
Prüfen Sie ob das Gewicht korrekt in Kilogramm angegeben ist (nicht Gramm)
Für schwere Sendungen: DHL Express Freight kontaktieren

Pickup-Fehler

„Pickup already exists"

Ursache: Für diesen Tag und Standort wurde bereits eine Abholung gebucht.

Lösung:

Bei Auto Pickup: DHL erkennt die bestehende Buchung automatisch — kein Handlungsbedarf
Manuell: Prüfen Sie die Pickup-Liste auf bestehende Buchungen für diesen Tag

„Ready time in the past"

Ursache: Die angegebene Ready Time liegt in der Vergangenheit.

Lösung:

Passen Sie die Pickup Ready Time im Setup an
Für Same-Day-Pickup muss die Ready Time mindestens 30 Minuten in der Zukunft liegen
Für Pickup am nächsten Tag: Verschieben Sie das Pickup-Datum

Zoll / International

„Customs declaration required"

Ursache: Für Sendungen in Drittländer (außerhalb EU) ist eine Zollerklärung erforderlich.

Lösung:

Aktivieren Sie Paperless Trade im Setup (empfohlen)
Oder füllen Sie die Zollfelder der Sendung aus:
Export Description
HS Code
Customs Value + Currency
Country of Origin

„EORI number required"

Ursache: Für kommerzielle Sendungen in bestimmte Länder (insbesondere GB nach Brexit) ist eine EORI-Nummer erforderlich.

Lösung:

Tragen Sie Ihre EORI-Nummer im Setup unter Customs → Shipper EORI ein
Deutsche EORI-Nummern beginnen mit DE gefolgt von 15 Ziffern

Lizenzfehler

„Module not licensed"

Ursache: Der DHL Express Connector hat keine gültige Lizenz (Demo oder Voll).

Lösung:

Öffnen Sie das DHL Express Setup
Prüfen Sie den License Status
Falls „Unregistered": Klicken Sie Register Demo für eine 30-tägige Testlizenz
Falls „Expired": Kontaktieren Sie den Support für eine Lizenzverlängerung

Sendungsverfolgung aktualisiert nicht mehr

Der Abruf hört still auf, wenn das Modul nicht mehr nutzbar ist — er bricht bewusst nicht stündlich mit einem Fehler ab, der nur das Aufgabenwarteschlangen-Protokoll füllt. Prüfen Sie in dieser Reihenfolge:

Prüfen	Wo	Erwartung
Lizenz des Moduls	merchantCENTRAL-Einrichtung → Module	Status Aktiv oder laufende Demo
Dienstleister aktiviert	Versanddienstleister-Liste	Aktiviert gesetzt
Tracking eingeschaltet	Einrichtungskarte des Connectors	Tracking aktiviert
Zeitplan	Aufgabenwarteschlangenposten	Status Bereit, nicht Angehalten

Ohne gültige Lizenz oder laufende Demo fragt der Connector den Dienstleister nicht mehr ab. Der Zeitplan bleibt bestehen und nimmt seine Arbeit wieder auf, sobald die Lizenz wieder gültig ist.

Support

Wenn Sie ein Problem nicht lösen können:

Notieren Sie die vollständige Fehlermeldung (inkl. HTTP-Statuscode)
Prüfen Sie das Activity Log im merchantCENTRAL-Dashboard
Kontaktieren Sie den Support unter support@merchantcentral.de