Klemen Trade

Contexte

Elektroplus maintient les données produits dans Minimax et a besoin d'un moyen rapide pour imprimer des étiquettes de rayon/produit avec des codes-barres EAN13. Les flux UI de l'ERP sont trop lents pour les tâches d'étiquetage quotidiennes, en particulier lors de l'impression de plusieurs articles par lots.

Problème

• Les employés doivent trouver des articles par code article ou code EAN et imprimer les étiquettes immédiatement.
• L'impression doit produire des planches d'étiquettes A4 stables avec un alignement de grille correct et des sauts de page.
• Les planches partiellement utilisées nécessitent un décalage (sauter N étiquettes avant l'impression).
• Les étiquettes doivent inclure des codes-barres EAN13 et une ventilation des prix (net/TVA/brut).

Objectifs du Projet

• Interface minimale pour ajouter plusieurs articles et quantités pour une impression par lot.
• Récupérer les données d'article directement depuis Minimax pour éviter les erreurs de saisie manuelle.
• Générer des codes-barres EAN13 dans le navigateur et imprimer dans une disposition en grille A4 cohérente.
• Prendre en charge le décalage/saut pour les planches d'étiquettes partiellement utilisées.

Aperçu de la Solution

Nous avons livré une petite application web qui :

• Recherche des articles Minimax par code ou EAN et pré-remplit les lignes d'étiquettes (nom, EAN, prix).
• Permet aux utilisateurs de créer une liste par lots avec des quantités et de supprimer des articles au besoin.
• Affiche les pages d'impression sous forme de grille A4 fixe 3×8 (24 étiquettes/page) avec décalage de départ optionnel.
• Génère des codes-barres EAN13 côté client via JsBarcode et déclenche l'impression.

Architecture et Approche Technique

Intégration Minimax

• Gestion des jetons OAuth2 avec support de rafraîchissement.
• Points de terminaison de recherche d'articles : `/items/code(...)`, `/items?SearchString=...`, `/items/{id}`.
• Point de terminaison JSON unique qui renvoie les payloads d'articles à l'interface utilisateur.

Moteur d'impression

• Rendu DOM d'impression uniquement (`@media print`) avec dimensionnement A4 `@page`.
• Disposition en grille stable avec sauts de page automatiques.
• Support du décalage : insère des étiquettes vides avant l'impression du lot.

Génération de codes-barres

• Génère un <svg> par étiquette et rend l'EAN13 en utilisant JsBarcode.
• S'assure que le rendu est terminé avant d'appeler `window.print()`.

Stack Technologique

• PHP (client Minimax + point de terminaison JSON)
• JavaScript + jQuery (interactions UI, traitement par lots, flux d'impression)
• JsBarcode (rendu EAN13)
• Style d'impression HTML/CSS (`@page`, disposition en grille, rendu d'impression uniquement)

Résultats et Impact

• Flux de travail quotidien rapide : recherche → ajout au lot → impression.
• Réduction des erreurs en récupérant les noms/EAN/prix directement depuis Minimax.
• Sortie A4 cohérente avec alignement prévisible et sauts de page.
• Moins de gaspillage de planches d'étiquettes grâce au contrôle du décalage.

Résumé

Un outil d'impression d'étiquettes connecté à Minimax qui permet au personnel de rechercher des articles par code/EAN et de générer des planches A4 prêtes à imprimer d'étiquettes de codes-barres EAN13 avec une ventilation des prix—optimisé pour des opérations de vente au détail rapides.