InfraSCusPrice

• 1. PRÉSENTATION GÉNÉRALE
• Présentation du module
• 2. INSTALLATION ET CONFIGURATION
• Installation et Configuration
• 3. FONCTIONNALITÉS PRINCIPALES
• Fonctionnalités Principales
• 4. GUIDE D'UTILISATION
• Cas d'Usage Typiques
• Guide d'Utilisation
• 5. PERMISSIONS ET DROITS D'ACCÈS
• Permissions
• 6. GESTION DES TARIFS
• Gestion des Tarifs
• 7. DÉPANNAGE ET SUPPORT
• Dépannage et Support
• 8. NOTES TECHNIQUES
• Notes Techniques

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

1. Téléchargez le module depuis le Dolistore ou le site InfraS
2. Décompressez l'archive dans le répertoire /htdocs/custom/
3. Connectez-vous à Dolibarr en tant qu'administrateur
4. Accédez à : Accueil > Configuration > Modules/Applications
5. Recherchez "InfraSCusPrice" ou "Gestion des prix par client"
6. 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 :

1. Accédez à la liste des modules
2. Désactivez le module InfraSCusPrice
3. Réactivez immédiatement le module
4. 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

1. Créez le tiers (filiale) dans Dolibarr
2. Définissez la maison mère dans la fiche du tiers
3. Accédez à l'onglet "Prix client" de la filiale
4. Cliquez sur "Mise à jour Tarifs"
5. 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

1. Accédez à la fiche du tiers (filiale)
2. Allez dans l'onglet "Prix client"
3. Cliquez sur "Supprimer les tarifs"
4. 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

1. Modifiez les prix clients de la maison mère
2. Pour chaque filiale concernée :
   • Accédez à l'onglet "Prix client"
   • Cliquez sur "Mise à jour Tarifs"
3. 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

1. Accédez à la fiche du tiers (filiale)
2. Cliquez sur "Modifier"
3. Dans le champ "Société mère", sélectionnez la maison mère
4. 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 :

1. Accédez à la fiche du tiers (filiale)
2. Cliquez sur l'onglet "Prix client"
3. 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
4. Confirmez l'action
5. Un message indique le nombre de lignes traitées avec succès

3.SUPPRIMER LES TARIFS D'UNE FILIALE

1. Accédez à la fiche du tiers (filiale)
2. Cliquez sur l'onglet "Prix client"
3. Cliquez sur le bouton Supprimer les tarifs
4. Confirmez la suppression
5. 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 :

1. Accédez à : Accueil > Configuration > Utilisateurs & Groupes
2. Sélectionnez un utilisateur ou un groupe
3. Cliquez sur l'onglet "Droits"
4. Recherchez "InfraSCusPrice" ou "Gestion des prix par client"
5. Cochez les permissions à attribuer
6. 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 :

1. Accédez à : Accueil > Configuration > Divers
2. Activez le mode de log Dolibarr
3. Reproduisez le problème
4. 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