INFRASTRUCTURE Gestion des documents commerciaux de Dolibarr : propositions/commandes/factures. 1. PRÉSENTATION DU MODULE Présentation du module Le module InfraStructure enrichit la gestion des documents commerciaux de Dolibarr en permettant d'organiser leurs lignes de manière claire et professionnelle. FONCTIONNALITÉS APPORTÉES : TITRES En-têtes de sections, imbriqués jusqu'à 9 niveaux (titre, sous-titre, sous-sous-titre…), permettant de regrouper les lignes en sections distinctes. SOUS-TOTAUX Calculés automatiquement pour chaque section : Total HT, quantité, TVA, réduction, marge. TEXTE LIBRE Lignes de description, conditions ou commentaires insérables librement entre les lignes de produits/services. DICTIONNAIRE Bibliothèque de textes prédéfinis réutilisables d'un document à l'autre. GLISSER-DÉPOSER Réorganisation intuitive des lignes et blocs par drag-and-drop. MODES PDF Trois modes d'impression : standard, liste, condensé. SOMMAIRE Sommaire rapide flottant pour naviguer rapidement dans les documents longs. TRANSFORMATIONS Préservation des structures lors des conversions devis → commande → facture. Toutes les fonctionnalités sont optionnelles et paramétrables depuis la page de configuration du module. 2. DOCUMENTS CONCERNÉS Documents concernés InfraStructure est disponible sur l'ensemble des documents commerciaux et techniques de Dolibarr , couvrant aussi bien la chaîne des ventes que des achats. Chaîne des ventes : Propositions commerciales (devis) Commandes clients Factures clients (standard, acompte, situation, avoir) Chaîne des achats : Demandes de prix fournisseurs Commandes fournisseurs Factures fournisseurs Documents techniques : Bons de livraison Bons de réception 3. INSTALLATION ET ACTIVATION Installation et activation PROCÉDURE D'INSTALLATION 1 .Déploiement du module Déployez le module de préférence via l'outil de déploiement des modules externes de Dolibarr . 2. Activation Activez-le depuis : Accueil > Configuration > Modules/Applications/Infrastructure 3. Initialisation automatique Les attributs nécessaires sont créés automatiquement : champs complémentaires sur les lignes, dictionnaire de textes, constantes par défaut. Important : Il est impératif de désactiver puis réactiver le module pour appliquer les modifications nécessaires. Attention : InfraStructure est incompatible avec le module Milestone / Jalon (iNodbox) . Les deux modules ne peuvent pas être activés simultanément : l'activation de l'un est bloquée si l'autre est déjà présent. Si le module Sous-Total (ATM Consulting) est présent et actif lors de l'activation, InfraStructure migre automatiquement les données de Sous-Total (paramètres, structures existantes, dictionnaire) puis désactive Sous-Total => Aucune perte de vos titres/sous-totaux existants. 4. CONCEPTS DE BASE Concepts Le module ajoute trois types de lignes spéciales dans vos documents commerciaux. TITRE En-tête de section. Peut être imbriqué sur 9 niveaux (titre, sous-titre, sous-sous-titre…). Il marque le début d'un regroupement de lignes. SOUS-TOTAL Ligne de totalisation placée à la fin d'une section. Additionne automatiquement les lignes situées entre le titre parent et la ligne de totalisation. TEXTE LIBRE Permet d'insérer un bloc explicatif comme une ligne standard sans mentionner de montant ni de quantité associés. PRINCIPE DE CALCUL D'UN SOUS_TOTAL Le sous-total remonte jusqu'au titre parent (ou au sous-total de même niveau précédent) et additionne toutes les lignes standards rencontrées. Sont exclus automatiquement du calcul : les titres, sous-totaux et textes libres ; les lignes masquées d'un bloc « caché » ; les lignes optionnelles ; les lignes de remise (module InfraSDiscount ). Exemple de structure Titre « Matériel » Produit A 100,00 EUR Produit B 200,00 EUR Sous-total « Matériel » 300,00 EUR Titre « Services » Service X 150,00 EUR Sous-total « Services » 150,00 EUR 5. UTILISATION DU MODULE Utilisation au quotidien Ouvrez un document en mode BROUILLON . Les boutons d'action InfraStructure apparaissent au-dessus ou en dessous des lignes du document. 5.1 AJOUTER UN TITRE Cliquez sur « Ajouter un titre » (ou « Ajouter un sous-titre » pour un niveau inférieur). Saisissez le libellé du titre. Validez : le titre s'insère dans le document. Selon la configuration, un sous-total manquant peut être ajouté automatiquement au-dessus du nouveau titre. 5.2 AJOUTER UN SOUS-TOTAL Cliquez sur « Ajouter un sous-total » (ou « Ajouter un sous-sous-total »). Saisissez le libellé. Le montant se calcule automatiquement à partir des lignes situées au-dessus, jusqu'au titre parent. OPTIONS D' AFFICHAGE Afficher le Total HT Afficher la quantité totale du bloc Afficher la réduction moyenne du bloc Afficher la marge (si activé dans la configuration) 5.3 AJOUTER UNE LIGNE DE TEXTE LIBRE Cliquez sur « Ajouter une ligne de texte » . Saisissez directement votre texte, OU sélectionnez un texte prédéfini dans le dictionnaire (voir 5.10). Le texte s'insère comme une ligne à part entière, sans mentionner un montant. 5.4 RÉORGANISER PAR GLISSER-DÉPOSER Remarque : le glisser-déposer nécessite que JavaScript/AJAX soit activé dans Dolibarr . Saisissez une ligne par sa poignée de déplacement et déplacez-la. Pour déplacer un titre avec tout son contenu , utilisez l'action « Déplacer le bloc titre complet ». Les sous-totaux sont recalculés automatiquement après réorganisation. 5.5 DUPLIQUER UN BLOC OU UNE LIGNE « Dupliquer » sur un titre : copie le titre et l'ensemble de ses lignes. « Dupliquer » sur une ligne : copie la ligne seule. Ces actions peuvent être désactivées dans la configuration. 5.6 MASQUER LE DÉTAIL D'UN BLOC Sur un titre, vous pouvez masquer les lignes pour obtenir une présentation synthétique (seuls le titre et son sous-total restent visibles). Les lignes masquées restent comptabilisées dans les sous-totaux. Modes de pliage disponibles : default Un bouton masque/affiche les lignes. keepTitle Deux boutons : masquer les lignes directes / masquer tout le contenu y compris les titres imbriqués. hideAll Deux boutons : masquer les lignes directes / masquer tout le contenu du bloc. 5.7 LIGNES / BLOCS OPTIONNELS (« Opt ») Si la gestion des lignes optionnelles est activée, une colonne « Opt » apparaît. Cocher une ligne ou un bloc la marque comme optionnelle : Son montant : Reste affiché Calculs : Exclu des sous-totaux parents et du total général Utile pour proposer des options chiffrées sans les inclure au total. 5.8 APPLIQUER UNE TVA OU UNE PROGRESSION AU BLOC Depuis un titre, deux actions sont disponibles : « Appliquer une TVA au bloc » : applique un taux de TVA unique à toutes les lignes du bloc. « Appliquer une progression au bloc » : applique un pourcentage d'avancement à toutes les lignes (factures de situation). 5.9 LE SOMMAIRE RAPIDE FLOTTANT Sur un document comportant des titres, un bouton flottant apparaît dans le coin inférieur droit. Cliquez dessus pour dérouler la liste des titres ; cliquez sur un titre pour faire défiler le document jusqu'à lui. Peut être désactivé dans la configuration. S'adapte automatiquement au thème Oblyon . 5.10 LE DICTIONNAIRE DE TEXTES LIBRES Le dictionnaire stocke des textes récurrents réutilisables d'un document à l'autre. GESTION DES ENTRÉES Accueil > Configuration > Dictionnaires > « Ligne de texte prédéfini » . Chaque entrée comporte un libellé et un contenu. UTILISATION Lors de l'ajout d'une ligne de texte, sélectionnez un texte prédéfini dans la liste pour le réutiliser immédiatement. 6. IMPRESSION PDF Impression PDF Les titres et sous-totaux sont rendus dans le PDF avec un style et des couleurs paramétrables. Trois modes d'impression sont disponibles par titre. STANDARD : Affichage complet, sous forme de tableau. Mode par défaut. LISTE : Le contenu du titre est rendu sous forme de liste à puces. CONDENSÉ : Affichage compact, avec agrégation selon les options choisies. OPTIONS COMPLÉMENTAIRES PAR TITRE : Cacher les lignes du bloc (seuls titre et sous-total apparaissent dans le PDF). Répéter l'en-tête du tableau juste avant ce titre. Ajouter un saut de page avant le titre. Numérotation automatique : Une numérotation des titres/sections peut être activée sur le PDF depuis la configuration du module. Récapitulatif par titre : Un document récapitulatif (par titre/lot) peut être généré et fusionné en fin de PDF, sur les devis, commandes et/ou factures (configuration). 7. TRANSFORMATIONS DE DOCUMENTS Transformations de documents Les structures (titres, sous-totaux, textes libres) sont préservées lors de toutes les opérations de transformation de documents. OPÉRATION SUPPORTÉES Conversion en chaîne Devis → commande → facture. La structure est intégralement conservée à chaque étape. Clonage La duplication d'un document reproduit fidèlement sa structure. Facturation groupée Un bloc titre peut être ajouté entre chaque commande. Le texte est personnalisable avec les clés __REFORDER__ et __REFCUSTOMER__ . Expéditions Génération d'expéditions depuis une commande. La liste des bons d'expédition/livraison liés peut être ajoutée à la description du titre. Factures récurrentes Création de factures récurrentes depuis un modèle — la structure est préservée. CHAÎNE DE TRANSFORMATION Devis → Commande → Facture = Structure préservée 8.FACTURES DE SITUATION Factures de situation InfraStructure prend en charge les factures de situation (avancement de travaux) tout en conservant la structure des titres et sous-totaux. Caractéristiques Structure préservée : Titres et sous-totaux restent intacts d'une situation à l'autre. Avancement par bloc Les pourcentages d'avancement sont gérés au niveau des blocs (titres). Utilisez « Appliquer une progression au bloc » (section 5.8) pour mettre à jour rapidement. Calcul de TVA adapté Le calcul de la TVA est adapté pour éviter toute accumulation erronée d'une situation à l'autre. Blocage automatique : La création d'une nouvelle situation est bloquée si la progression a déjà atteint 100 % . 9. CONFIGURATION DU MODULE Paramètres du module Accès : Accueil > Configuration > Modules/Applications > InfraStructure > (roue dentée) 1. PARAMÈTRES DU MODULE INFRASTRUCTURE [Ligne 1 à 12] Afficher les marges sur les lignes de sous-totaux. [Ligne 1] À l'ajout d'un titre, ajouter au-dessus les sous-totaux manquants. [Ligne 2] Texte des titres lors de la facturation groupée (clés __REFORDER__ , __REFCUSTOMER__ ). [Ligne 3] Gestion des lignes optionnelles : activer le marquage « Optionnel » ; vider aussi le prix de revient. [Ligne 4 et 5] Champs complémentaires (ExtraFields) : autoriser l'affichage sur les titres ; choisir les ExtraFields disponibles (devis / commandes / factures clients). [Ligne 6 à 9] Expéditions : ne pas reporter les lignes de titre lors de la génération ; cocher par défaut « Inclure la liste des expéditions ». [Ligne 10 et 11] Cacher le prix des lignes des ensembles par défaut dans les PDF. [Ligne 12] 2. PARAMÈTRES D'AFFICHAGE (ÉCRAN) [Ligne 1 à 13] Autoriser l'ajout / l'édition / la suppression des titres et sous-totaux. [Ligne 1 et 3] Autoriser la duplication d'un bloc / d'une ligne. [Ligne 4 et 5] Permettre l'ajout d'une ligne directement sous un titre. [Ligne 6] Plier les dossiers par défaut. [Ligne 7] Cacher les options de titre / l'option de saut de page avant. [Ligne 9 et 10] Forcer l'affichage des boutons d'action en mode éclaté ( Dolibarr ≥ 20). [Ligne 11] Styles à l'écran des textes libres / titres / sous-totaux (B = gras, U = souligné, I = italique). [Ligne 12 et 14] Pourcentage de réduction de luminosité entre niveaux. [Ligne 15] Désactiver le sommaire rapide flottant. [Ligne 16] Comportement de pliage d'un bloc ( default / keepTitle / hideAll ). [Ligne 17] Affichage de la somme des quantités sur les sous-totaux par type de document. [Ligne 18] Couleurs de fond et de texte des titres et sous-totaux. [Ligne 19 à 23] Cacher les options de génération du document. [Ligne 24] 3. PARAMÈTRES D'IMPRESSION PDF [Ligne 1 à 13] Activer la numérotation automatique des titres/sections. [Ligne 1] Imprimer les totaux directement sur les lignes de titre (les sous-totaux ne sont alors plus imprimés séparément). [Ligne 2] Taille des titres (9 par défaut si vide). [Ligne 3] Style des titres lorsque le détail est caché. [Ligne 4] Style PDF des titres et sous-totaux (écrase le style écran). [Ligne 5 et 6] Couleurs de fond et de texte des titres et sous-totaux dans le PDF. [Ligne 7 à 10] Ajouter le libellé du titre parent sur la ligne de sous-total. [Ligne 11] Pourcentage de luminosité entre niveaux dans le PDF. [Ligne 12] Ajustements fins de hauteur / décalage vertical des fonds colorés. [Ligne 13 à 16] Affichage de la somme des quantités sur les sous-totaux dans le PDF. [Ligne 17] Afficher le taux de TVA avec les sous-totaux si le bloc a un taux unique. [Ligne 18] Limiter l'affichage du taux de TVA aux blocs condensés / en liste. [Ligne 19] Génération d'un récapitulatif par titre : conserver le PDF après fusion ; activer sur devis / commandes / factures. [Ligne 20-23] Rappel : Cliquez sur « Modifier » après chaque changement. Certaines options nécessitent un rafraîchissement (F5). Sauvegarde / Restauration : L'onglet « Paramètres InfraS » permet de sauvegarder et restaurer l'ensemble des paramètres. X.COMPATIBILITÉ AVEC LES MODULES EXTERNES Compatibilité avec d'autres modules 1. COMPATIBLE AVEC : InfraSPackPlus Modèles PDF avancés avec support natif des structures. (InfraS) InfraSDiscount Remises — les lignes spéciales sont exclues automatiquement des calculs. (InfraS) Ouvrage Module Ouvrage / Forfait. (Inovea) Équipement (Patas-Monkey) Custom Link (Patas-Monkey) Note de Frais+ (Mikael Carlavan) Ultimate (ATM Consulting) Oblyon Thème — sommaire flottant adapté automatiquement. (Inovea / InfraS) 2. INCOMPATIBLE AVEC : Milestone / Jalon Les deux modules ne peuvent pas être actifs simultanément. L'activation de l'un est bloquée si l'autre est déjà présent. (iNodbox)