Medilip (Active Luxe)

Contexte

Active Luxe gère une opération e-commerce à grand volume où la vitesse d'exécution et la précision d'emballage affectent directement l'expérience client et les coûts opérationnels. Avant ce projet, les emballeurs s'appuyaient sur la recherche manuelle de commandes et la correspondance visuelle des articles, ce qui devient source d'erreurs à mesure que le catalogue produits grandit et que les commandes incluent des lots, variantes et SKU similaires. Le client avait besoin d'un système qui fonctionne sur le sol de l'entrepôt, sur un téléphone, avec la caméra comme entrée principale.

Problème

Les erreurs d'emballage et la gestion lente des commandes étaient causées par quelques problèmes structurels :

• L'étape d'identification de commande était manuelle (trouver la bonne commande à partir d'une étiquette de transporteur / référence d'expédition).
• La vérification des articles reposait sur l'attention humaine plutôt que sur une validation déterministe.
• Les lots/produits composites introduisent une complexité cachée : un article de ligne peut se développer en plusieurs SKU physiques.
• Une interface adaptée à l'entrepôt doit être rapide, minimale et pilotée par caméra.

Le client souhaitait un flux de travail où le système confirme d'abord la commande, puis confirme chaque article scanné par rapport à ce que le client a réellement acheté.

Objectifs du Projet

• Rendre l'identification de commande instantanée : scanner une étiquette de coursier et récupérer la commande exacte.
• Afficher une liste de préparation/emballage claire optimisée pour les écrans de téléphone.
• Vérifier l'emballage : scanner les codes-barres EAN et avertir immédiatement si l'article scanné n'appartient pas à la commande.
• Prendre en charge les quantités (par ex., 2× du même EAN) et afficher la progression par article.
• Gérer correctement les produits composites/en lot en les développant en leurs composants physiques.
• Minimiser les frictions en entrepôt (utilisation à une main, étapes minimales, retour visuel fort).

Contraintes et Défis

• Compatibilité mobile : le scan de codes-barres doit fonctionner de manière fiable sur les navigateurs iOS et Android.
• Sources d'identification multiples : les étiquettes de coursier peuvent être stockées sous différentes clés méta de commande selon le transporteur/outillage.
• Mappage de données ERP : les articles de ligne WooCommerce sont centrés sur la commande, tandis que la vérification d'exécution nécessite des EAN fiables du référentiel produits.
• Vitesse opérationnelle : le scan doit être régulé et robuste face aux détections répétées et aux changements de mise au point de la caméra.
• Faible charge de formation : l'interface doit être évidente pour le nouveau personnel d'entrepôt.

Aperçu de la Solution

Nous avons construit une application web mobile-first qui s'exécute dans un navigateur mobile standard et utilise la caméra comme entrée principale.

• Scanner l'étiquette de coursier → le système trouve la commande WooCommerce correspondante via les métadonnées.
• Le système construit une liste d'emballage en enrichissant les articles de ligne WooCommerce avec les données produits ERP (EAN, code article, nom), y compris les expansions composites.
• Scanner les EAN de produits → chaque scan incrémente le compteur d'article correspondant.
• Si un EAN n'existe pas dans la commande, l'application avertit immédiatement.
• Lorsque toutes les quantités requises sont scannées, l'application active une seule action de soumission.

Le résultat est un flux de travail d'emballage déterministe où la correction est appliquée par scan, pas par mémoire.

Architecture et Approche Technique

L'outil est implémenté comme une application PHP légère avec une interface minimale et une API POST basée sur JSON.

Recherche de commande par étiquette scannée

• Le scan d'étiquette déclenche une recherche de commande WooCommerce via les métadonnées.
• Prend en charge plusieurs clés méta de transporteur telles que `wgl_labels`, `ParcelNumber` et `_gls_tracking_codes`.

Enrichissement de produit et source de vérité EAN

• WooCommerce fournit les SKU et quantités, mais les EAN proviennent du référentiel produits ERP.
• L'API MiniMax est utilisée pour résoudre code article → EAN → nom d'affichage.

Expansion composite / lot

• Les articles composites sont développés en composants physiques.
• Les quantités sont multipliées en fonction du montant commandé.

Scan par caméra mobile

• Le polyfill BarcodeDetector assure le support iOS.
• zbar-wasm ajoute une couverture de format de codes-barres plus large.
• Le scan est régulé et les scans en double sont supprimés.
• Le retour UI par ligne utilise des états rouge/jaune/vert pour la progression.

Étape de finalisation opérationnelle

• Une fois tous les articles requis scannés, une seule action de soumission devient disponible.
• Le backend peut mettre à jour la commande WooCommerce vers un statut d'exécution personnalisé.

Stack Technologique

• PHP (application monopage avec points de terminaison POST JSON)
• API REST WooCommerce (Client WooCommerce Automattic)
• API MiniMax (gestion des jetons OAuth + requêtes d'articles/factures)
• JavaScript (boucle de scan par caméra + état UI)
• Stack de codes-barres : polyfill BarcodeDetector + zbar-wasm
• UI : Material Design Lite + UI de tableau léger

Processus d'Implémentation

1. Cartographie du flux de travail réel de l'entrepôt et réduction à un flux axé sur la caméra.
2. Implémentation d'une recherche de commande fiable à partir d'étiquettes de coursier à travers les variations méta de transporteur.
3. Implémentation de l'enrichissement de produit depuis l'ERP pour obtenir les EAN et normaliser l'identité d'article.
4. Ajout de l'expansion composite pour correspondre aux exigences d'emballage physique.
5. Implémentation du scan mobile avec régulation, suppression des doublons et UI de progression claire.
6. Implémentation de l'étape de finalisation qui fait progresser le statut de commande après vérification de scan réussie.

Résultats et Impact

• Exécution plus rapide : moins de temps passé à rechercher des commandes et vérifier les articles manuellement.
• Beaucoup moins d'erreurs d'emballage : les articles mal assortis sont détectés au moment du scan.
• Friction opérationnelle réduite : fonctionne sur un téléphone, utilise la caméra et nécessite une formation minimale.
• Opérations plus prévisibles : les produits composites sont gérés de manière cohérente et transparente.

Réflexion

Le facteur clé de succès était de traiter le flux d'entrepôt comme un problème de validation déterministe : l'identification de commande doit être sans ambiguïté, la correction d'article doit être appliquée, et les produits composites doivent être développés tôt pour que la liste d'emballage corresponde à la réalité. Cela empêche une grande classe d'erreurs sans ajouter de surcharge opérationnelle.

Résumé

Ce projet a livré un scanner d'exécution mobile de qualité production pour Medilip/Active Luxe. En intégrant les données de commande WooCommerce avec les données produits maîtres ERP et en appliquant l'emballage via le scan EAN par caméra, le système accélère l'expédition et réduit drastiquement les erreurs d'emballage.