EasySubtotals - Titres, Sous-Totaux et Blocs de Texte dans Devis, Commandes et Factures

EasySubtotals pour Dolibarr — Devis, Commandes et Factures Structurés par Blocs

EasySubtotals est le module Dolibarr qui transforme vos listes plates de lignes en documents commerciaux structurés. Insérez des titres pour regrouper les postes, fermez chaque bloc par un sous-total automatique, et utilisez les blocs de texte libre réutilisables pour vos clauses, notes ou séparateurs narratifs.

Compatible avec les devis, commandes et factures côté client comme fournisseur, y compris factures récurrentes et factures de situation. Les sous-totaux fonctionnent dans les modèles PDF standards (Crabe, Einstein, Azur) et — la fonctionnalité la plus demandée — également dans les modèles ODT personnalisés grâce à des tags prêts à l'emploi.

🎯 Le problème qu'il résout

Les factures et devis longs avec des dizaines de lignes sont illisibles pour vos clients. Sans regroupement, toutes les lignes paraissent équivalentes et le client perd le fil. Si vous proposez plusieurs sections (main d'œuvre, licences, matériel, maintenance), le résultat est un mur de texte où la négociation ligne par ligne est impossible.

EasySubtotals découpe le document en blocs visuels avec titre et sous-total. Votre client voit enfin un document lisible, négociable et professionnel.

🧩 Comparatif avec le sous-total standard Dolibarr

📝 Types de blocs insérables

• 🟦 Titre — ouvre un bloc et regroupe les lignes suivantes. Jusqu'à 9 niveaux hiérarchiques (titre, sous-titre, sous-sous-titre...).
• 💰 Sous-total — ferme un bloc et affiche automatiquement le total cumulé (HT, TVA, TTC).
• 📝 Texte libre — paragraphe narratif sans impact sur les calculs. Idéal pour clauses, conditions de paiement, notes au client ou séparateurs.
• 📐 Blocs préfabriqués réutilisables — créez un dictionnaire de textes préfabriqués (conditions, garanties, introductions) et réutilisez-les via un menu déroulant.

🎨 Intégration avec les modèles ODT personnalisés

La fonctionnalité la plus demandée du module. EasySubtotals se branche sur le pipeline standard de génération ODT de Dolibarr et expose un jeu de placeholders adaptés au type de ligne utilisables dans le segment [!-- BEGIN row.lines --] ... [!-- END row.lines --] de votre modèle :

Le moteur ODT de Dolibarr (Odtphp) n'évalue pas les conditionnels, le hook remplit donc les placeholders avec des valeurs adaptées au type de ligne. Une seule ligne plate couvre produits, titres et sous-totaux :

[!-- BEGIN row.lines --]
{line_desc}    {line_qty}    {line_up}    {line_price_ht}
[!-- END row.lines --]

Sur les titres {line_desc} arrive préfixé comme "▶ Services" ; sur les sous-totaux comme "Subtotal : Services", avec {line_price_ht} déjà calculé comme total du bloc. L'onglet d'administration Variables ODT liste tous les marqueurs avec des exemples.

⚙️ Éléments Dolibarr supportés

• ✅ Propositions / devis (clients et fournisseurs)
• ✅ Commandes (clients et fournisseurs)
• ✅ Factures (clients et fournisseurs)
• ✅ Factures récurrentes
• ✅ Factures de situation (gestion automatique de situation_percent)

🛠️ Options de configuration

• 🔢 Activer les niveaux hiérarchiques (titres imbriqués jusqu'à 9 niveaux)
• ➕ Autoriser ajout / édition / suppression / duplication des blocs indépendamment
• 🎨 Style PDF des titres et sous-totaux (gras, italique, souligné)
• 📄 Saut de page par ligne
• 🔀 Cascade commande → facture : un bloc titre + sous-total par commande facturée (avec __REFORDER__ et __REFCUSTOMER__)
• ❌ Marqueur "NC" (Non Compté) : exclut un bloc du total général
• 📚 Dictionnaire de textes libres géré depuis Admin → Dictionnaires

📦 Cas d'usage courants

• 🏗️ BTP et second œuvre : devis avec blocs par phase (fondations, structure, finitions) et sous-total par phase.
• 💻 Développement / conseil IT : séparer analyse, développement, tests et licences. Sous-totaux par bloc = négociation client facilitée.
• 🏭 Industrie et distribution : une facture avec toutes les commandes du mois, un bloc par commande avec son propre sous-total.
• 📋 Services professionnels : devis avec blocs optionnels (le client choisit ce qu'il accepte).
• 🔧 Maintenance technique : bons de livraison avec blocs séparés main d'œuvre + matériaux.
• 🎓 Formation et événementiel : devis avec un bloc par module ou par jour.

🧩 Contenu du module

• 🏗️ Descripteur de module avec permissions (lecture / écriture / suppression) et 15 constantes de configuration.
• 🎛️ Panneau d'administration avec 4 onglets : Configuration, Licence, À propos, Historique.
• 🧠 3 surcharges PDF : Crabe (factures), Einstein (commandes), Azur (devis).
• 🎨 Intégration ODT — le hook pré-remplit les placeholders avec des valeurs adaptées au type de ligne (Odtphp ne supporte pas les conditionnels).
• ⚙️ Trigger automatique pour la cascade commande → facture et la gestion des factures de situation.
• 📚 Dictionnaire de textes libres réutilisables, isolés par entité.
• 🧱 Architecture propre : services spécialisés, handlers de hook séparés, refactor en profondeur.
• 🌍 8 langues complètes : ES, EN, FR, DE, IT, PT, CA, GL.
• 🏢 Compatible Multisociété (Multicompany) avec données isolées par entité.

⚙️ Compatibilité et exigences

• 📦 Dolibarr V16+ (compatible jusqu'à V23+)
• ⚙️ PHP 7.4 – 8.3+
• 🗄️ MySQL 5.7+ / MariaDB 10.2+ / PostgreSQL 10+
• 🌐 Navigateur moderne avec JavaScript activé
• ⚠️ Incompatible avec l'ancien module subtotal (déclaré dans conflictwith) — à choisir l'un ou l'autre.

💰 Prix et licence

Le module est un logiciel libre sous licence GPL v3. Vous pouvez l'utiliser, le modifier et le redistribuer selon les termes de cette licence. Accès aux mises à jour pendant 24 mois après achat sur Dolistore. Support par e-mail.

✉️ Support

✉️ info@easysoft.es | 🌐 www.easysoft.es