📖 DOCUMENTATION

Pharma Toolkit
Module Périmés / Inventaire
Version 1.3.4 - Décembre 2025

1. Introduction - À quoi sert l'application ?

Pharma Toolkit vous permet de gérer vos produits périmés et de faire votre inventaire en même temps, avec un seul scan.

🎯 Le principe est simple : Vous scannez un produit → l'application enregistre la date d'expiration → vous recevez une alerte quand le produit va bientôt périmer → vous pouvez le mettre en promotion ou le retourner au laboratoire.

Les 7 onglets de l'application

L'application comporte 7 onglets accessibles en bas de l'écran :

📷 Scan

Pour enregistrer un nouveau produit en le scannant avec votre téléphone

🏥 Produits

Pour voir la liste de tous les produits que vous avez enregistrés

⏰ Périmés

Pour voir les produits qui vont bientôt périmer et les traiter

🔄 Suivi

Pour suivre ce que vous avez fait avec les produits périmés

🧮 Inventaire

Pour comparer votre stock physique avec votre logiciel de gestion

📊 Stats

Pour voir des graphiques et statistiques sur vos périmés

Et un 7ème onglet ⚙️ Paramètres pour configurer l'application.

2. Onglet SCAN - Enregistrer un produit

C'est l'onglet principal. C'est ici que vous enregistrez les produits en les scannant.

Comment enregistrer un produit ?

  1. Choisissez la zone

    En haut de l'écran, sélectionnez la zone où se trouve le produit (OTC, Frigo, Réserve...). Si la zone n'existe pas, appuyez sur le bouton + orange pour en créer une nouvelle.

  2. Scannez le produit

    Appuyez sur le bouton bleu 📊 Scanner pour ouvrir l'appareil photo. Pointez l'appareil photo vers le code DataMatrix (le petit carré) ou le code-barres du produit. Le produit sera reconnu en 2 secondes environ.

    💡 Conseil : Le code DataMatrix (petit carré) est plus pratique car il contient aussi la date d'expiration. Vous n'aurez pas à la saisir manuellement.
  3. Vérifiez la sélection

    Le nom du produit apparaît dans la zone "Sélection". Vérifiez que c'est le bon produit.

  4. Indiquez la quantité

    Utilisez les boutons et + pour indiquer combien d'unités vous avez. Vous pouvez aussi taper directement le nombre.

  5. Vérifiez la date d'expiration

    Si vous avez scanné un DataMatrix, la date est déjà remplie. Sinon, sélectionnez le mois et l'année d'expiration.

  6. Appuyez sur ENREGISTRER

    Le bouton bleu en bas enregistre le produit. Vous pouvez passer au produit suivant.

📦 Comprendre l'affichage du stock

Quand vous scannez un produit, l'application affiche le stock actuel pour cette date de péremption.

🔑 Comment ça marche ?

Chaque produit est identifié par 3 éléments :
• Le code du produit (code-barres)
• La zone où il se trouve
• La date de péremption

Le stock affiché correspond uniquement à cette combinaison précise.

Exemple concret : Vous avez du Doliprane 500mg dans votre réserve :

  • 5 boîtes qui périment en juin 2025
  • 3 boîtes qui périment en août 2025

Si vous scannez une boîte qui périme en juin 2025, l'application affichera "Stock : 5 unités", pas 8.

🔘 Les deux boutons d'enregistrement

Quand un produit a déjà du stock, vous avez deux choix :

Ajouter +X

Ce que ça fait : Ajoute X unités au stock existant

Quand l'utiliser : Quand vous recevez de nouvelles boîtes à ranger

Exemple : Stock = 5, vous scannez 2 → nouveau stock = 7

Stock → X

Ce que ça fait : Remplace le stock par X unités

Quand l'utiliser : Quand vous recomptez et voulez corriger le stock

Exemple : Stock = 5, vous comptez 3 → nouveau stock = 3

3. Onglet PRODUITS - Voir tous vos produits

Cet onglet affiche tous les produits que vous avez enregistrés.

Comment trouver un produit ?

  • Par zone : Utilisez le menu "Toutes les zones" pour filtrer par zone
  • Par statut : Utilisez le menu "Tous les statuts" pour voir seulement les expirés, ceux à 7 jours, 30 jours, etc.
  • Par nom : Tapez le nom du produit dans le champ de recherche

Les couleurs des produits

  • Vert "OK" : Le produit est loin de périmer (plus de 90 jours)
  • Jaune : Le produit va périmer dans 30 à 90 jours
  • Orange "15j" : Le produit va périmer dans moins de 30 jours
  • Rouge "Expiré" : Le produit est périmé, il faut le retirer !

Modifier ou supprimer un produit

  • Appuyez sur le bouton ✏️ (crayon bleu) pour modifier la quantité ou la date
  • Appuyez sur le bouton 🗑️ (poubelle rouge) pour supprimer le produit
⚠️ Attention : La suppression est définitive. Le produit sera complètement effacé.

4. Onglet PÉRIMÉS - Gérer les alertes

Cet onglet vous montre les produits qui vont bientôt périmer et que vous devez traiter.

Médicaments ou Parapharmacie ?

En haut de l'écran, vous avez deux boutons :

  • 💊 Médicaments : Affiche uniquement les médicaments
  • 🧴 Parapharmacie : Affiche uniquement les produits de parapharmacie
💡 Pourquoi cette séparation ? Parce que vous pouvez configurer des seuils d'alerte différents. Par exemple : alerte à 90 jours pour les médicaments, 60 jours pour la parapharmacie.

Que faire avec un produit périmé ?

Quand vous cliquez sur un produit, vous pouvez choisir une action :

  • 🏷️ Mettre en promotion : Vous allez le vendre à prix réduit
  • 📦 Retour laboratoire : Vous allez le retourner au laboratoire
  • 🗑️ Mettre à la poubelle : Vous allez le jeter (perte sèche)

Imprimer ou envoyer par email

  • 🖨️ Imprimer la liste : Pour avoir une version papier
  • ✉️ Envoyer par email : Pour recevoir la liste par email

5. Onglet SUIVI - Suivre le traitement des périmés

Cet onglet vous montre ce que vous avez fait avec les produits périmés.

Les différents états d'un produit

  • En promotion : Le produit est en rayon avec un prix réduit
  • Retour labo : Le produit attend d'être retourné au laboratoire
  • Détruit : Le produit a été jeté
  • Vendu : Le produit en promotion a été vendu

Pourquoi c'est utile ?

💡 Traçabilité : Vous pouvez voir l'historique de tous vos périmés : combien ont été vendus en promo, combien retournés aux labos, combien jetés. C'est utile pour le gérant et pour améliorer vos pratiques.

6. Onglet INVENTAIRE - Comparer avec votre LGO

💻 À faire sur ordinateur : Cet onglet est plus facile à utiliser sur un ordinateur car il faut importer et exporter des fichiers.

Cet onglet permet de comparer ce que vous avez scanné avec ce que dit votre logiciel de gestion (WinPharma, LGPI...).

Comment ça marche ?

  1. Choisissez votre logiciel

    Sélectionnez WinPharma ou LGPI (SmartRX bientôt disponible)

  2. Importez votre fichier stock

    Exportez le fichier de stock depuis votre logiciel, puis importez-le ici. Un bouton d'aide ℹ️ vous explique comment faire.

  3. Choisissez les zones à comparer

    Sélectionnez une ou plusieurs zones que vous avez scannées. Utilisez les boutons "✓ Tout" et "✕ Aucune" pour sélectionner/désélectionner rapidement.

  4. Lancez la comparaison

    L'application va comparer les deux et vous montrer les différences

🆕 Sélection Multi-zones

💡 Nouveau : Vous pouvez maintenant comparer plusieurs zones en même temps. Les quantités des produits identiques présents dans plusieurs zones sont automatiquement additionnées pour la comparaison.

Que faire des résultats ?

  • Différences : Les produits où la quantité scannée ne correspond pas au stock LGO
  • Identiques : Les produits où tout correspond
💡 Longue liste ? Si vous avez beaucoup de résultats, utilisez le bouton "📋 Voir tout" pour afficher tous les produits, ou gardez l'affichage réduit aux 10 premiers.

🆕 Prévisualisation avant Export/MAJ

Avant d'exporter un fichier ou de mettre à jour le stock LGO, une modal de prévisualisation s'affiche. Elle vous permet de :

  • Cliquer sur un produit pour l'exclure de la mise à jour (il sera barré)
  • Éditer la quantité directement dans le champ bleu (cette modification n'affecte PAS le stock de l'application, seulement l'export)
  • Utiliser "✅ Tout inclure" ou "❌ Tout exclure" pour sélectionner/désélectionner tous les produits rapidement
⚠️ Important : Les modifications de quantité dans cette modal sont temporaires. Elles ne modifient que le fichier exporté ou la MAJ LGO, pas les données enregistrées dans l'application.

🆕 Produits Multi-zones

Si un produit est présent dans plusieurs zones, il est affiché avec la mention "(multi-zones)" en bleu.

Dans la modal de prévisualisation, vous verrez les détails par zone :

  • Chaque zone est listée avec sa quantité
  • Cliquez sur une zone pour l'inclure ou l'exclure du total
  • La quantité totale se recalcule automatiquement
💡 Exemple : Un produit a 5 unités en "OTC" et 3 en "Réserve". Par défaut, la quantité affichée est 8. Si vous excluez la zone "Réserve", la quantité devient 5.

Vous pouvez ensuite exporter les corrections pour mettre à jour votre LGO, ou utiliser le bouton "MAJ Stock LGO" pour appliquer directement les modifications dans Winpharma.

7. Onglet STATS - Voir les statistiques

💻 À voir sur ordinateur : Les graphiques sont plus lisibles sur un grand écran.

Cet onglet affiche des graphiques et statistiques sur vos périmés.

Ce que vous pouvez voir

  • Évolution dans le temps : Combien de périmés par mois ?
  • Répartition par zone : Quelles zones ont le plus de périmés ?
  • Valeur des pertes : Combien vous coûtent les périmés ?
  • Tendances : Est-ce que la situation s'améliore ?
💡 Pour le gérant : Ces statistiques sont très utiles pour le titulaire ou le gérant. Elles permettent de voir si les efforts de gestion des périmés portent leurs fruits.

8. Onglet PARAMÈTRES - Configurer l'application

C'est ici que vous configurez le fonctionnement de l'application.

📧 Configuration des alertes email

Vous pouvez recevoir un email automatique chaque mois avec la liste des produits à traiter.

  • Email pour les rapports : Entrez votre adresse email
  • Seuil médicaments : À combien de jours avant expiration voulez-vous être alerté ? (par défaut : 90 jours)
  • Seuil parapharmacie : Pareil, mais pour la parapharmacie (peut être différent)

🌸 Produits saisonniers

Certains produits sont commandés longtemps à l'avance (crèmes solaires, produits de Noël...). Vous pouvez les marquer comme "saisonniers" pour avoir un seuil d'alerte plus long (par exemple 180 jours au lieu de 90).

🏷️ Gestion des zones

Créez, modifiez ou supprimez vos zones de stockage.

🔬 Reprises laboratoires

Configurez le pourcentage de reprise par laboratoire. Par défaut c'est 50%, mais certains labos reprennent plus ou moins.

💡 Exemple : Si un labo reprend à 70%, vous ne perdez que 30% du prix d'achat. L'application calcule automatiquement vos pertes réelles.

📚 Aide & Support

  • 📖 Mode d'emploi : Ouvre cette page que vous lisez actuellement
  • 💬 Contacter le support : Si vous avez un problème ou une question

9. Liaison LGO - Installer l'agent Winpharma

L'agent Toolkit permet de connecter l'application à votre logiciel Winpharma pour récupérer automatiquement les informations produits.

📥 Installation de l'agent

  1. Téléchargez l'agent

    Depuis l'onglet Paramètres → Liaison LGO, téléchargez l'installateur Windows.

  2. Installez sur un PC de la pharmacie

    L'agent doit être installé sur un ordinateur ayant accès au réseau Winpharma (généralement le même réseau que vos postes de travail).

    ⚠️ Avertissement Windows : Lors du lancement de l'installateur, Windows peut afficher un message "Windows ne reconnaît pas l'éditeur de cette application". Cliquez sur "Informations complémentaires" puis sur "Exécuter quand même" pour continuer l'installation.
  3. Connectez-vous avec vos identifiants

    Utilisez le même email et mot de passe que pour l'application Pharma Toolkit.

  4. Configurez l'IP locale du serveur Winpharma

    Voir ci-dessous comment trouver cette adresse.

🔍 Comment trouver l'IP locale du serveur Winpharma ?

💡 C'est quoi une IP locale ? C'est l'adresse de votre serveur Winpharma sur votre réseau interne. Elle ressemble à 192.168.1.xxx ou 10.0.0.xxx.
  1. Allez sur le serveur Winpharma

    C'est l'ordinateur principal où est installé Winpharma (souvent appelé "serveur" ou "poste principal").

  2. Ouvrez l'invite de commandes

    Appuyez sur les touches Windows + R, tapez cmd puis Entrée.

  3. Tapez la commande

    Dans la fenêtre noire, tapez ipconfig puis appuyez sur Entrée.

  4. Trouvez l'adresse IPv4

    Cherchez la ligne "Adresse IPv4" sous "Ethernet" ou "Wi-Fi". C'est votre IP locale (exemple : 192.168.1.100).

  5. Entrez l'IP dans l'agent

    Dans l'onglet Configuration de l'agent Toolkit, saisissez cette adresse IP.

🆘 Besoin d'aide ? Si vous ne trouvez pas l'IP, demandez à votre prestataire informatique ou contactez notre support.