InfraSCusPrice Gestion des prix clients pour Dolibarr 1. PRÉSENTATION GÉNÉRALE Présentation du module InfraSCusPrice est un module optionnel pour Dolibarr ERP & CRM qui facilite le déploiement automatique des prix spécifiques par client. OBJECTIF Le module permet d'automatiser le renseignement des prix des filiales à partir d'une maison mère disposant déjà de prix clients configurés. PRINCIPAUX AVANTAGES Gain de temps : Propagation automatique des tarifs vers les filiales Cohérence : Garantit l'uniformité des prix au sein d'un groupe Flexibilité : Possibilité de supprimer les tarifs d'une filiale en un clic Traçabilité : Historique des modifications PRÉREQUIS Dolibarr ERP & CRM version 18.0 ou supérieure Module "Prix par client" de Dolibarr activé Extension PHP ' XML ' chargée (pour certaines fonctionnalités) Droits d' administration pour l'installation Support : support@infras.fr | 🌐 Documentation : wiki.infras.fr | 📄 Licence : GPL v3+ 2. INSTALLATION ET CONFIGURATION Installation et Configuration 1.INSTALLATION Téléchargez le module depuis le Dolistore ou le site InfraS Décompressez l'archive dans le répertoire /htdocs/custom/ Connectez-vous à Dolibarr en tant qu' administrateur Accédez à : Accueil > Configuration > Modules/Applications Recherchez " InfraSCusPrice " ou " Gestion des prix par client " Cliquez sur " Activer " 2.ACTIVATION DES MODIFICATIONS IMPORTANT : Après toute mise à jour de Dolibarr et/ou du module : Il est IMPÉRATIF de désactiver puis réactiver le module pour effectuer les modifications nécessaires dans la base de données. Procédure : Accédez à la liste des modules Désactivez le module InfraSCusPrice Réactivez immédiatement le module Vérifiez les messages de confirmation 3.CONFIGURATION INITIALE Le module ne nécessite aucune configuration particulière . À l'activation, il configure automatiquement : INFRASCUSP_PS_ACTIVE_SOCIETE_PRICE = 1 PRODUIT_CUSTOMER_PRICES = 1 4.ACCÈS AUX PARAMÈTRES Menu : Outils > InfraS > InfraSCusPrice Sous-menus disponibles : Changelog/Support : Historique des versions et demande de support Paramètres : Configuration spécifique InfraSCusPrice 3. FONCTIONNALITÉS PRINCIPALES Fonctionnalités Principales 1.PROPAGATION DES TARIFS Permet de copier automatiquement tous les prix clients d'une maison mère vers une ou plusieurs filiales en une seule opération. Éléments copiés : Prix unitaire Prix minimum Type de base (HT/TTC) Taux de TVA et code Pourcentage de remise Dates de validité Référence client Taxes locales 2.SUPPRESSION DES TARIFS Supprime en un clic tous les prix clients spécifiques d'une filiale. Particulièrement utile lorsqu'une société quitte un groupe. Attention : Cette action est irréversible . Tous les prix clients seront définitivement supprimés. 3.GESTION DES GROUPES Le module fonctionne sur la base de la relation maison mère / filiale définie dans Dolibarr . Structure : 🏛️ Maison Mère (avec prix définis) ├── 🏢 Filiale 1 (peut hériter des prix) ├── 🏢 Filiale 2 (peut hériter des prix) └── 🏢 Filiale 3 (peut hériter des prix) Astuce : Définissez tous les prix de la maison mère avant de propager vers les filiales 4. GUIDE D'UTILISATION Cas d'Usage Typiques CAS I : NOUVELLE FILIALE CRÉÉE Créez le tiers (filiale) dans Dolibarr Définissez la maison mère dans la fiche du tiers Accédez à l'onglet " Prix client " de la filiale Cliquez sur " Mise à jour Tarifs " Les prix de la maison mère sont copiés automatiquement Astuce : Cette opération peut être répétée pour plusieurs filiales successivement. CAS II : FILIALE QUITTANT LE GROUPE Accédez à la fiche du tiers (filiale) Allez dans l'onglet " Prix client " Cliquez sur " Supprimer les tarifs " Modifiez la fiche du tiers pour supprimer la relation maison mère Important : Assurez-vous de vouloir supprimer tous les prix avant de confirmer l'action. CAS III : MISE À JOUR DES RARIFS D'UN GROUPE Modifiez les prix clients de la maison mère Pour chaque filiale concernée : Accédez à l'onglet " Prix client " Cliquez sur " Mise à jour Tarif s " Les nouveaux tarifs sont propagés Conseil : Notez les dates des mises à jour pour assurer la traçabilité des modifications de tarifs. Testez d'abord sur une filiale pilote avant un déploiement général Guide d'Utilisation 1.UNE RELATION MAISON MÈRE / FILIALE Accédez à la fiche du tiers (filiale) Cliquez sur "Modifier" Dans le champ "Société mère" , sélectionnez la maison mère Cliquez sur " Enregistrer " 2.PROPAGER LES TARIFS D'UNE MAISON MÈRE VERS UNE FILIALE Prérequis : La relation maison mère / filiale doit être définie La maison mère doit avoir des prix clients configurés L'utilisateur doit avoir les droits nécessaires Procédure : Accédez à la fiche du tiers (filiale) Cliquez sur l'onglet " Prix client" Deux nouveaux boutons sont disponibles en haut de page : Mise à jour Tarifs Permet de copier/mettre à jour les prix de la maison mère Le titre du bouton indique le nom de la maison mère Cliquez pour lancer la propagation Supprimer les tarifs Permet de supprimer tous les prix clients de cette filiale Confirmez l'action Un message indique le nombre de lignes traitées avec succès 3.SUPPRIMER LES TARIFS D'UNE FILIALE Accédez à la fiche du tiers (filiale) Cliquez sur l'onglet "Prix client" Cliquez sur le bouton Supprimer les tarifs Confirmez la suppression Tous les prix clients de cette filiale sont supprimés ATTENTION : Cette action est irréversible ! 5. PERMISSIONS ET DROITS D'ACCÈS Permissions Le module InfraSCusPrice définit trois niveaux de permissions pour un contrôle granulaire des accès. Permissions Code Description Afficher le menu secondaire vers les paramètres du module paramMenu Accéder aux menus de configuration (utilisateur non administrateur) Modifier les paramètres spécifiques InfraSCusPrice paramInfraSCusPrice Modifier les paramètres avancés du module Utiliser les fonctions de mise à jour des prix paramUse Utiliser les boutons de propagation et suppression des tarifs ATTRIBUTION DES PERMISSIONS : Accédez à : Accueil > Configuration > Utilisateurs & Groupes Sélectionnez un utilisateur ou un groupe Cliquez sur l'onglet "Droits" Recherchez " InfraSCusPrice " ou "Gestion des prix par client" Cochez les permissions à attribuer Cliquez sur " Enregistrer " RECOMMANDATION : Permission Profil Recommandé Usage MENU Tous les utilisateurs concernés Consultation des paramètres PARAMÈTRES Administrateurs uniquement Configuration avancée UTILISATION Gestionnaires commerciaux et administrateurs Propagation et suppression des tarifs ⚠️ Sécurité : Limitez la permission "UTILISATION" aux utilisateurs de confiance car elle permet de modifier en masse les prix clients 6. GESTION DES TARIFS Gestion des Tarifs 1.COMPRENDRE LES PRIX PAR CLIENT DANS DOLIBARR Dolibarr permet de définir des prix spécifiques pour chaque couple produit/service et client . Ces prix peuvent différer du tarif général. Avantages des prix par client : Tarif personnalisé Gestion des remises permanentes Tarifs négociés Prix contractuels 2.COMPORTEMENT DE LA PROPAGATION Lors de la propagation des tarifs : Le module récupère tous les prix de la maison mère Pour chaque produit de la maison mère il Vérifie si un prix existe déjà pour la filiale Crée ou met à jour le prix de la filiale Copie tous les paramètres (prix, TVA, dates, etc.) Affiche un message de confirmation avec le nombre de lignes traitées ATTENTION : Les prix existants de la filiale sont écrasés . L'opération est irréversible (sauf nouvelle propagation). Aucune sauvegarde automatique n'est effectuée 3.BONNES PRATIQUES ✓ À FAIRE Définir les prix de la maison mère avant propagation Vérifier la relation maison mère/filiale Tester sur une filiale pilote Documenter les propagations Sauvegarder la base avant toute opération massive ✗ À ÉVITER Propager vers une filiale avec prix spécifiques importants Oublier de mettre à jour les filiales après modification Propager sans vérifier les permissions Négliger la documentation 7. DÉPANNAGE ET SUPPORT Dépannage et Support PROBLÈMES COURANTS ET SOLUTIONS PROBLÈME SOLUTION Les boutons ne s'affichent pas Vérifiez que la relation maison mère/filiale est définie Vérifiez les permissions de l'utilisateur Vérifiez que le module est bien activé F5 pour rafraîchir la page "La société concernée n'est pas renseignée" Vérifiez que l'ID du tiers est correctement passé en paramètre Vérifiez l'URL de la page Erreur "Votre version de Dolibarr n'est pas encore supportée" Le module n'a pas encore été testé sur votre version de Dolibarr Contactez le support InfraS Option : Désactiver le contrôle de version ( déconseillé ) Variable : INFRASCUSPRICE_DISABLE_CHECK_VERSION_MAX "Core Change nécessaire" Désactivez complètement le module Réactivez le module => Le "Core Change" sera appliqué automatiquement Extension PHP 'XML' non chargée Installez l'extension PHP XML Redémarrez le serveur web Certaines fonctionnalités (changelog) ne seront pas disponibles sans cette extension "La société concernée n'est pas renseignée" Vérifiez que l'ID du tiers est correctement passé en paramètre Vérifiez l'URL de la page Aucun tarif n'est propagé Vérifiez que la maison mère a bien des prix clients définis Vérifiez que vous êtes sur l'onglet "Prix client" de la filiale Consultez les logs de Dolibarr pour plus de détails LOGS ET DÉBUGAGE Les logs du module sont enregistrés dans les logs Dolibarr, pour activer le mode debug : Accédez à : Accueil > Configuration > Divers Activez le mode de log Dolibarr Reproduisez le problème Consultez les logs dans : documents/dolibarr_*.log Recherchez les entrées contenant : infrascusprice InfraSCusPrice infrascusp_ SAUVEGARDE ET RESTAURATION Le module propose des fonctions de sauvegarde/restauration des paramètres dans : Menu Outils > InfraS > InfraSCusPrice > Paramètres Boutons disponibles : "Sauvegarder" : Exporte tous les paramètres du module "Restaurer" : Importe des paramètres précédemment sauvegardés Après restauration : Appuyez sur F5 pour rafraîchir la page Attention : Cela sauvegarde uniquement les paramètres du module , pas les données des prix clients. SUPPORT TECHNIQUE Pour toute assistance : 🌐 Site web : www.infras.fr 📧 Email : support@infras.fr Informations à fournir lors d'une demande de support : Version de Dolibarr Version du module InfraSCusPrice Description détaillée du problème Extraits des logs (si disponibles) Captures d'écran Environnement (OS, PHP, serveur web) 8. NOTES TECHNIQUES Notes Techniques HOOKS UTILISÉS Hook Description updateSession Redirection vers pages de substitution afterLogin Contrôle de version, redirection addMoreActionsButtons Ajout des boutons sur l'onglet Prix client doActions Traitement des actions (propagation/suppression) PAGES DE SUBSTITUTION Le module remplace la page standard de Dolibarr pour les prix clients : /societe/price.php Avantage : Cette substitution permet d'ajouter les boutons de gestion des tarifs tout en conservant toutes les fonctionnalités standard de Dolibarr . Versions supportées : 18.x 19.x 20.x 21.x 22.x BASE DE DONNÉES Information : Le module n'ajoute aucune table à la base de données. Il utilise les tables standard de Dolibarr : llx_product_customer_price : Stockage des prix clients llx_const : Constantes de configuration llx_c_tva : Taux de TVA PERFORMANCE Considérations : La propagation peut être longue si la maison mère a de nombreux produits (plusieurs minutes pour >1000 produits) L'opération est exécutée en synchrone Pas de mise en cache des données Chaque ligne est traitée individuellement Recommandations : Éviter les propagations durant les heures de forte activité Pour des volumes très importants, envisager une opération en batch Surveiller les logs en cas de timeout PHP SÉCURITÉ Le module respecte les standards de sécurité de Dolibarr : Utilisation de restrictedArea() Vérification des permissions utilisateur Protection CSRF native Échappement des requêtes SQL Validation des paramètres GET/POST COMPATIBILITÉ Environnement Dolibarr : 18.0 à 22.x PHP Min : 7.4 PHP Max : 8.3 Extensions : XML (recommandée) Modules compatibles Module Produits/Services Module Tiers Module Sociétés Module Multidevises Module Multi-tarifs Version du document : 2.0 | Date : Février 2026 InfraS - Sylvain Legrand | support@infras.fr | wiki.infras.fr