Quote Builder — Nuovo preventivo
Il Quote Builder è l'editor completo per creare e modificare un preventivo. Permette di aggiungere prodotti (finestre, porte-finestra, scorrevoli, tapparelle, persiane, zanzariere, porte d'ingresso), configurare ogni articolo nei dettagli, visualizzare il disegno tecnico in tempo reale e calcolare prezzi, margini e totali prima di esportare il PDF.
Come accedere
- Menu: Preventivi → pulsante "Nuovo preventivo" oppure clicca Modifica su un preventivo esistente
- Indirizzo:
/quote-builder(nuovo) ·/quote-builder?editId=<id>(modifica) - Chi può usarla: Amministratore e Utente
Interfaccia
Il builder è diviso in due pannelli affiancati (desktop) separati da un separatore trascinabile, o sovrapposti su mobile.
Intestazione
| Elemento | Descrizione |
|---|---|
| Titolo pagina | "Nuovo preventivo" oppure "Modifica preventivo" con il badge Bozza in arancio se lo stato è Draft. |
| Presenza collaborativa | Avatar degli utenti che stanno visualizzando lo stesso preventivo in contemporanea (massimo 3 avatar visibili). |
| Pulsante Anteprima PDF | Visibile su mobile, tablet e laptop fino a ~1280 px (nascosto sopra i 1280 px) — apre un dialogo con l'anteprima del documento prima di esportarlo. |
Pannello sinistro — Intestazione del preventivo
Una scheda in cima al pannello sinistro contiene:
- Titolo del preventivo — campo testo libero. Obbligatorio per il salvataggio.
- Cliente — selettore con ricerca tra i clienti esistenti; i clienti preferiti appaiono in cima. Il pulsante Nuovo cliente apre un modale per creare il cliente senza uscire dal builder.
Pannello sinistro — Gruppi prodotto
Sezione principale dove si aggiungono e configurano i prodotti. Ogni gruppo rappresenta un tipo di prodotto (es. "Finestra battente") e può contenere più righe di dimensioni diverse.
Aggiungere un prodotto
- Clicca Aggiungi prodotto (o usa il pulsante "+").
- Si apre il cassetto di configurazione del prodotto (vedi sotto).
- Compila tutti i campi obbligatori e clicca Applica.
- Il gruppo appare nel pannello sinistro con una riga di dimensioni già inserita.
Tipi di prodotto supportati
| Tipo | Descrizione |
|---|---|
| Finestra | Finestra singola con uno o più battenti, a vasistas, scorrevole o fissa. |
| Porta-finestra | Come la finestra ma con soglia a pavimento. |
| Porta scorrevole | Sistema scorrevole (alzante-scorrevole o scorrevole semplice). |
| Tapparella | Avvolgibile abbinabile a una finestra o autonomo. |
| Persiana | Persiana a pacchetto o alla veneziana. |
| Zanzariera | Zanzariera fissa, a rullo o pieghevole. |
| Porta d'ingresso | Porta blindata o di sicurezza. |
| Articolo generico | Voce libera per servizi, spese di trasporto o accessori non catalogati. |
Cassetto di configurazione prodotto
Il cassetto guida la configurazione in passi:
| Sezione | Campi principali |
|---|---|
| Profilo | Scelta del profilo dall'inventario (es. "Aluplast Ideal 4000"). |
| Tipo apertura | Battente, vasistas, fisso, scorrevole, alzante-scorrevole, ecc. |
| Vetro | Composizione del vetro (doppio/triplo, basso-emissivo, opaco, ecc.). |
| Colore esterno / interno | Colore RAL, anodizzato o laminato per ogni lato. |
| Accessori | Maniglia, cerniere, serratura, soglia, cassonetto per tapparella, ecc. |
Dopo aver configurato il gruppo, il cassetto si chiude e la tabella delle dimensioni è accessibile.
Tabella dimensioni (righe)
Ogni gruppo ha una tabella dove si inseriscono le righe di produzione. Le colonne visibili sono:
| Colonna | Descrizione |
|---|---|
| Larghezza (mm) | Larghezza luce muraria. |
| Altezza (mm) | Altezza luce muraria. |
| Quantità | Numero di pezzi con queste dimensioni. |
| Configurazione anta/apertura | Popover (RowWindowConfigPopover) che apre le opzioni di configurazione ante per la riga (numero di ante, tipo di apertura per pannello, ecc.). Non è una colonna di testo separata. |
| Prezzo unitario | Prezzo calcolato per singolo pezzo. |
| Totale | Prezzo unitario × quantità per la riga. |
Ogni riga mostra un'icona di avviso se ci sono errori di configurazione da correggere prima dell'esportazione.
Opzioni di riga (pannelli collassabili)
Ulteriori opzioni sono accessibili tramite il menu azioni (...) della riga, che apre pannelli collassabili dedicati:
| Opzione | Descrizione |
|---|---|
| Sconto riga | Sconto percentuale o fisso applicato solo a questa riga. |
| Prezzo manuale | Prezzo totale impostato manualmente (mutuamente esclusivo con lo sconto riga). |
| Posizione | Etichetta libera (es. "Soggiorno", "Camera 1"). |
| Note riga | Note interne visibili nel PDF. |
| Opzionale | Contrassegna la riga come articolo opzionale nel preventivo. |
Azioni sulle righe
- Aggiungi riga — inserisce una nuova riga nel gruppo con le stesse impostazioni del gruppo.
- Copia geometria a tutte — applica larghezza, altezza e pannelli della riga corrente a tutte le altre righe dello stesso gruppo.
- Rimuovi riga — elimina la riga dopo conferma.
- Esporta DoP — genera la Dichiarazione di Prestazione (CPR) per la riga selezionata. Apre un dialogo per scegliere la lingua (IT / EN).
- Alternativa — aggiunge un gruppo alternativo basato sullo stesso prodotto (per preventivi con opzioni A/B).
Aggiungere accessori in blocco
Se sono presenti tapparelle, persiane o zanzariere nell'inventario, appare il pulsante Aggiungi accessori in blocco. Apre un dialogo che permette di abbinare accessori a più finestre contemporaneamente.
Pannello sinistro — Impostazioni preventivo
Sotto i gruppi prodotto si trovano le impostazioni commerciali, organizzate in sezioni espandibili:
| Sezione | Descrizione |
|---|---|
| Scadenza offerta | Data di validità del preventivo (campo data). |
| Note | Testo libero incluso nel PDF (massimo 20 000 caratteri). |
| Sconto | Sconto globale in euro o percentuale applicato al totale netto. Esclusivo con il prezzo netto manuale. |
| Prezzo netto manuale | Sovrascrittura del totale netto calcolato. Richiede conferma. Esclusivo con lo sconto globale. |
| Vista disegni | Scegli se il disegno tecnico nel PDF mostra la vista interna o esterna. |
| IVA | Modalità (IVA inclusa / esclusa), aliquota e etichetta personalizzabile. |
| Piano di pagamento | Attiva un piano a rate personalizzato (massimo 5 rate); somma delle percentuali deve essere 100. Può essere precompilato dal piano predefinito dell'azienda. |
| Termini e condizioni | Interruttore per includere i T&C dell'azienda nel PDF (visibile solo se configurati nelle Impostazioni). |
Pannello destro — Anteprima e riepilogo (desktop)
Il pannello destro è fisso e scorrevole. Contiene:
- Anteprima documento — rendering live del documento PDF con i disegni tecnici generati automaticamente per ogni articolo configurato. Il disegno evidenzia l'articolo su cui si sta lavorando nel pannello sinistro.
- Riepilogo righe — elenco delle righe con possibilità di riordinare trascinando.
- Totali — subtotale, eventuale IVA, sconto, trasporto e totale finale. Mostra anche costo aggregato e margine (percentuale e importo assoluto) se il costo è impostato nell'inventario.
Barra azioni
Sul desktop la barra azioni è fissa in fondo al pannello destro. Su mobile è una barra fissa in fondo allo schermo.
| Pulsante | Condizione | Azione |
|---|---|---|
| Invia al cliente | Bozza | Salva e imposta lo stato su "Inviato". |
| Aggiorna modifiche | Non bozza | Salva le modifiche mantenendo lo stato attuale. |
| Approva | Stato "Inviato" | Imposta lo stato su "Approvato" (crea l'ordine automaticamente). |
| Rifiuta | Stato "Inviato" | Imposta lo stato su "Rifiutato". |
| Torna a bozza | Approvato o Rifiutato | Riporta il preventivo allo stato Bozza. |
| Esporta PDF | Almeno una riga | Apre il menu formato PDF. |
| Salva come modello | Almeno una riga | Salva la configurazione corrente come modello riutilizzabile. |
Formati di esportazione PDF
| Formato | Descrizione |
|---|---|
| Dettagliato | Una scheda per ogni articolo con disegno tecnico, parametri e prezzo. Formato predefinito. |
| Scheda | Tabella riepilogativa compatta, senza disegni tecnici. Adatto a offerte con molte righe. |
Oltre ai due layout persistiti esiste l'opzione Produzione: nasconde i prezzi (flag hidePrices) e genera un documento tecnico per l'officina di produzione. Non è un layout memorizzato ma un'opzione di esportazione separata.
Striscia modelli
Quando il builder è vuoto (nessun articolo e nessun preventivo in modifica), appare la striscia dei modelli salvati. Clicca un modello per applicarne la configurazione al preventivo corrente.
Striscia bozze
Sotto la striscia modelli compare l'elenco delle bozze non completate. Clicca una voce per riprendere il lavoro.
Operazioni
Creare un nuovo preventivo
- Clicca Nuovo preventivo dalla lista o dal menu principale.
- Inserisci il titolo del preventivo.
- Seleziona il cliente (opzionale: si può aggiungere in un secondo momento).
- Clicca Aggiungi prodotto e configura il primo articolo nel cassetto.
- Inserisci larghezza, altezza e quantità nella tabella dimensioni.
- Ripeti per ogni articolo.
- Imposta le condizioni commerciali nel pannello Impostazioni preventivo.
- Usa Invia al cliente o lascia in Bozza — il salvataggio automatico mantiene aggiornata la bozza.
Modificare un preventivo esistente
- Dalla lista preventivi clicca Modifica sulla riga del preventivo.
- Il builder si apre con tutti i dati precaricati.
- Modifica liberamente; le bozze si salvano automaticamente.
Esportare il PDF
- Assicurati che tutti gli articoli abbiano dimensioni e profilo configurati (nessuna icona di errore sulle righe).
- Clicca Esporta PDF nella barra azioni.
- Scegli il formato: Dettagliato, Scheda o l'opzione Produzione (senza prezzi).
- Il PDF viene generato e scaricato automaticamente; il formato scelto diventa il predefinito per le esportazioni successive di questo preventivo.
Esportare la DoP (Dichiarazione di Prestazione)
- Sulla riga prodotto, clicca il menu azioni (tre punti) e scegli Esporta DoP.
- Nel dialogo, seleziona la lingua (IT o EN).
- Clicca Esporta — il file PDF viene scaricato.
Salvare come modello
- Clicca Salva come modello nella barra azioni.
- Inserisci un nome per il modello.
- Clicca Salva — il modello è disponibile nella striscia modelli dei nuovi preventivi.
Disegno tecnico automatico
Per ogni articolo di tipo finestra, porta-finestra, porta scorrevole, tapparella, persiana o zanzariera, CADrivit genera automaticamente un disegno tecnico in formato vettoriale basato su:
- dimensioni (larghezza × altezza in mm)
- tipo di apertura (battente, vasistas, scorrevole, fisso, ecc.)
- numero di ante/pannelli
- eventuale design personalizzato per riga
Il disegno è visibile nel pannello destro in tempo reale durante la compilazione e viene incorporato nel PDF esportato. La vista (interna o esterna) si controlla dall'impostazione Vista disegni.
Calcolo del prezzo e margini
Il prezzo di ogni articolo è calcolato automaticamente dal motore di pricing in base al profilo selezionato, alle dimensioni, agli accessori e ai costi configurati nell'inventario. Il pannello Totali mostra:
- Subtotale — somma dei prezzi di tutte le righe.
- Trasporto — costo fisso per articolo, configurabile nelle Impostazioni azienda.
- Sconto — sconto globale se impostato.
- IVA — importo IVA se la modalità è "IVA esclusa".
- Totale — importo finale.
- Costo e Margine — visibili se il costo è impostato nell'inventario per i profili usati. Il margine è mostrato sia come importo assoluto sia come percentuale sul netto.
Stati e messaggi
| Situazione | Comportamento |
|---|---|
Modifiche non ancora salvate (pending) | Indicatore "Modifiche non salvate" con puntino arancio lampeggiante — le modifiche sono in attesa del debounce. |
Salvataggio in corso (saving) | Indicatore con spinner rotante — il salvataggio è attivo. |
Bozza salvata (saved) | Indicatore verde con orario dell'ultimo salvataggio (es. "Bozza salvata alle 14:32"). |
| Errore di salvataggio | Indicatore rosso con icona nuvola. Riprova o salva manualmente. |
| Articolo con errori | Icona di avviso sulla riga; il pulsante Esporta PDF è disabilitato finché non risolvi gli errori. |
| Campo obbligatorio mancante | Il sistema scorre automaticamente al campo problematico e lo evidenzia. |
| Conversione in ordine | Toast verde con link diretto alla pagina Ordini dopo l'approvazione. |
| Tasso di cambio non disponibile | Banner di avviso arancio se la valuta dell'azienda non è euro e il tasso non è aggiornato. |
Note e limiti
- Il salvataggio automatico si attiva solo sulle bozze. Preventivi in stato Inviato, Approvato o Rifiutato richiedono il salvataggio manuale.
- Il pulsante Invia al cliente e Approva sono disabilitati se ci sono articoli con errori di configurazione bloccanti.
- Sconto globale e prezzo netto manuale sono mutuamente esclusivi: impostarne uno azzera l'altro.
- Sconto per riga e prezzo manuale per riga sono anch'essi mutuamente esclusivi.
- Il piano di pagamento a rate viene incluso nel PDF solo se attivato e le percentuali sommano a 100.
- Su desktop il pannello destro è ridimensionabile trascinando il separatore verticale; la proporzione viene memorizzata nel browser.
- La striscia modelli e la striscia bozze appaiono solo quando il builder è aperto in modalità "Nuovo preventivo" senza articoli.
- L'esportazione DoP è disponibile solo per gli articoli per cui il profilo ha i dati CPR configurati nell'inventario.