UltimateInvoice v24.0

📌 Versione del modulo: 24.0.2 📅 Ultimo aggiornamento: 28/07/2026 👤 Editore/Licenza: Philippe GRAND / Atoo-Net / GNU GPL v3+ 🌍 Lingue dell'interfaccia: 📧 Assistenza: via e-mail all'indirizzo contact@atoo-net.com ✅ Compatibilità Dolibarr: Dolibarr 23.0 e 24.0 ✅ Modulo necessario: Fatture ✅ Versione PHP necessaria: PHP 7.4 o superiore 💡 Aggiornamenti gratuiti per 1 anno all'interno della stessa versione, poi sconto del 50 % sulla versione successiva.

Date alle vostre fatture Dolibarr l'immagine della vostra azienda con UltimateInvoice

Il modulo UltimateInvoice sostituisce il modello PDF nativo di Dolibarr per le fatture con un modello interamente personalizzabile, denominato ultimate_invoice.

Vero coltellino svizzero della fattura PDF, permette di definire la vostra identità grafica (logo, colori, margini, sfondo di pagina, larghezza delle colonne), di decidere con precisione che cosa viene stampato sul documento, di allegare le vostre condizioni generali di vendita o altri file PDF, di aggiungere codici a barre e codici QR e di firmare digitalmente il file generato.

Non serve programmare: tutto si configura dalle pagine di amministrazione del modulo, con anteprime grafiche e maniglie per regolare le larghezze con il mouse.

UltimateInvoice è la versione ridotta del modulo UltimatePDF: copre soltanto le fatture. Per preventivi, ordini, contratti, spedizioni, note spese, interventi, progetti, prodotti/distinte base o documenti fornitore occorre la versione completa UltimatePDF.

🎨 Che cosa potete personalizzare

🧩 Due livelli di configurazione da non confondere

Il modulo si articola attorno a due nozioni distinte:

1. Il Design (scheda Models) definisce l'aspetto del documento: colori, margini, logo, alias azienda, sfondo di pagina, larghezza delle colonne.

2. Le pagine Opzioni e Fatture decidono che cosa viene stampato sul documento: colonne visibili, blocchi indirizzi, menzioni legali, firme stampate.

Possono coesistere più Design. Uno solo è attivo per impostazione predefinita e un selettore posto in alto a destra dell'applicazione permette di passare dall'uno all'altro istantaneamente, senza tornare nella configurazione.

Ogni blocco del modulo di Design ha il proprio pulsante Salva: convalidate blocco per blocco senza perdere quanto inserito negli altri.

🖌️ Personalizzazione grafica (Design)

• Sfondo di pagina: immagine di sfondo o PDF di sfondo, per riutilizzare una carta intestata già impaginata, con regolazione della trasparenza e della posizione X/Y.

• Intestazione: altezza e larghezza del logo, secondo logo per un partner o una certificazione, larghezza del blocco mittente con anteprima trascinabile e preimpostazione per buste con finestra secondo la norma postale francese.

• Alias azienda: mostrate una ragione sociale, un indirizzo, un capitale sociale o una partita IVA diversi da quelli della persona giuridica reale, per un marchio commerciale o una filiale.

• Margini e colonne: margini del PDF e larghezza di ogni colonna della tabella delle righe (riferimento, immagine, data, tipo, progetto, IVA, prezzo unitario, quantità, unità, sconto), ridimensionabili con il mouse su un'anteprima grafica.

• Piè di pagina: dimensione del carattere, altezza riservata al testo libero, colori del testo e dello sfondo.

• Carattere tipografico: scelta del font del documento, con DejaVuSans per i set di caratteri estesi o cirillici.

📄 Contenuto della fattura

Le opzioni si attivano indipendentemente le une dalle altre, con semplici caselle di spunta:

• Colonne delle righe: numerazione, foto del prodotto, prezzo unitario netto, sconto, prezzo unitario dopo sconto, quantità, peso e peso totale, unità.

• Blocchi indirizzi: dati del destinatario, del cliente e del commerciale assegnato, identificativi professionali, partita IVA intracomunitaria, impilamento verticale dei blocchi contatti.

• Impaginazione: intestazione non ripetuta su ogni pagina, segno di piega, testo accanto alla data, formato carta.

• Specifico delle fatture: spedizioni collegate, condizioni di pagamento, fattura di stato avanzamento lavori (SAL), link di pagamento online, esposizione residua del cliente, importo in lettere, riga del totale IVA inclusa, generazione senza la colonna IVA.

• Firme stampate: firma del responsabile sul documento e firma del commerciale assegnato nella nota. Sono immagini aggiunte al PDF, da non confondere con la firma crittografica descritta più avanti.

📎 Unione di PDF e condizioni generali di vendita

🔏 Firma elettronica delle fatture (PAdES)

UltimateInvoice può applicare una firma digitale al PDF al momento della generazione. Garantisce al destinatario l'autenticità del documento (proviene davvero da voi) e la sua integrità (non è stato modificato da allora). Adobe Acrobat Reader la mostra nel pannello Firme e un riquadro di firma visibile viene disegnato in basso a destra dell'ultima pagina.

Questa funzionalità è descritta qui senza ambiguità, affinché il suo perimetro sia chiaro prima dell'acquisto:

Formati di certificato supportati: .pem, .crt, .p12, .pfx. Il file deve contenere il certificato e la chiave privata. Viene memorizzato nella cartella documenti di Dolibarr, fuori dalla cartella web del modulo: non è quindi scaricabile da un browser.

Limitazione importante: l'unione di file aggiuntivi riscrive il PDF dopo la generazione e romperebbe la firma. Su una fattura in cui vengono uniti dei file, la firma viene saltata automaticamente, lasciando un avviso nel registro di Dolibarr, invece di essere generata non valida. L'aggiunta delle CGV, invece, resta compatibile.

🔎 Codici a barre, codici QR e fattura QR svizzera

• Codici a barre dei prodotti (EAN13 con cifra di controllo, CODE128, CODE39) e dei terzi, in alto o in basso nella pagina.

• Codici QR della vostra azienda, dei terzi o della fattura.

• Codice QR di pagamento SEPA (norma EPC069-12) e fattura QR svizzera (Swiss QR-bill), compresa la ricevuta di pagamento completa su una pagina dedicata.

Queste due ultime impostazioni appartengono al core di Dolibarr (Home → Impostazioni → PDF → scheda Specific parameters, sezione Fatture) e non al modulo, che si limita a rispettarle durante la generazione del documento.

Per la ricevuta di pagamento svizzera completa, la modalità di pagamento deve essere il bonifico bancario, un conto bancario deve essere indicato sulla fattura, l'indirizzo della vostra azienda deve essere completo e l'IBAN valido. I QR-IBAN non sono ancora supportati. Questa pagina dedicata richiede PHP 8.1 o superiore.

🧱 Compatibilità con il modulo Milestone

UltimateInvoice riconosce le righe di milestone del modulo Milestone: non vengono trattate come normali righe prodotto nel calcolo del peso di riga e del prezzo unitario dopo sconto, e conservano la propria formattazione nel PDF.

📖 Guida all'uso integrata

Una guida completa in francese e in inglese è consultabile direttamente dalla configurazione del modulo, scheda User guide.

Descrive ogni opzione schermata per schermata, con un unico filo conduttore dall'inizio alla fine: creazione di un Design, regolazione delle opzioni, generazione di una fattura. Viene aggiornata a ogni versione.

⚙️ Prerequisiti

⚙️ Installazione

1. Scaricate l'archivio del modulo (.zip).

2. Collocate l'archivio nella cartella radice di Dolibarr.

3. Decomprimete l'archivio e verificate che il modulo si trovi in htdocs/custom/ultimateinvoice.

4. Attivate il modulo da Home → Impostazioni → Moduli/Applicazioni, scheda Atoo-Net.

5. Selezionate il modello ultimate_invoice nell'elenco a discesa dei modelli di documento della scheda fattura.

🧭 Casi d'uso ricorrenti

• Allineare le fatture alla vostra immagine coordinata: riutilizzare colori, logo e carta intestata esistenti senza commissionare lo sviluppo di un modello PDF su misura.

• Fatturare con un marchio commerciale: usare l'alias azienda per mostrare una ragione sociale o un indirizzo diversi da quelli della persona giuridica.

• Inviare le fatture per posta: usare la preimpostazione per busta con finestra e il segno di piega per una spedizione senza regolazioni manuali.

• Allegare sempre le vostre CGV: aggiungere automaticamente lo stesso documento contrattuale a ogni fattura.

• Facilitare il pagamento: aggiungere un codice QR di pagamento SEPA, oppure la ricevuta di pagamento svizzera per una clientela elvetica.

• Dare fiducia sull'origine del documento: firmare digitalmente le fatture inviate per e-mail affinché il destinatario possa verificare che non siano state modificate.

❓ Domande frequenti

• Qual è la differenza con il modulo UltimatePDF?
  UltimateInvoice è la versione ridotta di UltimatePDF, limitata alle fatture. Se dovete personalizzare anche preventivi, ordini, contratti, spedizioni, note spese, interventi o documenti fornitore, la scelta giusta è UltimatePDF.

• Il modulo modifica il core di Dolibarr?
  No. UltimateInvoice aggiunge un modello di documento supplementare e si appoggia agli hook standard. Il modello PDF nativo resta disponibile: potete tornare indietro in qualsiasi momento selezionandolo di nuovo nella scheda della fattura.

• Posso avere più impaginazioni diverse?
  Sì. Create tutti i Design che volete. Uno solo è attivo per impostazione predefinita e un selettore in alto a destra dell'applicazione permette di passare dall'uno all'altro.

• Servono competenze tecniche?
  No. Tutta la configurazione avviene dalle schermate di amministrazione, con anteprime grafiche. Non c'è alcun file da modificare.

• La firma elettronica ha valore legale?
  Si tratta di una firma di base di tipo PAdES-B-B: attesta l'integrità e l'origine del file, ma non ha il valore probatorio di una firma qualificata eIDAS e non comprende né marca temporale qualificata né archiviazione a lungo termine.

• La firma elettronica sostituisce FatturaPA o Factur-X?
  No. Sono due argomenti distinti. La firma garantisce l'integrità di un PDF; la fatturazione elettronica richiede un formato strutturato (FatturaPA, Factur-X, PDF/A-3) che UltimateInvoice non genera.

• Dove viene memorizzata la password della chiave privata?
  Nella tabella delle costanti di Dolibarr (llx_const), in chiaro, poiché Dolibarr non dispone di una cassaforte di segreti nativa. Limitate di conseguenza l'accesso al database. Il file del certificato si trova fuori dalla cartella web del modulo, ma resta leggibile dal server web: applicate autorizzazioni restrittive a quella cartella.

• Perché la mia fattura non è firmata?
  Il caso più frequente è l'unione di file aggiuntivi su quella fattura: le due funzioni si escludono a vicenda e la firma viene deliberatamente saltata, con un avviso nel registro di Dolibarr.

• Il codice QR di pagamento è generato dal modulo?
  Il codice QR SEPA e la fattura QR svizzera sono impostazioni del core di Dolibarr, in Impostazioni → PDF → Specific parameters. UltimateInvoice le rispetta durante la generazione del documento.

• È compatibile con le milestone del modulo Milestone?
  Sì. Le righe di milestone vengono riconosciute e conservano la propria formattazione nel PDF.

• Le mie fatture precedenti vengono modificate?
  No. Solo i documenti rigenerati dopo la selezione del modello usano la nuova impaginazione. I PDF già emessi restano intatti.

Perché usare UltimateInvoice?

• Ottenere fatture con la vostra immagine senza commissionare lo sviluppo di un modello PDF su misura

• Regolare l'impaginazione da schermate di amministrazione, con anteprime e ridimensionamento con il mouse

• Creare più Design e passare dall'uno all'altro con un clic

• Riutilizzare una carta intestata esistente come sfondo di pagina, in immagine o in PDF

• Fatturare con un marchio commerciale grazie all'alias azienda

• Scegliere con precisione quali colonne e quali blocchi vengono stampati sul documento

• Allegare automaticamente le vostre CGV e altri file PDF

• Aggiungere codici a barre, codici QR, codice QR SEPA e fattura QR svizzera

• Firmare digitalmente le fatture inviate per e-mail

• Mantenere disponibile in ogni momento il modello nativo di Dolibarr

⚠️ Raccomandazione importante

Come per qualsiasi modulo che modifica l'aspetto dei documenti commerciali, provate UltimateInvoice su un'istanza di test prima di usarlo in produzione.

Prima di iniziare, eseguite un backup completo di:

• Il database di Dolibarr

• La cartella documenti di Dolibarr

Una volta configurato, generate una fattura breve e una fattura lunga su più pagine, e verificate i blocchi indirizzi, i totali, il piè di pagina e l'assenza di pagine bianche prima di generalizzare il modello.

📖 Documentazione

La documentazione completa del modulo è disponibile sul wiki ufficiale di Dolibarr:

👉 Wiki Dolibarr – Modulo UltimateInvoice (IT)

Documentazione in altre lingue:

👉 Wiki Dolibarr – Modulo UltimateInvoice (FR)

👉 Wiki Dolibarr – Modulo UltimateInvoice (EN)

👉 Wiki Dolibarr – Modulo UltimateInvoice (DE)

👉 Wiki Dolibarr – Modulo UltimateInvoice (ES)

Il modulo integra inoltre una guida all'uso completa, nella scheda User guide della sua pagina di configurazione.

Altri moduli