Guida all’uso di Tessaro

1. Primi passi

Accedere

Aprite la pagina Accesso, quindi inserite la vostra e-mail e la vostra password. Per una nuova azienda, create il vostro spazio dalla pagina Prova gratuita (14 giorni, senza carta di credito). Per entrare in un’azienda già registrata, il vostro account viene creato dal suo amministratore, che vi comunica una password iniziale.

• Cambiate questa password al primo accesso, dal menu del vostro profilo. Una password conta almeno 8 caratteri, con lettere e cifre.
• Dopo 5 password errate, l’account viene bloccato per 15 minuti. L’amministratore può sbloccarlo reimpostando la password.
• La sessione resta aperta finché usate l’applicazione; «Esci» la chiude immediatamente.

La schermata di lavoro

Il menu a sinistra (pulsante menu sul telefono) raggruppa i moduli per ambito: Controllo, Cantieri, Commerciale, Catalogo, Acquisti, Magazzino, Squadre, Risorse, Finanza e Amministrazione. Vedete solo i moduli aperti al vostro ruolo. Un modulo che il vostro piano non comprende resta visibile nel menu, con il nome del piano che lo include (vedi Abbonamento). Ogni elenco offre una ricerca, un filtro per periodo quando è pertinente e un’esportazione CSV per i ruoli autorizzati.

L’applicazione esiste in cinque lingue: francese, arabo, inglese, spagnolo e italiano. La lingua si sceglie obbligatoriamente alla creazione dell’account e non può più essere cambiata in seguito: accesso, schermate di gestione, modalità cantiere, portale cliente, pagine aperte dai vostri clienti e fornitori, PDF ed e-mail sono tutti nella lingua della vostra azienda, per tutta la squadra.

Uno spazio vuoto all’inizio

Il vostro spazio parte senza alcun dato: nessun cantiere, nessun cliente, nessun deposito, nessuna categoria. Inserite o importate i vostri dati, nella vostra lingua.

I ruoli

Un utente ha un solo ruolo, che stabilisce cosa può consultare, creare, modificare, eliminare, convalidare ed esportare.

La matrice completa, modulo per modulo, è visibile nell’applicazione: Amministrazione → Utenti → Ruoli e permessi.

Il ruolo «Commercialista (esterno)» è un accesso gratuito, in sola lettura, per lo studio che tiene la vostra contabilità: vedi Esportazione contabile e commercialista.

2. Cantieri, lotti e foto

Il cantiere è l’oggetto centrale: acquisti, movimenti di magazzino, timbrature, contratti di subappalto e fatture vi fanno riferimento. La sua scheda riporta il cliente, le date, l’importo del contratto (al netto delle imposte) e il budget dei costi previsto: questi due importi servono al calcolo della redditività.

Stati di un cantiere

• Preparazione
• In attesa
• In corso
• Sospeso
• Terminato
• Consegnato
• Archiviato

Lotti e attività

Un cantiere si suddivide in lotti, ciascuno legato a una categoria di lavori:

• Opere strutturali
• Impianto elettrico
• Impianto idraulico
• Serramenti
• Tinteggiatura
• Climatizzazione
• Piastrellatura
• Varie

Le attività descrivono il lavoro da fare; il loro stato passa da «Da fare» a «In corso» e poi «Completata». La panoramica del cantiere riunisce avanzamento, lotti, attività, acquisti e costi.

Giornale di cantiere

Il capocantiere o il direttore dei lavori vi annota lo svolgimento della giornata. Tutti i ruoli che hanno accesso al cantiere possono rileggerlo.

Foto di cantiere

La scheda «Foto» del cantiere riunisce le foto scattate con il telefono, da questa scheda o dalla modalità cantiere. Vengono ridimensionate prima dell’invio; a ciascuna si possono assegnare una zona (piano, lotto…) e una didascalia. Spuntate «Visibile al cliente» perché una foto compaia sul suo portale di monitoraggio; le altre restano interne.

3. Clienti, potenziali clienti e preventivi

Potenziali clienti e clienti

Un potenziale cliente avanza nella pipeline commerciale:

• Nuovo
• Contattato
• Sopralluogo
• Preventivi
• Trattativa
• Acquisito
• Perso

Quando uno dei suoi preventivi viene trasformato in cantiere, il potenziale cliente diventa automaticamente un cliente, alla fase «Acquisito».

Redigere un preventivo

1. In Commerciale → Preventivi, create un preventivo e scegliete il cliente o il potenziale cliente. Il numero (DEV-anno-numero) viene assegnato automaticamente.
2. Aggiungete le righe: descrizione, unità, quantità, prezzo unitario, sconto in % e aliquota IVA. Potete partire da un prodotto del catalogo, oppure cliccare su «Aggiungi voce di lavoro» per riprendere una prestazione dalla vostra libreria.
3. I totali imponibile, IVA e IVA inclusa sono calcolati dall’applicazione; l’IVA si applica all’importo al netto dello sconto.

Voci di lavoro e libreria di voci di lavoro tipo

Una voce di lavoro è una prestazione che quotate spesso: codice, descrizione, unità, prezzo di vendita e aliquota IVA. Le voci di lavoro si gestiscono in Catalogo → Voci di lavoro.

• In un preventivo, «Aggiungi voce di lavoro» apre una ricerca per codice o per descrizione tra le vostre voci di lavoro attive. La riga aggiunta riprende descrizione, unità, prezzo di vendita e IVA della voce, con una quantità di 1 da correggere.
• Finché non avete alcuna voce di lavoro, la schermata Voci di lavoro propone la scheda «Carica una libreria di voci di lavoro tipo»: il pulsante «Carica la libreria» aggiunge 44 voci di lavoro comuni dell’edilizia residenziale, ordinate per categoria di lavori.
• Questa libreria fornisce le descrizioni e le unità, non i prezzi: vengono creati a 0 e restano da compilare a cura vostra. Si carica solo in un elenco di voci di lavoro vuoto.

• Opere strutturali
• Muratura
• Impermeabilizzazione
• Impianto elettrico
• Impianto idrico-sanitario
• Piastrellature e rivestimenti
• Serramenti
• Tinteggiatura

Modelli di preventivo

• Salvare: sulla scheda di un preventivo con almeno una riga, «Salva come modello» copia le sue righe (descrizioni, quantità, prezzi, sconti, IVA) con il nome che preferite. Cliente, date e totali non vengono ripresi.
• Riutilizzare: nell’elenco dei preventivi, «Da un modello» chiede il modello e il cliente, poi crea un preventivo in bozza, datato oggi, con le righe e i prezzi del modello. Tutto resta modificabile prima dell’invio.
• Gestire: il pulsante «Modelli» permette di vedere le righe di un modello, di rinominarlo o di eliminarlo. Eliminare un modello non modifica i preventivi già creati a partire da esso.
• Due modelli non possono avere lo stesso nome e un’azienda conserva al massimo 100 modelli. Una riga collegata a un prodotto ritirato dal catalogo viene conservata, come testo libero.

Stati di un preventivo

• Bozza
• Inviato
• Accettato
• Rifiutato
• Scaduto
• Convertito in cantiere

• Solo un preventivo «Bozza» è modificabile. Una volta «Inviato», può tornare in bozza per essere corretto, oppure passare a «Accettato», «Rifiutato» o «Scaduto».
• «Duplica» crea una nuova bozza a partire da un preventivo esistente: comodo per una variante.

Accettazione online da parte del cliente

Il vostro cliente può accettare o rifiutare un preventivo da un link privato, senza creare un account.

1. Passate il preventivo a «Inviato». Sulla sua scheda, aprite «Link di accettazione», poi cliccate su «Crea il link di accettazione». Questo pulsante è riservato ai ruoli che possono modificare i preventivi.
2. Copiate il link, oppure inviatelo via WhatsApp o via e-mail dalla finestra. Il link è mostrato solo in quel momento: se va perso, usate «Rigenera il link».
3. Il cliente apre la pagina, nella lingua della vostra azienda: numero del preventivo, data di validità, dettaglio delle righe, totali, le vostre note e condizioni, e un pulsante per scaricare il PDF.
4. Per accettare, inserisce il suo nome completo, spunta «Ho letto e accetto questo preventivo», poi clicca su «Accetto questo preventivo». Per rifiutare, clicca su «Rifiuto» e può indicare un motivo (500 caratteri al massimo).

Il preventivo passa allora a «Accettato» o a «Rifiutato» e l’autore del preventivo viene avvisato via e-mail. La scheda del preventivo mostra ciò che è stato registrato: il nome inserito dal cliente, la data e l’ora della sua risposta e il suo indirizzo IP, oppure il motivo del rifiuto. La risposta viene anche iscritta nel registro di audit. Dalla sua pagina, il cliente non può più modificarla.

Il link smette di funzionare nei casi seguenti:

• alla fine dell’ultimo giorno di validità del preventivo («Valido fino al»); se il preventivo non ha una data di validità futura, 30 giorni dopo la creazione del link;
• appena cliccate su «Rigenera il link» (il vecchio link viene sostituito) o su «Disattiva il link»;
• se il preventivo torna in bozza o viene eliminato;
• se siete voi stessi a dare un esito al preventivo (accettato, rifiutato, scaduto): la pagina indica allora che il preventivo non è più aperto all’accettazione online.

Trasformare un preventivo in cantiere

Su un preventivo «Accettato», l’azione «Trasforma in cantiere» crea il cantiere (stato «Preparazione») con il totale imponibile del preventivo come importo del contratto. Se il preventivo era già collegato a un cantiere, viene ripreso quel cantiere e il suo importo del contratto viene compilato solo se era vuoto. Il preventivo passa allora a «Convertito in cantiere» e non può più essere eliminato. Questa azione richiede il diritto «convalidare» sui preventivi.

PDF del preventivo

Dalla scheda del preventivo, «Visualizza il PDF» apre il documento e «Scarica» lo salva: logo e dati della vostra azienda, righe, totali, importo in lettere e piè di pagina. «Condividi» crea un link a questo PDF da inviare via WhatsApp o via e-mail (vedi Condivisione di documenti). Logo e piè di pagina si impostano in Amministrazione → Azienda.

4. Acquisti, consultazione online e comparatore

Un acquisto segue sempre lo stesso percorso, dall’espressione del fabbisogno al ricevimento:

1. Richiesta d’acquistoIl cantiere elenca i prodotti e le quantità di cui ha bisogno. La richiesta (DA-anno-numero) resta modificabile finché è «Bozza».
2. ConvalidaUna volta «Inviata» (almeno una riga), un responsabile con il diritto «convalidare» la passa a «Convalidata» o «Respinta». L’autore di una richiesta non può convalidarla da sé: deve farlo un altro validatore. Unica eccezione, l’azienda in cui è l’unico utente attivo in grado di convalidare: la convalida viene allora accettata e annotata nella richiesta.
3. Offerte dei fornitoriConsultate i vostri fornitori online (vedi sotto) o inserite voi stessi, per ogni fornitore, il prezzo unitario e lo sconto di ogni riga, le spese di trasporto e il termine di consegna. Una riga può essere segnata come non disponibile. Dalla prima offerta, la richiesta passa a «In consultazione».
4. ComparatoreLa tabella incrocia le righe della richiesta e le offerte; vedi il dettaglio qui sotto.
5. Ordini d’acquistoScegliete un fornitore unico (la sua offerta deve coprire tutte le righe) o la migliore combinazione: viene generato un ordine d’acquisto (BC-anno-numero) per ogni fornitore scelto e la richiesta passa a «Ordinata».
6. RicevimentoAlla consegna, inserite le quantità ricevute e il deposito di destinazione. Viene creato un documento di ricevimento e il magazzino di quel deposito aumenta.

Consultazione online dei fornitori

1. Sulla richiesta d’acquisto, cliccate su «Consulta fornitori» e spuntate quelli da interpellare. Ogni fornitore deve avere un indirizzo e-mail sulla sua scheda.
2. Ciascuno riceve via e-mail un link personale, valido 14 giorni. Non deve creare alcun account.
3. Sulla sua pagina, inserisce i suoi prezzi unitari al netto delle imposte, lo sconto, le spese di trasporto, il termine di consegna, le condizioni di pagamento e la garanzia; può spuntare «Non disponibile» su una riga, e poi correggere la sua offerta finché l’ordine non è stato emesso.
4. La sua offerta compare nella richiesta d’acquisto e nel comparatore; ne siete avvisati con una notifica.

La pagina aperta dal fornitore è nella lingua della vostra azienda. I suoi prezzi sono visibili solo alla vostra azienda.

Leggere il comparatore

Tutti gli importi confrontati sono al netto delle imposte e degli sconti.

• Miglior prezzo per riga: l’offerta più conveniente di ogni riga è evidenziata.
• Totale per fornitore: righe offerte + trasporto, con l’indicazione delle offerte incomplete.
• Miglior fornitore unico: l’offerta completa più conveniente, trasporto compreso.
• Migliore combinazione: la ripartizione tra fornitori che costa meno, compreso il trasporto di ogni fornitore scelto. A parità di costo, l’applicazione preferisce il minor numero di fornitori, poi quelli con la valutazione migliore.
• Risparmio: in evidenza, la differenza tra la migliore combinazione e il miglior fornitore unico (importo e percentuale del suo totale): è il risparmio reale. La differenza rispetto all’offerta completa più cara è ricordata in piccolo.

Stati di un’offerta fornitore:

• Richiesto
• Ricevuto
• Selezionato
• Respinto

Stati di un ordine d’acquisto

• Bozza
• Inviato
• Ricevuto parzialmente
• Ricevuto
• Annullata

• Un ordine si riceve quando è «Inviato» o «Ricevuto parzialmente». Passa a «Ricevuto» quando tutto è stato consegnato.
• La quantità ricevuta non può superare il residuo da consegnare della riga.
• Un ordine non può più essere annullato dopo la registrazione di un ricevimento.
• «Invia al fornitore» invia l’ordine via e-mail. Un ordine passato per telefono (o in altro modo) si annota con «Segna come inviato»: scegliete il canale e l’ordine passa a «Inviato» alla data odierna, senza e-mail.
• Il PDF dell’ordine d’acquisto riporta un riquadro «Consegna»: cantiere, indirizzo di consegna (il deposito scelto sull’ordine, altrimenti l’indirizzo del cantiere), data desiderata e referente in loco. Le righe riportano il codice del prodotto.

5. Area fornitore

Potete aprire a ciascuno dei vostri fornitori un’area online a suo nome: vi gestisce il suo catalogo, risponde alle vostre richieste di offerta e conferma i vostri ordini d’acquisto. È una funzione inclusa nei piani Pro ed Entreprise.

Lato azienda

1. In Acquisti → Fornitori, inserite l’indirizzo e-mail del fornitore, poi aprite «Area fornitore» sulla sua riga e scegliete «Crea l’accesso fornitore».
2. Il fornitore riceve un’e-mail con un link, valido 7 giorni, per scegliere la sua password. Il suo identificativo è questo indirizzo e-mail; un indirizzo può servire a un solo account.
3. La riga del fornitore indica lo stato dell’accesso: invito inviato, attivo o bloccato. Potete reinviare l’invito, inviare un link di reimpostazione della password, bloccare l’accesso (il fornitore viene disconnesso subito) o sbloccarlo. Disattivare o eliminare il fornitore chiude anche il suo accesso.
4. «Catalogo del fornitore», sulla stessa riga, mostra i suoi articoli. «Aggiungi ai miei prodotti» li trasforma in prodotti del vostro catalogo, con un prezzo d’acquisto a 0 da compilare poi; un prodotto già presente (stesso codice o stessa descrizione) non viene ricreato.
5. Quando passate un ordine d’acquisto da «bozza» a «inviato», il fornitore riceve un’e-mail con il link al PDF, il cantiere e il luogo di consegna. «Reinvia al fornitore» invia di nuovo questa e-mail. La sua conferma e la sua data di consegna compaiono sull’ordine d’acquisto, e ne siete avvisati con una notifica.

• Cosa vede il fornitore: il suo catalogo, le richieste di offerta che gli avete inviato, i propri ordini d’acquisto (mai le vostre bozze) con il cantiere e l’indirizzo di consegna, e i suoi dati.
• Cosa non vede: tutto il resto, cioè i vostri altri fornitori e i loro prezzi, i vostri clienti, i vostri cantieri, il vostro magazzino, le vostre fatture.
• Un account fornitore non conta nel limite di utenti del vostro piano e non compare in Amministrazione → Utenti.

Lato fornitore

• Il mio catalogo: gli articoli venduti, ordinati per categoria, con codice, unità e descrizione, senza prezzi né giacenze. Un articolo può essere nascosto senza essere eliminato.
• Importa: un file PDF o Excel (5 MB al massimo) viene letto automaticamente. Viene proposta un’anteprima; il fornitore corregge le descrizioni, completa le categorie, deseleziona ciò che non vuole, poi importa. Nulla viene salvato prima di questa conferma, e gli articoli già presenti nel catalogo vengono ignorati. Un PDF scansionato (un’immagine) non può essere letto.
• Richieste di offerta: lo stesso modulo del link di consultazione ricevuto via e-mail. Un’offerta trasmessa dall’area non è più modificabile.
• Ordini d’acquisto: righe, totale, PDF, luogo di consegna con un link «Visualizza sulla mappa», e «Conferma l’ordine» con una data di consegna e un messaggio facoltativi.
• Il mio account: nome del referente, telefono, indirizzo, città e password. Ragione sociale, codice fiscale e indirizzo e-mail restano gestiti dalla vostra azienda.

Password smarrita: «Password dimenticata?», sulla pagina di accesso, invia un link valido 1 ora. Questo link esiste per tutti gli account dell’applicazione.

6. Magazzino

Depositi

Il magazzino è gestito per prodotto e per ubicazione. Un’ubicazione può essere:

• Deposito centrale
• Cantiere
• Veicolo
• Negozio

Tipi di movimento

Un movimento che renderebbe negativa la giacenza viene rifiutato, con l’indicazione della quantità disponibile. Ogni movimento viene conservato nello storico.

Ogni cantiere riceve automaticamente, alla sua creazione, la propria ubicazione «cantiere»: un ordine può esservi consegnato direttamente.

Valorizzazione

Il magazzino è valorizzato al costo medio ponderato unitario (CMP) di ogni deposito, non al prezzo di catalogo. Un ricevimento d’ordine entra al prezzo d’acquisto dell’ordine, al netto dello sconto, con le spese di trasporto dell’ordine ripartite in proporzione al valore delle righe; il CMP del deposito viene allora ricalcolato. Le uscite, i consumi di cantiere e i trasferimenti sono valorizzati al CMP del deposito di origine.

Avvisi

• Esaurito: la quantità in magazzino è nulla.
• Scorta bassa: la quantità è inferiore o uguale alla scorta minima definita sul prodotto.

7. Timbratura e poster QR

Foglio del giorno

In Squadre → Presenze, scegliete la data, poi filtrate per cantiere o per squadra. Il foglio elenca i dipendenti interessati; per ciascuno indicate lo stato e, se è presente, l’ora di entrata e di uscita.

• Presente
• Assente
• Ritardo
• Ferie
• Trasferta

• Le ore sono calcolate dall’applicazione a partire dagli orari: una pausa di 60 minuti viene detratta dalle giornate di oltre 6 ore, e il tempo oltre le 8 ore viene conteggiato come straordinario.
• Un’uscita precedente all’entrata viene trattata come turno di notte.
• Un dipendente il cui account è collegato alla sua scheda può timbrare da sé entrata e uscita da «La mia timbratura»; l’ora registrata è quella del server.
• Per collegare un account a una scheda: Amministrazione → Utenti, «Modifica», campo «Scheda dipendente (per la timbratura)». Una scheda è collegata a un solo account; l’elenco degli utenti indica, sotto ogni nome, la scheda collegata.

Convalida

Il capocantiere o il direttore dei lavori convalida le timbrature di una giornata, per un cantiere o per tutti. Una riga convalidata non è più modificabile da un ruolo che non ha il diritto «convalidare», né dal dipendente stesso.

Poster QR di timbratura

Sulla scheda di un cantiere, scheda «Squadra», il pulsante «QR di timbratura» apre un poster da stampare: nome del cantiere, codice QR e istruzioni nella lingua della vostra azienda, ciascuna ripetuta in arabo. Il dipendente scansiona il codice con la fotocamera del telefono, accede se gli viene chiesto, poi timbra l’entrata o l’uscita su quel cantiere. La timbratura resta riservata agli account collegati a una scheda dipendente. Senza rete, lo stesso QR apre la modalità cantiere con quel cantiere già selezionato, se la modalità cantiere è già stata aperta su quel telefono.

Riepilogo mensile

Il riepilogo fornisce, per dipendente e per il mese scelto, il numero di giorni per stato, le ore ordinarie, le ore di straordinario e il corrispondente costo della manodopera. Serve da base per la preparazione delle buste paga e alimenta la redditività dei cantieri.

8. Modalità cantiere offline

La modalità cantiere (menu Cantieri → Modalità cantiere) è una schermata pensata per il telefono: riunisce la timbratura personale, le foto di cantiere e l’inserimento di un rifornimento di carburante. La timbratura e le foto restano utilizzabili senza rete. È nella lingua della vostra azienda, come il resto dell’applicazione.

Cosa funziona senza rete

• Timbrare entrata e uscita. Online, l’ora registrata è quella del server, nel fuso orario dell’azienda (Amministrazione → Azienda; Tunisi per impostazione predefinita). Offline, è l’ora del telefono: la timbratura è contrassegnata come «Inserito offline» e resta da convalidare da parte del capocantiere.
• Scattare foto di cantiere. Scegliete prima il cantiere; le foto vengono ridimensionate sul telefono e restano sul dispositivo fino al loro invio.

Cosa richiede una connessione

La scheda «Rifornimento» registra solo online: un rifornimento non viene messo in coda. Senza rete, annotate i litri, l’importo e il contatore, poi inseriteli al ritorno della connessione. Vedi Veicoli, autisti e carburante.

La coda di invio

Tutto ciò che viene inserito senza rete compare nella scheda «Coda di invio». L’invio parte al ritorno della rete finché la pagina è aperta, oppure alla sua apertura successiva; il pulsante «Sincronizza ora» lo avvia manualmente. Non c’è invio in background ad applicazione chiusa.

Installare l’applicazione sul telefono

Tessaro è un’applicazione web installabile: dal menu del browser del telefono, scegliete «Aggiungi alla schermata Home» (o «Installa app»). Non c’è alcuna applicazione da scaricare da uno store.

9. Veicoli, autisti e carburante

I veicoli si gestiscono in Risorse → Attrezzature e mezzi, insieme al resto delle attrezzature: non esiste un elenco separato dei veicoli. La schermata ha tre schede: «Attrezzature e mezzi», «Assegnazioni» e «Carburante».

Scheda di un veicolo o di un mezzo

Oltre a codice, nome, tipo e stato, la scheda di un’attrezzatura riporta:

• Veicolo: «Targa», «Autista abituale» (un dipendente) e «Costo giornaliero imputato al cantiere», in DT per giorno di assegnazione (0 = non viene imputato nulla).
• Scadenze amministrative: tre date, «Assicurazione», «Revisione» e «Bollo auto».

Il costo giornaliero è mostrato solo ai ruoli che consultano la redditività, una funzione inclusa nei piani Pro ed Entreprise. Nell’elenco, una scadenza entro 30 giorni viene segnalata sotto il nome del mezzo («scade tra 12 giorni», «scaduta da 3 giorni»).

Autisti

Un autista è un dipendente: non c’è una scheda separata. La sua scheda, in Squadre → Dipendenti, contiene la sezione «Patente di guida», con «N. patente» e «Validità della patente». Una patente che scade entro 30 giorni viene segnalata nell’elenco dei dipendenti.

Assegnare un mezzo a un cantiere

1. Nella scheda «Assegnazioni», create un’assegnazione: attrezzatura, cantiere, data di inizio e, se la conoscete, data di fine. Lasciate vuota la fine finché il mezzo resta sul cantiere.
2. L’autista è facoltativo: se lasciato vuoto, viene ripreso l’autista abituale del mezzo.
3. Dall’elenco delle attrezzature, l’icona «Assegnazioni di questo mezzo» apre le sue assegnazioni.

• Un mezzo non può avere due assegnazioni con periodi sovrapposti: la seconda viene rifiutata, con il nome del cantiere e le date in conflitto.
• Finché un’assegnazione copre la data odierna, il mezzo passa allo stato «Assegnato» su quel cantiere; un mezzo «In manutenzione» o «Fuori servizio» mantiene il suo stato.
• Il mezzo di un’assegnazione non si cambia: chiudetela e createne una nuova.

Costo di un’assegnazione = giorni trascorsi × costo giornalieroGiorni contati dall’inizio alla fine dell’assegnazione, o fino a oggi se è in corso, estremi inclusi. I giorni futuri non contano.

Il costo giornaliero viene copiato dalla scheda del mezzo alla creazione dell’assegnazione, poi bloccato: modificare in seguito la tariffa del mezzo non cambia il costo già attribuito al cantiere.

Rifornimenti di carburante

Un rifornimento si registra in due modi:

• In ufficio, nella scheda «Carburante»: data, attrezzatura, cantiere, «Rifornimento effettuato da», litri, importo in DT e, se lo rilevate, il contatore (km o ore).
• Sul campo, in Cantieri → Modalità cantiere, scheda «Rifornimento»: veicolo o mezzo, litri, importo e contatore, poi «Registra il rifornimento». Il rifornimento viene collegato al cantiere scelto in cima alla pagina o, in mancanza, a quello della vostra timbratura del giorno. Questa scheda richiede una connessione.

• La scheda della modalità cantiere propone i mezzi a motore (veicolo, camion, betoniera, gru, escavatore, piattaforma aerea) che non sono fuori servizio. Viene mostrata ai ruoli che possono creare in «Attrezzature e mezzi».
• La data di un rifornimento non può essere nel futuro.
• Un contatore rilevato aggiorna il contatore del mezzo se è superiore: il contatore non torna mai indietro.
• Il cantiere è facoltativo; senza cantiere, il rifornimento non viene imputato ad alcun cantiere.

Effetto sul costo del cantiere

Il costo delle assegnazioni e l’importo dei rifornimenti collegati a un cantiere si sommano alla sua voce «Attrezzatura», quindi al suo costo effettivo e alla sua redditività. Sulla scheda del cantiere, la scheda «Mezzi» elenca i mezzi assegnati, le loro date e il loro autista, e riporta il totale del carburante.

Promemoria delle scadenze

Un controllo quotidiano sorveglia l’assicurazione, la revisione e il bollo di ogni mezzo, nonché la patente di ogni dipendente attivo.

• Tre promemoria per scadenza: 30 giorni prima, 7 giorni prima e il giorno stesso. Una scadenza inserita in ritardo fa partire solo il promemoria del momento.
• Gli amministratori e i direttori ricevono un’unica e-mail, che raggruppa tutte le scadenze del giorno; compare anche una notifica nell’applicazione.
• Le scadenze di un mezzo «Fuori servizio» non vengono ricordate.
• Rinnovate la data sulla scheda per far ripartire il ciclo dei promemoria.

10. Stati di avanzamento lavori, fatture e redditività

Il modulo Finanza raggruppa gli stati di avanzamento lavori, le fatture clienti (acconto, avanzamento, SAL, conto finale, nota di credito), le fatture fornitori e i pagamenti, cioè incassi ed esborsi. La redditività, invece, non si inserisce: viene calcolata a partire da ciò che è stato registrato sul cantiere.

Stati di avanzamento lavori

1. In Finanza → Stati di avanzamento lavori, create un SAL per un cantiere. Riprende i suoi lotti e il loro importo di contratto; il suo numero (SIT-anno-numero) viene assegnato automaticamente.
2. Indicate l’avanzamento cumulato di ogni lotto. L’applicazione calcola i lavori cumulati, sottrae i lavori dei SAL precedenti e ottiene i lavori del periodo.
3. Il riepilogo aggiunge l’IVA, poi detrae la ritenuta di garanzia e l’acconto: mostra il netto da pagare. L’imposta di bollo e la ritenuta d’acconto della vostra azienda vi compaiono quando sono compilate (vedi sotto).
4. Finché è in bozza, il SAL si modifica o si elimina. «Convalida e fattura» lo blocca e crea la fattura cliente corrispondente, con le sue righe e il suo PDF.

Per capire il calcolo con un esempio numerico, leggete le nostre guide: lo stato di avanzamento lavori (in francese) e la ritenuta di garanzia (in francese).

Imposta di bollo, ritenuta d’acconto e IVA per aliquota

Queste opzioni riguardano le fatture clienti. Sono facoltative: a 0, nulla cambia sulle vostre fatture.

• Valori predefiniti: in Amministrazione → Azienda, i campi «Imposta di bollo per fattura (DT)» e «Ritenuta d’acconto predefinita (%)» stabiliscono ciò che viene proposto su ogni nuova fattura cliente, compresa quella creata da uno stato di avanzamento lavori.
• Fatture già create: quando modificate uno di questi due valori, compare una casella «Applica anche alle fatture clienti esistenti non saldate», spuntata. Al salvataggio, il netto da pagare delle bozze e delle fatture convalidate o parzialmente pagate viene ricalcolato; le fatture pagate o annullate e le note di credito non cambiano. Deselezionatela per applicare il nuovo valore solo alle fatture future.
• Fatture fornitori: in Finanza → Fatture fornitori, ogni riga ha le stesse icone «visualizza» e «scarica» delle fatture clienti. Il PDF è una scheda riepilogativa (fornitore, numero, importi, residuo da pagare); fa fede la fattura originale del fornitore.
• Fattura per fattura: i campi «Imposta di bollo (DT)» e «Ritenuta alla fonte (%)» della fattura restano modificabili finché è in bozza.
• IVA per aliquota: il PDF della fattura dettaglia, per ogni aliquota, l’imponibile e l’IVA. Sullo schermo, questo dettaglio compare appena le righe hanno più aliquote. L’IVA di un’aliquota è la somma dell’IVA delle sue righe.

Netto da pagare = totale IVA inclusa + imposta di bollo − ritenuta di garanzia − acconto − ritenuta d’accontoTotale IVA inclusa = imponibile + IVA. Ritenuta d’acconto = aliquota inserita × totale IVA inclusa, arrotondata al millesimo. Residuo da pagare = netto da pagare − importo incassato.

L’imposta di bollo è un importo fisso aggiunto dopo l’IVA: non entra né nel totale IVA inclusa, né nella base IVA, né nella base della ritenuta d’acconto.

Sollecitare una fattura non pagata

Su una fattura cliente convalidata o parzialmente pagata che ha ancora un residuo da pagare, il pulsante «Sollecita» apre la finestra di sollecito. Non compare su una bozza, né su una fattura pagata o annullata, né su una nota di credito, ed è riservato ai ruoli che possono modificare le fatture clienti.

• La finestra propone un messaggio che rileggete e correggete. Contiene un link al PDF della fattura, creato al momento dell’invio e valido 30 giorni.
• «Invia via e-mail»: l’e-mail parte all’indirizzo della scheda del cliente, a nome della vostra azienda. Il cliente risponde all’indirizzo e-mail della vostra azienda o, se non è compilato, al vostro.
• «Apri WhatsApp»: si apre la conversazione con il cliente, con il messaggio precompilato; resta a voi inviarlo. L’applicazione non sa se il messaggio è partito: lo storico annota «WhatsApp aperto».
• Un canale non è disponibile se la scheda del cliente non ha un indirizzo e-mail, o un numero di telefono utilizzabile: la finestra lo indica.
• Una sola e-mail di sollecito per fattura e per ora, solleciti automatici compresi.
• La finestra conserva lo storico dei solleciti della fattura: data, canale, destinatario e autore.

Solleciti automatici (opzionali)

I solleciti automatici sono disattivati per impostazione predefinita, perché le e-mail partono verso i vostri clienti. L’amministratore li attiva in Amministrazione → Azienda, scheda «Solleciti automatici delle fatture non pagate», con l’interruttore «Invia solleciti automatici ai miei clienti via e-mail». L’indirizzo e-mail della vostra azienda deve essere compilato: i vostri clienti vi rispondono.

• Fatture interessate: convalidate o parzialmente pagate, escluse le note di credito, con una scadenza superata, un residuo da pagare e un cliente che ha un indirizzo e-mail. Una fattura senza scadenza non viene mai sollecitata.
• Soglie: numeri di giorni di ritardo dopo la scadenza, 7, 15, 30 per impostazione predefinita. Scegliete da 1 a 5 soglie, tra 1 e 120 giorni.
• Il controllo avviene una volta al giorno. Ogni soglia viene inviata una sola volta; se più soglie sono già superate, parte solo la più alta e quelle inferiori non partiranno più.
• Nessuna e-mail automatica parte per una fattura sollecitata via e-mail da meno di 2 giorni, manualmente o automaticamente: la soglia viene rinviata al controllo successivo.
• Al massimo 50 e-mail per azienda e per giorno; il resto parte nei giorni successivi.
• L’e-mail indica il numero della fattura, la sua scadenza, l’importo residuo e un link al PDF. Un riepilogo compare nelle vostre notifiche dopo ogni invio.
• Se posticipate la scadenza di una fattura già sollecitata, le soglie già inviate non ripartono.

Costo effettivo di un cantiere

Costo effettivo = acquisti ricevuti + manodopera timbrata + subappalto + attrezzaturaTutti gli importi sono al netto delle imposte.

• Acquisti ricevuti: valore delle quantità effettivamente ricevute sugli ordini d’acquisto del cantiere, spese di trasporto dell’ordine comprese (in proporzione a quanto ricevuto): un ordine non consegnato non pesa ancora sul costo. Vi si aggiunge il materiale di magazzino consumato sul cantiere, valorizzato al costo medio ponderato del deposito, escluse le quantità già consegnate dagli ordini del cantiere: uno stesso acquisto non viene mai contato due volte.
• Manodopera timbrata: ore timbrate sul cantiere × costo orario del dipendente; le ore di straordinario sono maggiorate del 25 %.
• Subappalto: importo di ogni contratto × la sua percentuale di avanzamento.
• Attrezzatura: assegnazioni di mezzi (giorni trascorsi × costo giornaliero), carburante collegato al cantiere e manutenzione dei mezzi attualmente assegnati al cantiere. Vedi Veicoli, autisti e carburante.

Margine e scostamenti

Avvisi di sforamento del budget

Quando il costo effettivo di un cantiere attivo raggiunge l’80 % e poi il 100 % del suo budget, gli amministratori e i direttori vengono avvisati via e-mail, e gli utenti che consultano la redditività con una notifica.

• Il controllo avviene una volta al giorno, sui cantieri con stato «Preparazione», «In attesa», «In corso», «Sospeso» che hanno un budget inserito. Un cantiere senza budget viene ignorato.
• Ogni soglia viene segnalata una sola volta per cantiere, anche se il consumo scende e poi risale. Se il 100 % viene raggiunto subito, viene inviato solo l’avviso del 100 %.
• L’avviso riguarda l’intero cantiere, non ogni lotto: le spese sono collegate al cantiere, non ai suoi lotti.
• Gli avvisi sono attivi per impostazione predefinita. L’amministratore li disattiva in Amministrazione → Azienda, interruttore «Avvisi di sforamento del budget».

11. Esportazione contabile e commercialista

Esportare i registri di un periodo

1. Aprite Finanza → Esportazione contabile.
2. Scegliete il periodo: «Questo mese», «Mese scorso», «Questo trimestre», «Trimestre scorso», «Quest’anno», oppure date a vostra scelta (due anni al massimo).
3. La schermata mostra cosa conterranno i file: numero di fatture, totali, IVA a debito per aliquota, e il numero di bozze e di fatture annullate escluse.
4. Cliccate su «Scarica il CSV» sotto «Registro vendite» o sotto «Registro acquisti».

• Le fatture vengono selezionate in base alla loro data. Compaiono solo le fatture convalidate, parzialmente pagate o pagate; le bozze e le fatture annullate sono escluse.
• Nel registro vendite, una nota di credito è riportata in negativo. Se i totali di una fattura si discostano dalle sue righe, la differenza compare in due colonne «non ripartito», perché la somma delle colonne torni al totale.
• Nel registro acquisti, l’IVA non è dettagliata per aliquota: le fatture fornitori sono inserite per totali.
• Ogni file termina con una riga «TOTALE».
• Formato: CSV codificato in UTF-8, separatore punto e virgola, virgola decimale, importi a 3 decimali, date nel formato gg/mm/aaaa. Si apre direttamente in Excel.
• Oltre le 10 000 fatture nel periodo, l’applicazione chiede di ridurlo e di esportare in più volte.

Dare un accesso al vostro commercialista

In Amministrazione → Utenti, create un account con il ruolo «Commercialista (esterno)».

• Cosa vede, in sola lettura: fatture clienti e fornitori, pagamenti, stati di avanzamento lavori, clienti, fornitori, preventivi ed esportazione contabile, nei limiti di ciò che comprende il vostro piano. Può scaricare i due registri.
• Cosa non vede: la dashboard, i cantieri, il magazzino, le squadre, gli utenti. Non può creare, modificare, convalidare né eliminare nulla.
• Account gratuito: non conta nel limite di utenti del vostro piano. Un’azienda può avere al massimo 2 account attivi con questo ruolo contemporaneamente.
• Un account è collegato a una sola azienda: uno studio che segue più aziende usa un indirizzo e-mail diverso per ciascuna.

12. Portale cliente, rapporto di avanzamento e condivisione

Portale di monitoraggio del cliente

1. Sulla scheda del cantiere, aprite «Portale cliente», poi «Attiva e ottieni il link».
2. Inviate questo link privato al vostro cliente, via WhatsApp o via e-mail, oppure copiatelo. Non deve creare alcun account.
3. «Rigenera il link» sostituisce il link (il vecchio smette di funzionare); «Disattiva il portale» lo chiude.

Il portale è nella lingua della vostra azienda. Il cliente vi vede:

• lo stato del cantiere, le sue date, l’avanzamento globale e l’avanzamento di ogni lotto;
• le foto contrassegnate come «Visibile al cliente»;
• le sue fatture convalidate, scaricabili in PDF, con ciò che è stato pagato e ciò che resta da pagare.

Non vi vede né budget, né costi, né margini.

Rapporto di avanzamento per il cliente

Sulla scheda del cantiere, «Rapporto di avanzamento» produce un PDF da consegnare al vostro cliente.

1. Scegliete il periodo (vengono proposti gli ultimi sette giorni).
2. Redigete, se lo desiderate, «Lavori eseguiti» e «Prossime fasi» (1 500 caratteri al massimo ciascuno).
3. Attivate o meno «Includi le foto del cantiere», poi cliccate su «Scarica».

• Cosa contiene: l’intestazione della vostra azienda con il logo, il cantiere e il cliente, il periodo, l’avanzamento globale e quello di ogni lotto, i vostri due testi, e le foto contrassegnate come «Visibile al cliente» scattate durante il periodo, le 8 più recenti al massimo.
• Cosa non contiene mai: budget, costi, margini, acquisti, timbrature. Non mostra nulla di più del portale cliente.
• Il rapporto non viene conservato online. Una volta scaricato, «Messaggio WhatsApp» e «Messaggio e-mail» preparano un messaggio a cui allegate il PDF; su un telefono che lo consente, «Condividi il PDF» trasmette direttamente il file.
• Servono il diritto di modificare i cantieri e un piano che comprenda il portale cliente: è una funzione inclusa nei piani Pro ed Entreprise.

Condivisione di documenti

Su un preventivo, una fattura o un ordine d’acquisto, «Condividi» crea un link pubblico al PDF, valido 30 giorni, da copiare o da inviare via WhatsApp o via e-mail. L’invio avviene dal vostro WhatsApp o dalla vostra casella di posta: l’applicazione prepara il messaggio, non invia nulla al posto vostro.

13. Amministrazione e importazione CSV

Utenti

• Creare: nome, e-mail (identificativo di accesso, univoco), telefono, ruolo e password iniziale.
• Modificare: nome, telefono, ruolo, account attivo o no. Disattivare un account chiude le sue sessioni.
• Reimpostare la password: imposta una nuova password, sblocca l’account e chiude le sue sessioni aperte.
• Eliminare: l’account non può più accedere e la sua e-mail torna utilizzabile; lo storico delle sue azioni viene conservato.

Due salvaguardie: non potete né disattivare, né declassare, né eliminare il vostro account, e un’azienda conserva sempre almeno un amministratore attivo. La scheda «Ruoli e permessi» mostra cosa può fare ogni ruolo.

Azienda

Il profilo dell’azienda alimenta i vostri documenti: ragione sociale, codice fiscale, indirizzo, città, telefono, e-mail, IBAN, logo (immagine PNG o JPG, 500 KB al massimo), aliquota IVA predefinita, valuta, imposta di bollo e ritenuta d’acconto proposte sulle fatture clienti (vedi Imposta di bollo e ritenuta d’acconto) e piè di pagina dei preventivi. Il logo compare su preventivi, fatture e ordini d’acquisto. Solo l’amministratore può modificare questo profilo.

La stessa schermata riunisce le impostazioni della vostra azienda: Il mio abbonamento, solleciti automatici delle fatture, report settimanale, avvisi di budget, programma di referral e avvio assistito.

Report settimanale via e-mail

All’inizio di ogni settimana, gli amministratori e i direttori ricevono via e-mail l’essenziale da seguire: cantieri in corso e loro avanzamento, preventivi in attesa di risposta, fatture clienti non pagate, prodotti sotto la soglia di scorta e richieste d’acquisto da convalidare. Una sezione il cui modulo non è compreso nel vostro piano non vi compare, e non viene inviata alcuna e-mail quando non c’è nulla da segnalare.

Il report è attivo per impostazione predefinita. L’amministratore lo disattiva o lo riattiva con l’interruttore «Report settimanale via e-mail», in Amministrazione → Azienda.

Esportare i vostri dati

In Amministrazione → Azienda, la scheda «I tuoi dati» permette all’amministratore di scaricare i dati della sua azienda in un file (formato JSON).

Importazione CSV

Gli elenchi di clienti, potenziali clienti, contatti, fornitori, prodotti, categorie e dipendenti offrono «Importa». L’importazione avviene in due tempi: il file CSV viene prima verificato e l’applicazione indica quante righe sono valide e quali presentano problemi; nulla viene salvato prima della vostra conferma. Da Excel, usate «Salva con nome» e poi il formato CSV.

Avvio assistito

Invece di importare da soli, potete affidare il vostro file esistente (clienti, prodotti, fornitori, listino prezzi) al team PURA Solutions, che lo importa nel vostro spazio.

1. In Amministrazione → Azienda, scheda «Avvio assistito», cliccate su «Scegli un file»: un file Excel (.xlsx, .xls) o CSV di 5 MB al massimo.
2. Descrivete se necessario cosa contiene, spuntate l’autorizzazione all’importazione, poi cliccate su «Invia il mio file». Solo l’amministratore può inviare una richiesta, e può essere aperta una sola richiesta alla volta.
3. Seguitene lo stato in «Le tue richieste». Finché è «In attesa», potete annullarla.
4. Quando l’importazione è completata, ricevete una notifica «Avvio completato».

• In attesa
• In corso
• Completata
• Annullata

• Il team PURA Solutions può importare nel vostro spazio solo mentre la vostra richiesta è «In corso»: la vostra richiesta vale come autorizzazione, e nessuna importazione è più possibile una volta chiusa.
• Usa la stessa importazione che usate voi, con gli stessi controlli, per gli stessi elenchi.
• Ogni importazione effettuata per vostro conto viene iscritta nel registro di audit della vostra azienda: vedete cosa è stato aggiunto, e da chi.
• Il vostro file viene eliminato appena la richiesta è completata o annullata.

Registro di audit

Il registro elenca, dal più recente al più vecchio, gli accessi, i tentativi di accesso falliti, i cambi di password e tutte le creazioni, modifiche ed eliminazioni: data, utente, azione, elemento interessato e indirizzo IP. Si filtra per azione, per e-mail e per periodo. È in sola lettura e limitato alla vostra azienda.

14. Abbonamento, piani e programma di referral

Un nuovo spazio inizia con una prova gratuita (14 giorni), durante la quale tutte le funzioni sono aperte, senza limiti di quantità. In seguito, la vostra azienda si abbona a un piano, per 6 mesi o per 1 anno. Non c’è pagamento online: l’amministratore della vostra azienda invia una richiesta e PURA Solutions la attiva dopo il pagamento. I piani e i loro prezzi sono presentati nella pagina Prezzi.

Cosa comprende ogni piano

Il contenuto di ogni piano è stabilito da PURA Solutions e può evolvere: fa fede la tabella comparativa della pagina Prezzi, e l’applicazione applica esattamente questa tabella. A oggi:

L’affiancamento offerto con alcuni piani (importazione dei vostri dati, formazione, configurazione: vedi la pagina Prezzi) è un servizio del team PURA Solutions, non una funzione del software.

Modulo non incluso nel piano

Un modulo che il vostro piano non comprende resta nel menu, con il nome del piano che lo include. Aprendolo, leggete cosa fa e quali piani lo comprendono. L’amministratore vi trova il pulsante per richiedere quel piano, che porta a «Il mio abbonamento»; gli altri utenti sono invitati a rivolgersi a lui. I vostri dati esistenti vengono conservati: un cambio di piano non elimina nulla.

Limiti di utenti e di cantieri

• Un piano può limitare il numero di utenti attivi, di cantieri attivi e di fornitori attivi. Questi limiti sono stabiliti da PURA Solutions; quando ci sono, sono indicati nella pagina Prezzi e nella vostra scheda «Il mio abbonamento», con il vostro consumo, sulle righe «Utenti attivi», «Cantieri attivi» e «Fornitori attivi».
• Un cantiere è attivo finché il suo stato è «Preparazione», «In attesa», «In corso», «Sospeso». Completare o archiviare un cantiere libera un posto.
• Non contano gli account disattivati o eliminati, né l’account dimostrativo, né gli account «Commercialista (esterno)», né gli account dell’area fornitore.
• Quando il limite è raggiunto, la creazione di un ulteriore utente, cantiere o fornitore viene rifiutata, con un messaggio che indica il limite e come superarlo.
• Durante la prova gratuita non si applica alcun limite.

Richiedere o rinnovare un abbonamento

1. Aprite Amministrazione → Azienda: la scheda «Il mio abbonamento» riporta il vostro piano, il suo stato e la sua scadenza.
2. Cliccate su «Richiedi un abbonamento», oppure «Rinnova o cambia piano» se siete già abbonati.
3. Scegliete il piano e la durata (6 mesi o 1 anno), poi cliccate su «Invia la richiesta».
4. PURA Solutions attiva o rifiuta la richiesta; ne siete avvisati nell’applicazione e via e-mail.

• Solo l’amministratore dell’azienda può inviare una richiesta. Resta possibile anche quando la prova o l’abbonamento sono terminati.
• Una sola richiesta alla volta: «Modifica la mia richiesta» la sostituisce, «Annulla la richiesta» la ritira senza cambiare il vostro accesso attuale.

Proforma e ricevuta del bonifico

• Coordinate di pagamento: la finestra di richiesta e la scheda «Il mio abbonamento» mostrano le istruzioni, la banca e l’IBAN indicati da PURA Solutions.
• «Scarica la fattura proforma»: un PDF intestato alla vostra azienda, con il piano, la durata e il prezzo al netto delle imposte. È un documento non fiscale, destinato a preparare il vostro bonifico. Per un piano il cui prezzo è «su richiesta», PURA Solutions vi invia la proforma.
• «Allega la ricevuta del bonifico»: una volta inviata la richiesta, caricate un file PDF, PNG o JPG di 2 MB al massimo. Potete sostituirlo o rimuoverlo finché la richiesta è in attesa.
• La ricevuta viene trasmessa a PURA Solutions, poi cancellata una volta che la richiesta è stata evasa o annullata.

Scadenza e promemoria

Alla scadenza della prova o dell’abbonamento, l’accesso viene sospeso e i vostri dati vengono conservati; la schermata visualizzata permette all’amministratore di inviare la sua richiesta di abbonamento e di scrivere a PURA Solutions via e-mail, oppure via WhatsApp quando il pulsante è disponibile. Prima di allora, gli amministratori dell’azienda ricevono promemoria via e-mail, accompagnati da una notifica nell’applicazione:

• Prova gratuita: tre giorni prima della fine, il giorno prima e poi a prova terminata.
• Abbonamento: quattordici giorni prima della scadenza, tre giorni prima e poi alla scadenza.

Programma di referral

Quando il programma di referral è disponibile, la scheda «Programma di referral» di Amministrazione → Azienda mostra il vostro codice e il vostro link di registrazione da condividere, con i pulsanti «Copia» e «WhatsApp».

• L’azienda che si registra con il vostro link inizia la sua prova gratuita come le altre.
• Quando attiva il suo primo abbonamento, il vostro abbonamento viene prolungato, oppure la vostra prova, se siete ancora in prova. Il numero di giorni è indicato nella vostra scheda Programma di referral.
• Il prolungamento viene concesso una sola volta per azienda presentata. Ne siete avvisati con una notifica e via e-mail.
• La scheda elenca le aziende che avete presentato e il loro stato: «In prova», «Abbonata» o «Prova terminata».

15. Sicurezza e autenticazione a due fattori

• Ruoli e permessi: ogni chiamata al server verifica il ruolo dell’utente per il modulo e l’azione richiesti. Nascondere un pulsante sullo schermo è solo una comodità; il controllo avviene lato server.
• Isolamento delle aziende: ogni dato porta l’identificativo della sua azienda e ogni richiesta è filtrata sull’azienda dell’account connesso. Gli identificativi ricevuti in una richiesta vengono riverificati prima dell’uso.
• Password: memorizzate solo sotto forma di hash bcrypt. Blocco di 15 minuti dopo 5 accessi falliti.
• Sessioni: token di accesso di 15 minuti e token di aggiornamento rinnovato a ogni utilizzo, in cookie inaccessibili agli script. Viene conservato solo l’hash del token di aggiornamento; il riutilizzo di un token già rinnovato revoca l’intera sessione.
• Richieste di scrittura: rifiutate se provengono da un sito diverso dall’applicazione.
• Registro di audit: tutte le scritture e gli accessi vengono tracciati.

Autenticazione a due fattori

Quando è attivata sulla piattaforma, la voce «Autenticazione a due fattori» del menu del vostro account permette di proteggere l’accesso con un codice a sei cifre, oltre alla password.

1. Scansionate il codice QR con un’app di autenticazione (Google Authenticator, Microsoft Authenticator, Authy…).
2. Inserite il codice mostrato dall’app per confermare.
3. Conservate gli 8 codici di backup, monouso: servono se non avete più il telefono.

L’amministratore della piattaforma può rendere obbligatoria l’autenticazione a due fattori per gli amministratori delle aziende.

Buone pratiche: un account per persona, il ruolo più ristretto che consente di lavorare, e la disattivazione dell’account appena un collaboratore lascia l’azienda.

16. Installazione tecnica

Questa sezione si rivolge agli sviluppatori e agli amministratori di sistema. Tessaro è un’applicazione Next.js basata su PostgreSQL (tramite Prisma).

Prerequisiti

• Node.js 22 o più recente
• Docker (PostgreSQL viene avviato in un container)

Installazione in locale

cp .env.example .env     # poi compilate JWT_ACCESS_SECRET e l'account super-admin
npm install
npm run db:up            # avvia PostgreSQL (Docker)
npm run db:migrate       # applica le migrazioni
npm run db:seed          # carica i dati dimostrativi
npm run dev              # http://localhost:3041

Il file .env contiene la connessione al database (DATABASE_URL, DIRECT_URL), il segreto di firma dei token (JWT_ACCESS_SECRET, da generare con openssl rand -base64 48), l’account super-amministratore (SUPER_ADMIN_EMAIL, SUPER_ADMIN_PASSWORD) e l’indirizzo pubblico del sito (PUBLIC_APP_URL).

Promemoria pianificati

Un passaggio quotidiano invia i promemoria di fine prova e di fine abbonamento, il report settimanale, gli avvisi di budget, i promemoria delle scadenze dei veicoli e delle patenti e i solleciti automatici delle fatture. Definite CRON_SECRET in .env, poi pianificate npm run reminders una volta al giorno; npm run reminders -- --dry-run mostra cosa partirebbe senza inviare nulla. L’invio delle e-mail richiede una configurazione SMTP (variabili SMTP_*). I dettagli sono nel file README del progetto.

Test

npm test                 # test unitari (vitest)
npm run typecheck        # verifica TypeScript

Produzione

docker compose -f docker-compose.prod.yml up -d --build
docker compose -f docker-compose.prod.yml exec app npm run db:seed:prod

• Mettete accanto al file Compose un .env con POSTGRES_PASSWORD, JWT_ACCESS_SECRET, SUPER_ADMIN_EMAIL, SUPER_ADMIN_PASSWORD e PUBLIC_APP_URL.
• npm run db:seed:prod crea solo l’account super-amministratore, senza dati dimostrativi. Può essere rilanciato senza rischi: un account esistente non viene modificato. La sua password deve contare almeno 12 caratteri.
• Il super-amministratore crea poi ogni azienda e il suo primo amministratore da Piattaforma → Aziende.
• Compilate PUBLIC_APP_URL con l’indirizzo https definitivo: serve per i link canonici, la mappa del sito e i dati strutturati.