Skip to main content
AccueilBlogGuidesComment les plateformes de retours utilisent une API de suivi des expéditions pour suivre les expéditions de retour

Comment les plateformes de retours utilisent une API de suivi des expéditions pour suivre les expéditions de retour

17TRACK

Les plateformes de gestion des retours utilisent une API de suivi des expéditions pour relier un retour approuvé à son expédition physique. La plateforme enregistre le transporteur et l’identifiant de suivi de l’expédition retour, récupère les événements de suivi et utilise ces événements pour afficher la progression ou demander un examen opérationnel. L’API fournit une visibilité sur l’expédition ; la plateforme de gestion des retours reste responsable de la demande de retour, des décisions relatives à la politique, de l’inspection en entrepôt et du processus de remboursement.

Comment les plateformes de gestion des retours utilisent une API de suivi des expéditions

Pour une équipe chargée des opérations ou du produit des retours, la question utile n’est pas simplement de savoir si une API peut afficher un statut de suivi. Il s’agit de déterminer si l’intégration peut identifier de manière fiable la bonne expédition retour, interpréter les événements reçus et empêcher qu’une mise à jour du suivi ne déclenche le mauvais message client ou la mauvaise action de remboursement.

La place du suivi dans un retour

Un retour commence comme un enregistrement commercial : un client demande à renvoyer un article et le marchand décide ce qu’il autorise. Un enregistrement de suivi décrit autre chose : le déplacement d’un colis. Relier ces deux enregistrements permet à une plateforme de gestion des retours de répondre à des questions telles que : le client semble-t-il avoir remis le colis au transporteur, le colis se dirige-t-il vers la destination de retour et un événement de livraison a-t-il été signalé ?

Cette connexion doit être explicite. Une commande peut contenir plusieurs articles, un client peut effectuer plusieurs retours pour une même commande et un retour peut comprendre plusieurs colis. Le numéro de suivi de l’expédition initiale ne doit pas être confondu avec celui du retour. Un modèle de données pratique conserve des identifiants distincts pour la commande, l’autorisation de retour, le colis retour, le transporteur et l’enregistrement de suivi, puis stocke les relations entre eux.

Le suivi a également une limite claire. Un événement de livraison du transporteur peut indiquer qu’un colis est arrivé à une adresse ou dans un établissement. Il ne permet pas d’établir que l’entrepôt a reçu l’article attendu, que l’article a passé l’inspection ou qu’un remboursement est dû. Ces décisions nécessitent leurs propres éléments de preuve et règles.

Le flux d’intégration, de l’autorisation à la réception

1. Créer l’enregistrement du retour avant de suivre le colis

La plateforme de gestion des retours enregistre d’abord la demande, les articles concernés, la destination autorisée et la résolution permise. Si le retour utilise une étiquette délivrée par le marchand, la plateforme peut associer l’identifiant de suivi de l’étiquette au colis retour. Si le client organise lui-même l’expédition, la plateforme peut avoir besoin d’un moyen de recueillir et de valider le transporteur et le numéro de suivi avant de commencer la surveillance.

C’est le premier point où la qualité des données affecte la visibilité. Un numéro de suivi sans association fiable entre le colis et le retour peut produire une mise à jour du transporteur parfaitement exacte, mais concernant le mauvais retour. Les équipes doivent également décider comment gérer les numéros de suivi corrigés, les étiquettes de remplacement et les clients qui soumettent deux fois le même identifiant.

2. Enregistrer ou rechercher l’expédition

La plateforme envoie au prestataire de suivi choisi les informations nécessaires pour créer ou récupérer un enregistrement d’expédition. Les champs exacts de la requête et leur ordre dépendent de la documentation de ce prestataire. Au minimum, l’implémentation doit permettre d’associer de manière fiable la référence d’expédition du prestataire à son propre enregistrement de colis retour. Lorsque l’identification du transporteur est nécessaire, la plateforme doit confirmer la gestion des informations ambiguës ou non prises en charge au lieu de supposer qu’un numéro de suivi suffit à lui seul.

Conservez la réponse du prestataire, les erreurs d’intégration et la date à laquelle la plateforme a commencé la surveillance. Une requête acceptée ne prouve pas nécessairement qu’un transporteur a scanné le colis. Avant le premier scan, l’état affiché au client peut devoir indiquer que le suivi est en attente plutôt que de présenter le retour comme étant en transit.

3. Intégrer les mises à jour sans perdre l’événement d’origine

Selon l’API, les mises à jour peuvent arriver via un webhook, être récupérées par interrogation périodique ou utiliser une autre méthode documentée. L’intégration doit conserver les informations brutes de l’événement du prestataire avec tout statut simplifié affiché dans la plateforme de gestion des retours. Les champs utiles peuvent inclure la description de l’événement, son heure, le lieu lorsqu’il est fourni, la référence du transporteur et l’heure à laquelle la plateforme a reçu la mise à jour.

Ces deux heures répondent à des questions différentes. L’horodatage de l’événement indique quand une activité est censée avoir eu lieu ; l’horodatage de réception indique quand la plateforme de retours en a eu connaissance. Les retards, les livraisons répétées et les messages reçus dans le désordre peuvent sinon donner l’impression qu’un retour revient en arrière. Si le prestataire fournit des identifiants d’événement, utilisez-les pour la déduplication. Dans le cas contraire, définissez une méthode prudente de déduplication et testez-la avec de vrais échantillons d’intégration.

4. Traduire les événements de suivi en états de retour

Les descriptions des événements du transporteur ne constituent pas une politique de retour. La plateforme de gestion des retours les associe généralement à un ensemble plus restreint d’états opérationnels, tels que remise en attente, en transit, livraison signalée ou examen nécessaire. L’association doit tenir compte des événements inconnus au lieu de considérer silencieusement chaque mise à jour non reconnue comme une progression.

Par exemple, le premier scan du transporteur peut suffire à informer un client que son colis semble être en route. Il peut ne pas suffire à promettre une date de remboursement. Un événement de livraison peut aider l’entrepôt à donner la priorité à un colis correspondant, mais une règle de remboursement peut toujours exiger la réception physique et l’inspection. Les équipes doivent inscrire ces distinctions dans le flux de travail avant de relier les statuts aux actions automatisées.

5. Boucler le processus avec les preuves de l’entrepôt

Une fois le colis arrivé, l’entrepôt ou le centre de retours peut scanner un code-barres interne, associer le colis à une autorisation de retour, inspecter son contenu et enregistrer le résultat. Il s’agit d’événements de gestion des retours, et non d’événements de suivi du transporteur. Lorsque les deux systèmes sont connectés, la plateforme peut afficher une séquence plus utile : mouvement de l’expédition, livraison signalée par le transporteur, colis reçu par l’établissement et traitement finalisé.

Cette séquence aide également à résoudre les exceptions. Si le suivi signale une livraison mais qu’aucune réception en entrepôt n’apparaît, un opérateur peut examiner la destination, l’événement du transporteur, la file de réception de l’établissement et l’identifiant du colis avant de formuler une affirmation destinée au client. Si l’entrepôt reçoit un colis sans historique de suivi exploitable, la réception physique peut tout de même être enregistrée ; l’absence de données de suivi ne doit pas effacer les preuves indépendantes de l’entrepôt.

Ce qu’une API de suivi peut et ne peut pas indiquer à la plateforme

Une API de suivi des expéditions peut rendre les mouvements signalés par le transporteur accessibles à une autre application, sous réserve de la couverture documentée du prestataire, de la disponibilité des événements et du comportement de l’intégration. Elle ne peut pas, à elle seule, vérifier le contenu d’un retour ni décider si la politique du marchand a été respectée. Il se peut également qu’elle n’ait aucune mise à jour à signaler avant le premier scan du transporteur.

Cette distinction est importante lors de la conception de l’automatisation. Les statuts doivent être considérés comme des signaux associés à des usages définis, et non comme des preuves interchangeables. Un événement de remise au transporteur peut déclencher une notification de progression. Un événement de livraison peut créer une tâche de suivi pour l’entrepôt. Une réception confirmée par l’entrepôt peut faire passer le retour à l’étape d’inspection. La décision de remboursement ou d’échange doit suivre les règles réelles du marchand et les éléments de preuve exigés par ces règles.

Le langage destiné aux clients doit respecter la même limite. « Le transporteur indique que votre retour a été livré » est plus précis que « Nous avons approuvé votre remboursement » lorsqu’aucune inspection n’a encore eu lieu. De même, « Nous attendons la première mise à jour du transporteur » est plus informatif qu’une page de suivi vide et inexpliquée.

Contrôles de conception pour éviter les erreurs de suivi des retours

  • Faire la correspondance au niveau du colis. Testez les retours fractionnés, plusieurs colis associés à une même autorisation, les étiquettes de remplacement et les retours répétés pour une même commande. Chaque colis doit être associé sans ambiguïté à son propre enregistrement de suivi.
  • Définir la priorité des statuts. Décidez de ce qui se passe lorsqu’un ancien événement « en transit » arrive après un événement de livraison. Conservez l’historique des événements sans rétrograder automatiquement l’état du retour affiché.
  • Séparer les erreurs du prestataire du silence du transporteur. Un échec d’authentification, une requête rejetée ou un traitement de webhook échoué constitue un problème d’intégration. L’absence de scan est une condition différente et doit être communiquée autrement.
  • Prévoir les doublons et les nouvelles tentatives. Une mise à jour de livraison peut être répétée. Rendez l’intégration des événements sûre en cas de nouvelle tentative et évitez d’envoyer deux fois la même notification au client ou de créer deux fois la même tâche.
  • Protéger les données des clients et des expéditions. Limitez l’accès aux identifiants de suivi, ne conservez que les données nécessaires au flux de travail et examinez les exigences documentées du prestataire en matière d’authentification et de sécurité avant le lancement.
  • Conserver une procédure manuelle. Certains retours auront des informations de suivi incomplètes, tardives ou incohérentes. Les opérateurs doivent pouvoir examiner et corriger l’enregistrement du retour sans inventer d’événements du transporteur.

Ces contrôles sont particulièrement utiles lorsqu’ils sont testés sur des scénarios concrets plutôt que sur une seule expédition réussie. Un petit ensemble de tests doit inclure l’absence de premier scan, un numéro de suivi incorrect, un événement en double, un événement reçu dans le désordre, un signalement de livraison sans réception en entrepôt et une réception en entrepôt sans signalement de livraison correspondant. Le message attendu pour le client et l’action de l’opérateur doivent être définis pour chaque cas.

Choisir l’API et définir la répartition des responsabilités

Commencez par les itinéraires de retour et les transporteurs réellement utilisés par l’entreprise. Vérifiez ensuite, dans la documentation actuelle du prestataire, comment fonctionne l’enregistrement des expéditions, quels identifiants sont nécessaires, comment les mises à jour sont transmises, quelles données d’événement sont exposées et comment les erreurs et les nouvelles tentatives sont gérées. Confirmez directement les transporteurs et les itinéraires de retour concernés au lieu de les déduire d’une déclaration générale sur la couverture des transporteurs. Effectuez des tests avec des expéditions représentatives avant de vous appuyer sur des statuts associés pour communiquer avec les clients ou automatiser des actions.

17TRACK publie une présentation de l’API de suivi et une documentation de l’API ; sa page produit 17RETURNS couvre le volet de gestion des retours du processus. Il s’agit de points de départ pertinents pour une équipe qui évalue la visibilité du suivi parallèlement à un processus de retours. L’existence de ces deux domaines produits ne doit pas être considérée comme la preuve qu’une intégration, un transporteur, un événement ou une règle de remboursement automatisé donné est disponible. Vérifiez le flux exact dans la documentation actuelle et, si nécessaire, auprès du prestataire.

Pour un achat ou une preuve de concept, demandez à l’équipe responsable de la politique de retours et des opérations d’entrepôt d’examiner la correspondance des statuts avec l’équipe d’ingénierie. L’ingénierie peut confirmer si l’API fournit des événements exploitables ; les opérations peuvent confirmer si ces événements justifient l’action proposée. Une intégration réussie aide le personnel et les clients à suivre le colis tout en maintenant l’autorisation, la réception, l’inspection et la résolution comme des étapes distinctes.

FAQ

Un retour doit-il avoir un numéro de suivi différent de celui de la commande initiale ?

La plateforme doit conserver des enregistrements distincts pour les expéditions sortantes et les expéditions retour. Un retour voyage généralement comme une expédition distincte ; son identifiant de suivi doit donc être associé au colis retour et non être supposé correspondre à l’identifiant sortant de la commande initiale. Les identifiants exacts disponibles dépendent de la manière dont le retour est expédié.

Une API de suivi peut-elle confirmer qu’un remboursement doit être effectué ?

Non. Aucun événement de suivi ne confirme à lui seul que l’article retourné respecte les conditions de remboursement du marchand. La plateforme peut utiliser les événements du transporteur comme données d’entrée d’un flux de travail, mais l’éligibilité au remboursement peut également dépendre de l’autorisation, de la réception physique, de l’inspection et de la politique du marchand.

Que faire si le suivi indique une livraison, mais que l’entrepôt ne trouve pas le colis ?

Conservez séparément l’événement de livraison signalé par le transporteur et l’enregistrement de réception en entrepôt. Vérifiez la destination signalée et les détails de l’événement, puis examinez le processus de réception et d’association de l’établissement. Ne convertissez pas silencieusement la livraison du transporteur en réception confirmée par l’entrepôt.

Les webhooks sont-ils nécessaires pour suivre les expéditions retour ?

Pas nécessairement. La méthode de mise à jour dépend du prestataire choisi et des options documentées par celui-ci. Si des webhooks sont disponibles, prévoyez l’authentification, les nouvelles tentatives, les livraisons en double et les échecs de traitement. Si l’interrogation périodique est utilisée, choisissez un intervalle et une règle d’arrêt adaptés au flux de retours et aux exigences du prestataire.

Quand le client doit-il voir la première mise à jour du suivi ?

Cela dépend du moment où le transporteur signale un événement et du moment où l’intégration le reçoit. La création d’une étiquette ou l’enregistrement d’une expédition peut avoir lieu avant le scan du transporteur. Affichez clairement cette distinction afin que les clients n’interprètent pas une première mise à jour en attente comme un mouvement confirmé.

Sources