Subtotali & Abbonamenti

Presenta chiaramente i preventivi che combinano prestazioni una tantum e abbonamenti.

Sei un fornitore di servizi IT, rivenditore telecom, hosting, installatore o agenzia? I tuoi preventivi spesso combinano una parte una tantum (hardware, attivazione, formazione...) e una parte ricorrente (abbonamento mensile, manutenzione, hosting, licenza...). Con un modello PDF standard di Dolibarr, queste due nature si mescolano in un'unica colonna di totali — il cliente non riesce a distinguere ciò che paga una sola volta da ciò che paga ogni mese.

SousTotalAbo aggiunge due nuovi modelli PDF che strutturano visivamente i tuoi preventivi:

• 📋 Subtotali automatici per categoria (Una tantum / Abbonamento) nella tabella delle righe
• 💰 Riquadro dedicato agli abbonamenti in basso a sinistra del PDF, con totale Imponibile / IVA / Totale
• 🔄 Totale globale (Prestazioni + materiali) mantenuto in basso a destra, come un PDF standard
• 📅 Due varianti a scelta: abbonamento mensile o annuale

Come funziona

Il modello si basa sul formato delle righe che aggiungi al tuo preventivo. Nessun campo aggiuntivo da configurare.

1. Righe di titolo (subtotale)

Per creare un titolo di sezione che attiva un subtotale, aggiungi una riga con:

• Descrizione formattata come titolo HTML (<h1>, <h2>, <h3> o <h4>)
• Quantità = 0

Nel PDF, vengono visualizzati solo la descrizione e il subtotale della sezione. Le altre colonne (prezzo unitario, IVA, ecc.) sono nascoste.

2. Righe di commento

Per aggiungere una nota o un paragrafo esplicativo libero, aggiungi una riga con:

• Descrizione formattata come divisione HTML (<div>)
• Quantità = 0

Solo la descrizione viene mostrata nel PDF, senza tabella prezzi.

3. Righe di abbonamento

Qualsiasi riga il cui riferimento o etichetta contiene abo (non case-sensitive) viene automaticamente classificata come abbonamento e alimenta il riquadro "Totale Abbonamento" in basso a sinistra del PDF.

Esempi che attivano il rilevamento: SE-ABO-Hosting, Abbonamento manutenzione, MO-ABO-G1, Sottoscrizione abo annuale...

4. Righe normali

Qualsiasi altra riga (descrizione in testo semplice, quantità > 0) è considerata una tantum e appare nel subtotale Una tantum e nel totale globale Prestazioni + materiali.

⚠️ Prerequisito importante

La modalità di pagamento deve essere indicata sul preventivo, altrimenti i riquadri dei totali in fondo al PDF non si allineano correttamente (problema di layout). È un campo standard Dolibarr che compili comunque di solito — basta non lasciarlo vuoto.

Limitazioni

• Un solo livello di subtotali (nessuna gerarchia annidata H1 > H2 > H3). Se metti un H1 seguito da un H2, creano due sezioni separate, non una gerarchia.
• Il rilevamento degli abbonamenti è testuale: la stringa abo deve apparire nel riferimento o nell'etichetta. Nessun campo booleano "è un abbonamento" viene utilizzato.

Casi d'uso tipici

• 🌐 Hosting / SaaS: preventivo che combina spese di attivazione + abbonamento mensile
• 📞 Rivenditore telecom: hardware (telefono, switch) + linea SIM/abbonamento mensile
• 🛠️ Servizi IT / MSP: hardware + manodopera una tantum + contratto di manutenzione mensile
• 🏢 Installatore (allarmi, fotocopiatrici, climatizzazione): installazione + contratto di manutenzione annuale
• 🎨 Agenzia / freelance: progetto una tantum + retainer mensile

Caratteristiche tecniche

• Compatibile con Dolibarr 23.x
• Si installa tramite Configurazione → Moduli → Distribuire un modulo esterno
• Nessuna dipendenza esterna, nessuna modifica al core di Dolibarr
• Coesiste con gli altri modelli PDF (Azur, Crabe, Cyan, ecc.) — puoi tornare a un modello standard in qualsiasi momento
• Architettura fattorizzata: la logica di generazione è condivisa tra le due varianti (mensile/annuale) per facilitare la manutenzione e le evoluzioni future
• Licenza GPL-3.0+

E poi?

Le prossime versioni aggiungeranno: variante trimestrale, configurazione della parola chiave di rilevamento (invece di abo codificato), scelta del numero di livelli di subtotali. I tuoi suggerimenti sono benvenuti.

Altri moduli di Media-Interactive

• 📋 MultiSelect — Azioni di gruppo sulle righe dei preventivi: eliminazione e sconto in massa, con un clic.
• 📧 AutoSendMail — Invio automatico per e-mail delle fatture ricorrenti.
• 🌙 Dark Mode — Tema scuro per Dolibarr. Gratuito, donato alla community.

Tutti i nostri moduli sono sviluppati e mantenuti da Media-Interactive.