Una guida completa per il 2026 su come adattare le fatture all'identità aziendale.

Dolibarr ERP & CRM è una delle soluzioni di gestione aziendale open-source più diffuse al mondo. Che tu sia una microimpresa, una piccola o media impresa (PMI), un'organizzazione no-profit o un libero professionista, Dolibarr ti permette di gestire l'intera attività da un'unica interfaccia: preventivi, fatture, ordini, inventario, contabilità, gestione dei contatti e molto altro. Tuttavia, uno degli elementi più visibili per i tuoi clienti rimane la fattura . Una fattura ben progettata e chiara, in linea con l'identità del tuo marchio, migliora significativamente la credibilità della tua azienda e l'esperienza del cliente.

In questo articolo dettagliato, scoprirai passo dopo passo come personalizzare i modelli di fattura in Dolibarr . Tratteremo i modelli nativi, l'aggiunta del tuo logo, la modifica di colori e caratteri, la creazione di modelli PDF personalizzati tramite ODT, l'utilizzo del modulo Customreports e persino tecniche di sviluppo avanzate per creare un modello completamente personalizzato. Questa guida è adatta sia ai principianti che agli utenti esperti che desiderano approfondire l'argomento.

Riassunto dell'articolo

•      Perché personalizzare le fatture in Dolibarr?

•      Comprendere i modelli di fattura nativi di Dolibarr

•      Configurazione iniziale prima della personalizzazione

•      Personalizza i modelli PDF predefiniti (Granchio, Spugna, Eratostene)

•      Crea un modello di fattura personalizzato utilizzando un file ODT

•      Modifica i colori, i caratteri e il logo delle tue fatture.

•      Personalizzazione avanzata: crea il tuo modello PHP

•      Gestisci le note legali e le condizioni di pagamento

•      Le migliori pratiche SEO e UX per le tue fatture

•      Errori comuni da evitare

•      Conclusioni e prossimi passi

1. Perché personalizzare le fatture in Dolibarr?

Una fattura è molto più di un semplice documento contabile. È un potente strumento di comunicazione tra la tua azienda e i tuoi clienti. Una fattura personalizzata trasmette un'immagine professionale, rafforza il tuo marchio e semplifica la comprensione per i tuoi clienti. Ecco i principali motivi per cui dovresti dedicare del tempo alla personalizzazione delle tue fatture Dolibarr:

Rafforza l'immagine del tuo marchio

Quando i vostri clienti ricevono una fattura, non vedono solo un importo da pagare. Percepiscono l'identità della vostra azienda: colori, logo, tipografia e tono. Una fattura neutra e generica può dare l'impressione di una mancanza di professionalità, mentre una fattura che riporta i colori del vostro marchio instaura immediatamente un rapporto di fiducia.

Migliorare l'esperienza del cliente

Una fattura ben strutturata, con informazioni chiare su prodotti, sconti, IVA e condizioni di pagamento, riduce significativamente le domande dei clienti. Ciò diminuisce il numero di chiamate all'ufficio contabilità e velocizza i pagamenti.

Rispettare gli obblighi di legge

In Francia, Belgio, Marocco, Canada e Svizzera, le informazioni obbligatorie da riportare in fattura variano. Personalizzando i modelli, è possibile integrare automaticamente il numero SIRET, il numero di partita IVA intracomunitaria, l'ICE (Identificativo Commerciale Comune in Marocco), le condizioni generali di vendita e le penali per ritardato pagamento, senza doverle aggiungere manualmente a ogni singola fattura.

Risparmia tempo ogni giorno

Una volta configurato alla perfezione il tuo template, non dovrai più preoccuparti della formattazione. Ogni fattura emessa da Dolibarr rispetterà automaticamente le linee guida del tuo marchio. Si tratta di un investimento iniziale che si ripaga rapidamente, soprattutto se emetti decine di fatture al mese.

2. Comprendere i modelli di fattura nativi di Dolibarr

Prima di personalizzare qualsiasi elemento, è fondamentale capire quali modelli sono offerti nativamente da Dolibarr. Quando si installa Dolibarr, diversi modelli PDF sono già disponibili nel modulo Fatture. Ecco i principali:

Il modello del granchio

Questo è il template predefinito di Dolibarr e probabilmente il più utilizzato. Offre un layout classico e pulito, con un'intestazione contenente le informazioni aziendali, un blocco per i destinatari sulla destra, una tabella centrale che elenca prodotti o servizi e un piè di pagina con totali e condizioni di pagamento. È compatibile con la maggior parte delle esigenze comuni.

Il modello Spugna

Più moderno di Crabe, questo template offre un layout leggermente più spazioso. È particolarmente adatto alle aziende di servizi che desiderano una fattura chiara e di facile lettura. Include anche opzioni per mostrare o nascondere determinati elementi, come sconti o riferimenti ai prodotti.

Il modello di Eratostene

Questo modello è più compatto e ideale per le aziende che emettono fatture con molte righe. Ottimizza lo spazio per inserire più informazioni su un'unica pagina, riducendo così il numero di fogli stampati.

Il modello del polpo

Il nuovo modello Octopus è stato progettato per soddisfare le esigenze moderne e offre un look più contemporaneo. Include di default un supporto migliorato per i codici QR per i pagamenti bancari ed è particolarmente adatto alle aziende con un forte orientamento al digitale.

3. Configurazione iniziale prima della personalizzazione

Prima di iniziare la personalizzazione vera e propria, è necessario assicurarsi che le informazioni di base della propria azienda siano inserite correttamente in Dolibarr. Queste informazioni appariranno automaticamente su tutte le fatture.

Passaggio 1: Inserire le informazioni aziendali

Accedi a Dolibarr con un account amministratore. Vai su Configurazione > Azienda/Organizzazione. Compila attentamente tutti i campi: ragione sociale, indirizzo completo, codice postale, città, paese, telefono, email, sito web, numero SIRET, codice APE, partita IVA intracomunitaria, capitale sociale, forma giuridica, ecc.

Passaggio 2: carica il tuo logo

Sempre nella pagina Azienda/Organizzazione, troverai un campo per caricare il tuo logo. Per ottenere risultati ottimali, utilizza un file PNG trasparente. La dimensione consigliata è di circa 300 pixel di larghezza per una qualità di stampa ottimale. Evita loghi eccessivamente grandi, poiché potrebbero rallentare la generazione del PDF.

Passaggio 3: Configurare valute e lingua

Vai su Impostazioni > Varie e verifica che la valuta predefinita corrisponda alla tua attività (EUR, MAD, USD, CHF, CAD, ecc.). Configura anche la lingua predefinita. Dolibarr supporta oltre 70 lingue e, se lavori a livello internazionale, puoi generare fatture nella lingua del tuo cliente.

Passaggio 4: Attivare il modulo Fatture

Se non l'hai ancora fatto, vai su Impostazioni > Moduli e attiva il modulo Fatture. Senza questo modulo, non potrai creare o personalizzare le fatture. Una volta attivato, un nuovo menu Fatturazione apparirà nella dashboard principale.

4. Personalizza i modelli PDF integrati

Dolibarr permette la personalizzazione direttamente dall'interfaccia di amministrazione, senza dover modificare il codice. Ecco come fare.

Accedere alle impostazioni del modulo Fatture

Vai su Configurazione > Moduli > Moduli standard > Gestione finanziaria > Fatture. Fai clic sull'icona a forma di ingranaggio a destra della riga Fatture per accedere alle impostazioni dettagliate.

Abilita o disabilita i modelli

Nella sezione Modelli di documento, troverai un elenco di modelli disponibili (Granchio, Spugna, Eratostene, Polpo). Puoi attivare più modelli contemporaneamente e scegliere quale utilizzare per generare ogni fattura. Per impostare un modello predefinito, fai clic sulla stella accanto al modello desiderato.

Modifica le opzioni di visualizzazione

Per ogni modello attivato, è possibile configurare diverse opzioni facendo clic sull'icona di anteprima o sulle impostazioni. Ad esempio, è possibile scegliere se visualizzare o meno sconti, riferimenti interni ai prodotti, codici a barre, immagini dei prodotti o testo personalizzato nel piè di pagina.

Personalizza intestazioni e piè di pagina

Vai su Impostazioni > PDF e moduli per configurare le intestazioni e i piè di pagina comuni a tutti i tuoi modelli. Qui puoi definire testi personalizzati che appariranno su tutte le tue fatture, come uno slogan, i dati bancari (IBAN, BIC), un'informativa GDPR o informazioni legali obbligatorie.

5. Creare un modello di fattura personalizzato utilizzando un file ODT

Questo è probabilmente il metodo più efficace per personalizzare le fatture senza dover modificare il codice PHP. Dolibarr permette di utilizzare file ODT (OpenDocument Text), creati con LibreOffice o OpenOffice, come modelli dinamici.

Passaggio 1: Attivare il modulo ODT

Vai su Configurazione > Moduli e attiva il modulo Modelli di documenti ODT/ODS per fatture. Questo modulo consente a Dolibarr di generare fatture da file ODT anziché da modelli PDF nativi.

Passaggio 2: Scarica un modello ODT di base

Dolibarr mette a disposizione modelli ODT dimostrativi che è possibile scaricare e personalizzare. Questi modelli si trovano solitamente nella cartella documents/doctemplates/invoices/ dell'installazione di Dolibarr. Scarica uno di questi modelli sul tuo computer per modificarlo.

Passaggio 3: Modificare il file ODT con LibreOffice

Apri il file ODT con LibreOffice Writer. Noterai che il modello contiene variabili racchiuse tra parentesi quadre, come [company_name], [invoice_ref], [invoice_date], [customer_name], [line_desc], [line_qty], [line_price], [total_ht], [total_tva], [total_ttc], ecc. Queste variabili verranno automaticamente sostituite da Dolibarr durante la generazione.

È possibile modificare liberamente la formattazione: cambiare i caratteri, i colori, aggiungere immagini, creare tabelle personalizzate, inserire il proprio logo, modificare il layout dei blocchi, ecc. L'importante è non modificare i nomi delle variabili all'interno delle parentesi, altrimenti non verranno riconosciute.

Passaggio 4: Importa il modello in Dolibarr

Una volta pronto il tuo modello ODT, accedi a Dolibarr e vai su Configurazione > Moduli > Fatture > Impostazioni. Nella sezione Modelli ODT, puoi caricare il tuo nuovo file ODT. Sarà quindi disponibile nell'elenco dei modelli quando genererai una fattura.

Passaggio 5: Testa il tuo nuovo modello

Crea una fattura di prova e generala utilizzando il tuo nuovo modello ODT. Verifica che tutte le variabili siano state sostituite correttamente e che la formattazione corrisponda alle tue aspettative. Ripeti il processo tra LibreOffice e Dolibarr finché non ottieni il risultato perfetto.

6. Modifica i colori, i caratteri e il logo delle tue fatture

La personalizzazione visiva è uno degli aspetti più importanti per allineare le fatture alle linee guida del tuo marchio. Ecco come padroneggiare questi elementi.

Cambia il logo

Il logo si modifica principalmente tramite Impostazioni > Azienda/Organizzazione. Tuttavia, alcuni modelli consentono di utilizzare un logo diverso per le fatture rispetto al logo aziendale generale. Per farlo, vai su Impostazioni > PDF e inserisci il tuo logo specifico nella cartella designata. Per una stampa di alta qualità, utilizza il formato PNG con sfondo trasparente e una risoluzione di almeno 300 DPI.

Cambiare i colori

I colori dei modelli nativi non possono essere modificati direttamente dall'interfaccia utente. Per cambiarli, hai due opzioni. La prima è utilizzare un modello ODT personalizzato e definire i colori al suo interno tramite LibreOffice. La seconda è modificare direttamente il codice PHP del modello, operazione che richiede competenze tecniche.

Se si sceglie di modificare la versione PHP, aprire il file pdf_crabe.modules.php che si trova in htdocs/core/modules/factor/doc/. Cercare le variabili di colore, solitamente definite in esadecimale o RGB. Modificarle in modo che corrispondano ai codici colore del proprio marchio. Nota: queste modifiche verranno sovrascritte durante un aggiornamento di Dolibarr. Pertanto, è consigliabile duplicare il file con un nuovo nome per creare un modello personalizzato.

Cambia i caratteri

I font utilizzati nei modelli PDF nativi sono definiti nel codice sorgente. Per modificarli, è possibile scegliere tra il metodo ODT (che supporta qualsiasi font installato sul server) e il metodo PHP. Il metodo ODT è notevolmente più semplice. Per quanto riguarda il metodo PHP, si noti che Dolibarr utilizza la libreria TCPDF per generare i PDF, e questa libreria include solo alcuni font standard. Se si desidera utilizzare un font personalizzato, sarà necessario aggiungerlo alla directory TCPDF e dichiararlo esplicitamente.

Regola le dimensioni e il layout del logo

Le dimensioni del logo sulla fattura possono essere regolate. In Impostazioni > PDF, di solito si trovano le opzioni per impostare l'altezza massima del logo in pixel. Se è necessario un controllo più preciso, è possibile modificare le impostazioni direttamente nel codice PHP oppure utilizzare un modello ODT in cui le dimensioni dell'immagine sono controllate da LibreOffice.

7. Personalizzazione avanzata: crea il tuo modello PHP

Per gli utenti con competenze tecniche in PHP, la creazione di un modello di fattura completamente personalizzato rappresenta la soluzione ideale. Questo metodo offre completa libertà su tutti gli aspetti del documento generato.

Comprendere la struttura di un modello PDF di Dolibarr

Ogni modello PDF è un file PHP che eredita dalla classe ModelePDFFactures. Questo file contiene i metodi necessari per generare il documento: inizializzazione del PDF, aggiunta dell'intestazione, generazione del corpo con le righe dei prodotti, calcolo dei totali, aggiunta del piè di pagina e finalizzazione.

Passaggio 1: Duplicare un modello esistente

Il modo più rapido per creare un template personalizzato è copiare un template esistente, ad esempio pdf_crabe.modules.php, e rinominarlo, ad esempio, pdf_monentreprise.modules.php. Posiziona il nuovo file nella cartella htdocs/core/modules/factu/doc/. Successivamente, modifica il nome della classe all'interno del file in modo che corrisponda al nuovo nome.

Passaggio 2: Personalizzare i metodi

Modifica i vari metodi presenti nel file per personalizzare il rendering. I metodi più importanti sono _pagehead (intestazione di pagina), _tableau (tabella dei prodotti), _tableau_info (informazioni su totali e condizioni) e _pagefoot (piè di pagina). Puoi integrare immagini, colori specifici, diversi font e persino elementi dinamici basati sui dati del cliente o del prodotto.

Passaggio 3: Attiva il tuo template in Dolibarr

Una volta creato il modello, vai su Configurazione > Moduli > Fatture > Impostazioni. Il nuovo modello dovrebbe apparire automaticamente nell'elenco. Attivalo selezionando la casella di controllo corrispondente e, se lo desideri, impostalo come modello predefinito.

Passaggio 4: Test e debug

Crea una fattura e generala utilizzando il tuo nuovo modello. Se riscontri degli errori, abilita la modalità di debug di Dolibarr in Configurazione > Sicurezza per visualizzare i messaggi di errore dettagliati. Puoi anche utilizzare le funzioni di logging di PHP per tracciare il processo di generazione.

Migliori pratiche per lo sviluppo di modelli

•      Per evitare di reinventare la ruota, è sempre meglio iniziare copiando un modello esistente.

•      Utilizza Git per gestire le versioni del tuo modello e tenere traccia delle modifiche.

•      Esegui test con diversi set di dati: fatture a riga singola, a più pagine, con sconti, con diverse aliquote IVA.

•      Documenta il tuo codice per facilitare la manutenzione futura.

•      Eseguite un backup del vostro template prima di ogni aggiornamento di Dolibarr, poiché i file personalizzati potrebbero essere interessati.

8. Gestire le note legali e le condizioni di pagamento

Una fattura commerciale deve includere determinate informazioni obbligatorie a seconda del Paese e del tipo di attività svolta. Dolibarr consente di gestire queste informazioni in modo centralizzato.

Informazioni obbligatorie in Francia

In Francia, ogni fattura deve includere almeno: la ragione sociale del venditore e dell'acquirente, i rispettivi indirizzi, il numero SIRET, il numero di partita IVA intracomunitaria (se applicabile), la data di emissione, il numero di fattura, la descrizione precisa dei prodotti o servizi, le quantità e i prezzi unitari IVA esclusa, l'aliquota e l'importo dell'IVA, il totale IVA esclusa e IVA inclusa, le condizioni di pagamento, la data di scadenza, l'importo delle penali per ritardato pagamento e la franchigia fissa di 40 euro per le spese di recupero.

Informazioni obbligatorie in Marocco

In Marocco, le fatture devono contenere: il codice fiscale (IF), il codice identificativo univoco dell'azienda (ICE), il numero di brevetto, il numero di iscrizione all'albo professionale, il numero CNSS, la ragione sociale, l'indirizzo completo, il numero di fattura, la data e i dettagli dei prodotti o servizi con l'indicazione dell'IVA.

Configura le menzioni nel piè di pagina

Vai su Impostazioni > PDF e moduli. Troverai diversi campi per configurare le informazioni incluse automaticamente in calce a ogni fattura: termini e condizioni, coordinate bancarie, note legali obbligatorie e note specifiche. Queste informazioni appariranno su tutte le tue fatture senza che tu debba inserirle manualmente.

Definire le condizioni di pagamento predefinite

In Configurazione > Moduli > Fatture, è possibile definire le condizioni di pagamento predefinite: al ricevimento, 30 giorni a fine mese, 60 giorni netti, ecc. Queste condizioni saranno preselezionate al momento della creazione di una nuova fattura, facendovi risparmiare tempo prezioso.

9. Le migliori pratiche SEO e UX per le tue fatture

Potresti chiederti cosa c'entri la SEO con una fattura. In realtà, se le tue fatture sono accessibili online tramite un portale clienti o se vengono indicizzate da un motore di ricerca interno, è possibile applicare diversi principi di UX e SEO.

Assegna un nome corretto ai tuoi file PDF.

Configura Dolibarr per generare nomi di file descrittivi come Fattura-2026-001-NomeCliente.pdf invece di fact_xxx.pdf. In questo modo, i tuoi clienti troveranno più facilmente i file e l'organizzazione dei documenti sarà migliorata.

Ottimizzare la leggibilità

Utilizza un carattere leggibile, di almeno 10 punti per il corpo del testo e da 14 a 18 punti per i titoli. Opta per caratteri sans-serif come Arial, Helvetica o Open Sans per una migliore leggibilità sullo schermo. Limita l'uso di colori vivaci, che possono affaticare la vista.

Strutturare le informazioni

Organizza le informazioni in modo gerarchico: le informazioni più importanti in alto (numero di fattura, data, importo totale dovuto), i dettagli al centro (articoli di prodotto) e le informazioni secondarie in basso (note legali, coordinate bancarie). Utilizza separatori visivi come linee orizzontali o variazioni di colore di sfondo per differenziare le sezioni.

Includi un codice QR per il pagamento

Per facilitare i pagamenti, è possibile integrare un codice QR SEPA (codice QR EPC) o un link a un portale di pagamento online. Sempre più template Dolibarr, come Octopus, integrano nativamente questa funzionalità. I vostri clienti potranno quindi pagare semplicemente scansionando il codice con la propria applicazione bancaria.

Adotta un design responsivo per la visualizzazione su dispositivi mobili.

Sebbene i PDF non siano intrinsecamente adattabili allo schermo, è possibile ottimizzarne la leggibilità su dispositivi mobili utilizzando un carattere leggibile, margini sufficienti ed evitando tabelle eccessivamente larghe. Se i vostri clienti visualizzano spesso le fatture su smartphone, considerate un formato verticale con sezioni compatte.

10. Errori comuni da evitare

Quando si personalizzano i modelli di fattura in Dolibarr, si incontrano spesso alcuni errori comuni. Ecco i principali da evitare.

Modifica direttamente i file principali di Dolibarr

L'errore più comune è quello di modificare direttamente i file modello nativi come pdf_crabe.modules.php. Queste modifiche verranno sovrascritte al successivo aggiornamento di Dolibarr. È sempre consigliabile duplicare il file con un nuovo nome prima di modificarlo.

Dimenticare di testare in diversi scenari

Testare il tuo modello con una semplice fattura di una sola riga non è sufficiente. Considera di testarlo con fatture più lunghe e multipagina, con sconti, con diverse aliquote IVA, con prodotti che includono immagini e così via. Spesso, in questi casi specifici, scoprirai bug o problemi di formattazione.

Utilizzo di un logo di scarsa qualità

Un logo pixelato dà una cattiva impressione della tua azienda. Utilizza sempre un logo ad alta risoluzione, idealmente vettoriale o con almeno 300 DPI. Evita file JPG di bassa qualità o eccessivamente compressi.

Sovraccaricare la bolletta dell'informazione

Inserire troppe informazioni in una fattura la rende illeggibile. Concentrati sull'essenziale: le informazioni legali obbligatorie, i dettagli dei prodotti o servizi, l'importo totale e le condizioni di pagamento. Informazioni di marketing o lunghi paragrafi promozionali non hanno posto in una fattura.

Trascurare i backup prima di apportare modifiche

Prima di apportare qualsiasi modifica al tuo template, soprattutto tramite codice PHP, crea un backup completo della cartella e del database di Dolibarr. Questo ti permetterà di ripristinare lo stato precedente in caso di problemi.

Non addestrare l'utente

Se nella tua azienda diverse persone utilizzano Dolibarr, formale sull'uso dei modelli personalizzati. Spiega come cambiare modello durante la generazione, come verificare le informazioni e come evitare gli errori più comuni.

11. Conclusioni e prossimi passi

Personalizzare i modelli di fattura in Dolibarr è un investimento che si ripaga rapidamente. Una fattura ben progettata rafforza l'immagine del tuo marchio, migliora l'esperienza dei tuoi clienti, ti aiuta a rispettare gli obblighi di legge e ti fa risparmiare tempo prezioso ogni giorno.

Che tu scelga una semplice personalizzazione tramite le impostazioni native, l'utilizzo di modelli ODT o lo sviluppo di un modello PHP completamente personalizzato, l'importante è iniziare. Puoi cominciare con una personalizzazione di base (logo e informazioni aziendali) e far evolvere il tuo modello nel tempo in base al feedback dei clienti e alle esigenze della tua attività.

Per approfondire l'argomento, consigliamo di consultare la documentazione ufficiale di Dolibarr, partecipare alla community francofona sul forum ufficiale ed esplorare il Dolistore, che offre numerosi moduli aggiuntivi per estendere le funzionalità di Dolibarr. Se la personalizzazione avanzata supera le vostre competenze tecniche, non esitate a contattare un integratore Dolibarr certificato che potrà progettare un template perfettamente su misura per la vostra attività.

In definitiva, Dolibarr offre una notevole flessibilità nella personalizzazione delle fatture. Questo è uno dei principali vantaggi di questa soluzione open-source: hai il controllo completo sull'aspetto e sul contenuto dei tuoi documenti aziendali, senza dover dipendere da un editor di terze parti o pagare canoni ricorrenti per funzionalità di base. Approfitta di questa possibilità per creare fatture che riflettano appieno l'identità e i valori della tua azienda.

─── Fine dell'articolo ───

Se hai trovato utile questo articolo, condividilo con altri utenti di Dolibarr!