Système de mappage de suivi

Lorsque vous expédiez avec plusieurs transporteurs, vous avez probablement remarqué à quel point les mises à jour de suivi peuvent être déroutantes. Chaque transporteur utilise son propre langage, son propre style et son propre niveau de détail - certaines mises à jour sont vagues ("en transit"), d'autres sont trop techniques, et d'autres encore sont rédigées dans une langue totalement différente. Il est donc difficile de comprendre rapidement ce qui se passe réellement avec vos envois, en particulier lorsque vous essayez d'aider vos clients ou de contrôler les performances.

C'est pourquoi ShippyPro a mis en place un système de mappage de suivi standardisé: pour unifier ces messages dans des catégories claires et cohérentes, sans perdre les détails importants. Grâce à nos sous-états granulaires, vous obtenez toujours toutes les informations spécifiques (par exemple, si un colis est retardé à cause des douanes, d'une mauvaise adresse ou d'un dommage), mais d'une manière qui est facile à lire, à analyser et à agir - quel que soit le transporteur que vous utilisez.

Résumé :

1. Le premier niveau : Les principaux statuts de suivi

2. Sous-catégories granulaires

En transit (2000)
En Livraison (3000)
Exception (5000)

3. Où puis-je utiliser ce mappage actuellement ?

1. Le premier niveau : Les principaux statuts de suivi

Pour rendre le suivi plus facile et plus intuitif, nous avons regroupé tous les événements d'expédition en six catégories principales, chacune représentée par un code numérique clair :

Code	Catégorie	Définition
1000	Informations Reçues	Le transporteur a confirmé la réservation pour l’enlèvement ou a partagé les détails de l’expédition.
2000	En Transit	Le colis a été récupéré et est en route vers sa destination, y compris tous les déplacements entre installations.
3000	En Livraison	L’envoi est en cours de livraison finale ou disponible dans un point de retrait (entrepôt, PUDO, etc.).
4000	Tentative Échouée	Le transporteur a tenté de livrer le colis, mais la tentative a échoué.
5000	Exception	Une erreur générale s’est produite, non attribuée à une cause spécifique.
6000	Livré	Le colis a été livré avec succès au destinataire ou récupéré dans un lieu désigné, comme un point de retrait, un casier ou un PUDO.

Ces codes de premier niveau vous offrent un aperçu rapide de l'état de votre colis tout au long de son parcours de livraison. Cependant, nous comprenons qu'en cas de problème, un statut générique d'« exception » ne suffit pas — il est essentiel de connaître la raison précise de l'incident.

2. Sous-catégories granulaires

Afin d'offrir encore plus de visibilité sur vos expéditions, nous avons divisé les principales catégories en sous-statuts détaillés :

En Transit sous-statuts (2000)

Code	Catégorie	Définition
2000	En Transit	Applied to a carrier status that describes the parcel's transit between the sender's location and the recipient's location.
2100	Déposé par le Client	Used ONLY for return shipments when the sender (typically the customer) drops the parcel off at a designated drop-off point, such as a ParcelShop, locker, or PUDO.
2200	Collecté par le Transporteur	Applied to a carrier status that indicates the carrier has physically taken possession of the parcel, either from the sender directly or from a drop-off point (e.g., PUDO, locker).
2300	En Traitement par le Transporteur	Applied to a carrier status that indicates that the parcel is in the carrier's possession and undergoing handling or transport, but the specific stage (e.g., arrival, processing, departure) is not known.
2310	Arrivé au Terminal/Hub	Applied when the parcel arrives at a terminal, hub, or sorting center — indicating the start of facility-based processing.
2320	En Traitement au Terminal/Hub	Applied to a carrier status that describes an action taken while the parcel is at the hub of the carrier. It indicates that the parcel is being actively sorted, grouped, or otherwise processed inside a hub or sorting center.
2330	Parti du Terminal/Hub	Applied when the parcel departs from a terminal or hub after processing, usually en route to the next hub or delivery area.
2400	Dédouanement	Applied to a carrier status related to expected customs or border clearance, including inspection, in-progress clearance, and release after approval. It is NOT related to customs process issues.
2500	Livraison Programmée	Applied when the delivery has been scheduled, either by the recipient (e.g., chosen date or time slot) or by the carrier (e.g., estimated delivery window).

En Livraison sous-statuts (3000)

Code	Catégorie	Définition
3000	En Cours de Livraison	Applied to a carrier status that describes a parcel being out for delivery (in the process of being delivered to the recipient).
3100	Livraison en Cours	Applied to a carrier status that indicates the parcel is in the final stages of delivery and is expected to be delivered within 24 hours.
3200	Disponible pour Retrait au PUDO/Point Relais	Applied when the parcel has been successfully delivered to a pickup location (e.g., PUDO, locker, parcelshop, or post office) and is now ready to be collected by the recipient.

Exception sous-statuts (5000)

Nous avons étendu la catégorie des exceptions (5000) à un ensemble complet de sous-catégories granulaires (par exemple, 5110, 5220, 5330, etc.). Ces sous-catégories vous permettent de comprendre - et d'agir sur - des problèmes spécifiques sans avoir à déchiffrer de vagues messages de la part des transporteurs.

Par exemple :

Si un colis est retardé en raison des conditions météorologiques, il sera classé dans la catégorie 5120 - Causes externes.
S'il est mal acheminé, vous verrez 5210 - Mauvais acheminement.
S'il est perdu, l'état sera clairement indiqué par 5330 - Perdu.

Ce niveau de granularité vous aide à

Améliorer la communication avec les clients en fournissant des mises à jour précises et transparentes.
Accélérer la résolution des problèmes en identifiant instantanément la cause première.

Optimizer permet d'obtenir des analyses approfondies afin d'améliorer les performances des transporteurs et d'éviter que les problèmes ne se répètent.

Code	Catégorie	Définition
5000	Exception Générique	Statut utilisé lorsque le problème n’est pas clairement défini.
5100	Perturbations en Transit	Retards ou perturbations générales durant le transit.
5110	Retardé	Retard dû à un problème de transport, sans raison précisée.
5120	Causes Externes	La livraison est affectée par des événements incontrôlables (intempéries, catastrophes naturelles…).
5200	Problèmes Opérationnels	Perturbations causées par des problèmes internes du transporteur.
5210	Mauvais Acheminement	Le colis a été dirigé vers le mauvais centre ou la mauvaise destination.
5220	Enlèvement Impossible	Le transporteur n’a pas pu récupérer le colis comme prévu.
5230	En Attente	Le colis est temporairement retenu en attente d’actions ou d’informations.
5300	Problème sur le Colis	Problème lié à la condition du colis (endommagé, dimensions excessives…).
5310	Dimensions ou Poids Excessifs	Le colis dépasse les limites autorisées et compromet la livraison.
5320	Endommagé	Le colis a été signalé comme endommagé.
5330	Perdu	Le colis est considéré comme perdu.
5340	Détruit	Le colis a été détruit et ne peut pas être récupéré.
5400	Problème d’Adresse	Adresse incorrecte ou incomplète empêchant la livraison.
5410	Adresse Incomplète	L’adresse manque d’éléments essentiels pour livrer.
5420	Adresse Incorrecte	L’adresse fournie est invalide ou erronée.
5500	Douane et Documents	Retards dus aux procédures douanières ou documents manquants.
5510	Problème Douanier	Colis retenu à la douane pour restriction ou procédure.
5520	Documents Manquants	Documents requis absents, comme la facture.
5600	Problème Expéditeur/Destinataire	Problèmes dus à l’expéditeur ou destinataire (annulation, refus…).
5610	Exception Destinataire	Problème lié à une action du destinataire.
5620	Exception Expéditeur	Problème causé par l’expéditeur (ex : annulation).
5630	Retour à l’Expéditeur	Le colis est retourné à l’expéditeur.
5700	Actions du Transporteur	Le transporteur agit ou demande une action concernant la livraison.
5710	Demande de Contact	Le transporteur demande d’être contacté.
5720	Changement de Livraison	Modification des conditions de livraison.
5730	Autre Exception Transporteur	Statut générique pour les exceptions non classées.

3. Où puis-je utiliser ce mappage?

API GetTracking: vérification des champs StatusCode et ExtendedStatusCode dans la réponse (voir la documentation de l'API)
Suivi de la mise à jour du webhook : Vous pouvez attendre les propriétés code et extendedCode (voir la documentation de l'API).
Optimizer: le tableau des exceptions décompose vos envois en sous-statuts d'exception, ce qui vous permet d'identifier rapidement les problèmes de livraison tels que les retards, les erreurs d'adresse ou les colis endommagés. Cela vous permet de repérer les goulets d'étranglement, de suivre les tendances par transporteur ou par destination et de prendre des mesures pour résoudre les problèmes efficacement. (voir Comment fonctionne Optimizer)