Ultimatepropale

📌 Versione del modulo: 24.0.0 📅 Ultimo aggiornamento: 07/10/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 24 ✅ Modulo necessario: Proposte commerciali ✅ Versione PHP necessaria: PHP 8.2 o superiore 💡 Aggiornamenti gratuiti per 1 anno all'interno della stessa versione, poi sconto del 50 % sulla versione successiva.

Date ai vostri preventivi Dolibarr l'aspetto della vostra azienda con UltimatePropale

Il modulo UltimatePropale sostituisce il modello PDF nativo di Dolibarr per le proposte commerciali (preventivi) con un modello completamente personalizzabile: ultimatepropale_propal.

Consente di definire la vostra identità grafica (logo, colori, margini, sfondo di pagina, larghezze delle colonne), di scegliere con precisione cosa compare sul preventivo, di allegare le vostre condizioni generali di vendita o PDF aggiuntivi, di aggiungere codici a barre e codici QR e di farlo firmare online dal vostro cliente.

Non serve alcuna riga di codice: tutto si configura dalle schermate di amministrazione del modulo, con anteprime grafiche e maniglie di ridimensionamento con il mouse.

UltimatePropale è l'edizione del modulo UltimatePDF dedicata ai preventivi. Per ordini e fatture, vedere UltimatepdfLight o UltimateInvoice. Per contratti, spedizioni, documenti di trasporto, note spese, interventi, progetti, prodotti/distinte base o documenti fornitori, è necessaria la versione completa UltimatePDF.

🎨 Cosa potete personalizzare

🧩 Due livelli di configurazione da non confondere

Il modulo si basa su due nozioni distinte:

1. Il Design (scheda Modelli) definisce che aspetto ha il preventivo: colori, margini, logo, alias società, sfondo di pagina, larghezze delle colonne.

2. Le pagine Opzioni e Preventivi decidono cosa compare sul preventivo: colonne visibili, blocchi di indirizzo, diciture legali, blocco di accettazione, firme stampate.

Possono coesistere più Design. Solo uno è attivo per impostazione predefinita, e un selettore in alto a destra dell'applicazione consente di cambiarlo all'istante, senza tornare alla configurazione.

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

🖌️ Personalizzazione grafica (Design)

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

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

• Alias società: stampate una ragione sociale, un indirizzo, un capitale o una partita IVA diversi dall'entità giuridica reale, per un marchio commerciale o una controllata.

• Icone vettoriali: le icone telefono, cellulare, fax, e-mail e sito web dei blocchi di indirizzo sono icone Font Awesome, nitide a qualsiasi livello di zoom, con un colore regolabile per Design.

• Margini e colonne: margini del PDF e larghezza di ogni colonna della tabella delle righe (riferimento, immagine, 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: scelta del carattere del documento, con DejaVuSans per set di caratteri estesi o cirillici.

• Esportazione / importazione: ogni Design si esporta in un file JSON e si importa sullo stesso Dolibarr o su un altro, anche un Design esportato da UltimatePDF, UltimatepdfLight o UltimateInvoice. Il Design importato viene creato disattivato e rinominato se la sua etichetta esiste già: nulla viene sovrascritto.

• Anteprima PDF reale: un pulsante del modulo genera il PDF del preventivo più recente con le impostazioni in corso di inserimento, senza salvarle. I blocchi del modulo si chiudono a fisarmonica.

📄 Contenuto del preventivo

Le opzioni si attivano indipendentemente le une dalle altre, con una semplice casella di controllo:

📎 Unione di PDF e condizioni generali di vendita

📑 Pagine di presentazione e firma online

Il preventivo può aprirsi con una vera presentazione commerciale ed essere poi firmato dal cliente da una pagina web, senza stampa né scansione.

🔎 Codici a barre e codici QR

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

• Codici QR della società (MyCompany) o del soggetto terzo. In cima al preventivo è consentito un solo codice QR alla volta, per evitare sovrapposizioni.

🧱 Compatibilità con il modulo Milestone

UltimatePropale riconosce le righe milestone del modulo Milestone: non sono trattate come righe di prodotto classiche nel calcolo del peso della riga e del prezzo unitario dopo lo sconto, e mantengono la propria formattazione nel PDF.

📖 Guida d'uso integrata

Una guida completa in francese, inglese, tedesco, spagnolo e italiano è consultabile direttamente dalla configurazione del modulo, scheda Guida utente, nella lingua dell'interfaccia.

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

⚙️ Prerequisiti

⚙️ Installazione

Lo zip del modulo pesa circa 1,5 MB: rientra nel limite di caricamento di 2 MB applicato per impostazione predefinita da Dolibarr e da PHP, ma un'installazione più restrittiva può rifiutarlo. Sono possibili tre metodi, dal più semplice al più tecnico.

Metodo 1: installazione dall'interfaccia di Dolibarr

1. Home → Impostazioni → Moduli/Applicazioni, scheda Distribuisci/installa un modulo esterno.

2. Scegliere il file .zip del modulo e cliccare su Invia file.

Se Dolibarr risponde «Il file è troppo grande o non è stato fornito», uno dei tre limiti seguenti è troppo basso (prevale il più piccolo):

I valori in vigore compaiono passando il mouse sull'icona informativa a destra del pulsante Invia file, e in Home → Strumenti di amministrazione → Informazioni PHP. Dopo aver modificato il php.ini, riavviate il server web o PHP-FPM se il fornitore non lo fa. Su un hosting condiviso questi limiti non sono sempre modificabili: usate allora il metodo 2 o 3.

Metodo 2: installazione manuale sul server (SSH)

1. Copiare lo zip sul server ed estrarlo: unzip module_ultimatepropale-X.Y.Z.zip -d /tmp/ultimatepropale_zip

2. Copiare la cartella del modulo: cp -r /tmp/ultimatepropale_zip/htdocs/ultimatepropale /percorso/di/dolibarr/htdocs/custom/

3. Assegnare i permessi al server web se necessario: chown -R www-data:www-data /percorso/di/dolibarr/htdocs/custom/ultimatepropale

4. Verificare che il modulo si trovi in htdocs/custom/ultimatepropale (e non in htdocs/custom/htdocs/ultimatepropale).

Metodo 3: caricamento via FTP / SFTP (ultima risorsa)

1. Estrarre lo zip sul proprio computer: contiene una cartella htdocs, che a sua volta contiene la cartella ultimatepropale.

2. Con un client FTP/SFTP (FileZilla ad esempio), caricare la cartella ultimatepropale (né lo zip, né la cartella htdocs che la contiene) nella directory custom di Dolibarr (quella accanto ad admin, core, conf…; a seconda del fornitore, dentro htdocs, httpdocs, www o public_html).

3. Verificare nel registro del client che nessun file sia fallito e che il percorso …/custom/ultimatepropale/core/modules/modUltimatePropale.class.php esista.

In seguito

1. Attivare il modulo da Home → Impostazioni → Moduli, scheda Atoo-Net.

2. Selezionare il modello ultimatepropale_propal nell'elenco a discesa Modelli della scheda del preventivo.

3. Scegliere ultimatepropale_propal come modello predefinito in Home → Impostazioni → Moduli → Proposte commerciali (colonna Predefinito): è quello usato dalla convalida e dalle azioni di massa. Il vecchio modello ultimate_propal scompare con UltimatePDF.

🧭 Casi d'uso tipici

• Allineare i vostri preventivi alla vostra identità grafica: senza far sviluppare un modello PDF su misura.

• Vendere con un marchio commerciale: usare l'alias società per stampare una ragione sociale o un indirizzo diversi dall'entità giuridica.

• Far firmare i vostri preventivi: blocco di accettazione stampato, o area di firma online del cliente.

• Presentare la vostra offerta: aggiungere pagine di presentazione prima del preventivo e seguirne le versioni successive.

• Spedire i preventivi per posta: usare la preimpostazione per buste a finestra e il segno di piegatura.

• Allegare sempre le vostre condizioni di vendita: aggiungere automaticamente il documento contrattuale corretto e le schede tecniche dei prodotti dopo ogni preventivo.

❓ Domande frequenti

• Che differenza c'è con UltimatePDF, UltimatepdfLight e UltimateInvoice?
  UltimatePropale è l'edizione di UltimatePDF limitata ai preventivi. UltimatepdfLight copre preventivi, ordini e fatture, UltimateInvoice solo le fatture. UltimatePDF copre inoltre contratti, spedizioni, note spese, interventi, progetti, prodotti e documenti fornitori.

• Il modulo modifica il nucleo di Dolibarr?
  No. UltimatePropale aggiunge un modello di documento supplementare e si appoggia sugli hook standard. I modelli PDF nativi restano disponibili: potete tornare indietro in qualsiasi momento selezionandoli di nuovo sulla scheda.

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

• Posso riutilizzare un Design di UltimatePDF?
  Sì. Esportatelo in JSON da UltimatePDF, UltimatepdfLight o UltimateInvoice, poi importatelo in UltimatePropale.

• Servono competenze tecniche?
  No. Tutta la configurazione si fa dalle schermate di amministrazione, con anteprime grafiche. Non è necessario modificare alcun file.

• Il modulo è compatibile con le milestone del modulo Milestone?
  Sì. Le righe milestone vengono riconosciute e mantengono la propria formattazione nel PDF.

• I miei preventivi esistenti vengono modificati?
  No. Solo i preventivi rigenerati dopo l'attivazione del modello usano la nuova impaginazione. I PDF già prodotti restano intatti.

• Se aggiungo una copertina, pagine di presentazione e condizioni generali, la firma online finisce nel posto giusto?
  Sì. A ogni generazione, il modello scrive nel PDF il numero della pagina che contiene il riquadro «Per accettazione»; Dolibarr vi appone la firma, qualunque sia il numero di pagine di presentazione e la lunghezza degli allegati. Ricordate solo di rigenerare il PDF dopo ogni modifica del preventivo, prima di inviare il link.

Perché usare UltimatePropale?

• Ottenere preventivi a immagine della vostra azienda senza far sviluppare 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

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

• Vendere con un marchio commerciale grazie all'alias società

• Scegliere con precisione le colonne e i blocchi che compaiono sul preventivo

• Far firmare i vostri preventivi online

• Allegare automaticamente le condizioni di vendita e i PDF aggiuntivi

• Aggiungere codici a barre e codici QR

• Mantenere disponibile in ogni momento il modello nativo di Dolibarr

⚠️ Raccomandazione importante

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

Prima di iniziare, effettuate un backup completo di:

• Il database di Dolibarr

• La directory dei documenti di Dolibarr

Dopo la configurazione, generate un preventivo breve e uno lungo su più pagine, poi controllate i blocchi di indirizzo, 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 UltimatePropale (IT)

Documentazione in altre lingue:

👉 Wiki Dolibarr – Modulo UltimatePropale (FR)

👉 Wiki Dolibarr – Modulo UltimatePropale (EN)

👉 Wiki Dolibarr – Modulo UltimatePropale (DE)

👉 Wiki Dolibarr – Modulo UltimatePropale (ES)

Il modulo integra inoltre una guida d'uso completa, nella scheda Guida utente della sua pagina di configurazione.

Altri moduli