D'abord, la conclusion. Dans le dépannage des étiquettes perdues dans l'intégration de l'API d'étiquettes d'expédition, une étiquette perdue n'est pas une seule défaillance. Ce sont quatre défaillances différentes qui se ressemblent exactement : l'étiquette n'a jamais été créée, elle a été créée mais la réponse a été perdue, la réponse est arrivée mais rien ne s'est imprimé, ou elle s'est imprimée mais le numéro de suivi n'est jamais revenu. Quatre-vingt-dix pour cent des étiquettes perdues peuvent être localisées en dix minutes grâce à la chaîne en quatre étapes ci-dessous. Pour les dix pour cent restants, adressez-vous au transporteur ou à la plateforme avec vos journaux de requêtes en main, et non avec une phrase vague comme « l'étiquette a disparu ».

J'ai vu cette défaillance trois fois, et chaque fois elle portait un déguisement différent. La première fois, c'était un entrepôt de commerce électronique un jour de pic de ventes : plus de 40 commandes sans étiquettes, des préparateurs debout devant l'imprimante et les téléphones du service client qui sonnaient sans arrêt. La cause première était une nouvelle tentative après expiration du délai. L'appel au transporteur avait expiré, le système avait supposé que la création avait échoué et l'avait renvoyé, mais le premier appel avait déjà créé l'étiquette. Le deuxième appel a été rejeté, la commande est restée dans un état dont personne n'était responsable, et personne n'a pu l'imprimer. Le deuxième cas était un 3PL qui ne perdait des étiquettes que sur les commandes vers un seul pays. Deux jours de recherches ont montré qu'il manquait les codes SH aux produits, donc le transporteur a refusé l'envoi, et le système a avalé le message d'erreur pour n'afficher que « échec de création ». Le troisième cas était le plus exaspérant : toutes les étiquettes avaient été créées avec succès, mais une mise à jour du pilote d'imprimante avait cassé l'impression, et l'équipe a passé une demi-journée à blâmer l'API.

Pourquoi chaque étiquette perdue se ressemble

Une étiquette parcourt quatre étapes, de la commande au colis. Cette chaîne est tout le dépannage des étiquettes perdues dans l'intégration de l'API d'étiquettes d'expédition : quatre étapes, vérifiées dans l'ordre, et une étiquette perdue ne peut pas se cacher. La première étape est la création : votre système appelle l'API du transporteur ou de l'agrégateur avec l'adresse, le poids et le code de service, et reçoit un numéro de suivi et un fichier d'étiquette. La deuxième étape est le rappel : l'API renvoie un succès ou un échec, et votre système doit inscrire ce résultat dans le statut de la commande. La troisième étape est l'impression : le fichier d'étiquette parvient à l'imprimante et devient du papier. La quatrième étape est la réécriture : le numéro de suivi revient vers la commande et vers la plateforme de vente pour que le service client et le client puissent le suivre.

Si l'une de ces étapes casse, le préparateur voit toujours la même chose : cette commande n'a pas d'étiquette. La première démarche n'est donc jamais de « cliquer à nouveau sur créer ». C'est de poser trois questions : dans quel état est cette commande de notre côté, le transporteur a-t-il cet envoi, et le fichier est-il dans la file d'impression ? Répondez à ces trois questions et la zone de recherche se réduit de l'essentiel.

Voici la partie contre-intuitive. Le premier réflexe de la plupart des gens est de réessayer, et réessayer est le plus grand amplificateur des étiquettes perdues. Une expiration de délai ne signifie pas que l'étiquette n'a pas été créée. Le transporteur a peut-être déjà généré un numéro de suivi pendant que votre côté n'a jamais reçu la réponse. Renvoyez-la et vous risquez de créer un doublon. Un exemplaire part sur le colis, l'autre reste dans le système en attendant que quelqu'un le colle un jour sur le mauvais carton, et c'est un colis mal expédié. Ma règle de fer est la suivante : en cas d'expiration de délai, vérifiez avant de réessayer. Interrogez le transporteur par la référence de commande ou le numéro de suivi. S'il existe, la création a réussi et seule la réponse a été perdue : récupérez donc la réponse au lieu de créer à nouveau.

Étape par étape : suivez l'étiquette perdue à travers quatre étapes

Première étape, vérifiez la création. Retrouvez la requête et la réponse de cette commande dans les journaux de l'API. La requête est-elle partie ? Quel était le code de réponse ? Que disait réellement le message d'erreur du transporteur, mot pour mot ? Les rejets courants forment une courte liste : échec de vérification d'adresse, code de service non valide, compte non activé pour ce service, poids ou dimensions au-dessus de la limite, ou envoi transfrontalier auquel il manque un code SH ou un pays d'origine. Corrigez ce que dit le message. Je l'ai vu trois fois : quelqu'un a pris « échec de vérification d'adresse » pour « l'API est en panne », a redémarré le service pendant des heures, et n'a jamais changé un seul caractère de l'adresse.

Deuxième étape, vérifiez le rappel. L'API a renvoyé un succès, mais votre système l'a-t-il écrit dans la base de données ? Regardez à deux endroits : si le rappel ou le cycle d'interrogation est jamais arrivé, et si la machine à états de la commande s'est bloquée. Certains systèmes créent les étiquettes de manière asynchrone, de sorte que l'étiquette reste en file d'attente quelques minutes avant que le rappel ne revienne. Les préparateurs qui ne peuvent pas attendre cliquent sur réimprimer, et l'état part de travers. Ma méthode consiste à donner à chaque commande un seuil d'expiration explicite. Passé le seuil sans rappel, le système interroge le transporteur automatiquement au lieu de laisser une personne réessayer à la main. Intégrez cette recherche au système. Ne comptez pas sur la mémoire.

Troisième étape, vérifiez l'impression. Le fichier d'étiquette est-il parvenu à l'imprimante ? Un travail est-il bloqué dans la file ? Le pilote a-t-il été mis à jour récemment ? La taille du papier d'étiquettes correspond-elle au modèle d'étiquette ? L'impression est l'étape le plus souvent confondue avec un problème d'API, parce que le préparateur ne voit que l'absence de papier. Sur chaque liste de contrôle de la nuit de mise en service, j'insiste sur une ligne : testez l'impression avec une vraie commande, pas avec une page de test. Qu'une page de test s'imprime ne prouve rien sur une vraie étiquette. Avec le mauvais modèle ou la mauvaise taille de papier, il ne sort toujours rien.

Quatrième étape, vérifiez la réécriture. L'étiquette s'est imprimée, mais le numéro de suivi est-il revenu vers la commande et la plateforme ? Si cette étape casse, le service client ne peut pas voir l'envoi, le client pense que rien n'a été expédié, et la réclamation arrive. La réécriture échoue généralement à cause des limites de débit de la plateforme ou parce que quelqu'un a modifié le statut de la commande à la main. La solution est une nouvelle tentative automatique trois fois, avec des intervalles croissants, puis une file manuelle pour tout ce qui échoue encore. Ne la laissez jamais disparaître en silence.

La liste de contrôle de la nuit de mise en service : arrêtez la prochaine étiquette perdue

Voici une comparaison de coûts par scénario, avec les chiffres indiqués comme illustratifs. Un entrepôt qui expédie 2,000 commandes par jour en perd 1 pour cent un jour de pic, soit 20 commandes. Si seulement 5 d'entre elles sont des étiquettes en double collées sur les mauvais colis, les retours, les réexpéditions et les réclamations coûtent plus que plusieurs imprimantes neuves. Avec la chaîne de traçage en place, le même problème est localisé en dix minutes et récupéré en une demi-heure, et la perte s'arrête à la réimpression de 20 étiquettes. Je fais ce calcul avec chaque client avant la mise en service, et après cela, personne n'ose sauter la liste de contrôle.

La nuit de la mise en service, cochez chaque point en le signant : les nouvelles tentatives après expiration du délai interrogent le transporteur avant de renvoyer ; les messages d'erreur sont consignés mot pour mot, et non résumés par « échec de création » ; la vérification d'adresse, le code de service, les autorisations du compte, le poids et les dimensions, et les codes SH ont chacun été testés ; le rappel asynchrone a un seuil d'expiration et une recherche automatique ; l'impression a été testée avec une vraie commande ; les échecs de réécriture font l'objet de nouvelles tentatives puis atterrissent dans une file manuelle ; et les contacts d'assistance du transporteur et de la plateforme sont affichés sur le tableau de garde. Une liste de contrôle que personne ne signe revient à ne pas avoir de liste de contrôle.

Une dernière chose, et je n'ai aucune tolérance pour le langage vague ici. La prochaine fois que quelqu'un vous dira « l'étiquette est perdue », répondez par quatre questions : a-t-elle été créée, la réponse est-elle arrivée, du papier est-il sorti de l'imprimante, et le numéro de suivi est-il revenu ? Répondez à ces quatre questions et la faute est généralement sous vos yeux. L'intégration d'API n'a rien de mystérieux. Voilà le dépannage des étiquettes perdues dans l'intégration de l'API d'étiquettes d'expédition dans sa forme la plus simple : il n'y a qu'une chaîne, et une étiquette perdue ne peut pas se cacher quand on la vérifie étape par étape.

Par Lin Xiao, Consultant en implémentation WMS

Traduit de l'anglais. En cas de divergence, la version anglaise fait foi.