L'essentiel d'abord : dans un cas de dépannage de commande perdue par l'API d'étiquettes d'expédition, le transporteur n'a presque jamais perdu votre commande. Ce qui s'est généralement passé, c'est qu'un maillon de la chaîne n'a pas su la transmettre. La commande a été passée, la commande de sortie a été créée, puis aucune étiquette n'est sortie. Le colis reste sur le banc d'emballage et le téléphone du service client commence à sonner. J'ai vu cette panne exacte trois fois, et la cause racine était différente à chaque fois, mais la façon de la trouver est toujours la même chaîne : OMS vers WMS vers API du transporteur vers imprimante, un segment à la fois. Localisez d'abord, puis corrigez.
Le pire avec une étiquette perdue, ce n'est pas la perte. C'est de ne pas savoir où chercher. L'emballeur dit que le système n'a jamais imprimé d'étiquette. Le service client dit que la commande est confirmée. L'informatique dit que l'API n'a renvoyé aucune erreur. Tous les trois ont raison, parce que la commande est coincée dans l'écart entre eux. La chaîne ci-dessous montre comment trouver cet écart.
Localisez d'abord : quel segment de l'API d'étiquettes d'expédition a perdu la commande
Ne commencez pas par redémarrer les services ni par soumettre de nouveau les commandes. Prenez cinq minutes pour localiser la panne. La commande est coincée dans l'un des quatre segments, et chaque étape suivante dépend de celui dont il s'agit.
Vérifiez le statut de la commande dans l'OMS : est-elle confirmée et en attente d'expédition, ou a-t-elle déjà été envoyée au WMS ? Si l'OMS ne l'a jamais envoyée, le problème vient des règles d'envoi de l'OMS, pas de l'API d'étiquettes. Vérifiez ensuite si le WMS a une tâche de sortie pour elle, et si cette tâche est en attente de picking, prélevée ou emballée. Pas de tâche signifie que la commande est morte entre l'OMS et le WMS. Tâche existante, demande d'étiquette envoyée, pas de réponse du transporteur : le problème est dans le segment de l'API. Réponse reçue, fichier d'étiquette arrivé, imprimante silencieuse : le problème est dans le segment d'impression.
Localiser, c'est poser quatre questions et noter les réponses avant de toucher à quoi que ce soit : l'OMS l'a-t-elle envoyée ? Le WMS l'a-t-il reçue ? Le transporteur a-t-il répondu ? L'imprimante l'a-t-elle imprimée ? Le segment où la réponse devient non est celui où vit votre problème.
Dépannage de commande perdue par l'API d'étiquettes d'expédition : le parcours en quatre segments de la commande au quai
Segment un, de l'OMS au WMS. La panne la plus courante ici est une règle d'envoi qui oublie un type de commande. Pendant une haute saison, une équipe ajoute un nouveau type de commande cadeau, la règle d'envoi ne le couvre jamais, et la commande reste dans l'OMS pendant que le WMS n'en entend jamais parler. Comment vérifier : cherchez dans le journal d'envoi de l'OMS avec le numéro de la commande perdue. Y a-t-il un enregistrement d'envoi, et qu'a-t-il renvoyé ? Pas d'enregistrement signifie un problème de règle. Un enregistrement avec un échec signifie un problème de réseau ou de champ. Le filet de sécurité : ajoutez des nouvelles tentatives et des alertes aux envois de l'OMS. Si un envoi échoue trois fois, appelez la personne d'astreinte. Ne laissez jamais une commande traîner là en silence.
Segment deux, à l'intérieur du WMS. La tâche existe, le picking est fait, et elle se bloque à l'étape d'impression de l'étiquette. J'ai vu ce piège trois fois, et la cause racine était la même à chaque fois : avant que le WMS envoie la demande d'étiquette, il valide l'adresse, le poids et le produit de service du transporteur. Si l'une des trois validations échoue, la demande ne part jamais, et il n'y a pas d'erreur, juste une petite ligne dans les notes de la tâche. Comment vérifier : ouvrez le détail de la tâche et regardez le panneau de validation. Le filet de sécurité : une validation échouée doit déclencher une invite visible et écrire une entrée de journal. L'échec silencieux est le plus grand complice d'une étiquette perdue.
Segment trois, l'API du transporteur. La demande est partie et la réponse n'est jamais revenue. Deux variantes ici. L'une est un dépassement de délai de l'API du transporteur. L'autre est une réponse revenue mais que le WMS n'a pas reconnue. Pour un dépassement de délai, vérifiez d'abord à combien de secondes le délai est fixé, puis s'il s'agit d'une file d'attente aux heures de pointe. Pour une réponse non reconnue, le code de statut du transporteur ne correspond généralement pas au code de statut mappé dans votre système. Comment vérifier : prenez l'ID de trace de la demande dans le journal de l'API et voyez exactement ce que le transporteur a renvoyé. Le filet de sécurité : réessayez automatiquement une fois en cas de dépassement de délai, mais vérifiez si un numéro d'étiquette a déjà été généré avant de réessayer. Ne créez jamais deux numéros d'étiquette pour une seule commande.
Segment quatre, imprimante et fichier d'étiquette. Le fichier d'étiquette est arrivé et l'imprimante n'a rien fait, ou elle a imprimé et le système montre toujours la commande comme non expédiée. Vérifiez d'abord la file d'impression, puis si le format du fichier d'étiquette est correct, puis l'écriture de retour : l'impression réussie a-t-elle été écrite en retour dans le WMS ? Une écriture de retour ratée est la plus vicieuse des quatre. Le colis est déjà parti, le système dit toujours en attente d'expédition, et l'inventaire comme le statut de la commande sont faux tous les deux. Comment vérifier : comparez le journal de l'imprimante avec les enregistrements d'expédition du système. Si les comptes ne correspondent pas, une écriture de retour a été perdue. Le filet de sécurité : ne libérez pas le colis tant que le succès de l'impression n'est pas confirmé par l'écriture de retour. Dix secondes de plus au banc d'emballage valent mieux qu'un système en désaccord avec la réalité.
| Segment | Symptôme typique | Vérifiez d'abord | Filet de sécurité |
|---|---|---|---|
| OMS vers WMS | Pas de tâche dans le WMS | Journal d'envoi, règles de type de commande | Réessayez trois fois, puis alertez |
| Dans le WMS | Tâche bloquée à l'impression de l'étiquette | Panneau de validation d'adresse et de poids | La validation échouée doit alerter et journaliser |
| API du transporteur | Demande envoyée, pas de réponse | Journal de l'API, correspondance des codes de statut | Vérifiez s'il existe un numéro d'étiquette avant de réessayer |
| Imprimante | Imprimé mais toujours non expédié | File d'impression, enregistrements d'écriture de retour | Confirmez l'écriture de retour avant de libérer |
Voici la partie contre-intuitive : avec une étiquette perdue, ce qu'il faut craindre le plus, ce n'est pas la perte. C'est le doublon. Dès que les gens voient une étiquette manquante, ils appuient sur réessayer, soumettent de nouveau la commande, et l'étiquette finit par sortir, deux fois. Deux numéros d'étiquette, une commande. Un colis part, l'autre numéro d'étiquette flotte dans le système. Au mieux, votre inventaire est faux. Au pire, le client a la marchandise en main pendant que le système dit toujours non expédié, et le service client s'effondre une deuxième fois. Vérifiez si un numéro d'étiquette existe déjà avant de réessayer. C'est la règle de fer. Dix minutes lentes à localiser valent mieux que trois secondes rapides à soumettre de nouveau.
Un de mes clients est passé à une nouvelle API de transporteur la veille d'une haute saison, et a perdu plus de deux cents étiquettes le premier jour. La cause racine était embarrassante de simplicité : l'heure limite de la nouvelle API était une heure plus tôt que celle de l'ancienne. Les commandes passées après l'heure limite étaient rejetées d'emblée, et le système n'a jamais déclenché d'alerte. Au final, l'équipe a imprimé les étiquettes à la main, une par une, jusqu'à trois heures du matin. Après cette nuit-là, je me suis fait une règle : ne jamais basculer une interface la veille d'une haute saison.
Liste de contrôle de la nuit de mise en production : parcourez-la avant de dormir
La nuit de mise en production n'est pas le moment des grandes déclarations. Parcourez cette liste et cochez chaque case.
Un, les règles d'envoi : tous les types de commande sont-ils couverts ? Faites passer une vraie commande de bout en bout, pas seulement une commande de test. Deux, les règles de validation : adresse, poids et produit de service. Quand la validation échoue, quelqu'un peut-il voir l'invite ? Trois, délai et nouvelle tentative : à combien de secondes le délai est-il fixé ? Combien de nouvelles tentatives ? La nouvelle tentative vérifie-t-elle d'abord s'il existe déjà un numéro d'étiquette ? Quatre, correspondance des codes de statut : chaque code de statut renvoyé par le transporteur, votre système le reconnaît-il ? Cinq, écriture de retour d'impression : imprimante hors ligne, plus de papier, bourrage papier, que fait le système dans chaque cas ? Six, alertes : combien d'étiquettes perdues, ou combien de minutes bloquées, avant que quelqu'un reçoive un appel ? Sept, le plan de secours : si l'API tombe complètement, qui imprime les étiquettes à la main, et d'où viennent les numéros d'étiquette ?
Cochez les sept avant de dormir. Laissez-en une sans cocher, et l'appel téléphonique de minuit est pour vous.
Le dépannage de commande perdue par l'API d'étiquettes d'expédition n'est pas difficile la première fois que vous le faites. Le plus dur, c'est de le faire de la même façon à chaque fois, en suivant la chaîne au lieu de deviner au feeling. Épinglez le parcours à côté du banc d'emballage. La prochaine fois qu'une étiquette ne sort pas, descendez les quatre segments, et vous l'aurez localisée en dix minutes. Une fois l'emplacement correct, la correction est rapide.
Par Lin Xiao, Consultant en implémentation WMS Traduit de l'anglais. En cas de divergence, la version anglaise fait foi.







