Documentazione KSIDol > Moduli KSIDol > Pacchetti di prodotti e servizi
Guida del modulo: Pacchetti di prodotti e servizi
Guida non tecnica: a cosa serve il modulo, come utilizzarlo e come si integra con Dolibarr.
N. DoliStore493155
Modalità di prezzo3 (Padre / Somma / Auto)
Documenti supportatiPreventivi, ordini, fatture, interventi
Compatibilità Dolibarrda v18 a v24
1. Panoramica del modulo
Il modulo Pacchetti di prodotti e servizi consente di raggruppare più prodotti o servizi esistenti in un unico «pacchetto» (chiamato anche bundle o kit) che viene venduto come un tutt’uno. Un pacchetto è in realtà un prodotto Dolibarr a tutti gli effetti, identificato da un prefisso di riferimento (per impostazione predefinita «PK-»), a cui viene associato un elenco di componenti con la loro quantità, la loro IVA, il loro prezzo e un eventuale sconto.
Il vantaggio principale emerge sui documenti commerciali: è sufficiente aggiungere il pacchetto in una sola riga in un preventivo, un ordine o una fattura, e il modulo provvede automaticamente a «espanderlo» mostrando il dettaglio di tutti i componenti che contiene. Si risparmia tempo nell’inserimento mantenendo al tempo stesso un documento chiaro e dettagliato per il cliente. Il modulo si basa interamente sugli oggetti nativi di Dolibarr (prodotti, servizi, categorie, preventivi, ordini, fatture) senza duplicare il catalogo.
- Vendere un insieme di prodotti/servizi come un’offerta unica (pacchetto, bundle, kit)
- Comporre un pacchetto a partire da prodotti e servizi già presenti nel catalogo
- Inserire un pacchetto con un clic in un documento e vederlo dettagliarsi automaticamente
- Scegliere come vengono mostrati i prezzi (sul pacchetto o su ogni componente)
- Restare al 100% in Dolibarr: il pacchetto è un prodotto, i suoi componenti sono i tuoi articoli
2. Creare e comporre un pacchetto
Dal menu Prodotti/Servizi, la voce «Crea un pacchetto» apre un modulo che crea il prodotto-pacchetto e permette di definirne subito i componenti.
- Inserire il riferimento del pacchetto (il prefisso «PK-» viene proposto e completato automaticamente), un’etichetta, una descrizione, uno stato (attivo/inattivo) e il tipo (prodotto o servizio)
- Aggiungere tutti i componenti necessari: ogni riga rimanda a un prodotto o servizio esistente, con quantità, IVA, prezzo unitario al netto, prezzo unitario lordo, sconto (%) e descrizione
- Aggiungere o rimuovere righe di componente al volo grazie ai pulsanti «+» e «-»
- Beneficiare del riempimento automatico di prezzo, IVA e descrizione non appena si seleziona un prodotto dall’elenco
- Creare direttamente un nuovo prodotto/servizio da integrare nel pacchetto tramite una scorciatoia, senza uscire dalla schermata
3. Consultare e gestire l’elenco dei pacchetti
La voce «Pacchetti / Bundle» del menu Prodotti/Servizi mostra l’insieme dei pacchetti già creati e dà accesso alla loro gestione.
- Vedere ogni pacchetto con il suo riferimento, la sua etichetta, il suo totale al netto e il suo totale lordo (calcolati a partire dai componenti)
- Ordinare l’elenco per riferimento o per etichetta
- Aprire il dettaglio di un pacchetto, modificarlo o eliminarlo direttamente dall’elenco
- Accedere alla scheda di un pacchetto che riepiloga il prodotto collegato, i totali e la tabella completa dei componenti
4. Modificare i componenti di un pacchetto
Sulla scheda di un pacchetto, una tabella elenca tutti i componenti e permette di farli evolvere senza ripartire da zero.
- Aggiungere un nuovo componente (prodotto/servizio, quantità, IVA, prezzo al netto, prezzo lordo, sconto, descrizione)
- Modificare una riga esistente direttamente nella tabella
- Eliminare una riga di componente
- Vedere ricalcolarsi automaticamente il totale al netto e il totale lordo del pacchetto a ogni modifica
- Aggiornare con un clic prezzi, IVA e descrizioni di tutti i componenti a partire dalle schede prodotto (aggiornamento massivo dalla configurazione)
5. Aggiungere un pacchetto a un preventivo, un ordine o una fattura
Nelle schermate di preventivo, ordine e fattura (così come nei contratti), il modulo aggiunge un blocco dedicato per inserire un pacchetto.
- Scegliere un pacchetto da un elenco a discesa e indicare una quantità
- Inserire il pacchetto con una sola azione tramite il pulsante «Aggiungi»
- Il pacchetto viene aggiunto come una riga e poi automaticamente dettagliato sul documento
- Un messaggio conferma che il pacchetto è stato correttamente aggiunto al documento
6. Espandere automaticamente il pacchetto in righe dettagliate
È il cuore del modulo: non appena è presente una riga «pacchetto» su un documento, il modulo la trasforma in un insieme di riga principale + componenti e mantiene questo insieme aggiornato.
- Una riga «padre» rappresenta il pacchetto, seguita da una riga «figlia» per ogni componente
- La quantità di ogni componente è calcolata automaticamente (quantità del componente × quantità di pacchetto ordinata)
- Se si modifica la quantità del pacchetto, i componenti vengono ricalcolati di conseguenza
- Se si elimina la riga del pacchetto, tutti i suoi componenti vengono rimossi contemporaneamente
- I totali del documento vengono ricalcolati automaticamente dopo l’espansione
7. Scegliere la modalità di visualizzazione dei prezzi
Il modulo propone tre modi per ripartire gli importi tra la riga del pacchetto e i suoi componenti, a seconda della presentazione commerciale desiderata.
- Padre (Parent): il prezzo resta sulla riga del pacchetto e i componenti sono mostrati a titolo informativo (importi a zero)
- Somma (Sum): gli importi sono riportati su ogni componente e la riga del pacchetto viene azzerata
- Auto (Auto sum to parent): i componenti mantengono i loro importi e la riga del pacchetto viene automaticamente allineata alla loro somma
- La modalità scelta si applica allo stesso modo all’inserimento e al documento stampato
8. Configurare il modulo
La schermata di configurazione (riservata all’amministratore) riunisce le impostazioni di adattamento e due strumenti di manutenzione.
- Definire il prefisso che identifica un prodotto come pacchetto (per impostazione predefinita «PK-»)
- Scegliere la modalità di prezzo (Padre, Somma o Auto)
- Attivare o meno l’impatto dei componenti sulla giacenza
- Ricostruire il funzionamento del modulo (schema, impostazioni, pacchetti) e avviare l’aggiornamento massivo di tutti i pacchetti
- All’installazione e durante una ricostruzione, il modulo attiva automaticamente i sottoprodotti nativi di Dolibarr (opzione PRODUIT_SOUSPRODUITS), necessari all’espansione dei pacchetti.
- Nota: l’espansione dei pacchetti sui contratti esiste (tramite i trigger di Dolibarr) ma non è attivabile dalla schermata di configurazione; la visualizzazione o meno delle descrizioni dei componenti (schede e PDF) si imposta sulla scheda del pacchetto stessa, non nell’amministrazione.
9. Formattazione sui documenti e sui PDF
Il modulo cura la resa delle righe del pacchetto, sia a schermo sia sui documenti PDF generati da Dolibarr.
- La riga del pacchetto è messa in evidenza e il suo riferimento appare in grassetto
- Le righe dei componenti sono presentate in modo più discreto, rientrate sotto il pacchetto
- A seconda della configurazione, la descrizione dettagliata dei componenti può essere mostrata o nascosta sui PDF
10. Collegamenti con Dolibarr
Il modulo non funziona in modo isolato: si integra con i blocchi nativi di Dolibarr.
- Prodotti e servizi : Fondamento del modulo: un pacchetto è un prodotto Dolibarr nativo e ogni componente è un prodotto o servizio esistente del catalogo. I prezzi e l’IVA sono ripresi dalle schede articolo, senza duplicati.
- Categorie di prodotti : Ogni prodotto-pacchetto viene automaticamente inserito in una categoria «Pack» (creata se non esiste), il che permette di ritrovare e filtrare facilmente i pacchetti nel catalogo.
- Preventivi, ordini e fatture : Il modulo aggiunge un blocco di inserimento pacchetto ed espande automaticamente i componenti sulle proposte commerciali, gli ordini cliente e le fatture cliente.
- Acquisti fornitori : L’espansione dei pacchetti funziona anche sulle richieste di prezzo, gli ordini e le fatture fornitore, per gestire lotti sul lato approvvigionamento.
- Schede di intervento : Un pacchetto aggiunto a una scheda di intervento viene dettagliato nei suoi componenti, utile per le prestazioni che combinano più prodotti/servizi.
- Contratti : I pacchetti vengono espansi anche sulle righe di contratto, tramite i trigger di Dolibarr (comportamento non esposto nella schermata di configurazione).
- Prodotti composti / sottoprodotti (kit) : Il modulo si sincronizza con la funzione nativa dei sottoprodotti di Dolibarr affinché il pacchetto si comporti come un prodotto composto (kit), in coerenza con il catalogo.
- Gestione della giacenza : Un’opzione permette di attivare o disattivare l’impatto dei componenti sulla giacenza quando vengono utilizzati in un pacchetto.
- Prezzi dei prodotti : Il prezzo del prodotto-pacchetto può essere sincronizzato con il totale dei suoi componenti nello storico prezzi nativo del prodotto.
- Generazione dei documenti PDF : Tramite il meccanismo di stampa di Dolibarr, il modulo formatta le righe del pacchetto sui PDF (pacchetto in evidenza, componenti rientrati, descrizioni mostrate o nascoste).
