InfraSTructure

Gestion des documents commerciaux de Dolibarr : propositions/commandes/factures.

1. PRÉSENTATION DU MODULE

Présentation du module

2. DOCUMENTS CONCERNÉS

Documents concernés

3.INSTALLATION ET ACTIVATION

Installation et activation

4. CONCEPTS DE BASE

Concepts

5. UTILISATION DU MODULE

Utilisation au quotidien

6. Impression PDF

Impression PDF

7. TRANSFORMATIONS DE DOCUMENTS

Transformations de documents

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

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 ne peuvent pas être activés simultanément : l'activation 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 ses données (paramètres, structures existantes, dictionnaire) puis le désactive. 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 elle-même.

TEXTE LIBRE

Bloc de texte explicatif inséré entre des lignes standards. Sans montant associé.

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 montant.

5.4 RÉORGANISER PAR GLISSER-DÉPOSER

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.

Remarque : le glisser-déposer nécessite que JavaScript/AJAX soit activé dans Dolibarr.

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