Skip to main content
AccueilBlogGuidesUne API de suivi peut-elle fonctionner sans étiquettes d’expédition ? Suivi des commandes 3Pl et des marketplaces ?

Une API de suivi peut-elle fonctionner sans étiquettes d’expédition ? Suivi des commandes 3Pl et des marketplaces ?

17TRACK

Oui. Une API de suivi peut fonctionner sans que votre entreprise crée d’étiquettes d’expédition, à condition qu’un transporteur ou un partenaire logistique ait créé un envoi traçable et que vous puissiez obtenir un numéro de suivi utilisable ou un autre identifiant pris en charge par l’API. Cette situation est courante lorsqu’un prestataire logistique tiers (3PL) ou une marketplace gère l’exécution des commandes. La distinction se situe entre ne pas acheter soi-même l’étiquette et ne disposer d’aucun identifiant d’envoi : le premier cas est généralement gérable ; le second peut laisser l’API sans aucune donnée à suivre.

Une API de suivi peut-elle fonctionner sans étiquettes d’expédition Suivi 3PL

Pour un vendeur, un opérateur de marketplace ou une équipe d’intégration, la tâche pratique consiste à relier chaque commande à l’envoi créé par la partie qui assure effectivement l’expédition. Cela nécessite un accès aux bonnes données, et non nécessairement le contrôle de la création des étiquettes.

Ce dont une API de suivi a besoin lorsque vous ne créez pas l’étiquette

Une étiquette d’expédition est un moyen de produire un identifiant d’envoi, mais elle ne constitue généralement pas la donnée d’entrée lue par une API de suivi. Les intégrations de suivi fonctionnent généralement à partir des données d’envoi fournies après la création d’une étiquette ailleurs. Avant de concevoir la connexion, distinguez trois enregistrements souvent considérés comme interchangeables :

  • ID de commande : identifie un achat dans votre boutique, votre compte marketplace ou votre système de gestion des commandes. Il peut couvrir plusieurs articles et plusieurs envois.
  • ID d’exécution ou de colis : identifie une opération d’exécution ou un colis dans un système de 3PL ou de marketplace. Son format et sa signification dépendent de ce système.
  • Numéro de suivi du transporteur : identifie un envoi à des fins de suivi, sous réserve que le transporteur et le service de suivi l’acceptent.

Votre ID de commande interne vous aide à trouver la bonne commande client. Il ne fonctionne pas automatiquement comme un numéro de suivi de transporteur. Le schéma d’intégration habituel consiste à obtenir le numéro de suivi auprès du 3PL ou de la marketplace, à enregistrer ou interroger ce numéro via l’API de suivi, puis à stocker les informations d’envoi renvoyées avec la commande ou le colis concerné.

Un nom ou un code de transporteur peut également être nécessaire. Certains services peuvent tenter de détecter le transporteur, mais cela doit être testé plutôt que supposé, en particulier lorsque des identifiants se chevauchent entre plusieurs transporteurs ou qu’une commande passe par plusieurs réseaux de livraison. Consultez la documentation de l’API concernant les identifiants acceptés, les règles de sélection du transporteur, les exigences d’enregistrement et les champs de statut avant de vous engager dans une mise en œuvre.

Suivi des commandes expédiées par un 3PL

Lorsqu’un 3PL prépare une commande, achète l’étiquette et remet le colis à un transporteur, votre entreprise peut ne jamais voir l’étiquette elle-même. Vous avez toutefois besoin des informations d’envoi résultant de ce processus. Demandez au 3PL quel système ou flux fournit les numéros de suivi, les informations sur le transporteur, les identifiants de colis et la référence de commande que vous avez fournie lors de la demande d’exécution.

Un flux 3PL opérationnel se présente généralement ainsi :

  1. Envoyez la commande et une référence stable au 3PL dans le cadre de votre processus d’exécution existant.
  2. Recevez une confirmation d’exécution contenant le numéro de suivi au niveau du colis et, lorsque cette information est disponible, le transporteur.
  3. Associez ce colis à la bonne commande client et aux bons articles.
  4. Soumettez l’identifiant d’envoi pris en charge à votre API de suivi ou utilisez le processus de recherche prévu par l’API.
  5. Enregistrez les mises à jour de suivi pour le colis, puis présentez une vue au niveau de la commande à votre équipe opérationnelle ou à votre client.

L’étape d’association mérite une attention particulière. Une même commande peut quitter l’entrepôt dans deux cartons, ou un article peut être expédié plus tard que les autres. Dans les deux cas, aucun statut de colis unique ne décrit correctement l’ensemble de la commande. Conservez les enregistrements au niveau du colis et déduisez-en tout message au niveau de la commande. Par exemple, ne marquez pas une commande comme livrée simplement parce que son premier colis l’a été.

Convenez avec le 3PL de la manière dont les corrections seront transmises. Les étiquettes peuvent être annulées, les colis peuvent être reconditionnés et un numéro de suivi initial peut être remplacé. Votre intégration doit pouvoir associer le remplacement à la même commande sans afficher indéfiniment les deux numéros comme des envois actifs.

Suivi des commandes de marketplace lorsque la marketplace contrôle l’expédition

L’exécution des commandes par une marketplace soulève une question technique similaire, mais une question d’accès différente. La marketplace ou son partenaire d’exécution peut créer l’étiquette, tandis que le vendeur peut ne recevoir que les informations d’expédition exposées par son compte, son flux de commande ou son intégration autorisée. Une API de suivi ne peut pas compenser l’absence d’un numéro de suivi que la marketplace ne vous a pas rendu disponible.

Commencez par identifier le modèle d’exécution de chaque commande. Pour les commandes exécutées par le vendeur, votre propre processus d’expédition ou votre 3PL peut être la source des données de colis. Pour les commandes exécutées par la marketplace, celle-ci peut être la source des informations d’envoi, et les champs disponibles pour un vendeur peuvent différer. Ne supposez pas qu’une page de commande affichant un statut de livraison fournit également un numéro de suivi de transporteur adapté à l’enregistrement auprès d’une API distincte.

Si la marketplace fournit un numéro traçable, vérifiez que vous êtes autorisé à le récupérer et à l’utiliser dans le système prévu. Testez ensuite si l’API de suivi accepte cet identifiant et si les événements obtenus apportent des informations utiles au-delà du statut de la marketplace. Si la marketplace n’expose que sa propre référence de commande ou de livraison, recherchez une méthode de consultation explicitement prise en charge. Ne soumettez pas un ID de commande interne de marketplace comme s’il s’agissait d’un numéro de transporteur en espérant obtenir des résultats fiables.

Conservez séparément l’état de la commande de la marketplace et l’état de l’envoi de l’API de suivi. Une marketplace peut décrire une commande comme expédiée dès que l’exécution est confirmée, tandis que le suivi du transporteur peut encore n’afficher aucun scan d’acceptation. Ces enregistrements répondent à des questions différentes et peuvent être mis à jour à des moments différents.

Quand le suivi sans étiquette ne résoudra pas le problème

« Aucune étiquette créée par nos soins » n’est pas un obstacle. Les situations suivantes peuvent toutefois l’être :

  • Aucun envoi n’a été créé : avant que l’exécution ne génère un identifiant utilisable, il se peut qu’aucun envoi de transporteur ne soit interrogeable. Une confirmation de commande seule ne prouve pas qu’un colis est en transit.
  • L’identifiant ne vous est pas accessible : un 3PL ou une marketplace peut conserver le numéro sans l’exposer via votre flux autorisé. Résolvez ce problème d’accès aux données à la source.
  • L’identifiant n’est pas pris en charge : un numéro de référence, un code propre à une marketplace ou un format de transporteur non pris en charge peut ne pas fonctionner avec l’API sélectionnée. Vérifiez les données d’entrée acceptées dans la documentation et avec un envoi test.
  • Le colis n’a pas encore fait l’objet d’un nouveau scan : un numéro peut exister avant que le transporteur n’enregistre un événement d’acceptation. Considérez un résultat vide ou inchangé comme un état à examiner, et non comme la preuve automatique que le numéro est invalide.
  • Le suivi est limité ou incomplet : le transporteur, le service ou le processus d’expédition peut ne pas fournir les événements nécessaires à votre cas d’utilisation destiné aux clients. Vérifiez la qualité réelle des événements à l’aide d’envois représentatifs.

Ces limites sont importantes, car une API ne peut pas créer des événements physiques manquants ni accorder l’accès aux données de commande d’une autre partie. Sa valeur réside dans la récupération et l’organisation des informations de suivi prises en charge une fois que l’identifiant et les autorisations nécessaires existent.

Comment évaluer une API pour ce flux de travail

La Tracking API de 17TRACK est une option pertinente à étudier lorsque votre équipe a besoin de données de suivi des expéditions dans ses propres systèmes, plutôt que d’un outil d’achat d’étiquettes. Sa documentation développeur est l’endroit où vérifier les champs d’enregistrement acceptés, les transporteurs pris en charge, la structure des réponses, l’authentification et les éventuelles méthodes disponibles de diffusion des mises à jour pour votre cas d’utilisation. Ne déduisez pas la prise en charge d’un 3PL, d’une marketplace ou d’un identifiant propriétaire particulier de l’existence d’une API de suivi générale.

Constituez un petit ensemble de tests avant de sélectionner ou de déployer un fournisseur. Incluez une commande 3PL avec un numéro de transporteur, une commande de marketplace pour laquelle votre compte expose un numéro, une commande comportant plusieurs colis, un numéro créé avant son premier scan et un envoi avec un événement de livraison ultérieur. Si les remplacements ou les transferts internationaux sont courants, incluez-les également. Le test doit répondre à des questions opérationnelles, et pas seulement déterminer si une requête renvoie une réponse HTTP réussie :

  • Pouvez-vous transmettre les identifiants que vous recevez effectivement, sans les réécrire manuellement ?
  • Pouvez-vous associer de manière fiable chaque enregistrement de suivi à la bonne commande et au bon colis ?
  • Les descriptions des événements, les horodatages et les informations sur le transporteur sont-ils suffisants pour vos messages clients et vos flux de support ?
  • Comment votre système gérera-t-il les mises à jour en double, les événements manquants, les changements de numéro et les requêtes échouées ?
  • L’utilisation prévue des données de la marketplace et des clients respecte-t-elle les conditions d’accès applicables à ces données ?

Pour l’intégration elle-même, conservez à la fois l’enregistrement source d’origine et l’enregistrement de l’API de suivi. Stockez la référence de commande, la référence du colis, le numéro de suivi soumis, les informations sur le transporteur lorsqu’elles sont disponibles et l’heure de réception de chaque mise à jour. Il est ainsi plus facile d’examiner une incohérence sans présenter un événement de l’API comme s’il constituait l’historique complet de l’exécution. Si l’API propose le choix entre des vérifications planifiées et la réception de mises à jour via un mécanisme de diffusion pris en charge, choisissez en fonction du comportement documenté et de votre besoin de mises à jour rapides ; aucune de ces approches ne dispense de gérer les erreurs.

La décision pratique

Utilisez une API de suivi sans créer d’étiquettes lorsqu’une autre partie expédie le colis et vous fournit un identifiant d’envoi pris en charge que vous êtes autorisé à utiliser. Sécurisez d’abord un flux fiable de données de colis auprès du 3PL ou de la marketplace. Testez ensuite les identifiants et les événements de suivi avec l’API et votre logique d’association des commandes. Si vous ne disposez que d’un ID de commande ou d’un statut de marketplace, comblez cette lacune dans les données sources avant d’investir dans une intégration de suivi des transporteurs.

FAQ

Puis-je suivre une commande en utilisant uniquement le numéro de commande de ma boutique ?

Généralement pas via une API de suivi de transporteur. Le numéro de commande de votre boutique identifie l’achat dans votre système. Vous avez généralement besoin de l’identifiant d’envoi correspondant, sauf si le service concerné prend explicitement en charge la recherche à partir de votre type de référence de commande.

Ai-je besoin de l’autorisation du 3PL pour utiliser ses numéros de suivi ?

Confirmez vos droits contractuels et techniques d’accès aux données d’expédition. Un 3PL peut déjà renvoyer les numéros de suivi dans le cadre de son flux d’exécution, mais l’intégration doit utiliser un canal autorisé et traiter correctement les données clients.

Pourquoi l’API n’affiche-t-elle aucun mouvement après l’envoi d’un numéro par le 3PL ?

Le numéro peut avoir été créé avant le premier scan enregistré par le transporteur. Vérifiez si l’identifiant et le transporteur sont corrects, si l’étiquette d’origine a été remplacée et si une requête ultérieure produit des événements. N’assimilez pas « aucun scan pour le moment » à « non expédié » sans vérifier l’enregistrement d’exécution.

Que se passe-t-il si une commande de marketplace est expédiée en plusieurs colis ?

Suivez séparément chaque identifiant de colis disponible et associez tous les colis à la même commande. Maintenez une distinction entre le statut de la commande présenté au client et le statut de chaque colis, afin qu’un colis livré ne fasse pas apparaître toute la commande comme terminée.

Sources

  • 17TRACK Tracking API — informations produit pour évaluer l’intégration du suivi des expéditions.
  • 17TRACK API Documentation — référence technique pour vérifier les données d’entrée acceptées et le comportement de l’intégration.