Gestione Tabelle
Configurazione tabelle di sistema — Condizioni pagamento, tipi documento, regimi fiscali, nature IVA, cassa previdenza
v 2.0
Manuale Utente
Riferimenti normativi
- DPR 633/72 — Disciplina IVA: Definisce aliquote, esenzioni (art. 10), operazioni non imponibili (art. 8, 8-bis, 9), escluse (art. 15). Le Nature IVA (N1-N7) nel sistema codificano queste casistiche per il XML FatturaPA.
- DPR 633/72 art. 21 — Contenuto della fattura: Prescrive i dati obbligatori, tra cui le condizioni e modalità di pagamento. I codici TP (termini) e MP (modalità) traducono queste informazioni nel formato SDI.
- DPR 642/72 — Imposta di bollo: Bollo virtuale di 2,00 € su documenti esenti IVA con imponibile > 77,47 € (DM 17/06/2014). La tabella Tipi Documento configura quali tipi calcolano il bollo.
- DPR 600/73 art. 25-bis — Ritenuta d'acconto: Disciplina le ritenute sui compensi professionali. La tabella Tipi Documento configura la ritenuta di default per tipo (RT01/RT02).
- L. 190/2014 — Regime forfettario (RF19): Codificato nella tabella Regimi Fiscali. Implica: no IVA in fattura, natura N2.2, no ritenuta, dicitura obbligatoria.
- D.Lgs. 127/2015 — Fatturazione elettronica: Obbligo di trasmissione XML via SDI. Le tabelle Formati Trasmissione (FPR12/FPA12) e Nature IVA sono codificate secondo le Specifiche Tecniche v1.8 dell'Agenzia delle Entrate.
- D.Lgs. 241/1997 — Cassa Previdenza: I contributi a casse professionali (INPS, ENASARCO, ENPAM, ecc.) devono essere evidenziati in fattura. La tabella Tipi Cassa Previdenza codifica i tipi TC per il blocco 2.1.1.9 FatturaPA.
- Provvedimento AdE n. 89757/2018 — Specifiche FatturaPA: Definisce i codici ammessi per tutti i campi del XML: TipoDocumento (TD01-TD28), FormatoTrasmissione (FPR12/FPA12), ModalitaPagamento (MP01-MP23), CondizioniPagamento (TP01-TP03), Natura (N1-N7), RegimeFiscale (RF01-RF19), TipoCassa (TC01-TC22).
1Panoramica
Le Tabelle di Sistema contengono i dati di configurazione che alimentano tutti i moduli di NOX. Sono accessibili da Amministrazione → Tabelle / Parametri.
Navigazione unificata. La voce di menu Tabelle / Parametri apre ora direttamente Gestione Tabelle: la vecchia riga di tab orizzontali è stata eliminata. Tutte le sezioni di configurazione — Dati Aziendali, Fatturazione-Cassa ⚡SDI, Preset Fatture, Numerazioni e Configurazione Email — si trovano nella sidebar a sinistra, nel gruppo Parametri azienda sopra l'elenco delle tabelle. Dove nel manuale si legge «tab nei Parametri», oggi si intende la corrispondente voce della sidebar.
Le tabelle sono organizzate in voci della sidebar, ciascuna con un colore identificativo:
| Tabella | Icona | Contenuto | Usata da |
|---|---|---|---|
| Condizioni Pagamento | 💳 | Termini e modalità pagamento con codici SDI | Documenti, Scadenzario, Soggetti |
| Tipi Documento | 📄 | Configurazione completa tipi con regole fatturazione | Documenti, Stampa, SDI |
| Formati Trasmissione | 📡 | Formati XML per invio SDI | Fatturazione Elettronica |
| Regimi Fiscali | ⚖ | Regimi IVA (ordinario, forfettario, ecc.) | Parametri Azienda, Fatturazione |
| Tipi Cassa Previdenza | 🏛 | Casse professionali (INPS, ENASARCO, ecc.) | Parcelle, Fatture professionali |
| Nature IVA | 📊 | Codici natura N1-N7 per esenzioni/esclusioni IVA | Righe documento, XML SDI |
ⓘ
Al primo accesso, il sistema pre-popola le tabelle con i valori standard dell'Agenzia delle Entrate tramite il modulo “Tabelle Normativa” nel Seed Demo. Non è necessario inserire i codici manualmente.
2Condizioni Pagamento
La tabella Condizioni Pagamento unifica in un unico record le informazioni che il SDI richiede nei blocchi CondizioniPagamento (TP) e ModalitaPagamento (MP).
Campi principali
| Campo | Obbligatorio | Descrizione | ||||
|---|---|---|---|---|---|---|
| Codice | Sì | Codice identificativo (es. BB30, RD60) | ||||
| Descrizione | Sì | Testo completo (es. “Bonifico Bancario 30 gg”) | ||||
| Codice SDI (TP) | Sì | Termine pagamento per XML FatturaPA | ||||
| Modalità Pagamento (MP) | Consigliato | Modalità pagamento per XML FatturaPA | ||||
| Attivo | — | Se visibile nei dropdown di selezione | ||||
| Ordine | — | Posizione nell'elenco dropdown |
| Codice | Significato | Scadenze generate |
|---|---|---|
TP01 | Pagamento a rate | N scadenze distribuite a intervalli regolari |
TP02 | Pagamento completo | 1 scadenza unica (a vista o a N giorni) |
TP03 | Anticipo + saldo | 2 scadenze: acconto immediato + saldo a termine |
Codici Modalità Pagamento SDI (MP)
| Codice | Descrizione | Note |
|---|---|---|
MP01 | Contanti | Non ammette TP01 (rate) |
MP02 | Assegno | — |
MP03 | Assegno circolare | — |
MP04 | Contanti presso Tesoreria | Non ammette TP01 |
MP05 | Bonifico | Il più usato. Richiede IBAN. |
MP06 | Vaglia cambiario | — |
MP07 | Bollettino bancario | — |
MP08 | Carta di pagamento | Non ammette TP01 |
MP09 | RID | Addebito diretto. Richiede IBAN. |
MP10 | RID utenze | — |
MP11 | RID veloce | — |
MP12 | RIBA | Ricevuta bancaria. Non ammette TP01. |
MP13 | MAV | — |
MP14 | Quietanza erario | — |
MP15 | Giroconto su conti di contabilità speciale | — |
MP16 | Domiciliazione bancaria | — |
MP17 | Domiciliazione postale | Non ammette TP01 |
MP18 | Bollettino di c/c postale | — |
MP19 | SEPA Direct Debit | — |
MP20 | SEPA Direct Debit CORE | — |
MP21 | SEPA Direct Debit B2B | — |
MP22 | Trattenuta su somme già riscosse | — |
MP23 | PagoPA | Non ammette TP01. Solo verso PA. |
Parametri scadenze (campi avanzati)
- Numero rate: per TP01, quante scadenze generare
- Giorni prima scadenza: giorni dalla data documento alla prima scadenza
- Intervallo giorni: intervallo tra le rate (es. 30 per rate mensili)
- Percentuale acconto: per TP03, % del totale come anticipo
- Modalità scadenza: intervallo fisso, fine mese, giorno fisso del mese
- Giorno fisso mese: es. 15 = ogni rata scade il 15 del mese
- Overflow mese: se la data cade oltre la fine mese: ultimo giorno o primo del mese successivo
Flag comportamentali
| Flag | Effetto |
|---|---|
| Richiede IBAN | Alla selezione in documento, avvisa se il soggetto non ha IBAN configurato |
| Richiede riferimento | Obbliga l'inserimento di un riferimento (CRO, n° assegno) |
| Pagamento immediato — applica subito imposta di bollo | Vedi spiegazione dettagliata sotto |
| Addebito diretto | Indica che il pagamento avviene per addebito in conto |
| Applica sconto | Propone sconto % se il cliente paga entro i termini |
⚠
Alcune modalità pagamento (MP01, MP04, MP08, MP12, MP17, MP23) non sono compatibili con il tipo TP01 (rate). Il sistema filtra automaticamente le combinazioni impossibili.
Approfondimento: il flag «Pagamento immediato — applica subito imposta di bollo»
Imposta di bollo da 2,00 € dovuta su fatture/ricevute senza IVA con totale superiore a 77,47 € (conversione storica di 150.000 lire — Art. 13 Tariffa A DPR 642/72).
Quando il bollo va applicato:
- Fatture in regime forfettario (no IVA per principio)
- Operazioni esenti art. 10 DPR 633/72 (prestazioni sanitarie, mediche, finanziarie)
- Operazioni fuori campo IVA
- Ricevute fiscali non commerciali
- Operazioni in regime margine o non imponibili in alcuni casi
💡
Il bollo NON dipende dal metodo di pagamento, ma dal regime IVA della fattura. Il flag è una scorciatoia pratica: se attivo, NOX applica subito il bollo in fattura per documenti senza IVA (utile per chi incassa al momento), altrimenti la verifica avviene a livello contabile.
Cosa fare in pratica:
| Tipo attività | Flag «Pagamento immediato» sui MP contanti/POS/bancomat |
|---|---|
| Naturopata, operatore olistico, fisioterapista, psicologo | SPUNTARE — emette molte ricevute esenti art. 10 |
| Forfettario in genere (RF19) o regime minimi (RF02) | SPUNTARE — il bollo va sempre messo sopra 77,47 € |
| Tabaccheria, parrucchiere, barbiere | SPUNTARE — ricevute al momento dell'incasso |
| Negozio retail con prevalenza fatture IVA standard | NON spuntare — il bollo non si applica alle fatture con IVA |
| B2B con bonifici a 30/60/90 gg | NON spuntare — bollo gestito in chiusura contabile |
⚠
L'etichetta storica del flag era «È pagamento in contanti, attiva verifica bollo»: dicitura fuorviante che mescolava i due concetti (metodo pagamento + tipo fiscalità). Oggi il flag si chiama «Pagamento immediato — applica subito imposta di bollo», più preciso semanticamente.
Spese banca / bolli su tratta: vanno in fattura
Quando una Condizione di Pagamento ha attivi i flag «Includi spese bancarie» e/o «Includi bolli su tratta», le spese che si addebitano al cliente diventano righe della fattura, aggiunte dalla scheda del documento quando si sceglie la condizione:
| Riga | Importo | IVA |
|---|---|---|
| 🏦 Spese d'incasso | Spese Banca dei Parametri Azienda × numero delle rate | L'aliquota prevalente delle altre righe; se la fattura è tutta esente o non imponibile, la stessa natura. Le spese d'incasso sono parte della base imponibile (art. 13 DPR 633/72) e seguono l'operazione principale (art. 12). |
| 📋 Bolli su effetti | Spese Bolli dei Parametri Azienda × numero delle rate | Fuori campo IVA, natura N1 (art. 15): è l'imposta di bollo recuperata dal cliente. |
Le rate dello scadenzario si fanno sul totale della fattura, spese comprese: nessuna spesa viene aggiunta alle sole rate. La vecchia scelta «in scadenzario» (spese sommate alle rate e non fatturate) non c'è più: faceva pagare al cliente più di quanto fatturato.
⚠
Le righe automatiche si riconoscono dalla descrizione («Spese d'incasso», «Bolli su effetti»; anche le vecchie «Spese bancarie» e «Bolli su tratta»). Si possono correggere o togliere: tolte, non ricompaiono finché non si sceglie di nuovo la condizione. Rinominate, NOX non le riconosce più e al cambio di condizione potrebbe aggiungerne altre.
3Tipi Documento
La tabella Tipi Documento definisce il comportamento fiscale e di interfaccia di ciascun tipo. Ogni record contiene un oggetto JSON regoleFatturazione.
Novità. La configurazione è ora interamente config-driven tramite il campo Famiglia e il Codice SDI dedicato: il Codice interno è un'etichetta libera, senza impatti su fisco, magazzino o conversioni (si rinomina finché il tipo non ha documenti emessi). Le tab visibili e gli stati disponibili vengono ora calcolati automaticamente dalla Famiglia (e dai moduli attivi nel workspace): i vecchi riquadri manuali “Tab visibili” e “Stati disponibili” sono stati rimossi.
Campi principali
| Campo | Descrizione |
|---|---|
| Codice | Codice identificativo liberamente rinominabile (TD01, DDT, PRV, RIC, FP, o un'etichetta a piacere): non determina più il comportamento fiscale |
| Famiglia | Famiglia dichiarata che pilota interfaccia, stati e tab: FATTURA / DDT / PREVENTIVO / ORDINE / RICETTA / ALTRO |
| Descrizione | Nome esteso (es. “Fattura”, “Nota di Credito”) |
| Descrizione breve | Label per intestazione stampa |
| Suffisso | Suffisso nella numerazione, al massimo 3 caratteri (FA, NC, DDT...) |
| Visibile in inserimento | Se appare nel dropdown tipo quando si crea un documento |
| Attivo / Ordine | Stato e posizione nell'elenco |
Regole di fatturazione (JSON)
| Regola | Tipo | Effetto |
|---|---|---|
calcolaIva | boolean | Calcola IVA per aliquota sulle righe |
calcolaBollo | boolean | Applica bollo 2 € se imponibile esente > 77,47 € |
calcolaInps | boolean | Aggiunge contributo cassa previdenziale |
famiglia | string | Famiglia documento (FATTURA/DDT/PREVENTIVO/ORDINE/RICETTA/ALTRO): fonte primaria del comportamento |
codiceSDI | string | Codice SDI fiscale (TD01…TD29), selezionabile da dropdown: indipendente dal codice interno |
movimentaMagazzino | string | Movimento di magazzino generato: Nessuno / Carico / Scarico |
isRicetta | boolean | Marca il tipo come ricetta/consiglio (form ridotto alle sole righe) |
isFatturaPassiva | boolean | Marca il tipo come documento di acquisto/fornitore |
tabs | — | Deprecato. Le tab del form sono ora calcolate automaticamente dalla Famiglia + moduli attivi (nessun toggle manuale) |
statiDisponibili | — | Deprecato. Gli stati selezionabili sono ora derivati automaticamente dalla Famiglia (vedi tabella sotto); nessun toggle manuale |
colore | hex | Colore badge nella lista documenti |
visibileInInserimento | boolean | Mostra nel dropdown creazione documento |
isRiepilogativaDDT | boolean | Abilita overlay selezione DDT (per TD24) |
richiedeCodiceFiscale | boolean | Blocca il salvataggio se l'intestatario non ha né Codice Fiscale né Partita IVA |
mostraImporti | boolean | Mostra prezzi e importi nelle righe |
contenutiExtra | string[] | Campi extra catalogo da mostrare (posologia, note, ecc.) |
Stati disponibili per famiglia (automatici)
Gli stati selezionabili nel form non si configurano più a mano: dipendono dalla Famiglia del documento. Lo stato Parz. evaso viene impostato automaticamente dal sistema in caso di evasione parziale.
| Famiglia | Stati offerti |
|---|---|
| Preventivo | Bozza · Emesso (Inviato al cliente) · Evaso · Annullato |
| Ordine | Bozza · Confermato · Evaso · Annullato |
| DDT | Bozza · Emesso (Consegnato) · Fatturato · Annullato |
| Fattura | Bozza · Emesso · Inviato SDI · Pagato · Archiviato · Annullato |
| Altro | Bozza · Emesso · Confermato · Inviato · Pagato · Annullato · Archiviato |
Codici documento standard AdE
| Codice | Tipo | Uso |
|---|---|---|
TD01 | Fattura | Fattura ordinaria |
TD02 | Acconto su fattura | Pagamento anticipato parziale |
TD03 | Acconto su parcella | Anticipo su parcella professionale |
TD04 | Nota di Credito | Storno totale o parziale di fattura emessa |
TD05 | Nota di Debito | Integrazione importo fattura emessa |
TD06 | Parcella | Fattura professionale con cassa e ritenuta |
TD07 | Fattura Semplificata | Per importi < 400 € (art. 21-bis DPR 633/72) |
TD24 | Fattura Differita | Riepilogativa DDT, entro il 15 del mese successivo |
DDT | Documento di Trasporto | Accompagnamento merci (non SDI) |
PRV | Preventivo | Offerta commerciale |
PF | Pro-Forma | Fattura proforma (non fiscale) |
ORD | Ordine | Ordine cliente |
RIC | Ricetta | Prescrizione sanitaria |
FP | Fattura Passiva | Fattura ricevuta da fornitore (ciclo passivo) |
ⓘ
I Profili Documenti (accessibili da Parametri → Profilo Documenti) preconfigurano automaticamente tutti i tipi documento con le regoleFatturazione corrette per il tipo di azienda selezionato.
4Formati Trasmissione
I formati di trasmissione definiscono il tracciato XML per l'invio al Sistema di Interscambio (SDI).
| Codice | Descrizione | Quando usare |
|---|---|---|
FPR12 | Fattura verso privati | Fatture B2B e B2C verso soggetti privati e imprese. È il formato standard per la quasi totalità delle fatture. |
FPA12 | Fattura verso PA | Fatture verso la Pubblica Amministrazione. Richiede codice IPA (6 cifre) invece del codice destinatario SDI (7 cifre). Richiede CIG e/o CUP. |
Il formato si seleziona in Parametri → Fatturazione Elettronica → Formato Trasmissione. La scelta è unica per azienda.
5Regimi Fiscali
Il regime fiscale dell'azienda determina il comportamento IVA, le diciture obbligatorie in fattura e le regole di calcolo. Si seleziona in Parametri → Fatturazione Elettronica.
| Codice | Descrizione | Implicazioni |
|---|---|---|
RF01 | Regime Ordinario | IVA applicata normalmente. Ritenuta se professionista. |
RF02 | Contribuenti minimi (art. 1 c.96-117 L.244/2007) | No IVA, no ritenuta, natura N2.2 |
RF04 | Agricoltura e pesca (artt. 34/34-bis DPR 633/72) | Regime speciale compensazione |
RF05 | Vendita sali e tabacchi (art. 74 c.1 DPR 633/72) | Regime monofase |
RF06 | Commercio fiammiferi (art. 74 c.1) | Regime monofase |
RF07 | Editoria (art. 74 c.1) | Regime monofase editoria |
RF08 | Gestione servizi telefonia pubblica (art. 74 c.1) | Regime monofase |
RF09 | Rivendita documenti di trasporto (art. 74 c.1) | Regime monofase |
RF10 | Intrattenimenti e giochi (art. 74 c.6) | Regime speciale |
RF11 | Agenzie di viaggio (art. 74-ter) | Regime del margine 74-ter |
RF12 | Agriturismo (art. 5 c.2 L.413/91) | Regime speciale agriturismo |
RF13 | Vendite a domicilio (art. 25-bis c.6 DPR 600/73) | Ritenuta a titolo d'imposta |
RF14 | Rivendita beni usati, oggetti d'arte, antiquariato (art. 36 DL 41/95) | Regime del margine |
RF15 | Agenzie vendite all'asta (art. 40-bis DL 41/95) | Regime del margine |
RF16 | IVA per cassa (art. 32-bis DL 83/2012) | Esigibilità IVA differita all'incasso |
RF17 | IVA per cassa P.A. (art. 6 c.5 DPR 633/72) | IVA differita per forniture a PA |
RF18 | Altro | Regime non codificato |
RF19 | Regime forfettario (art. 1 c.54-89 L.190/2014) | No IVA, no ritenuta, natura N2.2, dicitura obbligatoria, bollo 2 € |
⚠
Cambiare il regime fiscale ha impatto su tutti i documenti futuri: aliquota IVA, natura, ritenuta, diciture. Il cambio non è retroattivo sui documenti già emessi.
6Tipi Cassa Previdenza
I contributi alle casse previdenziali professionali devono essere indicati nel blocco 2.1.1.9 DatiCassaPrevidenziale del XML FatturaPA. La tabella codifica i tipi ammessi.
| Codice | Cassa | Professione |
|---|---|---|
TC01 | Cassa Nazionale Previdenza Avvocati | Avvocati |
TC02 | Cassa Previdenza Dottori Commercialisti | Commercialisti |
TC03 | Cassa Previdenza Geometri | Geometri |
TC04 | Cassa Nazionale Previdenza Ingegneri e Architetti (Inarcassa) | Ingegneri, Architetti |
TC05 | Cassa Nazionale Notariato | Notai |
TC06 | Cassa Ragionieri e Periti Commerciali | Ragionieri |
TC07 | ENASARCO | Agenti di commercio |
TC08 | ENPACL | Consulenti del lavoro |
TC09 | ENPAM | Iscritti ENPAM |
TC10 | ENPAPI | Infermieri professionali |
TC11 | ENPAV | Veterinari |
TC12 | ENPAIA | Addetti in agricoltura |
TC13 | Fondo Previdenza Impiegati Agricoltura | Impiegati agricoltura |
TC14 | INPGI | Giornalisti |
TC15 | ONAOSI | Orfani sanitari |
TC16 | CASAGIT | Giornalisti (assistenza integrativa) |
TC17 | EPPI | Periti industriali |
TC18 | EPAP | Attuari, chimici, geologi, forestali |
TC19 | ENPAB | Biologi |
TC20 | ENPAP | Psicologi |
TC21 | ENPAF | Farmacisti |
TC22 | INPS Gestione Separata | Professionisti senza cassa (rivalsa INPS 4%) |
Il tipo cassa si seleziona in Parametri → Fatturazione Elettronica → Tipo Cassa Previdenza. L'aliquota (es. 4%) va specificata nel campo adiacente.
7Nature IVA
I codici Natura IVA sono obbligatori nel XML FatturaPA quando l'aliquota IVA della riga è 0%. Indicano il motivo dell'esenzione/esclusione/non imponibilità.
| Codice | Descrizione | Normativa | Esempio |
|---|---|---|---|
N1 | Escluse art. 15 | Art. 15 DPR 633/72 | Interessi moratori, penali, bolli, spese anticipate in nome e per conto |
N2 | Non soggette | — | Generico (dal 01/01/2021 obbligatorio il dettaglio N2.1/N2.2) |
N2.1 | Non soggette - artt. 7-7septies | Art. 7-7sep DPR 633/72 | Operazioni fuori campo IVA per territorialità |
N2.2 | Non soggette - altri casi | Art. 1 c.54-89 L.190/2014 | Regime forfettario, contribuenti minimi, omaggi senza rivalsa |
N3 | Non imponibili | — | Generico (obbligatorio il dettaglio N3.1-N3.6) |
N3.1 | Non imponibili - esportazioni | Art. 8 c.1 lett. a DPR 633/72 | Esportazioni dirette |
N3.2 | Non imponibili - cess. intra-UE | Art. 41 DL 331/93 | Cessioni intracomunitarie |
N3.3 | Non imponibili - cessioni a San Marino | Art. 71 DPR 633/72 | Cessioni verso San Marino |
N3.4 | Non imponibili - op. assimilate esportazioni | Art. 8 c.1 lett. c DPR 633/72 | Cessioni con lettera di intento (esportatori abituali) |
N3.5 | Non imponibili - dichiarazioni intento | Art. 8 c.1 lett. c DPR 633/72 | A seguito di dichiarazione d'intento |
N3.6 | Non imponibili - altre operazioni | Vari | Altre operazioni non imponibili non rientranti nei precedenti |
N4 | Esenti | Art. 10 DPR 633/72 | Prestazioni sanitarie, operazioni bancarie, assicurazioni, locazioni |
N5 | Regime del margine / IVA non esposta | Art. 36 DL 41/95 | Beni usati, oggetti d'arte, antiquariato (regime del margine) |
N6 | Inversione contabile (Reverse Charge) | — | Generico (obbligatorio il dettaglio N6.1-N6.9) |
N6.1 | RC - cessione rottami | Art. 74 c.7-8 DPR 633/72 | — |
N6.2 | RC - cessione oro/argento | Art. 17 c.5 DPR 633/72 | — |
N6.3 | RC - subappalto edilizia | Art. 17 c.6 lett. a DPR 633/72 | Subappalti settore edile |
N6.4 | RC - cessione fabbricati | Art. 17 c.6 lett. a-bis | — |
N6.5 | RC - cessione telefoni cellulari | Art. 17 c.6 lett. b | — |
N6.6 | RC - cessione prodotti elettronici | Art. 17 c.6 lett. c | — |
N6.7 | RC - prestazioni edili | Art. 17 c.6 lett. a-ter | — |
N6.8 | RC - settore energetico | Art. 17 c.6 lett. d-bis/ter/quater | — |
N6.9 | RC - altri casi | Art. 17 c.6 altri | Altre casistiche di reverse charge |
N7 | IVA assolta in altro stato UE | Art. 7 DPR 633/72 | Operazioni con IVA versata in altro Stato membro (OSS/IOSS) |
⚠
Dal 01/01/2021, i codici generici
N2, N3 e N6 non sono più ammessi nel XML SDI: obbligatorio specificare il sottotipo (N2.1, N2.2, N3.1-N3.6, N6.1-N6.9). Il sistema rifiuta (errore 00401) le fatture con codice generico.
ⓘ
Logica automatica: se l'aliquota IVA di una riga è > 0%, il campo Natura è disabilitato (non necessario). Se è = 0%, il campo diventa obbligatorio.
8Operazioni Comuni
Tutte le tabelle condividono le stesse operazioni CRUD:
Creare un record
- Selezionare la sub-tab della tabella desiderata.
- Premere il pulsante + Nuovo.
- Compilare i campi nel form che appare (codice, descrizione, parametri specifici).
- Premere Salva.
Modificare un record
- Nella lista, premere l'icona ✎ (Modifica) sulla riga desiderata.
- Il form si apre con i dati pre-compilati.
- Modificare i campi e premere Salva.
Tipi documento già usati. Su un tipo documento che ha documenti emessi (non in bozza) non si cambiano codice, codice SdI, famiglia, nota di credito, fattura ricevuta, ordine o DDT del fornitore, autofattura: registro IVA e liquidazione dei documenti già emessi cambierebbero all'indietro. Il programma lo rifiuta e dice perché. Se le regole erano sbagliate, si crea un tipo nuovo con le regole giuste e si disattiva quello vecchio. Descrizione, colore, schede, suffisso (per i numeri futuri) e ordine restano modificabili.
I codici devono essere quelli ufficiali delle specifiche FatturaPA (modalità MP01–MP23, condizioni TP01–TP03, tipi TD, regimi RF, nature N, casse TC, formati FPR12/FPA12): un codice che lo SdI scarterebbe non si salva. Le rate delle condizioni di pagamento sono almeno una, e la prima scadenza non può venire prima della fattura. Gli spazi attorno al codice si tolgono da soli.
Importare ed esportare in CSV
Dalla tabella si esporta un CSV con tutte le colonne e lo si reimporta. La chiave è il codice: le righe con un codice nuovo si creano, quelle esistenti si aggiornano solo nelle colonne presenti nel file (un file «codice;descrizione» cambia solo le descrizioni). Ogni riga passa dagli stessi controlli del form; una riga sbagliata si scarta col motivo e le altre proseguono.
Attivare / Disattivare
Il toggle Attivo rende il record visibile o nascosto nei dropdown di selezione. I record disattivati restano nei documenti esistenti.
Riordinare
Il campo Ordine determina la posizione nell'elenco dropdown. Impostare numeri crescenti (10, 20, 30...) per facilitare inserimenti futuri.
Eliminare
Premere l'icona 🗑 (Elimina) con conferma. Non è possibile eliminare un record in uso — nei Parametri Azienda, nelle anagrafiche, nei documenti, nei DDT, nei sezionali, o (per le nature IVA) sulle righe e sul catalogo: il programma dice dove è usato. In tal caso, disattivare il record.
9Dati Aziendali
La sezione Dati Aziendali (Parametri → Dati Aziendali) contiene i dati identificativi dell'azienda usati in tutti i documenti e nella fatturazione elettronica.
Tipo azienda
| Opzione | Campi aggiuntivi |
|---|---|
| Persona Fisica | Nome e cognome del titolare |
| Ditta Individuale | Nome/cognome + ragione sociale |
| Persona Giuridica (Srl, Spa, Snc, Sas) | Solo ragione sociale |
| Ente Pubblico | Denominazione ente |
Campi principali
- Titolo / Ragione Sociale (obbligatorio): nome dell'azienda visualizzato in tutti i documenti
- Nota sotto logo: sottotitolo (es. “di Mario Rossi”)
- Codice Fiscale (obbligatorio): 16 caratteri (PF) o 11 cifre (PG)
- Partita IVA (obbligatoria): 11 cifre con validazione checksum Luhn
- Indirizzo sede legale (obbligatorio): via, CAP, comune, provincia, paese
- Email e PEC: email ordinaria e posta certificata
- Telefono e cellulare
- IBAN: coordinate bancarie per pagamenti
- Prestazione: descrizione default del servizio/attività
Profilo attività
Il dropdown Tipo Attività (Studio di Naturopatia, Farmacia, Ferramenta, Elettronica, Verniciatura, Industria, Generico) pre-configura terminologia e label appropriate per il settore.
10Fatturazione Elettronica
La sezione Fatturazione Elettronica (Parametri → Fatturazione e Cassa) configura i parametri per la generazione XML SDI:
| Parametro | Descrizione |
|---|---|
| Formato Trasmissione | FPR12 (privati) o FPA12 (PA). Obbligatorio. |
| Regime Fiscale | RF01-RF19. Determina IVA, diciture, natura. Obbligatorio. |
| Tipo Cassa Previdenza | TC01-TC22. Solo per professionisti con cassa. |
| Aliquota Cassa (%) | Percentuale contributo (es. 4% INPS, 2% CNPADC). |
| Aliquota IVA (%) | Aliquota IVA default (22%, 10%, 4%, 0%). Applicata alle nuove righe documento. |
| Natura IVA | Obbligatoria se aliquotaIVA = 0%. Disabilitata se > 0%. |
| Bollo Virtuale | Attiva/disattiva il calcolo automatico del bollo. |
| Massimale senza bollo | Soglia in euro (default 77,47 € da DPR 642/72). |
| Importo bollo | Importo del bollo (default 2,00 € da DM 17/06/2014). |
| Spese banca per rata | Importo fisso aggiunto ad ogni rata dello scadenzario. |
11Numerazioni e Sezionali (multi-codice)
NOX gestisce sezionali multipli per ogni Tipo Documento in pagine dedicate:
- Tabelle → Sezionali: CRUD completo con codice, descrizione, attività, formato personalizzabile, progressivo, flag default e attivo.
- Tabelle → Multi-Attività: lookup per gestione multi-attività (art. 36 DPR 633/72) referenziato dai sezionali.
Schema sezionale
| Campo | Descrizione |
|---|---|
| Tipo Documento | Es. TD01 Fattura, DDT, NC... |
| Anno | Reset progressivo automatico al cambio anno |
| Codice | Identificativo breve (es. A, IT, EXP, RC). Vuoto = sezionale principale |
| Descrizione | Es. “Fatture estere UE”, “Cartacee 2026” |
| Attività | Riferimento alla tabella Multi-Attività (opzionale, per multi-attività ex art. 36 DPR 633/72) |
| Formato | Template stringa con placeholder, default {prog}_{anno}{suffisso} |
| Progressivo | Ultimo numero usato (incrementato al passaggio EMESSO) |
| Default | Sezionale pre-selezionato sui nuovi documenti del tipo+anno (uno solo per tipo+anno) |
| Attivo | Se selezionabile nei nuovi documenti |
Placeholder formato disponibili
| Token | Significato | Esempio |
|---|---|---|
{prog} | Numero progressivo | 5, 142, 999 |
{anno} | Anno a 4 cifre | 2026 |
{anno2} | Anno a 2 cifre | 26 |
{suffisso} | Suffisso predefinito del Tipo Documento | F, NC, FD |
{codice} | Codice di questo sezionale | A, IT, EXP |
Esempi di formato
| Caso d'uso | Formato | Output |
|---|---|---|
| Default storico (retrocompat) | {prog}_{anno}{suffisso} | 5_2026F |
| Cosmetico con slash | {prog}/{anno}{codice} | 5/2026A |
| Anno corto + dash | {prog}-{anno2}-{codice} | 5-26-EXP |
| Solo progressivo + tipo | FT-{prog}/{anno} | FT-5/2026 |
Inserimento placeholder — drag & drop o click
Sotto il campo Formato Numero appaiono i placeholder come pillole grafiche con icona «grip» (⠿⠿) che indica la possibilità di trascinarle. Due modi per inserire un placeholder nel formato:
- Trascinamento: tieni premuto il mouse sulla pillola, il cursore diventa
grabbing(mano chiusa) e il campo Formato si evidenzia con bordo blu tratteggiato come drop-zone. Rilasciando il mouse sul campo, il token viene inserito alla posizione del cursore (o sostituisce la selezione se ne avevi una). Il cursore si riposiziona subito dopo il token inserito. - Click: clicca sulla pillola e il token viene inserito alla posizione corrente del cursore (o accodato se l'input non ha focus). Equivalente al drag ma più veloce per chi non ama il trascinamento.
L'anteprima del numero a destra si aggiorna in tempo reale mentre componi il formato.
Casi d'uso supportati
- Single sezionale (default storico): un sezionale per tipo, codice vuoto, formato classico.
- Multi-attività (art. 36 DPR 633/72): più sezionali con campo Attività valorizzato (es. studio professionale + ditta individuale sotto la stessa P.IVA).
- Distinzione cartacea / elettronica: sezionale
CARTeELcon formati diversi. - Italia / Estero / Reverse Charge: sezionali
IT,EXP,RCcon numerazioni indipendenti. - Filiale / agente / punto vendita: codice = sigla filiale.
Selezione sezionale nel form documento
- In inserimento nuovo documento, NOX mostra un dropdown Sezionale con i sezionali attivi per il Tipo Documento + Anno scelti, pre-selezionando il default.
- L'utente può scegliere un sezionale diverso prima del passaggio a EMESSO.
- L'anteprima del numero appare a fianco di ogni opzione del dropdown.
- Su documenti già emessi il dropdown è bloccato (lucchetto 🔒). Per cambiare sezionale a posteriori si usa il bottone «↺ Cambia»: si apre un dialog con motivazione, conferma esplicita e log audit tracciato in
log_modifiche_sezionali.
Logica di assegnazione del numero
Quando il documento passa da BOZZA a EMESSO (o CONFERMATO/INVIATO):
- NOX prende il sezionale dal documento (se selezionato) o il default per (tipo, anno).
- Acquisisce un advisory lock Postgres su
sezionaleId(anti race-condition). - Calcola il prossimo progressivo come
max(progressivi giฉ usati, sezionale.progressivo) + 1(anti-buco se documenti cancellati). - Aggiorna
sezionale.progressivo. - Applica il
formatoai placeholder per ottenere la stringa numero finale (es.5_2026F). - Salva
documento.numeroedocumento.sezionaleId.
Override manuale progressivo
Dalla pagina Sezionali, bottone 🔢, l'admin può impostare il progressivo manualmente (utile per migrazione da altro gestionale o allineamento numerazione esistente).
⚠
Modificare il progressivo verso il basso può causare duplicazioni di numero. La numerazione delle fatture deve essere progressiva e senza buchi per ogni sezionale (art. 21 c.2 lett. b DPR 633/72). NOX usa il max progressivo effettivamente usato come baseline, ma se si abbassa manualmente il valore e ci sono documenti già emessi con numero superiore, il prossimo emesso ricostruirà comunque il numero più alto + 1 (per sicurezza).
Cambio sezionale a posteriori (audit)
Su un documento già emesso il bottone Cambia apre un dialog modale che richiede:
- Selezione del nuovo sezionale (stesso tipo + anno)
- Motivazione testuale (opzionale ma consigliata)
- Conferma esplicita (doppio click)
Il sistema rinumera dal nuovo sezionale e registra il movimento nella tabella log_modifiche_sezionali con: documentoId, sezionaleVecchio, sezionaleNuovo, numeroVecchio, numeroNuovo, motivazione, utenteId, timestamp.
12Aliquote IVA e Regimi
La sezione Aliquote IVA & Regimi (tab dedicata nei Parametri) gestisce tutte le aliquote IVA e i regimi fiscali speciali utilizzabili nelle righe dei documenti.
Campi per ogni aliquota
| Campo | Descrizione | Esempio |
|---|---|---|
| Codice | Identificativo univoco dell'aliquota | 22, ES10, SP22 |
| Aliquota % | Percentuale IVA (0–100, decimali ammessi) | 22, 10, 4, 0 |
| Descrizione | Nome descrittivo | “IVA 22%”, “Esente art. 10” |
| Tipo Regime | Regime fiscale speciale associato | Split Payment, Reverse Charge, Forfettario |
| Natura IVA (SDI) | Codice natura per XML FatturaPA (obbligatorio se aliquota = 0%) | N4, N2.2, N3.1 |
| Riferimento Normativo | Articolo di legge | “Art. 10 DPR 633/72” |
| Attiva | Se selezionabile nei documenti | Sì / No |
| Predefinita | Aliquota pre-selezionata per le nuove righe | Sì (una sola) |
Regimi speciali supportati
| Regime | Normativa | Effetto |
|---|---|---|
| Split Payment | Art. 17-ter DPR 633/72 | IVA non incassata dal cedente, versata dal cessionario (PA) |
| Reverse Charge | Art. 17 c.6 DPR 633/72 | IVA assolta dal cessionario con autofattura. Natura N6.x |
| Forfettario | L. 190/2014 art. 1 c.54-89 | No IVA in fattura, natura N2.2, dicitura obbligatoria |
| Esenzione art. 10 | Art. 10 DPR 633/72 | Operazioni esenti (sanitarie, bancarie, assicurative). Natura N4 |
| Esclusione art. 15 | Art. 15 DPR 633/72 | Escluse da IVA (interessi moratori, spese anticipate). Natura N1 |
Come aggiungere un'aliquota
- Premere + Nuova Aliquota.
- Inserire codice, percentuale, descrizione.
- Se aliquota = 0%: selezionare il Tipo Regime e la Natura IVA obbligatoria per il SDI.
- Opzionale: inserire il riferimento normativo.
- Attivare il flag Predefinita se deve essere l'aliquota di default.
- Premere Salva.
Filtri
- Filtra per tipo regime (tutti, Split Payment, Reverse Charge, ecc.)
- Filtra per stato (tutte, solo attive, solo inattive)
⚠Le aliquote predefinite di sistema (22%, 10%, 4%, 0% esente) non possono essere eliminate. Possono essere disattivate se non più necessarie.
13Profilo Documenti
La sezione Profilo Documenti (tab nei Parametri) consente di applicare una configurazione pre-impostata a tutti i tipi documento in base al profilo dell'azienda.
Profili disponibili
| Profilo | Icona | Destinato a |
|---|---|---|
| PG Ordinario | 🏢 | SRL, SPA, SNC, SAS, Cooperative — regime IVA ordinario |
| PF Ordinario | 👤 | Professionista con cassa previdenziale, regime ordinario, ritenuta |
| PF Olistico/Naturopatico | ⚕ | Naturopata, discipline olistiche — prestazioni art. 10, ricetta |
| PF Forfettario | 📋 | Contribuenti regime forfettario L.190/2014 |
| DI Ordinario | 🛠 | Ditta individuale, regime ordinario |
| PA | 🏛 | Ente pubblico (Comune, ASL, Scuola) — split payment |
| PG Commercio | 🛒 | Azienda commerciale con DDT, magazzino, listini |
| PF Senza Cassa | 💻 | Professionista senza cassa previdenziale (INPS gestione separata) |
Come applicare un profilo
- Il sistema suggerisce un profilo automatico in base al tipo azienda e al regime fiscale configurati nei Dati Aziendali.
- Selezionare il profilo desiderato dalla griglia di card.
- Il sistema mostra l'anteprima con la tabella dei tipi documento che verranno configurati: codice, tipo, IVA, bollo, cassa, intestatario, ritenuta, esigibilità IVA, CIG/CUP, visibilità.
- Premere “Applica Profilo” per applicare la configurazione.
- Il sistema aggiorna le
regoleFatturazionedi tutti i tipi documento secondo il profilo scelto.
Cosa configura il profilo
Per ogni tipo documento (TD01, TD04, DDT, PRV, RIC, FP, ecc.):
- calcolaIva / calcolaBollo / calcolaInps: attiva/disattiva i calcoli fiscali
- labelIntestatario: Cliente, Paziente, Fornitore, Destinatario, Ente
- tabs: sezioni visibili nel form documento
- statiDisponibili: stati ammessi per il workflow
- visibileInInserimento: se il tipo appare nel dropdown di creazione
- ritenutaDefault: ritenuta pre-attivata per professionisti
- esigibilitaIvaDefault: Split Payment per fatture verso PA
- richiedeCigCup: obbligatorio per enti pubblici
- colore: colore badge nella lista documenti
ⓘI tipi documento nascosti dal profilo (visibileInInserimento = false) restano nel sistema e possono essere riattivati manualmente dalla Gestione Tabelle → Tipi Documento.
14Configurazione Email / SMTP
La sezione Configurazione Email (tab nei Parametri) imposta il server SMTP per l'invio di fatture, notifiche e comunicazioni direttamente dal sistema.
Campi di configurazione
| Campo | Obbligatorio | Descrizione | Esempio |
|---|---|---|---|
| Server SMTP | Sì | Indirizzo del server di posta in uscita | smtp.gmail.com, smtp.aruba.it |
| Porta | Sì | Porta di connessione | 587 (STARTTLS) o 465 (SSL) |
| Username | Sì | Account di autenticazione | info@miodominio.it |
| Password | Sì | Password di autenticazione (per Gmail: App Password) | Password app 16 caratteri |
| Email mittente | No | Indirizzo “Da:” (se diverso da username) | noreply@miodominio.it |
| SSL/TLS | No | Abilita connessione cifrata | Attivo per la maggior parte dei provider |
Configurazione passo per passo
- Aprire la tab Configurazione Email nei Parametri.
- Inserire l'indirizzo del server SMTP del proprio provider email.
- Inserire la porta: 587 per STARTTLS (consigliata) o 465 per SSL diretto.
- Inserire username (solitamente l'indirizzo email completo) e password.
- Attivare SSL/TLS se il provider lo richiede (quasi sempre).
- Opzionale: inserire un indirizzo mittente diverso dall'username.
- Inserire un indirizzo nel campo Email di test.
- Premere “Testa Connessione” per verificare che la configurazione funzioni.
- Se il test ha successo (banner verde), premere Salva.
Configurazione per i principali provider
| Provider | Server SMTP | Porta | SSL | Note |
|---|---|---|---|---|
| Gmail | smtp.gmail.com | 587 | Sì | Richiede App Password (non la password normale). Attivare 2FA su Google Account, poi generare App Password da Sicurezza → Password per le app. |
| Aruba | smtps.aruba.it | 465 | Sì | Username: indirizzo email completo |
| Aruba PEC | smtps.pec.aruba.it | 465 | Sì | Per invio PEC |
| Microsoft 365 | smtp.office365.com | 587 | Sì | Richiede autenticazione moderna (OAuth) |
| Register.it | smtp.register.it | 587 | Sì | Username: indirizzo email completo |
Uso dell'email nel sistema
Una volta configurato lo SMTP, il sistema può:
- Inviare fatture e documenti in PDF direttamente dalla schermata documento
- Inviare notifiche di scadenza ai clienti
- Inviare avvisi di backup (successo/errore) all'amministratore
- Inviare solleciti di pagamento per fatture scadute
⚠Gmail: dal 2022 Google non accetta più la password normale per SMTP. È necessario generare una App Password di 16 caratteri da: Google Account → Sicurezza → Verifica in 2 passaggi → Password per le app. Questa password va inserita nel campo Password dello SMTP.
ⓘIl pulsante “Testa Connessione” si abilita solo quando Host, Username e Password sono compilati. Se il test fallisce, verificare: credenziali, porta, SSL/TLS, firewall del server e limiti del provider.
15Preset Fatture
La tab Preset Fatture (Parametri) configura i valori predefiniti per i nuovi documenti:
| Campo | Descrizione | Visibilità |
|---|---|---|
| Tipo Documento | Tipo documento predefinito per i nuovi documenti (es. TD01 Fattura) | Sempre |
| Condizioni e Modalità Pagamento | Condizioni preselezionate con codice TP e MP per XML SDI | Sempre |
| Divisa | Codice valuta ISO predefinito (es. EUR, USD, GBP) | Sempre |
| Dicitura Standard per riga fattura | Testo precompilato nella descrizione della prima riga di ogni nuova fattura TD01 | Solo Studio di Naturopatia / Discipline Olistiche |
| Importo Proposto | Prezzo precompilato nella prima riga di ogni nuova fattura TD01 | Solo Studio di Naturopatia / Discipline Olistiche |
Dicitura Standard e Importo Proposto
Questi campi appaiono solo quando il Profilo Attività è “Studio di Naturopatia / Discipline Olistiche”. Quando si crea un nuovo documento di tipo TD01:
- La descrizione della prima riga viene precompilata con la “Dicitura Standard” (es. “Consulenza sulla salute e test bioenergetici”)
- Il prezzo unitario della prima riga viene precompilato con l'“Importo Proposto”
- La precompilazione avviene solo se la prima riga è vuota (non sovrascrive dati già inseriti)
- L'utente può sempre modificare manualmente i valori precompilati
ⓘQuesta funzionalità è pensata per gli studi olistici/naturopatici che emettono fatture con prestazione e importo ricorrenti, velocizzando l'inserimento.
16Novità della v2.1
Estensioni alle tabelle di sistema per il supporto ai profili naturopatici e nuovi stati documento.
Profili documento: PF_NATUROPATA
È stato introdotto il nuovo profilo PF_NATUROPATA (Naturopati L.4/2013) separato da PF_SANITARIO. Caratteristiche:
- Non sanitario — L. 4/2013 (professioni non organizzate in albi)
- IVA non esente (22% standard)
- Niente ricette con conservazione obbligatoria
- Niente invio SistemaTS
- Fattura SDI obbligatoria
- INPS gest. separata rivalsa 4% facoltativa
- Dicitura proposta: “Prestazione resa ai sensi della Legge n. 4/2013”
Tipo attività: STUDIO_NATUROPATICO
Il campo Tipo Attività in Parametri Azienda distingue ora:
| Tipo attività | Settore | Profilo documento default |
|---|---|---|
| STUDIO_NATUROPATICO | NATUROPATIA | PF_NATUROPATA |
| COMMERCIALE | COMMERCIALE | PF_COMMERCIALE |
La scelta condiziona: visibilità Preset Fatture, campo skipValidazioneSDI, dicitura standard, comportamento Ricette.
Stati documento: INVIATO e PAGATO
L'enum StatoDocumento ora include anche:
- INVIATO — documento inviato al cliente (via mail, SDI, PEC) ma non ancora saldato
- PAGATO — documento completamente incassato, allineato col Scadenzario
Gli stati si affiancano ai precedenti (BOZZA, EMESSA, ANNULLATA, ecc.) e permettono un workflow di incasso più granulare.
Condizioni Pagamento: nuovi campi
La tabella Condizioni Pagamento è stata estesa con:
| Campo | Tipo | Descrizione |
|---|---|---|
modalitaPagamento | Stringa | Codice MP SDI associato (MP01…MP23) |
richiedeIBAN | Boolean | Se true, il soggetto deve avere IBAN per usare questa condizione |
isPagamentoContanti | Boolean | Marca la condizione come pagamento cash (MP01/MP04) |
skipValidazioneSDI
In Parametri è disponibile uno switch skipValidazioneSDI per disabilitare l'avviso “Codice Destinatario / PEC mancanti” per i clienti privati che non hanno né Codice SDI né PEC (consumatori finali con codice 0000000).
Aliquote IVA & Regimi: rimosso dal menu dashboard
La voce Aliquote IVA & Regimi è stata rimossa dalla dashboard perché duplicato: la gestione avviene ora unicamente da Parametri → Gestione Tabelle (sub-tab Regimi Fiscali e Aliquote IVA).
17Configurazione Trasmissione SDI (v2.1.1)
Dalla versione 2.1.1 la pagina Parametri include una nuova tab dedicata alla fatturazione elettronica e alla cassa previdenziale, denominata Fatturazione-Cassa ⚡SDI. La tab raccoglie i parametri di regime, cassa, preset e la nuova sezione di Trasmissione al Sistema di Interscambio.
Nuova tab «Fatturazione-Cassa ⚡SDI»
La precedente voce Fatturazione e Cassa è stata rinominata per rendere visibile la nuova funzione di trasmissione diretta SDI (icona ⚡). Contenuti della tab:
- Regime fiscale, Natura IVA di default, Cassa Previdenziale
- Preset Fatture (dicitura standard, importo proposto)
- skipValidazioneSDI e opzioni di validazione
- ⚡ Trasmissione Sistema di Interscambio (SDI) — nuova sezione
Sezione «⚡ Trasmissione Sistema di Interscambio (SDI)»
Permette di scegliere la modalità con cui NOX trasmette gli XML FatturaPA generati al SDI. I dati vengono salvati nel campo sdiConfig (JSONB) della tabella Parametri del workspace corrente.
| Modalità | Descrizione | Campi richiesti |
|---|---|---|
| Manuale (default) | L'operatore scarica l'XML e lo carica manualmente sul portale Fatture e Corrispettivi dell'Agenzia delle Entrate. | Nessuno |
| PEC | Invio del file XML come allegato a un messaggio PEC diretto a sdi01@pec.fatturapa.it, tramite libreria nodemailer. | Host SMTP, Porta, Utente (indirizzo PEC), Password, Mittente |
| Aruba API | Chiamata al web service REST Aruba Fatturazione Elettronica (autenticazione Basic). Disponibili ambiente Produzione e Demo. | URL endpoint, Username, Password |
Parametri tipici Aruba PEC
| Campo | Valore |
|---|---|
| Host | smtps.pec.aruba.it |
| Porta | 465 (SSL implicito) |
| Utente | Indirizzo PEC completo |
| Password | Password della casella PEC |
URL Aruba API
| Ambiente | URL | Registrazione |
|---|---|---|
| Produzione | https://ws.fatturazioneelettronica.aruba.it | Contratto Aruba Fatturazione Elettronica |
| Demo (test) | https://demows.fatturazioneelettronica.aruba.it | Registrazione gratuita su demo.fatturazioneelettronica.aruba.it |
⚠
Sicurezza password. I campi Password PEC, Password Aruba e Password SMTP sono dotati dell'icona 👁 (toggle occhio) per mostrare o nascondere temporaneamente il valore durante l'inserimento, evitando errori di digitazione. Il valore viene memorizzato nel campo
sdiConfig/smtpConfig e non viene mai ri-mostrato in chiaro di default. L'intera comunicazione UI ↔ backend avviene su HTTPS.
ⓘ
La configurazione è per workspace: ogni azienda ha il proprio intermediario, il proprio canale e le proprie credenziali. Il cambio modalità non richiede riavvio e ha effetto immediato sulle trasmissioni successive.
Schema database
Il campo sdiConfig JSONB è stato aggiunto al modello Parametri in tutti i workspace di sistema (gestione, gestione_generico, nox_provatest, nox_studio-delpizzo, nox_demo-generale, nox_devsystems, nox_test-profili). La migrazione ha usato ADD COLUMN IF NOT EXISTS ed e idempotente.
18Configurazione 11 intermediari SDI (v2.1.2)
Dalla versione 2.1.2 il menu Modalità trasmissione nella sezione ⚡ Trasmissione Sistema di Interscambio (SDI) offre 11 intermediari selezionabili (3 esistenti + 8 nuovi). La configurazione di ciascuno è dinamica: selezionando una modalità si apre automaticamente il relativo form di credenziali, salvato sempre nel campo sdiConfig (JSONB) della tabella Parametri.
[Screenshot: menu «Modalità trasmissione» espanso con 11 opzioni selezionabili]
Elenco completo delle 8 modalità
| # | Intermediario | Tipo autenticazione | Campi config | Stato |
|---|---|---|---|---|
| 1 | Manuale | — | nessuno | Attivo |
| 2 | PEC | SMTP TLS | host, port, user, password, mittente | Attivo |
| 3 | Aruba | Signin + upload REST | apiUrl, username, password | Attivo |
| 4 | Fatture in Cloud | OAuth2 refresh-token | clientId, clientSecret, companyId, refreshToken | Attivo (upload XML → 501) |
| 5 | Agyo Digital Hub | OAuth2 client_credentials | clientId, clientSecret, vatId | Attivo |
| 6 | Zucchetti Digital Hub | X-API-Key header | apiKey, endpoint | Attivo |
| 7 | FattureWeb (Wolters Kluwer) | Authorization: ApiKey | apiKey, companyCode, environment | Attivo |
| 8 | Fatturapa.it | Bearer token | email, apiKey | Attivo |
Validazione credenziali e gestione errori
Ogni intermediario attivo valida i campi obbligatori prima di contattare il provider remoto. I codici di errore restituiti al frontend seguono uno schema uniforme:
| Codice | Significato | Causa tipica |
|---|---|---|
400 | Credenziali incomplete | Campo obbligatorio mancante (clientId, apiKey, ecc.) |
401 / 403 | Autenticazione fallita | Chiave revocata, token scaduto, password errata |
501 | Non implementato | Funzione non supportata dal fornitore (Fatture in Cloud: invio diretto dell'XML) |
502 | Errore provider remoto | Il body dell'errore del provider è incluso nel messaggio |
ⓘ
In caso di errore
502 il messaggio contiene il body di risposta del provider (JSON, HTML o testo). Utile per identificare velocemente errori di configurazione (es. P.IVA non registrata presso l'hub, companyCode errato, environment non valido).
Password toggle 👁
Tutti i campi di tipo password e chiave API nei form dei nuovi intermediari sono dotati dell'icona 👁 (occhio) per mostrare/nascondere il valore in fase di inserimento. Nel componente Angular sono state introdotte 8 nuove variabili dedicate:
| Variabile | Campo controllato |
|---|---|
showPwdFic | Fatture in Cloud — clientSecret |
showPwdFicRefresh | Fatture in Cloud — refreshToken |
showPwdAgyo | Agyo Digital Hub — clientSecret |
showPwdZucchetti | Zucchetti Digital Hub — apiKey |
showPwdFattureweb | FattureWeb — apiKey |
showPwdFatturapaIt | Fatturapa.it — apiKey |
Persistenza e compatibilità
Il campo sdiConfig resta di tipo Json? (JSONB) e accetta qualsiasi shape. Nessuna modifica al modello Prisma è stata necessaria: le 8 nuove configurazioni si salvano come sotto-oggetti dedicati (fic, agyo, zucchetti, fattureweb, fatturapaIt, ecc.) all'interno dello stesso campo.
⚠
Nessuna dipendenza npm aggiuntiva. Le 8 integrazioni usano esclusivamente
fetch nativo di Node 18+ e FormData, senza introdurre librerie client proprietarie. Questo riduce la superficie d'attacco e mantiene la build leggera.
?Domande Frequenti (FAQ)
Devo inserire manualmente tutti i codici SDI (TP, MP, RF, TC, N)?
No. Il sistema pre-popola tutte le tabelle con i codici standard dell'Agenzia delle Entrate al primo accesso o tramite il Seed “Tabelle Normativa”. Si possono poi personalizzare le descrizioni e aggiungere condizioni pagamento specifiche.
Qual è la differenza tra Condizioni Pagamento e Tipi Pagamento?
I Tipi Pagamento (TP01/TP02/TP03) definiscono i termini (rate, unica, anticipo). Le Modalità Pagamento (MP01-MP23) definiscono il mezzo (contanti, bonifico, carta, ecc.). In NOX sono unificati nella tabella Condizioni Pagamento per semplificare la gestione.
Quando devo specificare la Natura IVA?
La Natura è obbligatoria solo quando l'aliquota IVA è 0%. Se l'aliquota è 22%, 10%, 4% o qualsiasi valore > 0, la Natura non serve e viene disabilitata. Senza Natura su righe a IVA 0%, il SDI rifiuta con errore 00401.
Come configuro il regime forfettario?
In Parametri → Fatturazione Elettronica, selezionare RF19 come regime fiscale e impostare aliquotaIVA = 0% con natura N2.2. Il sistema imposterà automaticamente le diciture obbligatorie sui documenti e disattiverà il calcolo IVA e ritenuta.
Come configuro una rata 30/60/90 giorni?
Creare una condizione pagamento con codice TP01, numero rate = 3, giorni prima scadenza = 30, intervallo = 30. Le scadenze verranno generate a 30, 60 e 90 giorni dalla data documento.
Come configuro un pagamento con acconto?
Creare una condizione pagamento con codice TP03 e specificare la percentuale acconto (es. 30%). Il sistema genera 2 scadenze: acconto immediato al 30% e saldo a termine per il restante 70%.
Posso eliminare un regime fiscale o una natura IVA?
Sì, ma solo se non è in uso: nei Parametri Azienda, nelle anagrafiche, nei documenti, sulle righe o sul catalogo. In caso contrario, il sistema impedisce l'eliminazione e dice dove è usato. È preferibile disattivare il record piuttosto che eliminarlo.
Cosa succede se cambio il codice TP di una condizione pagamento?
Il cambio si applica solo ai nuovi documenti. I documenti già salvati mantengono le scadenze già generate. Per ricalcolare, aprire il documento e premere “Rigenera scadenze”.
Perché FPR12 e non FPA12?
FPR12 (Fattura PRivati) è il formato per fatture verso imprese e privati (codice SDI a 7 cifre). FPA12 (Fattura Pubblica Amministrazione) è per fatture verso enti pubblici (codice IPA a 6 cifre, richiede CIG/CUP). La maggior parte delle aziende usa FPR12.
I codici N2, N3, N6 generici sono ancora validi?
No. Dal 01/01/2021 il SDI rifiuta i codici generici N2, N3 e N6. È obbligatorio specificare il sottotipo: N2.1 o N2.2, N3.1-N3.6, N6.1-N6.9. I codici generici restano nella tabella per compatibilità con documenti storici ma non devono essere usati per nuovi documenti.
Come faccio a sapere quale Tipo Cassa scegliere?
Il tipo cassa dipende dalla professione: iscritti ENPAM → TC09, avvocati → TC01, commercialisti → TC02, ingegneri/architetti → TC04 (Inarcassa). I professionisti senza cassa dedicata usano TC22 (INPS Gestione Separata) con rivalsa del 4%.
Come funziona la scadenza a fine mese?
Nella condizione pagamento, impostare modalità scadenza = “Fine mese”. Con giorni prima scadenza = 30: la scadenza cade l'ultimo giorno del mese successivo. Con overflow = “primo mese successivo”: se la data calcolata supera la fine mese, slitta al primo del mese dopo.
Posso avere più aliquote IVA con la stessa percentuale?
Sì. Puoi avere ad esempio “IVA 22%” ordinaria e “IVA 22% Split Payment” con regime split. Il codice deve essere diverso (es.
22 e SP22). Nella riga documento scegli l'aliquota corretta per l'operazione.Devo applicare un profilo documenti o posso configurare manualmente?
Il profilo è un punto di partenza consigliato: configura automaticamente tutti i tipi documento in base al tipo di azienda. Puoi poi personalizzare ogni singolo tipo documento dalla Gestione Tabelle. I tipi nascosti dal profilo non vengono eliminati e possono essere riattivati.
Perché il test SMTP fallisce con Gmail?
Dal 2022 Gmail non accetta la password normale per SMTP. Devi: (1) attivare la Verifica in 2 passaggi sul Google Account, (2) generare una App Password da Sicurezza → Password per le app, (3) usare la password di 16 caratteri generata nel campo Password SMTP. Server:
smtp.gmail.com, porta: 587, SSL: attivo.Posso usare la PEC come SMTP per inviare le fatture?
Tecnicamente sì (es. Aruba PEC:
smtps.pec.aruba.it:465), ma è sconsigliato per invii massivi: la PEC ha limiti stringenti di invio e costi per messaggio. Usare la PEC solo per comunicazioni formali. Per l'invio fatture e notifiche usare un account email ordinario o un servizio SMTP dedicato.
📖
Guida alla Configurazione Fiscale dei Documenti
Manuale operativo per la corretta configurazione dei tipi documento in base al profilo aziendale, regime fiscale e normativa italiana vigente.
G1. Profili Aziendali e Tipi Documento
Il sistema propone un profilo automatico in base ai Dati Aziendali (tipo anagrafica, regime fiscale, cassa previdenziale, settore). Ogni profilo configura automaticamente:
- Quali tipi documento sono visibili nel menu di inserimento
- Se il documento calcola IVA, bollo, cassa previdenziale
- Se la ritenuta d'acconto è attiva per default
- L'esigibilità IVA predefinita (Immediata, Differita, Split Payment)
- Se CIG/CUP sono obbligatori
| Profilo | Per chi | IVA | Bollo | Cassa | Ritenuta | Split |
|---|---|---|---|---|---|---|
| PG Ordinario | SRL, SPA, SNC, SAS, Coop | Sì | Su esenti | No | No | No |
| PF Ordinario | Professionista con cassa | Sì | Sì | Sì | Sì 20% | No |
| PF Olistico/Naturopatico | Naturopata, discipline olistiche | No (art.10) | Sì | Sì | No* | No |
| Forfettario | PF/DI regime forfettario | No | Sempre | No | No | No |
| DI Ordinario | Artigiano, commerciante con P.IVA | Sì | Su esenti | No | No | No |
| Ente Pubblico | Comune, ASL, Scuola | Sì | No | No | No | Sì |
| Commercio | Ingrosso/dettaglio | Sì | Su esenti | No | No | No |
| PF senza Cassa | Professionista INPS gest. sep. | Sì | Sì | No | Sì 20% | No |
* Il sanitario non applica ritenuta di default perché i pazienti privati non sono sostituti d'imposta. Si attiva manualmente per fatture verso aziende/enti.
⚠️
Applicare un profilo sovrascrive le regoleFatturazione di tutti i tipi documento. Se hai personalizzazioni manuali, verranno perse. Esegui un backup prima di applicare un nuovo profilo.
G2. IVA: Aliquote, Nature ed Esigibilità
Aliquote IVA italiane:
| Aliquota | Applicazione | Riferimento |
|---|---|---|
| 22% | Aliquota ordinaria | Art. 16 DPR 633/72 |
| 10% | Alimentari, farmaci, ristrutturazioni, turismo | Tab. A p. III DPR 633/72 |
| 5% | Alcuni beni alimentari di prima necessità | Tab. A p. II-bis DPR 633/72 |
| 4% | Alimentari base, prima casa, ausili disabili | Tab. A p. II DPR 633/72 |
| 0% con Natura | Esenti, escluse, non imponibili | Artt. 7-15 DPR 633/72 |
Nature IVA (obbligatorie quando aliquota = 0%):
| Codice | Descrizione | Uso tipico |
|---|---|---|
N1 | Escluse art. 15 | Bollo, anticipazioni in nome/conto, interessi moratori |
N2.1 | Non soggette (artt. 7-7sep) | Operazioni extra-UE territorialmente non rilevanti |
N2.2 | Non soggette — altri casi | Regime forfettario, contribuenti minimi |
N3.5 | Non imponibili — lett. intento | Esportatori abituali con dichiarazione d'intento |
N4 | Esenti art. 10 | Prestazioni sanitarie, finanziarie, assicurative, educative |
N5 | Regime del margine | Beni usati, oggetti d'arte |
N6.x | Inversione contabile | Reverse charge: edilizia (N6.3), rottami (N6.1), elettronica (N6.6) |
N7 | IVA assolta in altro stato UE | Vendite intra-UE con IVA nel paese del cliente |
🚫
Errore SDI 00401: riga con IVA 0% senza Natura → fattura rifiutata. Verifica sempre che ogni riga esente/esclusa abbia la natura corretta.
Esigibilità IVA:
| Codice | Descrizione | Quando si usa |
|---|---|---|
| I | Immediata | Default — IVA esigibile alla data fattura |
| D | Differita (art. 6 c.5) | Fatture differite TD24/TD25 — IVA esigibile al pagamento |
| S | Split Payment (art. 17-ter) | Solo verso PA — la PA versa l'IVA all'Erario |
G3. Bollo Virtuale
Il bollo virtuale da 2,00 € è obbligatorio su fatture e ricevute esenti IVA con importo superiore a 77,47 €.
| Condizione | Bollo |
|---|---|
| Fattura con IVA (qualsiasi aliquota > 0%) | MAI |
| Fattura esente art. 10 importo ≤ 77,47 | No |
| Fattura esente art. 10 importo > 77,47 | Sì — 2,00 € |
| Fattura forfettario (N2.2) importo > 77,47 | Sì — 2,00 € |
| DDT | Mai |
| Nota di credito | No (segue fattura originale) |
ℹ️
Chi paga il bollo? È a carico del cedente/prestatore, ma può essere addebitato al cliente in fattura. Il forfettario addebita tipicamente il bollo al cliente con dicitura "Imposta di bollo assolta in modo virtuale ai sensi del DM 17/06/2014".
G4. Ritenuta d'Acconto
La ritenuta d'acconto è un anticipo sulle imposte sul reddito trattenuto dal sostituto d'imposta (il cliente, se è azienda o professionista con P.IVA) al momento del pagamento.
| Cedente | Committente | Ritenuta |
|---|---|---|
| Professionista (PF) regime ordinario | Azienda / Professionista | Sì — 20% |
| Professionista (PF) regime ordinario | Privato senza P.IVA | No |
| Regime forfettario | Qualsiasi | Mai (esente per legge) |
| Persona giuridica (SRL, SPA…) | Qualsiasi | No (la PG non subisce ritenuta) |
| Sanitario verso paziente privato | Privato | No |
| Agente di commercio | Mandante | Sì — tipo RT04 (ENASARCO) |
Tipi di ritenuta SDI:
| Codice | Descrizione |
|---|---|
RT01 | Ritenuta persone fisiche |
RT02 | Ritenuta persone giuridiche |
RT03 | Contributo INPS |
RT04 | Contributo ENASARCO |
RT05 | Contributo ENPAM |
RT06 | Altro contributo previdenziale |
🧮
Formula:
Ritenuta = Imponibile netto × Aliquota / 100 — Netto a pagare = Totale documento − Ritenuta⚠️
Incompatibilità Split Payment + Ritenuta: non compatibili sullo stesso documento. Il sistema blocca l'invio SDI se entrambi attivi. Rif.: Circolare AdE 15/E del 2015.
G5. Cassa Previdenziale
I professionisti iscritti ad un albo possono (o devono) addebitare in fattura il contributo integrativo della propria cassa previdenziale.
| Cassa | Codice SDI | Aliquota | In base imponibile IVA? |
|---|---|---|---|
| INPS Gestione Separata | TC22 | 4% (facoltativa) | Sì |
| ENPAM | TC07 | 2-4% | Sì |
| CNPADC (commercialisti) | TC01 | 4% | Sì |
| Cassa Forense (avvocati) | TC02 | 4% | Sì |
| INARCASSA (ingegneri/arch.) | TC03 | 4% | Sì |
| ENPAV (veterinari) | TC05 | 2% | Sì |
| ENPAP (psicologi) | TC18 | 2% | Sì |
ℹ️
Professionista senza cassa: chi non è iscritto ad un albo versa alla Gestione Separata INPS. La rivalsa 4% è facoltativa; se applicata, indicarla come cassa TC22 nei Parametri.
G6. Split Payment (art. 17-ter)
Meccanismo di scissione dei pagamenti: la Pubblica Amministrazione versa l'IVA direttamente all'Erario, pagando al fornitore solo l'imponibile.
- Cessioni/servizi verso PA (Comuni, ASL, Scuole, Ministeri, ecc.)
- Verso società controllate dalla PA inserite nell'elenco MEF
- Non si applica ai forfettari (non espongono IVA)
- Non si applica ai compensi soggetti a ritenuta d'acconto
🧮
Netto a pagare = Imponibile + Cassa + Bollo − Ritenuta (l'IVA non viene incassata) — IVA versata all'Erario dalla PA = Totale IVA del documentoG7. CIG e CUP (Tracciabilità Flussi Finanziari)
Per le fatture verso PA, la Legge 136/2010 richiede almeno uno tra:
| Campo | Descrizione | Formato |
|---|---|---|
| CIG | Codice Identificativo Gara | Alfanumerico max 15 car. (es. 1234567ABC) |
| CUP | Codice Unico Progetto (progetto di investimento pubblico) | Alfanumerico 15 car. (es. B21B12000000001) |
🚫
Obbligo PA: l'assenza di CIG e/o CUP può causare il rifiuto della fattura. Il gestionale blocca l'invio SDI se il profilo PA richiede CIG/CUP e nessuno è compilato.
Eccezioni (CIG non obbligatorio):
- Acquisti sotto soglia 5.000 € (alcune PA lo richiedono comunque)
- Acquisti tramite convenzioni CONSIP
- Utenze (luce, gas, telefono, acqua)
- CIG
0000000per contratti esclusi dalla tracciabilità
G8. Regime Forfettario (L. 190/2014)
| Aspetto | Regola |
|---|---|
| IVA | Non si espone. Natura: N2.2 |
| Ritenuta d'acconto | Non si applica (art. 1 c.67 L.190/2014) |
| Bollo | Obbligatorio se importo > 77,47 € |
| Cassa previdenziale | Non applicabile (contributi versati a parte) |
| Imposta sostitutiva | 15% (o 5% per nuove attività nei primi 5 anni) |
| Diciture obbligatorie | "Operazione ex art. 1 cc. 54-89 L. 190/2014 — Regime forfetario" |
✅
Configurazione automatica: selezionando "Regime Forfettario" nei Parametri, il gestionale disattiva IVA/ritenuta, attiva il bollo e imposta natura N2.2 su tutti i tipi documento visibili.
G9. Codici SDI e FatturaPA
Tipi Documento SDI:
| Codice | Descrizione | Uso nel gestionale |
|---|---|---|
TD01 | Fattura | Documento di vendita principale |
TD02 | Acconto/anticipo su fattura | Acconto ricevuto |
TD04 | Nota di credito | Storno parziale/totale |
TD05 | Nota di debito | Integrazione importo |
TD06 | Parcella | Professionisti con cassa |
TD07 | Fattura semplificata | Importi < 400 €, CF non obbligatorio |
TD24 | Fattura differita art. 21 c.4 | Riepilogativa DDT mensile |
Formato Trasmissione:
FPR12— Fattura verso privati (B2B e B2C)FPA12— Fattura verso Pubblica Amministrazione
G10. Errori Comuni e Come Evitarli
| Errore | Causa | Soluzione |
|---|---|---|
| SDI 00401 | Riga con IVA 0% senza Natura | Imposta la Natura IVA corretta (N1-N7) per ogni riga esente |
| SDI 00423 | Ritenuta + Split Payment | Disattiva uno dei due — incompatibili |
| SDI 00430 | Bollo assente su esente > 77,47 € | Attiva "Bollo virtuale" nei Parametri (nelle aziende nuove nasce già acceso) |
| Fattura PA rifiutata | CIG/CUP mancanti | Compila almeno uno tra CIG e CUP |
| Ritenuta su forfettario | Profilo errato | Seleziona "Regime Forfettario" |
| IVA esposta su esente | Tipo documento con calcolaIva=true su prestazione sanitaria | Seleziona "Professionista Sanitario" |
| Cassa su P.G. | Profilo errato | Le persone giuridiche non hanno cassa previdenziale |
| Scadenze non generate | Tab "Scadenzario" mancante | Verifica che il tipo documento includa "scadenzario" nei tabs |
💡
Consiglio: dopo aver applicato un profilo documenti, verifica sempre emettendo una fattura di prova. Controlla che i totali (imponibile, IVA, bollo, ritenuta, netto a pagare) siano corretti prima di inviare al SDI.
Riferimenti Normativi
- DPR 633/72 — Istituzione e disciplina dell'IVA
- DPR 600/73 — Ritenuta d'acconto (art. 25)
- DPR 642/72 — Imposta di bollo
- DM 17/06/2014 — Bollo virtuale sulle fatture elettroniche
- L. 190/2014 — Regime forfettario (art. 1 cc. 54-89)
- L. 136/2010 — Tracciabilità flussi finanziari (CIG/CUP)
- Art. 17-ter DPR 633/72 — Split Payment
- D.Lgs. 471/97 — Sanzioni tributarie
- Specifiche tecniche FatturaPA v1.8.1 (AdE, gen. 2024)