EasySubtotals - Titoli, Subtotali e Blocchi di Testo in Preventivi, Ordini e Fatture

EasySubtotals per Dolibarr — Preventivi, Ordini e Fatture Strutturati per Blocchi

EasySubtotals è il modulo Dolibarr che trasforma gli elenchi piatti di righe in documenti commerciali professionalmente strutturati. Inserisci titoli per raggruppare le voci, chiudi ogni blocco con un subtotale automatico e sfrutta i blocchi di testo libero riutilizzabili per clausole, note o separatori narrativi.

Compatibile con preventivi, ordini e fatture sia cliente sia fornitore, inclusi fatture ricorrenti e fatture di situazione. I subtotali funzionano nei modelli PDF standard (Crabe, Einstein, Azur) e — la funzionalità più richiesta — anche nei modelli ODT personalizzati tramite tag pronti all'uso.

🎯 Il problema che risolve

Le fatture e i preventivi lunghi con decine di righe di prodotti e servizi sono difficili da leggere per i tuoi clienti. Senza raggruppamento, ogni riga sembra ugualmente importante e il cliente perde il contesto. Se poi offri più sezioni (manodopera, licenze, hardware, manutenzione), il risultato è un muro di testo in cui la trattativa riga per riga è impossibile.

EasySubtotals divide il documento in blocchi visivi con titolo e subtotale. Il tuo cliente vede finalmente un documento leggibile, negoziabile e professionale.

🧩 Confronto con il subtotale standard di Dolibarr

📝 Tipi di blocchi inseribili

• 🟦 Titolo — apre un blocco e raggruppa le righe successive. Fino a 9 livelli gerarchici (titolo, sottotitolo, sotto-sottotitolo...).
• 💰 Subtotale — chiude un blocco e mostra automaticamente il totale cumulato (imponibile, IVA, totale).
• 📝 Testo libero — paragrafo narrativo senza impatto sui calcoli. Ideale per clausole, termini di pagamento, note al cliente o separatori.
• 📐 Snippet riutilizzabili — crea un dizionario di testi prefabbricati (condizioni, garanzie, introduzioni) e riutilizzali da un menu a tendina.

🎨 Integrazione con modelli ODT personalizzati

La funzionalità più richiesta del modulo. EasySubtotals si integra nel flusso standard di generazione ODT di Dolibarr ed espone un insieme di placeholder adattati al tipo di riga utilizzabili all'interno del segmento [!-- BEGIN row.lines --] ... [!-- END row.lines --] del tuo modello:

Il motore ODT di Dolibarr (Odtphp) non valuta i condizionali, quindi l'hook riempie i placeholder stessi con valori adattati al tipo di riga. Una sola riga piatta copre prodotti, titoli e subtotali:

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

Sui titoli {line_desc} arriva prefissato come "▶ Servizi"; sui subtotali come "Subtotal: Servizi", con {line_price_ht} già calcolato come totale del blocco. La scheda di amministrazione Variabili ODT elenca tutti i placeholder con esempi concreti.

⚙️ Elementi Dolibarr supportati

• ✅ Preventivi (cliente e fornitore)
• ✅ Ordini (cliente e fornitore)
• ✅ Fatture (cliente e fornitore)
• ✅ Fatture ricorrenti
• ✅ Fatture di situazione (gestione automatica di situation_percent)

🛠️ Opzioni di configurazione

• 🔢 Attiva livelli gerarchici (titoli annidati fino a 9 livelli)
• ➕ Consenti aggiunta / modifica / cancellazione / duplicazione dei blocchi indipendentemente
• 🎨 Stile PDF per titoli e subtotali (grassetto, corsivo, sottolineato)
• 📄 Interruzione di pagina per riga
• 🔀 Cascata ordine → fattura: un titolo + subtotale per ogni ordine fatturato (con __REFORDER__ e __REFCUSTOMER__)
• ❌ Marcatore "NI" (Non Incluso): esclude un blocco dal totale generale
• 📚 Dizionario di testi liberi gestito da Admin → Dizionari

📦 Casi d'uso comuni

• 🏗️ Edilizia e artigianato: preventivi con blocchi per fase (fondamenta, struttura, finiture) e subtotale per fase.
• 💻 Sviluppo / consulenza IT: separare analisi, sviluppo, test e licenze. Subtotali per blocco = negoziazione col cliente più facile.
• 🏭 Industria e distribuzione: una fattura con tutti gli ordini del mese, un blocco per ordine con il suo subtotale.
• 📋 Servizi professionali: preventivi con blocchi opzionali (il cliente sceglie cosa accettare).
• 🔧 Manutenzione tecnica: bolle di consegna con blocchi separati manodopera + materiali.
• 🎓 Formazione ed eventi: preventivi con un blocco per modulo o giornata.

🧩 Contenuto del modulo

• 🏗️ Descrittore del modulo con permessi (lettura / scrittura / cancellazione) e 15 costanti di configurazione.
• 🎛️ Pannello di amministrazione con 4 schede: Configurazione, Licenza, Informazioni, Cronologia.
• 🧠 3 override PDF: Crabe (fatture), Einstein (ordini), Azur (preventivi).
• 🎨 Integrazione ODT — l'hook riempie i placeholder con valori adattati al tipo di riga (Odtphp non supporta i condizionali).
• ⚙️ Trigger automatico per la cascata ordine → fattura e la gestione delle fatture di situazione.
• 📚 Dizionario di testi liberi riutilizzabili, isolato per entità.
• 🧱 Architettura pulita: servizi specializzati, handler hook separati, refactor profondo.
• 🌍 8 lingue complete: ES, EN, FR, DE, IT, PT, CA, GL.
• 🏢 Compatibile Multicompany (Multisociété) con dati isolati per entità.

⚙️ Compatibilità e requisiti

• 📦 Dolibarr V16+ (compatibile fino a V23+)
• ⚙️ PHP 7.4 – 8.3+
• 🗄️ MySQL 5.7+ / MariaDB 10.2+ / PostgreSQL 10+
• 🌐 Browser moderno con JavaScript abilitato
• ⚠️ Non compatibile con il vecchio modulo subtotal (dichiarato in conflictwith) — scegli uno dei due.

💰 Prezzo e licenza

Il modulo è software libero con licenza GPL v3. Puoi usarlo, modificarlo e ridistribuirlo liberamente rispettando i termini di tale licenza. Accesso agli aggiornamenti per 24 mesi dopo l'acquisto su Dolistore. Supporto diretto via email.

✉️ Supporto

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