Module Ultimateline IT
Sommario
Informazioni
| Module name | UltimateLine |
| Editor / Editeur | 
|
| Download or buy page / Page achat ou téléchargement | External module - www.dolistore.com |
| Status / Statut / Estado | Stable |
| Prerequisites / Prérequis | Dolibarr 25.0, PHP 8.2
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-3 |
| Note / Nota | ⬆ Torna al sommario |
Funzionalità
UltimateLine aggiunge automaticamente una riga finale (eco-contributo, estensione di garanzia, spese fisse, sconto...) subito sotto una riga di prodotto o di servizio, in preventivi, ordini e fatture. La riga finale è un servizio del catalogo, calcolato in percentuale dell'importo della riga padre o come importo fisso per unità. Uno stesso prodotto può generare più righe finali.
Esempio: un servizio «Estensione di garanzia» al 5 % e un servizio «Eco-contributo RAEE» di 3,50 € per unità, associati a una finestra venduta a 2 × 389,00 €, aggiungono sotto la finestra una riga di 38,90 € e una riga di 7,00 €.
Comportamento nei documenti
- La riga finale viene inserita automaticamente subito sotto la sua riga di prodotto padre, con quantità 1 e l'aliquota IVA del servizio.
- Viene ricalcolata quando cambiano la quantità o il prezzo della riga padre, ed eliminata insieme a essa.
- Nell'interfaccia, la riga finale è rientrata e raggruppata visivamente con la sua riga padre.
- Nei PDF dei modelli UltimatePDF, la riga finale è stampata con un'icona «└» che ne indica il legame con la riga padre, e sotto il Totale Netto viene aggiunta una riga Di cui [nome del servizio]: [importo netto] per servizio.
- Con i modelli standard di Dolibarr (cyan, eratosthene, sponge...), un riquadro Di cui: sotto i totali indica il totale di ogni servizio di riga finale, nella lingua del documento.
Compatibilità con il modulo Milestone
UltimateLine è compatibile con il modulo Milestone, che organizza le righe dei documenti in milestone. Quando una riga di prodotto appartiene a una milestone:
- nell'interfaccia, la riga finale è visualizzata all'interno del blocco della milestone, subito dopo la sua riga di prodotto padre, prima del subtotale della milestone;
- l'importo della riga finale è incluso nel subtotale della milestone;
- nei PDF, la riga finale mantiene l'icona «└» (e non l'icona di riga figlia della milestone);
- le conversioni preventivo → ordine, preventivo → fattura e ordine → fattura mantengono il legame tra la riga finale e la sua riga di prodotto padre.
Prerequisiti
- Dolibarr 25.x;
- PHP 8.2 o superiore (testato fino a PHP 8.5);
- moduli Servizi e Fatture, attivati automaticamente con UltimateLine.
Per Dolibarr da 18 a 24, utilizzare la versione 24.0 del modulo.
⚙️ Procedura di installazione
⚙️ Installazione dall'interfaccia
- Andare in Home → Impostazioni → Moduli/Applicazioni, scheda Distribuisci/installa modulo esterno.
- Scegliere il file
module_ultimateline-25.0.0.zipe fare clic su Carica file.
⚙️ Installazione manuale
- Scaricare il file archivio del modulo (.zip).
- Decomprimere il file:
unzip module_ultimateline-25.0.0.zip -d /tmp/ultimateline_zip - Copiare la cartella del modulo:
cp -r /tmp/ultimateline_zip/htdocs/ultimateline /percorso/di/dolibarr/htdocs/custom/ - Verificare che il modulo si trovi in
htdocs/custom/ultimateline. - Il modulo è ora disponibile e può essere attivato da Dolibarr.
Aggiornamento da una versione precedente: sostituire la cartella ultimateline, poi disattivare e riattivare il modulo. I servizi di riga finale e le loro associazioni vengono conservati.
Configurazione
Collegati con un account amministratore, andare in Home → Impostazioni → Moduli/Applicazioni. Il modulo compare nella famiglia AtooNet: fare clic sul pulsante di attivazione, poi sulla rotella dentata a fine riga per aprire la pagina di configurazione del modulo.
Creare prima, nel modulo Prodotti/Servizi, il servizio o i servizi da usare come righe finali (per esempio «Eco-contributo RAEE»). La loro aliquota IVA viene ripresa sulle righe finali.
La pagina di configurazione ha quattro schede: Configurazione dei servizi di riga finale, Guida utente, About e Registro delle modifiche.
Guida introduttiva
Alla prima apertura, la finestra Benvenuti in UltimateLine! presenta i tre passaggi della configurazione (creare un servizio di riga finale, associare prodotti al servizio, consultare la guida utente) e spunta quelli già completati. Il link Non mostrare più questa guida la nasconde definitivamente.
Definire un servizio come riga finale
Nel blocco Definire un servizio come riga finale:
- Selezionare un servizio da usare come servizio di riga finale: scegliere uno dei servizi creati in precedenza.
- Associato ai prodotti/servizi come: scegliere il tipo di calcolo:
- Aliquota sul prezzo (in percentuale): la riga finale vale una percentuale dell'importo netto della riga padre;
- Importo fisso aggiunto al prezzo: la riga finale vale questo importo moltiplicato per la quantità della riga padre.
- Valore da applicare: inserire la percentuale o l'importo.
- Fare clic su Assegnare.
Associare prodotti al servizio
Nel blocco Selezione di un servizio di riga finale, scegliere il servizio in Selezionare un servizio di riga finale e fare clic su Visualizza.
Il pannello Configurazione del servizio di riga finale mostra il riferimento, l'Etichetta del servizio, il Tipo di servizio e il Valore del servizio, poi due elenchi:
- Prodotti associati (a sinistra): i prodotti e servizi che generano già questa riga finale;
- Prodotti disponibili (a destra): i prodotti e servizi che possono essere aggiunti.
Selezionare dei prodotti in un elenco (o usare Seleziona tutti / Deseleziona tutto), spostarli con le frecce ← e →, poi fare clic su Applica per salvare.
Sotto gli elenchi, Elimina le associazioni selezionate rimuove solo i prodotti spuntati dall'elenco dei prodotti associati.
Eliminare un servizio di riga finale
Il pulsante Elimina il servizio apre una finestra di conferma di Dolibarr. Dopo la conferma, il servizio di riga finale e tutte le sue associazioni di prodotti vengono eliminati; il servizio stesso resta nel catalogo.
Per guardare una formazione online su YouTube: https://www.youtube.com/watch?v=OBwRoyuBrPk
Utilizzo
- Quando una riga di prodotto viene aggiunta o modificata, le righe finali corrispondenti vengono create o ricalcolate automaticamente.
- Quando una riga di prodotto viene eliminata, le sue righe finali vengono eliminate con essa.
- Le righe libere (senza prodotto del catalogo) non generano alcuna riga finale.
- Conversioni: quando si converte un preventivo in ordine, un preventivo in fattura o un ordine in fattura, le righe vengono copiate così come sono e restano legate alla loro riga di prodotto, senza essere aggiunte una seconda volta.
- Con il modulo Milestone: le righe finali restano all'interno del loro blocco di milestone dopo la conversione, e il loro importo è incluso nel subtotale della milestone.
Novità della versione 25.0.0
Compatibilità
- Richiede Dolibarr 25 e PHP 8.2, testato fino a PHP 8.5. Il controllo degli aggiornamenti legge
versionmodules/ultimateline/v25/ultimateline.txt.
Correzioni
- Il riquadro Di cui: sotto i totali dei modelli PDF standard non veniva più stampato: ritrova le righe finali, le raggruppa per servizio, usa la lingua e la valuta del documento e non viene più stampato due volte con i modelli UltimatePDF e UltimatePDFLight.
- L'eliminazione di un servizio chiede una conferma in una finestra di dialogo di Dolibarr, protetta da un token di sicurezza.
- Pagina di configurazione: titolo della scheda del browser, foglio di stile del modulo, etichetta del riferimento del servizio e testo di ricerca degli elenchi di prodotti tradotti.
Traduzioni e documentazione
- Interfaccia, guida utente e pagina wiki in francese, inglese, tedesco, spagnolo e italiano, con nuove schermate.
- Libreria Markdown integrata rimossa: Dolibarr visualizza da sé la guida e il registro delle modifiche.
- Test automatici (PHPUnit, PHPStan) e pacchetto DoliStore più leggero.
Versioni precedenti
- 24.0.1 (non pubblicata, inclusa nella 25.0.0): token CSRF nei moduli di amministrazione, schede Guida utente e Registro delle modifiche.
- 24.0.0: versione compatibile con Dolibarr 24.
- Versioni da 18 a 23: vedere il file
ChangeLog.mdfornito con il modulo.
Domande frequenti
Non viene aggiunta alcuna riga finale
Verificare che il prodotto compaia in Prodotti associati del servizio di riga finale e che la riga usi un prodotto del catalogo: le righe libere vengono ignorate.
L'importo della riga finale sembra errato
Verificare il tipo di calcolo (percentuale o importo fisso) e il valore mostrati nel pannello Configurazione del servizio di riga finale. Un importo fisso viene moltiplicato per la quantità della riga padre.
Le associazioni non vengono salvate
Fare clic su Applica dopo aver spostato dei prodotti da un elenco all'altro.
Gli importi «Di cui» compaiono due volte nel PDF?
No. I modelli UltimatePDF e UltimatePDFLight stampano le proprie righe «Di cui ...» sotto il Totale Netto; il riquadro Di cui: di UltimateLine viene aggiunto solo con i modelli standard di Dolibarr.
Il modulo modifica il core di Dolibarr?
No. UltimateLine funziona con trigger e hook, senza modificare i file di Dolibarr.