CSVXpressSmart — Guida completa
Cos’è
CSVXpressSmart è una PWA installabile per creare preventivi e ordini partendo da listini CSV, con gestione avanzata di sconti, margini e presentazione cliente.
In questa guida trovi le funzioni operative, i flag disponibili e il loro comportamento.
Indice
1) Caricamento e salvataggio del CSV 2) Selezione articoli dal listino 3) Tabella articoli — campi modificabili 4) Trasporto e Installazione 5) Modalità Smart Cliente 6) Sconto Cliente (funzione chiave) 7) Flag di visibilità (output) 8) IVA 9) Report 10) Connessione e limiti dichiarati Installazione PWA (Android / iOS / Windows / macOS / Linux)1️⃣ Caricamento e salvataggio del listino CSV
Carica Listino CSV
- Usa la sezione Carica Listino CSV.
- Il file deve contenere almeno: Codice, Descrizione, Prezzo lordo.
- Se presenti, le colonne Trasporto e Installazione vengono lette automaticamente.
CSVXpressSmart può ricordare l’ultimo listino caricato.
- Flag: Ricorda l’ultimo CSV
- Se attivo: il listino viene salvato in locale (IndexedDB) e puoi ricaricarlo senza selezionare il file.
- Pulsanti: Carica CSV salvato / Cancella CSV salvato
👉 I dati restano solo sul dispositivo. Nessun invio a server.
2️⃣ Selezione articoli dal listino
- Ricerca: usa Cerca per filtrare per codice o descrizione.
- Aggiunta articolo: seleziona l’articolo e clicca Aggiungi Articolo Selezionato.
- L’articolo entra nella tabella “Articoli Aggiunti”.
3️⃣ Tabella articoli — campi modificabili
Ogni riga rappresenta un articolo.
Campi principali
- Prezzo lordo
- Sconto 1 %
- Sconto 2 %
- Margine %
- Trasporto
- Installazione
- Quantità
- Venduto a € (facoltativo)
Comportamento
- I campi numerici accettano decimali.
- Accettano virgola o punto.
- I calcoli vengono aggiornati in tempo reale.
4️⃣ Trasporto e Installazione
I costi possono arrivare dal CSV oppure essere gestiti manualmente, a seconda delle impostazioni scelte.
- Se il CSV contiene colonne Trasporto/Installazione, i valori vengono importati automaticamente.
- Puoi comunque modificarli per singolo articolo, se previsto dalla tua configurazione.
- Se scegli di mostrare il dettaglio, Trasporto e Installazione appaiono separati nel report.
- Se no, restano inclusi nel totale, senza dettaglio.
5️⃣ Modalità Preventivo / Ordine (Smart)
Modalità Cliente (Smart)
- Attivando questo flag, l’app entra in modalità presentazione cliente.
- Vengono nascosti i dati interni: restano solo i valori utili al cliente finale.
- Venduto A € → nascosto
- Differenza sconto → nascosta
- Sconti interni → nascosti
- Margine → nascosto
6️⃣ Sconto Cliente — funzione chiave
Sconto equivalente cliente (informativo)
- Viene mostrato sopra la tabella.
- Rappresenta lo sconto reale applicato al cliente tenendo conto di Sconto 1, Sconto 2 e Margine.
- È solo informativo: non modifica nulla da solo.
Quando attivi Attiva Sconto cliente:
- Sconto 1 / Sconto 2 / Margine vengono sostituiti dalla colonna Sconto cliente %
- ✔ Il prezzo finale resta identico
- ✔ Tabella più semplice
- ✔ Preventivo più chiaro
È una trasformazione logica, non solo grafica.
7️⃣ Flag di visibilità (controllo output)
- Ometti “Venduto A €” → nasconde il campo “Venduto”.
- Ometti “Differenza sconto” → nasconde differenze interne e migliora la leggibilità.
- Ometti Sconti (Sconto 1 / 2) → nasconde sconti tecnici e lascia solo i prezzi finali.
8️⃣ IVA
- Mostra IVA: se attivo, calcola l’IVA e mostra il totale ivato.
- Aliquota IVA %: modificabile, accetta decimali (usata nel riepilogo).
9️⃣ Report
Tipi di report
- Report standard
- Report Smart Cliente
- Report senza Margine
Output
- Invia su WhatsApp
- Genera TXT
I report rispettano i flag attivi e cambiano automaticamente struttura e contenuto.
🔟 Connessione e limiti dichiarati
- CSVXpressSmart richiede connessione Internet.
- Non è progettata per un offline “pieno”.
- Evita cache aggressive.
- Privilegia semplicità e affidabilità.
Questa scelta riduce complessità, facilita aggiornamenti rapidi e mantiene l’app snella.
Installazione PWA (Android / iOS / Windows / macOS / Linux)
- Apri l’app nel browser
- Menu ⋮ → Installa app
- Icona “Installa” nella barra indirizzi
- Oppure menu → Installa
- Condividi → Aggiungi a Home
- Non esiste un bottone “Installa” come su Chrome
- Consigliato Chrome / Edge per installazione PWA completa
- Safari: comportamento variabile a seconda della versione
Nota: la disponibilità dell’installazione e alcune funzioni dipendono dal browser e dalle politiche del sistema operativo.