Aller au contenu principal

Problèmes courants

Réponses rapides aux problèmes d'intégration les plus fréquents.

Authentification​

401 Unauthorized à chaque requête​

Cause: Le jeton est absent, expiré ou malformé.

Solution:

  1. Vérifiez que l'en-tête est correct : Authorization: Bearer <jeton> (avec le mot Bearer)
  2. Vérifiez si le jeton a expiré — utilisez /api/v1/login-extended pour voir le champ expireAt
  3. Reconnectez-vous via /api/v1/login pour obtenir un nouveau jeton

Le jeton expire trop vite​

Solution: Contactez votre responsable de compte DPD pour ajuster la durée de vie (TTL) du jeton.

Expéditions​

400 Bad Request — erreur de validation​

Cause: Un champ obligatoire est absent ou échoue à la validation.

Solution: Vérifiez l'objet fieldErrors dans la réponse :

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

Exigences courantes :

  • email requis pour toutes les destinations hors CH/LI (sauf GB)
  • phone requis pour GB (format international : +44...)
  • houseNumber requis pour NL
  • stateCode requis pour US/CA

L'étiquette est vide ou ne s'imprime pas​

Solution: Définissez labelFormat explicitement :

  • "A4" — imprimantes de bureau standard
  • "A6" — imprimantes d'étiquettes thermiques

Points de collecte​

Résultats vides lors d'une recherche par adresse​

Solution:

  1. Fournissez zipCode et city
  2. Supprimez les filtres de service ou de type
  3. Définissez hideClosed: false

Suivi​

404 Not Found pour un numéro de colis​

Solution:

  1. Vérifiez le numéro de colis dans la réponse de création d'expédition (success[].parcelNumber)
  2. Attendez quelques minutes après la création
  3. Vérifiez le format du numéro (ex. 05305000123456)

Toujours bloqué ?​

Contactez le support DPD en fournissant :

  • Le tracingId de la réponse API
  • Le point de terminaison appelé et l'heure approximative de la requête
  • Votre environnement d'intégration (dev/staging/production)