Suivi des envois

Récupérez l'historique de suivi en temps réel pour un colis DPD, incluant tous les événements de statut, horodatages et informations de localisation.

Point de terminaison: GET /api/v1/tracking/{parcelNumber} Authentification: Jeton JWT Bearer requis

---

Requête

Paramètre de chemin :

Paramètre	Type	Obligatoire	Exemple
parcelNumber	String	Oui	05305000123456

Paramètre de requête :

Paramètre	Type	Obligatoire	Description
locale	String	Non	Localise les descriptions — de_CH, en_US, fr_CH, it_CH

# Basique
curl -X GET "https://label-print-shipments.dpd.ch/api/v1/tracking/05305000123456" \
  -H "Authorization: Bearer <jwt_token>"

# Avec locale
curl -X GET "https://label-print-shipments.dpd.ch/api/v1/tracking/05305000123456?locale=fr_CH" \
  -H "Authorization: Bearer <jwt_token>"

---

Réponse

200 OK :

{
  "shipmentInfo": {
    "type": "shipment",
    "service": "PSD",
    "product": "DPD Classic"
  },
  "statusInfo": [
    {
      "name": "ACCEPTED",
      "displayName": "Parcel handed to DPD",
      "description": "DPD has received your parcel.",
      "location": "",
      "date": "2025-10-29 14:30:00",
      "hasBeenReached": true,
      "isCurrent": false
    },
    {
      "name": "AT_SENDING_DEPOT",
      "displayName": "In transit",
      "description": "The parcel is at the parcel dispatch centre.",
      "location": "Bern Hub",
      "date": "2025-10-30 08:15:00",
      "hasBeenReached": true,
      "isCurrent": true
    },
    {
      "name": "DELIVERED",
      "displayName": "Parcel delivered",
      "description": "Your parcel has been delivered successfully.",
      "location": "",
      "date": "",
      "hasBeenReached": false,
      "isCurrent": false
    }
  ]
}

Champs statusInfo

Champ	Type	Description
name	String	Identifiant du code de statut
displayName	String	Libellé de statut traduit
description	String	Description détaillée traduite
location	String	Lieu où l'événement s'est produit
date	String	Horodatage (yyyy-MM-dd HH:mm:ss), vide si pas encore atteint
hasBeenReached	Boolean	Indique si ce statut a été atteint
isCurrent	Boolean	Indique s'il s'agit du statut actuel

---

Codes de statut

Statut	Anglais (en_US)	Allemand (de_CH)	Français (fr_CH)	Italien (it_CH)
ACCEPTED	Parcel handed to DPD	Paket an DPD übergeben	Colis reçu	Pacco ricevuto
AT_SENDING_DEPOT	In transit	Paket unterwegs	Colis en cours d'acheminement	Pacco in viaggio
ON_THE_ROAD	At parcel delivery centre	Im Paketzustellzentrum	Colis au centre de tri	Pacco nel centro consegne pacchi
AT_DELIVERY_DEPOT	Parcel out for delivery	In Zustellung	Colis livré	Pacco consegnato
DELIVERED	Parcel delivered	Paket zugestellt	Colis livré	Pacco consegnato

Flux de statut typique

ACCEPTED → AT_SENDING_DEPOT → ON_THE_ROAD → AT_DELIVERY_DEPOT → DELIVERED

---

Codes de statut HTTP

Code	Description
200 OK	Données de suivi retournées
401 Unauthorized	Jeton manquant ou invalide
404 Not Found	Numéro de colis introuvable