Zum Hauptinhalt springen

Häufige Probleme

Schnelle Antworten auf die häufigsten Integrationsprobleme.

Authentifizierung​

401 Unauthorized bei jeder Anfrage​

Ursache: Token fehlt, ist abgelaufen oder fehlerhaft.

Lösung:

  1. Prüfen Sie, ob der Header korrekt ist: Authorization: Bearer <token> (mit dem Wort Bearer)
  2. Prüfen Sie, ob das Token abgelaufen ist – nutzen Sie /api/v1/login-extended für das Feld expireAt
  3. Melden Sie sich erneut mit /api/v1/login an, um ein neues Token zu erhalten

Token läuft zu schnell ab​

Ursache: Die Token-TTL ist serverseitig konfiguriert.

Lösung: Wenden Sie sich an Ihren DPD-Ansprechpartner, um die Token-TTL anzupassen. Implementieren Sie in der Zwischenzeit eine Token-Erneuerungslogik, die vor Ablauf eine erneute Authentifizierung durchführt.

Sendungen​

400 Bad Request – Validierungsfehler​

Ursache: Ein Pflichtfeld fehlt oder schlägt bei der Validierung fehl.

Lösung: Prüfen Sie das Objekt fieldErrors in der Antwort:

{
  "fieldErrors": {
    "receiver.email": ["REQUIRED_FOR_INTERNATIONAL"],
    "receiver.countryCode": ["NOT_SUPPORTED"]
  }
}

Häufige Pflichtfelder:

  • email ist für alle Ziele ausserhalb CH/LI erforderlich (ausser GB)
  • phone ist für GB-Ziele erforderlich (internationales Format: +44...)
  • houseNumber ist für NL-Ziele erforderlich
  • stateCode ist für US/CA-Ziele erforderlich

207 Multi-Status – Teilweise fehlgeschlagen​

Ursache: Bei einer Batch-Anfrage waren einige Sendungen erfolgreich, andere nicht.

Lösung: Prüfen Sie das Array failed in der Antwort für feldspezifische fieldErrors. Das Array success enthält erstellte Sendungen mit Paketnummern und Etiketten.

Etikett leer oder druckt nicht​

Ursache: printOptions.labelFormat stimmt nicht mit Ihrem Drucker überein.

Lösung: Setzen Sie labelFormat explizit in Ihrer Anfrage:

  • "A4" – normales A4-Blatt (bis zu 4 Etiketten pro Seite, Position 1–4 über labelStartPosition)
  • "A6" – Thermoetikettendrucker

Paketshops​

Leere Ergebnisse bei der Adresssuche​

Ursache: Keine Shops im Standard-Suchradius (5 km) gefunden, oder die Adresse konnte nicht aufgelöst werden.

Lösung:

  1. Geben Sie sowohl zipCode als auch city an
  2. Entfernen Sie Service-/Typfilter, um die Suche zu erweitern
  3. Setzen Sie hideClosed: false, um auch temporär geschlossene Shops einzuschliessen

404 Not Found für Paketshop-ID​

Ursache: Die Shop-ID existiert nicht oder ist nicht mehr aktiv.

Lösung: Führen Sie eine neue Suche per Adresse oder Koordinaten durch, um aktuelle Shop-IDs zu erhalten.

Sendungsverfolgung​

404 Not Found für Paketnummer​

Ursache: Verfolgungsdaten sind noch nicht verfügbar oder die Paketnummer ist falsch.

Lösung:

  1. Überprüfen Sie die Paketnummer aus der Sendungserstellungs-Antwort (success[].parcelNumber)
  2. Warten Sie einige Minuten nach der Sendungserstellung
  3. Prüfen Sie das Format der Paketnummer (z.B. 05305000123456)

Abholaufträge und Abholbestellungen​

pickupDate wird abgelehnt​

Ursache: Das Datum liegt in der Vergangenheit oder hat ein falsches Format.

Lösung: Verwenden Sie das Format yyyy-MM-dd und stellen Sie sicher, dass das Datum mindestens der morgige Tag in der europäischen Zeitzone ist.

Allgemein​

HTTPS / SSL-Fehler​

Alle API-Aufrufe müssen HTTPS verwenden. Selbstsignierte Zertifikate werden in der Produktion nicht akzeptiert.

Rate Limiting (429 Too Many Requests)​

Implementieren Sie exponentielles Backoff. Cachen Sie Paketshop-Daten, da diese sich selten ändern.

Noch nicht gelöst?​

Kontaktieren Sie den DPD-Support mit:

  • Der tracingId aus der API-Antwort (oder dem vollständigen Fehlerantwort-Body)
  • Dem aufgerufenen Endpunkt und dem ungefähren Zeitpunkt der Anfrage
  • Ihrer Integrationsumgebung (dev/staging/production)