Skip to main content
AccueilBlogGuidesComment les prestataires 3PL et de services logistiques utilisent une API de suivi des expéditions sur les comptes de leurs clients

Comment les prestataires 3PL et de services logistiques utilisent une API de suivi des expéditions sur les comptes de leurs clients

17TRACK

Les prestataires 3PL et les prestataires de services d’exécution des commandes utilisent une API de suivi des expéditions pour collecter les mises à jour des transporteurs concernant les expéditions appartenant à plusieurs clients, puis acheminer chaque mise à jour vers le compte client, la commande, l’équipe d’assistance et la vue de reporting appropriés. L’API fournit les données de suivi ; le propre système du prestataire doit gérer la propriété des clients, contrôler les accès, traiter les exceptions et décider de ce que chaque client et chaque acheteur peuvent voir.

Comment les prestataires 3PL et les prestataires d’exécution des commandes utilisent une API de suivi des expéditions

Cette distinction est importante lorsqu’une même opération d’entreposage sert de nombreux marchands. Un numéro de suivi à lui seul n’est pas un identifiant de compte client. Pour fournir une visibilité fiable entre les comptes, le prestataire d’exécution doit conserver une trace du propriétaire de chaque expédition et disposer d’un processus reproductible pour transformer les mises à jour des transporteurs en informations propres à chaque client.

Solution de suivi des commandes personnalisée

Offrez une meilleure expérience client et générez davantage d’achats répétés grâce au suivi personnalisé et aux notifications automatisées.

Essayer gratuitement →

Le processus de base : enregistrer, recevoir, acheminer, agir

Le responsable de l’action est généralement l’équipe des opérations ou de l’ingénierie du 3PL. Elle intègre le service de suivi une seule fois, puis utilise son système de gestion d’entrepôt, son système de gestion des commandes ou sa couche d’intégration pour relier les enregistrements de suivi aux différents clients. Un processus pratique comporte quatre étapes :

  1. Enregistrer l’expédition. Lorsqu’une étiquette est créée ou qu’un colis est remis à un transporteur, le prestataire enregistre le numéro de suivi, les informations disponibles sur le transporteur, l’ID du compte client, la référence de commande et tout ID interne d’expédition. Il transmet les détails du suivi à son intégration de suivi selon la méthode documentée par le prestataire.
  2. Recevoir les mises à jour. L’intégration obtient les nouvelles informations de suivi au moyen des méthodes effectivement prises en charge par l’API. Selon le service et la configuration, cela peut impliquer des requêtes relatives au statut actuel, des notifications de changements, ou les deux.
  3. Acheminer et interpréter. Le prestataire associe l’enregistrement de suivi renvoyé à son ID interne d’expédition et à son compte client. Il conserve le message du transporteur et le mappe vers un ensemble limité d’états opérationnels sans supprimer les détails utiles.
  4. Agir. Le bon client peut consulter l’avancement, le service client peut répondre à une demande et l’équipe des opérations peut enquêter sur une exception. Les mises à jour destinées aux acheteurs doivent utiliser les canaux et les règles de communication approuvés par ce client.

La décision de conception essentielle intervient avant la première requête API : chaque expédition doit avoir un propriétaire clairement identifié dans les registres du 3PL. Sans ce lien, une réponse de suivi peut être techniquement correcte mais inutilisable — ou visible par le mauvais marchand.

Solution mondiale de suivi des expéditions via l’API 17TRACK

Connectez-vous à plus de 3 500 transporteurs dans le monde via une seule API pour un suivi des colis simple, précis et fiable.

Essayer gratuitement →

Séparer la propriété du client de l’identité de suivi

Un modèle de données multi-clients doit distinguer un compte client, une commande, une expédition interne, un transporteur et un identifiant de suivi. Ces éléments sont liés, mais ils ne sont pas interchangeables. Une commande peut générer plusieurs colis ; un colis peut avoir un numéro de suivi avant l’apparition de scans significatifs du transporteur ; et un client peut utiliser différents transporteurs pour différentes commandes.

Par exemple, si un entrepôt expédie deux colis pour la commande d’un marchand, la page de commande peut devoir afficher deux chronologies d’expédition distinctes. Si l’un des colis rencontre une exception de livraison, le 3PL doit identifier le colis concerné plutôt que de marquer toute la commande comme impossible à livrer. Un ID interne d’expédition fournit un point de rattachement stable pour ces enregistrements, même lorsque les références de commande visibles par les clients ne sont pas uniques entre les différents clients.

Enregistrez l’ID du compte client avec l’enregistrement d’expédition et appliquez des contrôles d’accès lors de la création, de la récupération, de l’exportation ou de l’envoi de l’enregistrement vers un autre système. Ne vous fiez pas à un numéro de suivi comme unique clé d’autorisation. Les numéros de suivi sont des identifiants opérationnels, pas des identifiants d’accès, et un tableau de bord partagé ne doit pas exposer les commandes d’un marchand simplement parce qu’un utilisateur connaît un numéro.

Si les clients gèrent leurs propres transporteurs ou fournissent leurs propres identifiants, déterminez où ces identifiants sont stockés et quel compte peut les utiliser. Une intégration de suivi unique ne signifie pas automatiquement que tous les clients partagent les mêmes accords avec les transporteurs, les mêmes autorisations de données ou les mêmes préférences de communication avec les clients. Ces limites doivent être reflétées dans la configuration et testées.

Transformer les messages des transporteurs en statuts exploitables pour les clients

Les descriptions des événements des transporteurs varient. Un 3PL peut souhaiter un ensemble commun de libellés — tels que étiquette créée, en transit, en cours de livraison, livré et exception — pour les tableaux de bord et les files d’exceptions. Ce mappage relève d’une décision applicative et ne remplace pas l’événement d’origine. Conservez le statut source, l’heure de l’événement lorsqu’elle est fournie, l’identité du transporteur et le lieu lorsqu’il est disponible, afin qu’un agent d’assistance puisse comprendre ce qui s’est réellement passé.

Ne considérez pas chaque nouveau message comme une progression. Les mises à jour peuvent arriver en retard, décrire des scans antérieurs ou répéter un événement déjà reçu. Pour chaque mise à jour entrante, l’intégration doit vérifier si elle appartient à une expédition connue, s’il s’agit d’un doublon et si son heure d’événement modifie la chronologie. Le dernier message reçu n’est pas nécessairement le dernier événement survenu.

De même, le statut « livré » ne doit pas être transformé en affirmation selon laquelle le destinataire prévu a personnellement accepté le colis. La signification d’un scan de livraison dépend des détails de l’événement fournis par le transporteur et de toute preuve de livraison disponible pour cette expédition. Une interface destinée aux clients doit afficher les éléments dont elle dispose plutôt que de déduire davantage que ce que les données permettent.

Une approche utile consiste à conserver à la fois un statut normalisé pour le filtrage et l’événement sous-jacent du transporteur pour les investigations. Le statut commun aide un 3PL à trouver les expéditions nécessitant une intervention parmi de nombreux comptes clients ; le détail d’origine aide le personnel à expliquer une expédition donnée sans transformer une catégorie générale en fausse conclusion.

Concevoir la gestion des exceptions autour de la personne capable de résoudre le problème

Le suivi devient utile sur le plan opérationnel lorsqu’il modifie l’action suivante de l’équipe. Une exception de livraison peut nécessiter une notification au client, une demande auprès du transporteur, une vérification de l’adresse ou aucune action immédiate pendant l’attente d’un scan ultérieur. La réponse appropriée dépend de l’événement et des responsabilités réparties entre le 3PL et son client.

Définissez les règles de responsabilité pour les cas courants avant de créer les alertes. Par exemple, le 3PL peut être responsable de l’enquête sur un colis qui semble bloqué avant sa remise au transporteur, tandis que le marchand traite la demande d’un acheteur souhaitant modifier une adresse de livraison. Il s’agit d’exemples d’accords possibles, et non de règles universelles. Chaque prestataire doit documenter ses propres limites de service et son processus d’escalade.

Les règles de notification doivent également comporter des mesures de protection. Envoyer un message pour chaque scan peut submerger le personnel et les acheteurs. Toutefois, supprimer chaque statut répété peut masquer un changement important de lieu ou une nouvelle exception. Définissez quels événements intègrent une file opérationnelle, lesquels apparaissent uniquement dans un tableau de bord et lesquels peuvent déclencher une communication avec un client ou un acheteur. Donnez au personnel accès à la chronologie de suivi sous-jacente lorsqu’une règle doit être examinée.

Points à vérifier lors de la sélection ou de l’implémentation d’une API

Une API de suivi est adaptée lorsque le 3PL a besoin des mises à jour d’expédition dans ses propres systèmes plutôt que de demander aux employés de vérifier chaque transporteur séparément. La question à poser lors de l’achat n’est pas simplement de savoir si une API renvoie un statut. Il faut déterminer si son comportement documenté prend en charge la composition réelle des expéditions du prestataire et son processus de gestion des comptes.

17RETURNS

Simplifiez les retours et les échanges afin de réduire la charge du support DTC et les pertes de revenus.

En savoir plus →
  • Adéquation des transporteurs et des expéditions : vérifiez les transporteurs et les services d’expédition utilisés par les clients. Confirmez comment l’API identifie un transporteur et ce qui se passe lorsqu’un numéro de suivi est ambigu ou ne comporte encore aucun événement.
  • Transmission des mises à jour : examinez les options documentées permettant d’obtenir les changements, les formats de requête et de réponse attendus, ainsi que la manière de gérer les échecs ou les nouvelles tentatives. Si des notifications d’événements sont disponibles, validez leur authentification et leur comportement en cas de nouvelle tentative au lieu de supposer qu’elles éliminent toutes les requêtes de suivi ultérieures.
  • Association des comptes : déterminez si le prestataire peut associer sa propre référence à un enregistrement de suivi. Quelles que soient les fonctionnalités de l’API, conservez une association interne entre l’enregistrement de suivi, le compte client et l’ID d’expédition.
  • Détail des données : examinez les réponses d’exemple pour connaître les événements, les horodatages, les descriptions des transporteurs, les lieux et les informations de livraison nécessaires aux opérations et au support. Confirmez quels champs peuvent être absents.
  • Limites opérationnelles : vérifiez l’authentification documentée, les limites d’utilisation, les réponses d’erreur et les éventuelles conditions commerciales pertinentes pour le volume d’expéditions prévu. N’estimez pas les coûts à partir d’un prix d’appel sans tester le modèle de requêtes envisagé.
  • Sécurité et conservation : déterminez qui peut accéder aux historiques de suivi, comment les identifiants sont protégés, combien de temps les enregistrements sont conservés et comment les clients reçoivent ou exportent leurs propres données.

La page de l’API de suivi de 17TRACK et la documentation destinée aux développeurs constituent des points de départ pertinents pour un prestataire évaluant une intégration de suivi multi-transporteurs. Leur présence ne signifie pas que le service gère les autorisations des clients ou la structure des comptes d’un 3PL. Vérifiez le comportement actuel de l’API dans la documentation et au moyen d’une intégration de test, puis implémentez la propriété des clients et les contrôles d’accès dans la propre application du 3PL, sauf si un dispositif spécifique pris en charge a été confirmé.

Un petit projet pilote révèle davantage qu’une liste de fonctionnalités

Avant de connecter tous les comptes clients, exécutez un projet pilote avec un groupe d’expéditions volontairement varié. Incluez plusieurs clients, les transporteurs effectivement utilisés par ces clients, une commande comportant plusieurs colis, un numéro de suivi sans scan initial et des expéditions qui atteignent à la fois des états de livraison ordinaires et des états d’exception. Conservez les données pilotes séparées des communications de production afin que les tests n’envoient pas accidentellement de messages aux acheteurs.

Suivez chaque expédition depuis l’enregistrement de l’entrepôt jusqu’à l’enregistrement du suivi, puis jusqu’à la vue du client. Posez des questions concrètes : le bon compte est-il propriétaire de l’enregistrement ? Un autre compte peut-il le voir via un tableau de bord, une recherche, un export ou une notification ? Un ancien scan est-il correctement placé dans la chronologie des événements ? Que se passe-t-il si le service de suivi rejette temporairement une requête ou ne renvoie aucune nouvelle information ? Un agent d’assistance peut-il toujours identifier la formulation d’origine du transporteur ?

Consignez les réponses comme critères d’acceptation et non comme impressions. Un projet pilote réussi démontre que le 3PL peut identifier le propriétaire de chaque expédition, afficher des événements utiles, se remettre des défaillances d’intégration courantes et acheminer les exceptions vers la bonne équipe. Si ces conditions ne sont pas remplies, l’ajout de comptes clients supplémentaires amplifiera le problème au lieu de le résoudre.

L’architecture la plus durable considère le suivi comme une source de données partagée, entourée de contrôles propres à chaque client. L’API aide à obtenir les informations d’expédition ; le 3PL reste responsable de relier ces informations aux commandes, de protéger les limites entre les comptes et de les rendre exploitables.

FAQ

Un 3PL peut-il utiliser une seule intégration d’API de suivi pour plusieurs clients ?

Potentiellement, oui, si les conditions de l’API et son modèle technique prennent en charge l’utilisation prévue. Le 3PL doit néanmoins identifier le propriétaire de chaque expédition et faire respecter cette limite dans tous ses systèmes. Confirmez les exigences relatives aux comptes, aux identifiants et aux conditions commerciales auprès du fournisseur de l’API au lieu de supposer qu’une seule intégration autorise tous les dispositifs.

Les comptes clients doivent-ils partager le même tableau de bord de suivi ?

Ils peuvent partager la même application sous-jacente, mais chaque client ne doit voir que les expéditions et les informations auxquelles il est autorisé à accéder. Testez l’isolation lors des recherches, des exports, des notifications, des outils d’assistance et des réponses de l’API — et pas uniquement sur la page principale du tableau de bord.

Que faire si un numéro de suivi ne renvoie pas immédiatement de mises à jour ?

Conservez le lien entre l’expédition, la commande et le compte client, affichez un état d’attente précis et suivez les recommandations documentées de l’API pour effectuer une nouvelle vérification. Une étiquette peut exister avant l’apparition de l’activité du transporteur ; l’absence de scan ne doit pas être automatiquement présentée comme la perte du colis.

Une API de suivi suffit-elle pour envoyer des mises à jour de livraison personnalisées ?

Non. Les données de suivi peuvent fournir l’événement qui déclenche une mise à jour, mais le 3PL ou le marchand doit également décider qui l’envoie, quelle image de marque du client s’applique, quels destinataires sont autorisés et ce que le message doit dire. Ces règles de communication et de gestion des comptes sont extérieures à l’événement de suivi lui-même.

Quel est le premier contrôle à mettre en place pour un déploiement multi-clients ?

Créez et testez le lien entre chaque ID interne d’expédition et le compte client qui en est propriétaire. Appliquez ce contrôle de propriété partout où les données de suivi peuvent être consultées ou distribuées. Il constitue le fondement de rapports fiables, de flux de support efficaces et de l’isolation des comptes.

Sources