Zum Inhalt

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:

  1. Öffnen Sie das DHL Express Setup
  2. Klicken Sie auf das Username-Feld und geben Sie den Benutzernamen erneut ein
  3. Klicken Sie auf das Password-Feld und geben Sie das Passwort erneut ein
  4. 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:

  1. Aktivieren Sie Paperless Trade im Setup (empfohlen)
  2. Oder füllen Sie die Zollfelder der Sendung aus:
  3. Export Description
  4. HS Code
  5. Customs Value + Currency
  6. 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:

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

Support

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

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