⚙️ Parametri Aziendali

Configurazione completa dell'azienda: dati anagrafici, fatturazione, IVA, numerazioni, email, e Wizard di setup unificato.

Cos'è il modulo Parametri

I Parametri sono la "carta d'identità" della tua azienda nel programma. Definiscono:

Chi sei: ragione sociale, P.IVA, indirizzo, contatti, tipo attività
Come fatturi: regime fiscale, cassa previdenziale, IVA, bolli, ritenute
Come visualizzi: nome dei clienti (Cliente/Paziente/Socio…), nome del catalogo (Catalogo/Prodotti/Medicine…), schede del form modifica voci
Numerazioni: progressivi e sezionali per ogni tipo documento
Email: configurazione SMTP per invio fatture/ricevute ai clienti

Dove si trova: sidebar → gruppo "Amministrazione" → "Parametri", oppure URL diretto /parametri.

💡 Per la prima configurazione di una nuova azienda usa il Wizard Configurazione Aziendale (sez. 2 sotto). È la via più rapida: ti guida in 3 passi e imposta automaticamente i preset più comuni.

Wizard Configurazione Aziendale (3 passi)

Apri il Wizard cliccando il bottone 🪄 Configurazione Aziendale in fondo alla tab "Dati Aziendali". È la modalità consigliata per impostare l'azienda da zero o per cambiare l'attività.

Cosa sostituisce

Il Wizard sostituisce 3 vecchie procedure separate riunendole in un unico flusso guidato:

❌ Tab "Profilo Documenti" (rimossa)
❌ Modale "Configura Tipo Cliente" (rimossa)
❌ Menu a tendina "Profilo Attività" sparso (ora è dentro lo Step 1)

STEP 1Chi sei

Ti chiede 3 informazioni base che descrivono la tua attività:

Tipo di attività: Studio Medico, Industria, Farmacia, Studio Legale, Commercialista, Generico, ecc. (12 categorie)
Regime fiscale: RF01 Ordinario, RF19 Forfettario, RF02 Minimi, ecc.
Cassa previdenziale (opzionale): ENPAM medici, INPS, Gestione Separata, ecc.

Mentre compili, il sistema sceglie automaticamente il Profilo Documenti più adatto da proporti nello Step 2.

STEP 2Cosa fatturi

Mostra il Profilo Documenti suggerito con etichetta gold "★ SUGGERITO" e la lista di tutti i profili disponibili (cliccabili per scegliere alternativi).

Esempi di profili: Persona Giuridica Ordinario, Professionista Sanitario, Regime Forfettario, Edilizia con CIG/CUP, Commercio al Dettaglio…

Ogni profilo configura automaticamente i tipi documento (TD01, TD06, TD24, ecc.) con le impostazioni corrette per:

IVA / esenzione art.10 / split payment / reverse charge
Bollo virtuale (€2 sopra €77,47)
Ritenuta d'acconto (RT01/RT02 + aliquota)
Cassa previdenziale (4% INPS, 2-4% ENPAM, ecc.)
Etichette ("Cliente" o "Paziente"), colori, schede del form

La checkbox "Applica i preset al salvataggio" in basso decide se sovrascrivere o no le configurazioni attuali dei tipi documento. Se la disattivi, le tue regole personalizzate restano intatte.

STEP 3Come visualizzi

Personalizza l'interfaccia in base alla tua attività:

Cosa mostrare nel titolo della pagina: nome azienda OPPURE nome workspace (per chi gestisce più aziende, vedi sez. 3)
Come chiami i tuoi clienti: Cliente, Paziente, Socio, Studente, Assistito, Conduttore, Coachee, Utente, Azienda
Come chiami ciò che vendi: Catalogo, Prodotti, Articoli, Medicine, Servizi, Trattamenti, Prestazioni, Listino, Inventario, Repertorio + custom personalizzato
Tipi di voce nel catalogo: scegli quali tipi (Articolo, Farmaco, Integratore, ecc.) compaiono nei filtri. + tipi custom personalizzati.
Schede della finestra modifica voce: nascondi quelle non utili (es. studio di servizi nasconde Magazzino e Logistica). La scheda "Base" è sempre presente.

In fondo a ogni step trovi i bottoni: ← Indietro Avanti → Annulla. Sull'ultimo step compare il bottone verde 💾 Salva e applica.

💡 Le tue scelte si applicano solo dopo aver cliccato "Salva e applica". Puoi annullare in qualsiasi momento senza modifiche al programma.

Multi-azienda: nome workspace nel titolo

Se sei un professionista che gestisce più aziende (es. commercialista con 10 clienti, ognuno in un workspace separato), può essere comodo avere come titolo non il nome dell'azienda corrente, ma una dicitura del tipo "Studio Rossi — Cliente Acme S.r.l.".

Come configurarlo

Apri il Wizard (Parametri → 🪄 Configurazione Aziendale)
Vai allo Step 3 "Come visualizzi"
Alla domanda "Cosa mostrare nel titolo in alto della pagina?" seleziona "📂 Nome del workspace"
Compare un riquadro azzurro: scrivi il nome esteso che vuoi vedere (max 120 caratteri)
Salva e applica

Esempi pratici

Scenario	Scelta	Cosa appare in alto
Acme S.r.l. (azienda singola)	Nome azienda	"Acme S.r.l."
Commercialista Rossi, workspace Acme	Nome workspace + nomeLungo	"Studio Rossi — Acme S.r.l."
Stesso commercialista, workspace Beta	Nome workspace + nomeLungo	"Studio Rossi — Beta SPA"
Workspace senza nomeLungo	Nome workspace	Cade su nome corto (es. "ProvaTest")

⚠️ Solo gli utenti con ruolo ADMIN o superiore possono modificare il nome esteso del workspace. USER comuni vedono il campo ma non possono salvarlo.

ℹ️ Il nome corto del workspace (usato per liste/menu interni) non viene toccato. Solo il titolo in alto mostra il nome esteso, quando configurato.

Tab della pagina Parametri

La pagina Parametri è organizzata in 7 tab orizzontali:

Tab	Cosa contiene	Quando aprirla
🏢 Dati Aziendali	Ragione sociale, CF/PIVA, indirizzo, contatti, profilo attività, bottone Wizard	Setup iniziale + Wizard
📄 Fatturazione-Cassa ⚡SDI	Formato trasmissione SDI (FPR12/FPA12), regime fiscale, cassa previdenza, IVA default, bollo, spese banca	Configurazione fiscale
📊 Preset Fatture	Tipo documento default, modalità pagamento, condizioni pagamento, divisa	Default per nuove fatture
🔢 Numerazioni	Progressivi sezionali per ogni tipo documento e anno	Inizio anno fiscale o creazione nuovo sezionale
📋 Gestione Tabelle	Lookup embedded: tipi pagamento, condizioni, tipi documento, formati trasmissione, regimi fiscali	Personalizzazione codici
🧮 Aliquote IVA & Regimi	Componente dedicata gestione IVA — aliquote, nature, regimi	Modifica aliquote
📧 Configurazione Email	SMTP host/port/user/password, mittente, test invio	Setup invio fatture/ricevute via email

ℹ️ La vecchia tab "Profilo Documenti" è stata rimossa: i suoi contenuti sono ora nello Step 2 del Wizard.

Salvataggio: pulsante "💾 Salva Parametri"

In fondo alla tab "Dati Aziendali" trovi il pulsante 💾 Salva Parametri. Salva tutti i campi visibili nel form (titolo azienda, contatti, indirizzo, ecc.).

Le modifiche fatte tramite il Wizard hanno un loro pulsante "Salva e applica" indipendente. Le due cose non sono in conflitto: puoi usare l'una o l'altra a seconda di cosa stai cambiando.

💡 Se sei ADMIN puoi modificare i Parametri. Se sei USER comune vedi i Parametri in sola lettura.

📌 Aggiornamenti aprile 2026 — Profilo Attività

Nella tab Dati Aziendali, il campo Profilo Attività è ora in sola lettura: mostra il profilo corrente ma non si modifica direttamente. Per cambiarlo c'è un bottone gold "Wizard" accanto, che apre il Wizard Configurazione Aziendale a 3 step.

Motivazione: cambiando il profilo, il sistema applica automaticamente i preset coerenti (profilo documenti, terminologia catalogo, layout tab interne, cassa previdenziale). Modificare il profilo dal solo select bypassava i preset e lasciava il workspace in stato incoerente. Il wizard è ora l'unica fonte di verità per il cambio profilo.

Il bottone "Moduli" rimane nella label come vista informativa ("quali moduli sono rilevanti per questo profilo").

📧 Aggiornamento 1 Maggio 2026 — Invio email da amministratore

Aggiunto un form per inviare email arbitrarie sfruttando lo SMTP già configurato nei Parametri del workspace attivo (sezione "Configurazione email"). Disponibile in due punti dell'app:

Profilo → Sicurezza: card "Invio email da amministratore" in fondo alla tab.
Amministrazione di Sistema (/admin/sistema): card "Invio email da amministratore" fra "Pulizia Posizioni Note" e "Bot di Simulazione".

Form: destinatario, oggetto, corpo libero. Bottoni:

"Test SMTP": verifica la connessione del server SMTP configurato (utile per capire se le credenziali in Parametri sono valide).
"Invia email": invia il messaggio. Il mittente è il smtpFrom dei Parametri (oppure smtpUser se from non specificato).

Prerequisito: lo SMTP deve essere configurato nei Parametri della tab "Email" e flag "Test SMTP" superato (altrimenti l'invio fallisce con errore "SMTP non configurato o non testato").