Module UltimatePropale IT

Sommario

Retour index
Documentation développeur

Retour index
Documentation Utilisateur

Informazioni

Module name	UltimatePropale
Editor / Editeur
Download or buy page / Page achat ou téléchargement	External module - www.dolistore.com
Status / Statut / Estado	Stable
Prerequisites / Prérequis	Modulo Proposte commerciali attivato - PHP 8.2 minimo Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore
Last update date / Date mise à jour fiche / Fecha última actualización	2026-10-7
Note / Nota	⬆ Torna al sommario

Funzionalità

UltimatePropale sostituisce il modello PDF nativo delle proposte commerciali (preventivi) di Dolibarr 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 far firmare il preventivo online dal vostro cliente.

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.

Due livelli di configurazione

Il modulo si basa su due nozioni da non confondere:

• Il Design (scheda Modelli) definisce che aspetto ha il preventivo: colori, margini, logo, alias società, sfondo di pagina, larghezze delle colonne. Possono coesistere più Design, solo uno è attivo per impostazione predefinita (costante ULTIMATE_DESIGN), e un selettore in alto a destra dell'applicazione consente di passare dall'uno all'altro all'istante.
• Le pagine Opzioni e Preventivi decidono cosa viene stampato sul preventivo: colonne visibili, blocchi di indirizzo, diciture legali, blocco di accettazione, firme stampate, ecc. Non modificano l'aspetto grafico.

Personalizzazione grafica (Design)

• Sfondo di pagina: immagine di sfondo o PDF di sfondo (carta intestata già impaginata), con trasparenza e posizionamento X/Y.
• Intestazione: altezza e larghezza del logo, secondo logo (partner, certificazione), larghezza del blocco mittente con anteprima trascina e rilascia e preimpostazione busta a finestra secondo la norma postale francese.
• Alias società: stampa sul preventivo una ragione sociale, un indirizzo, un capitale o una partita IVA diversi dall'entità giuridica reale — utile 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), ciascuna ridimensionabile 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 (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à.
• Anteprima PDF reale: un pulsante del modulo genera il PDF del preventivo più recente con le impostazioni in corso di inserimento, senza salvarle.

Ogni blocco del modulo ha il proprio pulsante Salva: confermate blocco per blocco senza perdere quanto inserito negli altri. I blocchi si chiudono a fisarmonica.

Contenuto del preventivo

• Righe: numerazione, foto del prodotto, prezzo unitario IVA esclusa, sconto, prezzo unitario dopo lo sconto, quantità, peso e peso totale, unità, trattini tra le righe, descrizione nascosta per impostazione predefinita.
• Intestazione e indirizzi: dati del destinatario e del cliente, identificativi professionali (SIRET...), partita IVA intracomunitaria, progetto collegato, oggetti collegati, intestazione non ripetuta, testo associato alla data, segno di piegatura.
• Commerciale: dicitura «Pratica seguita da» con nome ed e-mail del commerciale interno che segue il preventivo.
• Specifico dei preventivi: gestione delle versioni, pagine di presentazione aggiuntive prima del preventivo, dicitura di inversione contabile dell'IVA (subappalto nell'edilizia), possibilità di nascondere la data del preventivo, la data di consegna o i riferimenti del cliente.
• Firma: blocco di accettazione, area di firma online del cliente compilata dalla pagina pubblica di firma di Dolibarr, firma del responsabile e del commerciale (immagini).

Unione di PDF e condizioni generali di vendita

• Condizioni generali di vendita: un file viene caricato dalla pagina Opzioni e aggiunto dopo il preventivo, con eventuale preselezione predefinita. Le condizioni vengono aggiunte a ogni generazione, compresa la rigenerazione automatica alla convalida e le azioni di massa.
• File aggiuntivi: dopo aver attivato l'opzione nella pagina Preventivi, uno o più PDF qualsiasi possono essere uniti al preventivo dalla sua scheda, con rinumerazione facoltativa delle pagine.
• PDF dei prodotti: le schede tecniche PDF dei prodotti possono essere aggiunte automaticamente dopo il preventivo.

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 (product_type = 9): 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. Viene aggiornata a ogni versione e descrive ogni opzione.

⬆ Torna al sommario

Prerequisiti

Dolibarr: Versioni supportate:

• 25.x

PHP: versione 8.2 minima, testato fino a PHP 8.5.

Moduli Dolibarr: il modulo Proposte commerciali deve essere attivato.

Moduli incompatibili: UltimatePropale non può essere attivo contemporaneamente a UltimatePDF, UltimatepdfLight o UltimateInvoice.

⚙️ Procedura di installazione

Sono disponibili tre metodi, dal più semplice al più tecnico. Lo zip di UltimatePropale pesa circa 1,5 MB: rientra nei limiti di caricamento predefiniti di Dolibarr e PHP (2 MB), ma un'installazione più restrittiva può rifiutarlo (vedi sotto).

⚙️ Metodo 1: installazione dall'interfaccia di Dolibarr

1. Andate in Home > Impostazioni > Moduli/Applicazioni.
2. Aprite la scheda Trova app/moduli esterni... (distribuzione/installazione di un modulo esterno).
3. Cliccate su Scegli file e selezionate il file .zip del modulo.
4. Cliccate su Upload per avviare l'installazione.
5. Attivate il modulo al termine dell'installazione.

Verificare la dimensione massima di caricamento

Al caricamento dello zip si applicano tre limiti, e vince il più piccolo:

Limite	Dove vederlo / modificarlo	Valore frequente
Limite Dolibarr (MAIN_UPLOAD_DOC)	Home > Impostazioni > Sicurezza, scheda File, «Dimensione massima dei file caricati» (in KB)	2048 KB (valore di installazione di Dolibarr)
upload_max_filesize (PHP)	file php.ini del server	2M (valore predefinito di PHP)
post_max_size (PHP)	file php.ini del server	8M

Come conoscere i valori in vigore:

• Nella pagina di installazione dei moduli esterni, passate il mouse sull'icona informativa a destra del pulsante Upload: Dolibarr mostra il limite Dolibarr e il limite PHP in Kb.
• I parametri PHP sono visibili in Home > Strumenti di amministrazione > Informazioni PHP (pagina admin/system/phpinfo.php): cercate upload_max_filesize e post_max_size.

Se uno dei limiti è inferiore alla dimensione dello zip, Dolibarr rifiuta il file con il messaggio «La dimensione del file è troppo grande o il file non è fornito.».

Come aumentarli:

1. Limite Dolibarr: in Home > Impostazioni > Sicurezza, scheda File, inserite per esempio 10240 (10 MB) e salvate.
2. Limiti PHP: nel php.ini (o nel pannello del vostro hosting: Plesk, cPanel, «Impostazioni PHP»…), impostate per esempio:

upload_max_filesize = 10M
post_max_size = 12M

post_max_size deve restare maggiore o uguale a upload_max_filesize. Riavviate poi il server web o PHP-FPM (inutile presso la maggior parte degli hosting, che applicano subito la modifica) e controllate i nuovi valori in Informazioni PHP.

Su un hosting condiviso i limiti PHP non sono sempre modificabili. In tal caso usate il metodo 2 o 3.

⚙️ Metodo 2: installazione manuale sul server (SSH)

Lo zip contiene una cartella htdocs/ultimatepropale/; è la cartella ultimatepropale che deve finire nella directory custom di Dolibarr.

1. Copiate lo zip sul server, per esempio in /tmp.
2. Decomprimete: unzip module_ultimatepropale-X.Y.Z.zip -d /tmp/ultimatepropale_zip
3. Copiate la cartella del modulo: cp -r /tmp/ultimatepropale_zip/htdocs/ultimatepropale /percorso/di/dolibarr/htdocs/custom/
4. Assegnate la proprietà al server web se necessario, per esempio: chown -R www-data:www-data /percorso/di/dolibarr/htdocs/custom/ultimatepropale
5. Verificate che il modulo si trovi in htdocs/custom/ultimatepropale (e non in htdocs/custom/htdocs/ultimatepropale).
6. Attivate il modulo da Dolibarr.

⚙️ Metodo 3: invio tramite FTP / SFTP (ultima risorsa)

Se non potete né caricare file in Dolibarr né accedere al server in SSH:

1. Decomprimete l'archivio sul vostro computer (clic destro > «Estrai tutto…» su Windows).
2. Aprite la cartella estratta: contiene htdocs, che a sua volta contiene la cartella ultimatepropale.
3. Collegatevi al server con un client FTP/SFTP (per esempio FileZilla), con le credenziali fornite dal vostro hosting.
4. Individuate la directory di Dolibarr: è quella che contiene le cartelle admin, core, conf… e custom. A seconda dell'hosting si chiama htdocs, httpdocs, www o public_html. Se custom non esiste, createla.
5. Inviate la cartella ultimatepropale (non lo zip, né la cartella htdocs che la contiene) dentro custom.
6. Attendete la fine del trasferimento e verificate nel registro del client FTP che nessun file sia fallito: un trasferimento interrotto lascia un modulo incompleto.
7. Verificate che il percorso finale sia …/custom/ultimatepropale/core/modules/modUltimatePropale.class.php.
8. Attivate il modulo da Home > Impostazioni > Moduli/Applicazioni.

Per un aggiornamento via FTP, sostituite la cartella ultimatepropale esistente (dopo averne fatto un backup), poi disattivate e riattivate il modulo per applicare le eventuali modifiche al database. I vostri modelli e le vostre impostazioni, salvati nel database, vengono conservati.

Configurazione

Per utilizzare questo modulo, dovete prima attivarlo. Per farlo, accedete con un account amministratore e andate alla pagina «Home - Impostazioni - Moduli». Il modulo compare nella scheda «Atoo-Net», fate clic su «Attiva». Alla fine della riga del modulo compare un'icona: fateci clic per accedere alle pagine di configurazione specifiche del modulo.

Tutte le pagine di amministrazione del modulo sono protette dal diritto ultimatepropale -> config: solo gli utenti con questo diritto (di solito gli amministratori) possono accedervi. Gli altri utenti vedono semplicemente il modello ultimatepropale_propal nell'elenco a discesa «Modelli» delle schede dei preventivi.

La configurazione è composta da cinque schede: Modelli, Opzioni, Preventivi, Guida utente e Informazioni.

Scheda Modelli (Design)

Qui si crea l'aspetto grafico dei vostri preventivi.

- L'elenco mostra tutti i Design esistenti: etichetta, descrizione, tipo di bordo, colori, stato e badge «Predefinito» per quello attualmente in uso.

- Fate clic su Aggiungi un design per crearne uno nuovo, o sulla matita per modificare un design esistente.

- Compilate blocco per blocco: informazioni del modello e carattere, sfondo di pagina, intestazione e loghi, alias società, blocco centrale, margini e larghezze delle colonne, piè di pagina. Ogni blocco ha il proprio pulsante Salva.

- Un Design disattivato non compare più negli elenchi di selezione. Il «Modello master» e il Design predefinito non possono essere eliminati, per non compromettere mai la generazione dei documenti.

- Esporta questo modello scarica il Design in un file JSON, Importa un modello lo ricrea sullo stesso Dolibarr o su un altro. Il Design importato viene creato disattivato e rinominato se la sua etichetta esiste già.

- Il pulsante Anteprima PDF reale del modulo genera il PDF del preventivo più recente, con il modello ultimatepropale_propal e le impostazioni in corso di inserimento, senza salvarle. Il PDF di questo preventivo viene rigenerato nel frattempo: rigeneratelo dopo aver salvato il Design.

Importante: dopo aver modificato un Design, se il preventivo generato non sembra cambiato, verificate che sia questo Design a portare il badge «Predefinito».

Scheda Opzioni (impostazioni globali)

Queste impostazioni si applicano al preventivo indipendentemente dal Design scelto: loghi, blocchi di indirizzo e identificativi professionali, sfondo di pagina, contenuto delle righe, condizioni generali di vendita, coordinate bancarie, formato della carta.

La maggior parte delle impostazioni sono interruttori on/off applicati immediatamente; il formato della carta e gli identificativi professionali si confermano con un apposito pulsante Salva.

Caricamento delle condizioni generali di vendita

Nel blocco dedicato, selezionate il vostro file PDF di condizioni generali di vendita e caricatelo. Comparirà poi in un elenco a discesa accanto al pulsante Genera della scheda del preventivo e può essere preselezionato per impostazione predefinita.

Scheda Preventivi

La pagina raggruppa le impostazioni proprie del contenuto del preventivo: indirizzi, commerciale, codici a barre e QR, progetto e oggetti collegati, intestazione e impaginazione, colonne delle righe, inversione contabile dell'IVA, opzioni per nascondere elementi, versioni dei preventivi, pagine di presentazione, blocco di accettazione e area di firma online, firme stampate, unione di PDF.

Le sezioni di questa pagina si chiudono a fisarmonica.

Scheda Guida utente

Mostra la guida completa del modulo nella lingua dell'interfaccia (francese, inglese, tedesco, spagnolo o italiano, con il francese come ripiego). È la documentazione di riferimento, più dettagliata di questa pagina.

⬆ Torna al sommario

Utilizzo

- Aprite la scheda del preventivo e, nel blocco Documenti in fondo alla scheda, scegliete il modello ultimatepropale_propal nell'elenco a discesa «Modelli» e fate clic su Genera.

- Modello predefinito: in Home - Impostazioni - Moduli, pagina Proposte commerciali, scegliete ultimatepropale_propal come modello predefinito. È quello utilizzato dalla convalida del preventivo, dalle azioni di massa e dagli altri moduli. Il vecchio modello ultimate_propal di Ultimatepdf scompare una volta disattivato quel modulo.

- Il PDF compare nell'elenco dei file allegati: può essere scaricato, visualizzato in anteprima o inviato per e-mail.

- Cambiare rapidamente Design: utilizzate il selettore nel menu in alto a destra dell'applicazione, senza tornare alla configurazione completa.

- Aggiungere le condizioni generali di vendita: selezionate il file nell'elenco a discesa accanto al pulsante Genera.

- Unire un PDF aggiuntivo: dopo aver attivato l'opzione nella pagina Preventivi, selezionate dalla scheda il file o i file da unire.

- Far firmare il preventivo online: attivate l'area di firma elettronica nella pagina Preventivi, poi inviate al cliente il link alla pagina pubblica di firma di Dolibarr. La sua firma viene apposta nel riquadro previsto.

Pagine di presentazione e firma online

Pagine di presentazione e copertina

Attivate Aggiungere una pagina di presentazione prima del preventivo (ULTIMATE_PDF_PROPAL_ADD_NEW_PRESENTATION_PAGES) nella pagina Preventivi del modulo. Il PDF del preventivo è allora organizzato così:

Ordine	Pagine	Dove si impostano
1	Copertina	Modifica del Design, blocco Impostare il blocco centrale
2	Pagine di presentazione proprie del preventivo	Scheda del preventivo, colonna Posizione = Prima del preventivo (presentazione)
3	Il preventivo: intestazione, righe, totali e riquadro «per accettazione»	—
4	Allegati: file uniti dopo il preventivo, schede tecniche dei prodotti, condizioni di vendita	Scheda del preventivo (Dopo il preventivo), pagina Preventivi, pagina Opzioni

Scegliere la copertina. Nella modifica del Design, aprite il blocco Impostare il blocco centrale:

• l'elenco Colore di sfondo della pagina di presentazione del preventivo propone i quattro sfondi forniti (blu, ciano, verde, arancione) e le copertine che avete caricato;
• il campo Caricare una copertina personalizzata per il preventivo (immagine o PDF) aggiunge una copertina a questo elenco. Un PDF viene salvato in proposals/cover: si usa solo la sua prima pagina, estesa su tutta la pagina.

Il modulo stampa sopra la copertina il logo della società, il titolo del documento, il nome del destinatario, la data del preventivo e la sua data di fine validità: scegliete una copertina su cui queste zone restino leggibili.

Aggiungere pagine di presentazione a un preventivo.

1. Allegate il PDF al preventivo (scheda Documenti).
2. Nella scheda del preventivo, nel blocco dei file PDF uniti al preventivo, spuntate il file, scegliete Prima del preventivo (presentazione) nella colonna Posizione, poi cliccate su Salva.
3. Rigenerate il PDF del preventivo.

Più file vengono inseriti nell'ordine dell'elenco, cioè l'ordine alfabetico dei loro nomi: anteponete 1-, 2-... per imporre un ordine. Ogni pagina importata, prima come dopo il preventivo, mantiene il suo formato e il suo orientamento e riceve il piè di pagina del preventivo (dati della società e numero di pagina «n / totale»).

Firma online del cliente

Il cliente firma il preventivo da una pagina web, senza stamparlo: la sua firma viene apposta nel riquadro «per accettazione» del PDF e il preventivo passa allo stato Firmato.

Configurazione

1. In Impostazioni > Moduli > Preventivi, attivate Consenti firma online (opzione del nucleo di Dolibarr, PROPOSAL_ALLOW_ONLINESIGN).
2. Nella pagina Preventivi del modulo, attivate Mostrare: «Per accettazione» (ULTIMATEPDF_PDF_PROPAL_USE_ELECTRONIC_SIGNING). Il preventivo stampa allora sotto i totali un riquadro «Accettazione scritta, timbro, data e firma».
3. Convalidate il preventivo e generatene il PDF con il modello ultimatepropale_propal.

Inviare il link al cliente. La scheda del preventivo convalidato mostra il blocco Link per firma online. Copiatelo nella vostra e-mail, oppure usate la variabile __ONLINE_SIGN_URL__ in un modello di e-mail. Il cliente apre la pagina, consulta il PDF, clicca su Accetta proposta, inserisce il suo nome, traccia la firma e conferma. Dolibarr salva allora un nuovo file REF_signed-AAAAMMGGHHMMSS.pdf accanto al PDF originale, che resta invariato.

Su quale pagina viene apposta la firma? Sulla pagina che porta il riquadro «per accettazione», e solo su quella. A ogni generazione, il modello scrive il numero di questa pagina nelle proprietà del PDF (parola chiave PAGESIGN=n), letta dalla pagina di firma di Dolibarr. La copertina e le pagine di presentazione poste prima del preventivo vengono contate. Gli allegati posti dopo (file uniti, schede tecniche, condizioni di vendita) non spostano mai la firma. Esempio: una copertina, due pagine di presentazione, un preventivo di due pagine, un allegato tecnico e le condizioni di vendita danno PAGESIGN=5, qualunque sia la lunghezza degli allegati.

Da sapere

• Viene firmato il PDF presente nella scheda: rigeneratelo dopo ogni modifica del preventivo, prima di inviare il link. Un PDF prodotto da una versione precedente del modulo, senza la parola chiave PAGESIGN, viene firmato sull'ultima pagina.
• Le versioni precedenti scrivevano il numero di pagine dell'ultimo PDF generato nella costante PROPAL_SIGNATURE_ON_SPECIFIC_PAGE. Globale all'entità e prioritaria su PAGESIGN, mandava la firma sugli allegati, o persino su una pagina di un altro preventivo. Il modulo ora la elimina a ogni generazione: non ricreatela.
• L'altezza della firma nella pagina viene da un'altra costante del nucleo, PROPAL_SIGNATURE_YFORIMGSTART, anch'essa globale: il modulo vi scrive la posizione del riquadro a ogni generazione. Se tra la generazione e la firma viene generato un altro preventivo, il cui riquadro si trova a un'altra altezza, la firma può risultare spostata in verticale. In tal caso, rigenerate il PDF del preventivo prima di inviare di nuovo il link.

Risoluzione dei problemi

Sintomo	Causa probabile
Il modello ultimatepropale_propal non compare nell'elenco	Il modulo UltimatePropale o il modulo Proposte commerciali non è attivato, oppure il modello non è attivato nella configurazione delle proposte commerciali
Le generazioni automatiche (convalida, azioni di massa) usano un altro modello	ultimatepropale_propal non è il modello predefinito delle proposte commerciali
Impossibile attivare UltimatePropale	UltimatePDF, UltimatepdfLight o UltimateInvoice è attivo: disattivatelo prima
Il preventivo non riflette le modifiche di un Design	Questo Design non è quello che porta il badge «Predefinito»
Due codici QR si sovrappongono in cima al preventivo	Configurazione precedente: disattivate uno dei codici QR, ne è consentito uno solo alla volta
La firma online non è sulla pagina giusta, o non all'altezza giusta	PDF generato con una versione precedente (senza parola chiave PAGESIGN), costante PROPAL_SIGNATURE_ON_SPECIFIC_PAGE ricreata da un altro modulo, o altro preventivo generato nel frattempo: rigenerate il PDF e rinviate il link
Il link per la firma online non compare sulla scheda del preventivo	Preventivo non convalidato, o opzione Consenti la firma online disattivata nella configurazione delle proposte commerciali
Le pagine di presentazione non compaiono nel PDF	Opzione delle pagine di presentazione disattivata, file non spuntato sulla scheda del preventivo, o posizione non salvata

Il registro di Dolibarr (Home - Impostazioni - Altro - Registri) traccia ogni generazione.

⬆ Torna al sommario

Altre lingue

• Documentation française du module UltimatePropale
• English documentation for the UltimatePropale module
• Deutsche Dokumentation für das Modul UltimatePropale
• Documentación en español del módulo UltimatePropale

⬆ Torna al sommario