slug: wcs-wms-count-discrepancy-troubleshooting-guide lang: fr title: Quand les comptages du WCS ne correspondent pas au WMS : guide de dépannage des écarts excerpt: Quand les comptages du WCS ne correspondent pas au WMS, 90% des cas se résument à cinq causes profondes. La liste de vérification en 10 étapes de Lin Xiao permet de retrouver la plupart des écarts avant l'étape 4. section: software subcategory: wcs region: common tags: ['wcs','wms','rapprochement','écart','comptage-sur-convoyeur'] author: 林晓

Quand les comptages du WCS ne correspondent pas au WMS : guide de dépannage des écarts

Voici le verdict d'emblée : quand les comptages du WCS et le stock du WMS ne correspondent pas, neuf fois sur dix la cause entre dans exactement cinq catégories — erreurs de lecture des cellules photoélectriques et des scanners, perte de paquets réseau et dérive d'horloge, flux inverses qui ne bouclent jamais, interventions manuelles jamais scannées, et définitions de comptage jamais alignées au départ. J'ai vu exactement cette panne trois fois, et à chaque fois le premier réflexe du client a été "on recompte tout le bâtiment ce soir". À chaque fois, c'était une erreur. Voici pourquoi, suivi d'une liste de vérification en 10 étapes. Suivez les étapes dans l'ordre, et quatre-vingt-dix pour cent des écarts se révèlent avant l'étape quatre.

Un vrai désastre : 3,000 unités d'écart la veille du go-live

En octobre 2024, un entrepôt e-commerce de 50,000 pieds carrés traitant 20,000 unités par jour sur une nouvelle ligne de tri pilotée par le WCS était en activité depuis trois semaines lorsque le stock du WMS et les comptages machine du WCS ont commencé à dériver — de plus de 3,000 unités en cumulé. Le directeur des opérations a exigé un comptage physique complet le soir même. Je l'en ai empêché : un comptage vous dit à quel point vous êtes à côté, pas d'où vient l'écart. Trois heures d'investigation ont révélé deux causes profondes. D'abord, une cellule photoélectrique à barrière sur le trieur avait été aveuglée par la poussière de carton, sous-comptant environ 1,200 unités. Ensuite, le processus de retours fonctionnait hors ligne — plus de 1,800 unités retournées n'ont jamais passé un point de scan. Au total : environ 3,000 unités. La leçon tient en une phrase : trouvez d'où vient l'écart avant d'essayer de solder les chiffres.

Les cinq vraies causes des écarts de comptage WCS–WMS

Cause 1 : erreurs de lecture des cellules photoélectriques et des scanners. La plus fréquente. Capteurs encrassés, faisceaux désalignés, colis trop serrés provoquant des doubles déclenchements. Les scanners fixes ont un taux de non-lecture — c'est une probabilité, pas un dysfonctionnement. Faites le calcul : à 20,000 unités par jour avec un taux de non-lecture de 0.5%, vous dérivez de 100 unités par jour, 3,000 par mois. C'est exactement comme cela que l'entrepôt ci-dessus a construit son écart de 3,000 unités.

Cause 2 : perte réseau et dérive d'horloge. Quand le contrôleur du WCS et le serveur du WMS ne partagent pas la même horloge, l'ordre des événements se brise. Le WCS signale "trié", le WMS déduplique par horodatage, décide qu'il a déjà vu cet événement et le jette. J'ai vu cela trois fois, et les trois fois l'équipe IT jurait que "le réseau est bon" — jusqu'à ce qu'on découvre l'horloge du contrôleur en retard de plus de 40 secondes.

Cause 3 : flux inverses sans boucle fermée. Retours, détournements d'exception, ré-emballage — tout ce qui sort du chemin principal. Le WCS ne compte jamais ces unités, mais le stock du WMS bouge. Neuf entrepôts sur dix traitent les flux inverses manuellement, hors ligne. C'est là que les écarts se multiplient.

Cause 4 : interventions manuelles sans nouveau scan. Un bourrage, un opérateur transporte des cartons à la main jusqu'au toboggan d'exception, sans scan. Un prélèvement qualité de quelques unités, oublié. Une ou deux fois, rien ; des dizaines de fois par jour en haute saison, et les chiffres ne se réconcilient plus.

Cause 5 : définitions de comptage jamais alignées. La plus injuste : les deux parties ont raison, mais elles ne comptent pas la même chose. Le WCS compte "les unités passées devant la machine", le WMS compte "les unités en stock" — en transit, toboggans d'exception, zones de blocage qualité : à qui appartiennent-ils ? Avec des définitions désalignées, les comptages ne peuvent jamais correspondre.

Un jugement contre-intuitif : ne faites jamais confiance au compteur cumulé du WCS lui-même ; faites confiance au flux d'événements horodatés. Un compteur cumulé qui perd un événement est faux pour toujours. Un flux d'événements avec un trou peut être reconstruit à partir des journaux. Dépannez toujours à partir des événements, jamais en fixant le total.

La liste de vérification en 10 étapes : dépannez dans cet ordre

1. Sortez le rapport d'écarts et découpez-le. Par SKU, par toboggan/destination et par fenêtre horaire. Un écart concentré sur quelques toboggans pointe vers l'équipement ; un écart uniformément réparti pointe vers les interfaces et les définitions.
2. Lisez le journal d'événements du WCS. Concentrez-vous sur les enregistrements de non-lecture et les anomalies photoélectriques, et alignez-les avec le moment où l'écart a commencé.
3. Testez les cellules photoélectriques. Testez chacune par occultation : nettoyez les encrassées, réalignez celles qui ont dérivé. Si l'espacement minimal des colis passe sous 300 millimètres, les doubles déclenchements sont quasi certains — corrigez l'espacement ou acceptez l'erreur et construisez une logique de compensation.
4. Vérifiez le réseau et les horloges. Contrôlez la synchronisation du contrôleur avec le serveur du WMS ; toute dérive au-delà de 5 secondes se corrige avant toute chose. Vérifiez la file d'interface : arriérés, tentatives et pertes.
5. Auditez les flux inverses. Parcourez la dernière semaine de retours, détournements d'exception et tickets de ré-emballage, et vérifiez que chacun a atteint le WMS.
6. Examinez les registres d'interventions manuelles. Registres manuels du toboggan d'exception, relevés de débouchages, prélèvements qualité — réconciliez-les un par un.
7. Alignez les définitions de comptage. Écrivez les définitions des deux parties et comparez-les ligne par ligne : en transit, toboggans d'exception, blocage qualité, staging — qui possède quoi. La moitié de tous les "écarts" s'évaporent à cette étape.
8. Vérifiez les données de base. Codes-barres SKU en double, un produit avec plusieurs codes — le scanner a lu le code-barres correctement, mais le code-barres était lié au mauvais SKU.
9. Reconstruisez une heure de bout en bout. Prenez la pire heure, sortez les images de caméra et les journaux, et réconciliez unité par unité. C'est du travail de fourmi, mais c'est la seule chose qui clôt l'affaire.
10. Corrigez, retestez, puis comptez. Après avoir corrigé la cause profonde, faites tourner 4 heures et observez la convergence de l'écart. S'il converge, faites un comptage physique pour recaler la référence ; sinon, la cause profonde était fausse — revenez en arrière et revérifiez.

Quatre erreurs classiques

• Commencer par un recomptage. Un recomptage convertit un "écart d'événements" en un "écart de stock" pendant que la cause profonde continue de fuir. Le lendemain, l'écart est de retour.
• Vérifier l'équipement mais pas les interfaces. D'après mon expérience, plus de la moitié des décalages sont des problèmes logiciels et d'interface, pas des problèmes de capteurs.
• Se réunir avant d'aligner les définitions. Les deux parties parlent dans le vide tout un après-midi. Écrivez d'abord les définitions, discutez ensuite.
• Crier victoire sans retester. Capteurs nettoyés, problème "résolu", écart de retour sous trois jours. Faites tourner 4 heures, prouvez la convergence avec des données.

La liste de vérification de la nuit du go-live : empêcher le retour des écarts

C'est la liste que je déroule la veille de chaque go-live. Je la publie ici :

1. Test par occultation de chaque cellule photoélectrique, avec enregistrements
2. Taux de non-lecture du scanner sous la ligne d'acceptation du projet pendant 2 heures consécutives
3. Horloges du contrôleur et du serveur du WMS synchronisées, dérive sous 5 secondes
4. File d'événements WCS→WMS purgée, zéro arriéré
5. Flux inverses (retours/détournements d'exception) parcourus de bout en bout, événements arrivant dans le WMS
6. Procédure de rescan manuel imprimée et affichée au poste d'exception
7. Test à blanc du rapport d'écarts : les trois dimensions de découpe retournent des données
8. Instantané du stock complet — votre dernier point de retour

Un dernier conseil : quand le WCS et le WMS sont en désaccord, demandez toujours "d'où vient l'écart" avant "quelle est l'ampleur de l'écart". Inversez l'ordre et personne ne pourra vous sauver.

Par Lin Xiao, consultant en implémentation WMS

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