Comment les marques de commerce électronique par abonnement peuvent suivre les expéditions récurrentes grâce à une API de suivi
Pour suivre des expéditions récurrentes avec une API de suivi, créez un enregistrement d’expédition pour chaque colis physique, associez-le à la commande d’exécution correspondant à ce cycle d’abonnement et enregistrez son numéro de suivi lorsque votre entrepôt ou votre partenaire logistique vous le fournit. Utilisez les mises à jour de suivi de l’API pour indiquer aux clients où se trouve ce colis et signaler les exceptions de livraison à votre équipe. Conservez l’ID d’abonnement comme lien entre les cycles, et non comme identifiant d’un colis.

Suivez le colis, pas l’abonnement
Un abonnement vous indique ce qu’un client doit recevoir au fil du temps. Une commande d’exécution vous indique ce qui doit être expédié pour un cycle donné. Un numéro de suivi vous renseigne sur un colis particulier. Séparer ces enregistrements évite qu’une expédition en retard d’un cycle apparaisse sur la page de suivi du cycle suivant.
Par exemple, supposons qu’une box d’abonnement de mai soit répartie en deux colis et que la box de juin soit expédiée alors qu’un colis de mai est encore en transit. Le client doit voir deux colis sous la commande de mai et un colis distinct sous la commande de juin. La mise à jour tardive de mai ne doit modifier que le colis de mai. Si vous envoyez un remplacement, créez un nouvel enregistrement d’expédition et associez-le à l’original afin que le service d’assistance puisse comprendre pourquoi les deux existent.
- Abonnement : Enregistrez l’ID d’abonnement afin que le service d’assistance puisse retrouver l’historique des expéditions du client.
- Cycle et commande : Enregistrez l’identifiant du cycle ou la date d’exécution planifiée, l’ID de commande et tous les identifiants d’exécution nécessaires pour associer les colis à la bonne commande. Ne déduisez pas le cycle de la date d’arrivée d’un événement de suivi.
- Expédition : Attribuez à chaque colis un ID d’expédition interne. Enregistrez son transporteur et son numéro de suivi, la référence d’exécution pertinente ainsi que tout ID d’enregistrement du suivi renvoyé par le prestataire. Retirez de la vue client active les étiquettes annulées et les numéros de suivi remplacés, mais conservez l’historique pour le service d’assistance.
Sur une page de commande, affichez la progression au niveau du colis en parallèle de tout résumé de commande. Si un colis est livré et qu’un autre est en transit, indiquez-le. N’affichez la commande entière comme livrée que lorsque tous les colis nécessaires à son exécution sont arrivés, en tenant compte des expéditions annulées et des remplacements.
Connectez l’exécution à l’API de suivi
- Enregistrez à partir d’un événement d’exécution. Déclenchez l’enregistrement lorsqu’un système d’exécution, un entrepôt ou un partenaire logistique tiers envoie le transporteur et le numéro de suivi. Un paiement de renouvellement est trop précoce : la commande peut encore être en attente d’expédition et aucun numéro de suivi n’existe peut-être.
- Enregistrez l’expédition avant d’appeler l’API. Enregistrez l’expédition interne de manière persistante et mettez la demande d’enregistrement en file d’attente. Si le même message d’exécution arrive deux fois, réutilisez cet enregistrement au lieu de créer un autre colis. Si l’appel à l’API expire, vérifiez si la demande initiale a abouti avant de réessayer, lorsque le prestataire vous offre cette possibilité.
- Associez les mises à jour au colis enregistré. Utilisez l’identifiant d’enregistrement du prestataire s’il est renvoyé dans les mises à jour. Sinon, faites l’association à l’aide des identifiants indiqués dans sa documentation et validez le résultat par rapport à vos enregistrements d’expédition. Si une mise à jour peut correspondre à plusieurs enregistrements, envoyez-la pour examen au lieu de l’appliquer à la commande la plus récente.
- Séparez la création de l’étiquette du déplacement du transporteur. Un numéro de suivi peut exister avant que le transporteur enregistre la prise en charge. Utilisez un message tel que « Préparation de la prise en charge par le transporteur » lorsque vous ne disposez que d’une étiquette. Réservez « En transit » aux informations du transporteur qui le justifient.
L’API de suivi 17TRACK constitue une option pour cette configuration. Sa documentation destinée aux développeurs fait référence pour l’enregistrement des numéros de suivi et la réception des mises à jour de suivi. Utilisez ces mises à jour pour maintenir l’enregistrement du colis dans votre système ; gérez l’attribution au cycle, l’achèvement de la commande et les règles de notification client dans votre application de commerce électronique. Avant le déploiement, testez avec des colis provenant de vos itinéraires de transporteurs et de vos partenaires logistiques réels, plutôt que de vous fier uniquement à une liste de transporteurs.
Rendez les mises à jour sûres à traiter deux fois
Lorsque votre prestataire propose des webhooks, utilisez-les pour recevoir les mises à jour sans interroger continuellement chaque colis. Un webhook est une requête HTTP que le prestataire envoie à votre application. Respectez ses exigences de vérification, stockez durablement les charges utiles acceptées et accusez réception des demandes conformément à ses règles de réponse documentées. Exécutez les tâches plus lentes, telles que la mise à jour des vues de commande ou l’envoi d’e-mails, en dehors du gestionnaire de requêtes.
Concevez le processus de traitement de manière à ce qu’une mise à jour répétée n’ait aucun effet supplémentaire. Si le prestataire fournit des ID d’événement stables, utilisez-les pour reconnaître les répétitions. S’il envoie des instantanés de suivi plutôt que des événements individuels, comparez l’état entrant et l’historique des scans avec les données existantes avant d’agir. Dédupliquez séparément les messages destinés aux clients : une notification de livraison déjà envoyée ne doit pas l’être à nouveau simplement parce que les mêmes données d’expédition ont été traitées deux fois.
Conservez séparément l’heure à laquelle un scan a eu lieu et celle à laquelle votre application l’a reçu. Un scan de transit arrivé tardivement peut figurer dans l’historique du colis sans remplacer un statut de livraison plus récent. Ne supposez toutefois pas que chaque changement légitime fait progresser un colis. Une correction du transporteur ou une mise à jour de retour à l’expéditeur peut nécessiter de modifier ce que vous affichez. Si les nouvelles données sont en conflit avec l’état enregistré et que vous ne pouvez pas déterminer laquelle est correcte, placez l’expédition dans une file d’examen.
Effectuez périodiquement une vérification des expéditions ouvertes qui peuvent nécessiter une intervention : enregistrements toujours en attente, colis sans premier scan après un transfert prévu et expéditions dont le suivi est devenu silencieux. Lorsque l’API prend en charge une recherche ou une actualisation, utilisez-la de manière sélective dans les limites du prestataire. Examinez les tendances entre les transporteurs et les entrepôts avant de procéder à une escalade. Si les mises à jour cessent simultanément pour de nombreuses expéditions sans lien entre elles, examinez l’intégration avant d’ouvrir des dossiers de livraison individuels.
Transformez les données de suivi en messages utiles pour les clients
Les clients ont rarement besoin d’un e-mail pour chaque scan. Commencez par des messages liés à une information ou à une action importante pour eux : le colis est entré dans le réseau du transporteur, une tentative de livraison nécessite une action ou le transporteur signale la livraison. Affichez la référence de commande ainsi que la box ou le cycle concernés afin que les abonnés sachent de quelle expédition il s’agit. Pour une commande divisée, identifiez le colis et indiquez clairement si le reste de la commande est toujours en route.
- Étiquette créée, aucun scan : Vérifiez le transfert prévu dans les registres de l’entrepôt. Si le délai de transfert est dépassé, demandez à l’équipe d’exécution de confirmer que le colis a quitté l’établissement avant d’indiquer au client qu’il est retardé en transit.
- Le suivi n’évolue plus : Utilisez des seuils qui tiennent compte de l’itinéraire et du service, plutôt qu’un seul délai pour tous les colis. Pour les expéditions transfrontalières, examinez le dernier événement du transporteur avant de décider de contacter le client ou de procéder à une escalade.
- Tentative échouée ou retrait requis : Indiquez au client l’action requise si le transporteur fournit des instructions claires. Si l’événement est vague, transmettez le dossier au service d’assistance au lieu de deviner une date de nouvelle livraison ou un lieu de retrait.
- Indiqué comme livré mais non reçu : Conservez le statut signalé par le transporteur et ouvrez un dossier d’assistance distinct. Votre processus d’assistance doit distinguer un signalement du client d’une correction du transporteur.
Donnez au personnel d’assistance une vue unique du cycle, de la commande, de l’historique des colis et des messages déjà envoyés. Pour chaque exception, désignez un responsable et une prochaine étape. L’équipe d’exécution peut examiner un transfert manquant, la logistique peut effectuer un suivi concernant une exception du transporteur et le service d’assistance peut gérer la communication avec le client. Un statut de suivi décrit le colis ; il ne décide pas si un remplacement ou un remboursement est dû.
Testez le chevauchement avant le déploiement
Commencez avec un partenaire d’exécution et un ensemble d’expéditions qui reflète la façon dont il expédie réellement les commandes. Incluez un cycle comportant plusieurs colis, une étiquette annulée, un remplacement et une ancienne expédition encore ouverte lorsque le cycle suivant est expédié. Rejouez ensuite volontairement un webhook en double et transmettez un ancien événement après un événement plus récent. Vérifiez l’enregistrement du colis, la page de commande client, la vue du service d’assistance et le journal des notifications. Un test qui vérifie uniquement une réponse API réussie peut manquer l’erreur la plus coûteuse : mettre à jour la mauvaise commande ou contacter le mauvais client.
Surveillez les échecs d’enregistrement, la proportion de colis éligibles enregistrés avec succès, les premiers scans plus tardifs que prévu et les mises à jour non associées. Si vous suivez la latence des mises à jour, distinguez le délai entre un événement du transporteur et sa réception du temps nécessaire à votre propre système pour le traiter. Cela vous aide à déterminer s’il faut examiner le flux du transporteur, votre point de terminaison webhook ou une file d’attente dans votre application.
Étendez le dispositif à d’autres itinéraires une fois que vous pouvez répondre à trois questions pour n’importe quel colis : À quel cycle appartient-il ? Qu’a signalé le transporteur en dernier ? Qui intervient si la mise à jour est absente ou incorrecte ? Si une réponse n’est pas claire, corrigez la correspondance des enregistrements ou le processus de gestion des exceptions avant d’ajouter d’autres règles de notification.
FAQ
Une API de suivi peut-elle indiquer aux clients quand leur prochaine box d’abonnement sera expédiée ?
Utilisez votre calendrier d’abonnement et votre système d’exécution pour connaître la prochaine date d’expédition prévue. Une API de suivi concerne un colis précis une fois que les informations de suivi existent. Une date d’expédition prévue, une estimation de livraison du transporteur et une livraison confirmée sont des faits différents et doivent être étiquetés séparément.
Que faire si l’entrepôt remplace un numéro de suivi après l’envoi d’un e-mail ?
Marquez l’ancienne étiquette comme remplacée et associez le nouveau numéro de suivi à la même commande. Si votre e-mail renvoie vers une page de suivi au niveau de la commande, mettez cette page à jour afin que le client puisse trouver le colis actif sans avoir besoin du lien initial du transporteur. Envoyez une correction lorsque le changement concerne une information sur laquelle le client doit agir.
Que faire si un partenaire d’exécution envoie des numéros de suivi sans codes de transporteur ?
Demandez au partenaire un champ de transporteur cohérent ou une correspondance avec ses codes de service d’expédition. Si votre API propose la détection du transporteur, vérifiez son fonctionnement avec les étiquettes du partenaire avant de vous y fier. Dirigez les correspondances ambiguës vers un examen plutôt que de choisir un transporteur uniquement à partir du numéro de suivi.
Les abonnements suspendus ou ignorés nécessitent-ils des enregistrements de suivi ?
Aucun enregistrement de colis n’est nécessaire pour un cycle qui n’est jamais expédié. Si une expédition précédente est toujours ouverte, continuez à la suivre même lorsque l’abonnement est suspendu, ignoré ou annulé. L’état de l’abonnement contrôle les futures exécutions ; il ne vous indique pas ce qui est arrivé à un colis qui a déjà quitté l’entrepôt.
Sources
- API de suivi 17TRACK — présentation du produit pour intégrer le suivi des colis aux systèmes professionnels.
- Documentation de l’API de suivi 17TRACK — référence de mise en œuvre pour enregistrer les numéros de suivi et recevoir les données de suivi.
- Documentation des webhooks Stripe — référence concernant les pratiques générales liées aux webhooks, telles que la gestion des événements en double et l’absence de suppositions sur l’ordre de livraison. Suivez les propres règles de votre prestataire de suivi en matière de vérification et d’accusé de réception.


