Suivi de colis

But & intention utilisateur : l’outil résout le suivi inter-transporteurs pour les équipes opérationnelles et les flux de travail du support client. Il accepte une ou plusieurs numéros de suivi avec des identifiants de transporteur optionnels pour récupérer le statut actuel, la localisation et l’ETA. Il est utilisé par l’exécution du commerce électronique, les planificateurs logistiques et les agents du support pour fournir des mises à jour précises aux clients ou alimenter des tableaux de bord en aval, notamment lorsque’une vue unifiée des transporteurs est requise. Logique centrale & fonctionnalités : capacités principales incluant normalisation des entrées, cartographie des transporteurs et orchestration API pour récupérer le statut en temps réel auprès des transporteurs ou des agrégateurs. Fonctionnalités obligatoires : recherche multi-numéros, schéma de sortie standardisé, validation des entrées et contrôles de fraicheur des données. Fonctions optionnelles/avancées : traitement par lots avec gestion des limites, mise en cache, notifications webhook et formats d’exportation (JSON/CSV) avec localisation.
Entrées & sorties : entrées incluent tracking_numbers (tableau de chaînes, requis), carriers (optionnel) include_eta (booléen, par défaut true), locale (optionnel). Sorties sous forme de shipments (tableau d’objets) avec champs: tracking_number, carrier, status, location, timestamp, eta, history (tableau d’événements). Règles de validation exigent des tracking_numbers non vides et des identifiants de transporteur connus si fournis, timestamps ISO 8601 pour les sorties.
Algorithmes & Calculs : l’outil utilise des appels REST API vers des transporteurs ou agrégateurs avec délais d’expiration et politiques de retry. Règles ETA : utiliser l’ETA fournie par le transporteur lorsque disponible ; sinon estimation via les temps de transit typiques par itinéraire et le dernier événement. Normalisation des statuts : mappe les statuts propres au transporteur sur une taxonomie commune (In Transit, Out for Delivery, Delivered, Exception, Pending).
Erreurs & Cas limites : entrées invalides, transporteurs inconnus ou inputs manquants entraînent des erreurs de validation. Résultats partiels avec codes d’erreur par expédition lorsque le transporteur est injoignable. Timeouts, limites de débit ou pannes d’API déclenchent une logique de retry ou un fallback sur les données les plus récentes lorsque cela est permis.
Industrie/Région & Localisation : normes ISO 8601, heure UTC et taxonomie standardisée des statuts. Couverture mondiale; formats de données conformes aux conventions industrielles habituelles. Protection des données conforme au RGPD et pratiques régionales ; aucune devise n’est applicable. Hypothèses & Exclus : accès aux API des transporteurs ou agrégateurs autorisés ; pas d’interface utilisateur ; données indisponibles marquées ; pas de streaming en temps réel ; exclut la logique interne de routage ou les données d’inventaire.