Skip to main content
AccueilBlogGuidesComment les plateformes de retours peuvent utiliser les API de suivi des expéditions pour les retours et les échanges

Comment les plateformes de retours peuvent utiliser les API de suivi des expéditions pour les retours et les échanges

17TRACK

Les plateformes de gestion des retours peuvent utiliser des API de suivi des expéditions pour relier les flux de retours et d'échanges aux événements de colis en temps réel. L'API peut aider une plateforme à identifier la création d'une étiquette de retour, à surveiller l'acheminement dans le réseau du transporteur, à détecter les événements de livraison ou d'exception et à déclencher l'étape opérationnelle suivante. Le résultat est un processus de retour plus facile à comprendre pour les clients et plus simple à gérer pour les marchands.

Comment les plateformes de gestion des retours peuvent utiliser les API de suivi des expéditions pour les retours

Le suivi ne remplace ni les règles de retour, ni l'inspection en entrepôt, ni les remboursements, ni les contrôles des stocks. Il fournit les données d'expédition qui permettent à ces processus de fonctionner avec un meilleur timing et moins de vérifications manuelles.

Pourquoi la visibilité des expéditions est importante pour les retours

Une expédition initiale poursuit généralement un objectif principal : livrer une commande à l'acheteur. Un retour ou un échange peut avoir plusieurs issues. Le colis peut être livré à un entrepôt, reçu par un site de traitement tiers, réacheminé, retardé ou indiqué comme livré avant que le marchand n'ait terminé son inspection. Les clients doivent également savoir si leur article retourné est en cours d'acheminement, tandis que les équipes d'assistance doivent pouvoir répondre aux questions sans dépendre des sites des transporteurs ni de recherches manuelles de suivi.

Une API de suivi offre à une plateforme de gestion des retours un moyen structuré de récupérer et de normaliser les informations d'expédition auprès des transporteurs. Selon l'API et les données disponibles du transporteur, celles-ci peuvent inclure un numéro de suivi, le statut de l'expédition, les horodatages des événements, les informations de localisation, les données de livraison estimée et les messages d'exception. Les champs exacts et la fréquence des mises à jour doivent être vérifiés dans la documentation du fournisseur sélectionné, plutôt que supposés.

Pour un flux de retours ecommerce, la valeur pratique ne réside pas simplement dans l'affichage d'un numéro de suivi. Elle consiste à utiliser les événements d'expédition comme données d'entrée pour les décisions, les messages aux clients, la gestion des dossiers et la coordination avec l'entrepôt.

Les principaux événements de suivi dans un flux de retour ou d'échange

Une plateforme de gestion des retours doit associer les événements des transporteurs à ses propres états opérationnels. La terminologie des transporteurs n'étant pas toujours cohérente, une intégration doit utiliser un modèle de statuts normalisé tout en conservant l'événement original du transporteur à des fins d'audit et d'assistance.

Événement d'expéditionAction possible de la plateformeValeur pour le client
Étiquette crééeOuvrir l'enregistrement de suivi et l'associer à l'autorisation de retour.Indique que les instructions de retour ont été émises, sans laisser entendre que le colis est déjà en mouvement.
Acceptation par le transporteur ou premier scanDémarrer le délai de transport et réduire l'incertitude quant à l'entrée du colis dans le réseau.Confirme que le transporteur a reçu le colis.
En transitMettre à jour le calendrier du retour et identifier les expéditions bloquées.Fournit une indication de progression sans nécessiter de contacter l'assistance.
Exception ou retardCréer une alerte, ajuster les attentes ou transmettre le dossier à l'assistance.Explique pourquoi le retour pourrait ne pas arriver comme prévu initialement.
LivréNotifier l'équipe réception et lancer le processus d'inspection ou d'échange.Confirme l'arrivée à la destination indiquée, tout en précisant que l'inspection peut encore être en attente.

Ces associations doivent rester distinctes de la décision finale du marchand concernant le remboursement. Un événement de livraison indique que le transporteur a signalé une livraison ; il ne prouve pas à lui seul que le bon article a été retourné, que l'article est intact ou que le retour respecte la politique du marchand.

Comment connecter une API de suivi aux opérations de retour

1. Créer un enregistrement d'expédition de retour

Lorsqu'un retour est approuvé, la plateforme de gestion des retours doit créer un enregistrement reliant l'autorisation de retour à la commande d'origine, au client, à l'article, à la destination et à l'identifiant de l'expédition. Si un échange est concerné, l'enregistrement doit également identifier la commande de remplacement ou l'action d'exécution. Cette relation empêche qu'un événement de suivi soit traité comme une simple mise à jour isolée du colis.

La plateforme doit distinguer l'expédition sortante d'origine de l'expédition de retour. Elles peuvent utiliser des transporteurs, niveaux de service, numéros de suivi et destinations de livraison différents. Un modèle de données simple peut inclure un identifiant de commande, un identifiant de retour, un identifiant d'échange le cas échéant, le transporteur, le numéro de suivi, la direction, le statut normalisé actuel, l'heure du dernier événement et l'événement brut du transporteur.

2. Envoyer le numéro de suivi à l'API

L'intégration transmet le transporteur et le numéro de suivi au service de suivi, conformément aux exigences du fournisseur en matière d'authentification, de requêtes et d'identification du transporteur. Si le système ne peut pas identifier le transporteur de manière fiable, il doit utiliser une méthode de détection approuvée ou demander le transporteur à l'utilisateur ou au marchand. Une mauvaise association du transporteur peut entraîner des résultats retardés ou inexacts.

À ce stade, la plateforme doit enregistrer la date de création de la requête de suivi et indiquer si l'API a accepté, rejeté ou n'a pas encore pu identifier l'expédition. Une requête acceptée par une API n'est pas équivalente à un scan du transporteur. Ces états ne doivent pas être combinés dans l'interface utilisateur.

3. Recevoir les mises à jour par interrogation ou webhooks

Les fournisseurs de suivi prennent généralement en charge une ou plusieurs méthodes pour obtenir les événements ultérieurs. Une plateforme peut interroger le service pour obtenir des mises à jour, recevoir des notifications push ou combiner les deux, selon la documentation du fournisseur et la latence requise. La documentation de l'API 17TRACK est l'endroit approprié pour vérifier son modèle d'intégration actuel, les modèles de requêtes pris en charge et les exigences de mise en œuvre.

Quelle que soit la méthode utilisée, la plateforme doit rendre les mises à jour idempotentes. Le même événement peut être transmis plusieurs fois, arriver dans le désordre ou être révisé par un transporteur. Stockez l'identifiant de l'événement lorsqu'il est disponible, comparez les horodatages des événements et conservez un historique au lieu d'écraser chaque état précédent.

4. Normaliser les événements en états métier

Les statuts des transporteurs sont conçus pour les opérations de transport, pas nécessairement pour les décisions de retour. Une plateforme de gestion des retours peut les convertir en états tels que étiquette émise, dépôt en attente, en transit, retardé, livré, exception de livraison et enquête requise. L'association doit préserver l'incertitude. Par exemple, « livré » peut faire passer un dossier à « inspection en attente », et non directement à « remboursement approuvé ».

Les règles métier doivent également tenir compte des événements manquants ou contradictoires. Un colis sans nouveau scan depuis plusieurs jours peut justifier une alerte interne, mais ne doit pas être automatiquement considéré comme perdu, sauf si la politique du marchand et le processus du transporteur permettent cette conclusion.

5. Déclencher les actions opérationnelles et destinées aux clients

Une fois les événements normalisés disponibles, la plateforme peut appliquer des règles. Le premier scan du transporteur peut déclencher l'envoi d'une confirmation au client. Une exception de livraison peut créer une tâche d'assistance. Un événement de livraison peut informer un entrepôt de retours qu'il doit rechercher le colis. Pour les échanges, l'entreprise peut décider de libérer l'article de remplacement après le premier scan, après la livraison ou après l'inspection. Cette décision dépend du risque, des stocks et de la politique ; les données de suivi peuvent l'éclairer, mais ne peuvent pas la déterminer universellement.

Les notifications doivent utiliser un langage simple et identifier l'étape suivante attendue. Le client doit pouvoir distinguer « le transporteur a reçu votre retour » de « le marchand a inspecté votre retour » et de « votre remboursement a été effectué ». Il s'agit d'événements différents, pris en charge par des parties différentes du processus.

Utiliser les données de suivi pour les échanges

Les flux d'échange comportent une dépendance supplémentaire : l'article de remplacement peut devoir être expédié avant que l'article retourné ait terminé son parcours. Une plateforme de gestion des retours dotée du suivi peut conserver deux enregistrements d'expédition associés : le retour entrant et le remplacement sortant. Leur liaison offre aux agents d'assistance une vue plus complète de l'échange.

Les règles d'échange utiles peuvent inclure :

  • Ne pas présenter le remplacement comme expédié tant que le système d'exécution n'a pas confirmé ce statut.
  • Afficher séparément les calendriers du retour et du remplacement, même s'ils font partie d'un seul dossier d'échange.
  • Alerter l'assistance lorsque le retour est retardé mais que le remplacement a déjà été livré.
  • Conserver la décision d'éligibilité du client séparée du statut de livraison du transporteur.
  • Enregistrer l'événement ayant déclenché une action automatisée afin que l'équipe puisse l'auditer ou l'annuler.

Cette approche réduit une source fréquente de confusion : considérer la livraison d'un remplacement comme la preuve que le retour d'origine est terminé. Les deux expéditions peuvent évoluer indépendamment et nécessiter des résolutions différentes.

La place de 17TRACK

17TRACK publie une Tracking API dédiée aux intégrations destinées aux développeurs et propose également 17RETURNS, un produit axé sur les retours. Ces produits doivent être évalués selon le rôle que le marchand doit remplir. Une API de suivi est pertinente lorsqu'une plateforme de retours a besoin de données d'expédition dans son propre flux ou sa propre application. Un produit de gestion des retours est pertinent lorsque l'entreprise a besoin d'un processus plus large pour initier, organiser et gérer les retours.

Les documents officiels de 17TRACK doivent être utilisés pour vérifier le comportement actuel de l'API, les transporteurs pris en charge, les détails d'intégration, les exigences d'authentification et les éventuelles limitations propres au produit avant la mise en œuvre. La page produit 17RETURNS et la fiche 17RETURNS sur Shopify fournissent un contexte produit, tandis que la documentation de l'API constitue la source la plus appropriée pour les décisions d'intégration technique. Un marchand qui exploite déjà une plateforme de retours personnalisée peut utiliser l'API comme couche de données ; un marchand à la recherche d'un flux de retours géré doit évaluer le produit de gestion des retours lui-même plutôt que de supposer qu'une API seule fournit ces fonctions.

Vérifications de mise en œuvre avant le lancement

Une preuve de concept doit utiliser de vrais scénarios de retour et pas seulement un exemple de colis en transit réussi. Testez au moins un retour national, un retour transfrontalier si cela est pertinent pour l'entreprise, une expédition retardée, une exception de livraison, un colis livré, une mise à jour en double et un numéro de suivi qui ne peut pas être identifié immédiatement.

L'équipe de mise en œuvre doit confirmer les points suivants :

  • Quels transporteurs et services sont nécessaires pour les itinéraires de retour du marchand et comment ces transporteurs sont identifiés.
  • Quels événements sont disponibles pour chaque transporteur concerné et si le niveau de détail des événements varie selon la destination.
  • À quelle fréquence les mises à jour sont actualisées et comment la plateforme gère les erreurs d'API, les limites de débit et les interruptions temporaires.
  • Comment les événements en double, tardifs, manquants ou reçus dans le désordre sont stockés et rapprochés.
  • Quelles actions sont automatiques et lesquelles nécessitent une vérification humaine.
  • Comment les notifications aux clients sont traduites, personnalisées à la marque, suspendues et auditées.
  • Comment les informations personnelles et les données d'expédition sont protégées, conservées et supprimées conformément aux exigences du marchand.
  • Comment le système distingue la livraison par le transporteur de la réception en entrepôt, de l'inspection, de l'approbation, du remboursement et de l'exécution de l'échange.

La responsabilité opérationnelle est aussi importante que la connectivité technique. Les équipes logistiques doivent définir la signification des événements, les équipes d'assistance doivent définir les messages destinés aux clients, les équipes financières doivent définir les contrôles des remboursements et les équipes d'entrepôt doivent définir ce qui se passe après la livraison. Sans ces décisions, une connexion API techniquement réussie peut tout de même créer une automatisation trompeuse.

Un cadre de décision pratique

Utilisez une API de suivi des expéditions lorsque le processus de retour dépend d'événements opportuns des transporteurs, lorsque l'entreprise doit connecter plusieurs systèmes ou lorsque les clients et les agents d'assistance ont besoin d'une vue partagée de l'avancement du colis. Envisagez une plateforme de gestion des retours lorsque le problème plus large comprend la configuration des politiques, l'autorisation des retours, les flux d'étiquettes, la communication avec les clients, la gestion des stocks et les rapports. Dans certaines opérations, les deux couches fonctionnent ensemble : le système de retours gère le dossier, tandis que le service de suivi fournit les événements d'expédition normalisés.

La conception la plus solide considère le suivi comme un élément probant au sein d'une machine à états plus large. Il indique à la plateforme ce que le transporteur a signalé, à quel moment et à quelle expédition cela correspond. Les règles métier décident ensuite de ce qui doit se passer. Cette séparation rend les retours et les échanges plus transparents sans promettre un niveau de certitude que les données des transporteurs ne peuvent pas fournir.

FAQ

Une API de suivi peut-elle confirmer qu'un remboursement est dû ?

Non. Elle peut signaler des événements d'expédition tels que l'acceptation, l'acheminement, une exception ou la livraison lorsque ces événements sont disponibles. L'éligibilité au remboursement dépend généralement aussi de la politique de retour, de l'état de l'article, de l'inspection, des contrôles antifraude et de l'approbation du marchand.

Un retour livré doit-il automatiquement déclencher un remboursement ?

Pas nécessairement. La livraison signifie que le transporteur a signalé que le colis avait atteint sa destination. Le marchand doit peut-être encore vérifier l'article, la quantité, l'état et l'autorisation de retour avant d'approuver un remboursement.

Pour le suivi des retours, vaut-il mieux utiliser l'interrogation ou les webhooks ?

Aucune méthode n'est universellement meilleure. Le choix dépend des méthodes prises en charge par le fournisseur, de la vitesse de mise à jour requise, de l'effort de mise en œuvre et de la tolérance aux notifications retardées. Certaines plateformes utilisent des mises à jour push avec un rapprochement périodique afin de détecter les événements manqués.

Comment une plateforme d'échange doit-elle suivre deux expéditions ?

Stockez le retour entrant et le remplacement sortant comme des enregistrements d'expédition distincts, liés au même dossier d'échange. Affichez leurs statuts indépendamment et définissez des règles empêchant de confondre le statut d'une expédition avec l'achèvement de l'autre.

Que faut-il tester avant de connecter une API de suivi ?

Testez le suivi réussi, les scans retardés, les exceptions, les événements en double, les informations de transporteur incorrectes ou inconnues, les cas transfrontaliers lorsqu'ils sont pertinents et les interruptions de l'API. Testez également les messages destinés aux clients et les parcours nécessitant une vérification humaine après chaque événement.

Sources