Gestione Tabelle

Configurazione tabelle di sistema — Condizioni pagamento, tipi documento, regimi fiscali, nature IVA, cassa previdenza

v 2.0 Aprile 2026 Manuale Utente

Riferimenti normativi

1Panoramica

Le Tabelle di Sistema contengono i dati di configurazione che alimentano tutti i moduli di NOX. Sono accessibili da Parametri → Gestione Tabelle.

Le tabelle sono organizzate in sub-tab, ciascuna con un colore identificativo:

TabellaIconaContenutoUsata da
Condizioni Pagamento💳Termini e modalità pagamento con codici SDIDocumenti, Scadenzario, Soggetti
Tipi Documento📄Configurazione completa tipi con regole fatturazioneDocumenti, Stampa, SDI
Formati Trasmissione📡Formati XML per invio SDIFatturazione Elettronica
Regimi FiscaliRegimi 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 IVARighe 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

Codici Condizioni SDI (TP)

CampoObbligatorioDescrizione
CodiceCodice identificativo (es. BB30, RD60)
DescrizioneTesto completo (es. “Bonifico Bancario 30 gg”)
Codice SDI (TP)Termine pagamento per XML FatturaPA
Modalità Pagamento (MP)ConsigliatoModalità pagamento per XML FatturaPA
AttivoSe visibile nei dropdown di selezione
OrdinePosizione nell'elenco dropdown
CodiceSignificatoScadenze generate
TP01Pagamento a rateN scadenze distribuite a intervalli regolari
TP02Pagamento completo1 scadenza unica (a vista o a N giorni)
TP03Anticipo + saldo2 scadenze: acconto immediato + saldo a termine

Codici Modalità Pagamento SDI (MP)

CodiceDescrizioneNote
MP01ContantiNon ammette TP01 (rate)
MP02Assegno
MP03Assegno circolare
MP04Contanti presso TesoreriaNon ammette TP01
MP05BonificoIl più usato. Richiede IBAN.
MP06Vaglia cambiario
MP07Bollettino bancario
MP08Carta di pagamentoNon ammette TP01
MP09RIDAddebito diretto. Richiede IBAN.
MP10RID utenze
MP11RID veloce
MP12RIBARicevuta bancaria. Non ammette TP01.
MP13MAV
MP14Quietanza erario
MP15Giroconto su conti di contabilità speciale
MP16Domiciliazione bancaria
MP17Domiciliazione postaleNon ammette TP01
MP18Bollettino di c/c postale
MP19SEPA Direct Debit
MP20SEPA Direct Debit CORE
MP21SEPA Direct Debit B2B
MP22Trattenuta su somme già riscosse
MP23PagoPANon 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

FlagEffetto
Richiede IBANAlla selezione in documento, avvisa se il soggetto non ha IBAN configurato
Richiede riferimentoObbliga l'inserimento di un riferimento (CRO, n° assegno)
È pagamento contantiAttiva le verifiche per bollo e soglia contanti
Addebito direttoIndica che il pagamento avviene per addebito in conto
Applica scontoPropone 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.
3Tipi Documento

La tabella Tipi Documento definisce il comportamento fiscale e di interfaccia di ciascun tipo. Ogni record contiene un oggetto JSON regoleFatturazione.

Campi principali

CampoDescrizione
CodiceCodice identificativo (TD01, TD04, DDT, PRV, RIC, FP, ecc.)
DescrizioneNome esteso (es. “Fattura”, “Nota di Credito”)
Descrizione breveLabel per intestazione stampa
SuffissoSuffisso nella numerazione (FA, NC, DDT...)
Visibile in inserimentoSe appare nel dropdown tipo quando si crea un documento
Attivo / OrdineStato e posizione nell'elenco

Regole di fatturazione (JSON)

RegolaTipoEffetto
calcolaIvabooleanCalcola IVA per aliquota sulle righe
calcolaBollobooleanApplica bollo 2 € se imponibile esente > 77,47 €
calcolaInpsbooleanAggiunge contributo cassa previdenziale
labelIntestatariostringEtichetta: Cliente, Paziente, Fornitore, Destinatario
labelDocumentostringTitolo del documento in stampa
tabsstring[]Tab visibili nel form (righe, pagamento, trasporto, agente, ecc.)
statiDisponibilistring[]Stati ammessi (BOZZA, EMESSO, CONFERMATO, ecc.)
colorehexColore badge nella lista documenti
visibileInInserimentobooleanMostra nel dropdown creazione documento
isRiepilogativaDDTbooleanAbilita overlay selezione DDT (per TD24)
intestatarioLiberobooleanConsente intestatario manuale senza soggetto anagrafica
mostraImportibooleanMostra prezzi e importi nelle righe
contenutiExtrastring[]Campi extra catalogo da mostrare (posologia, note, ecc.)

Codici documento standard AdE

CodiceTipoUso
TD01FatturaFattura ordinaria
TD02Acconto su fatturaPagamento anticipato parziale
TD03Acconto su parcellaAnticipo su parcella professionale
TD04Nota di CreditoStorno totale o parziale di fattura emessa
TD05Nota di DebitoIntegrazione importo fattura emessa
TD06ParcellaFattura professionale con cassa e ritenuta
TD07Fattura SemplificataPer importi < 400 € (art. 21-bis DPR 633/72)
TD24Fattura DifferitaRiepilogativa DDT, entro il 15 del mese successivo
DDTDocumento di TrasportoAccompagnamento merci (non SDI)
PRVPreventivoOfferta commerciale
PFPro-FormaFattura proforma (non fiscale)
ORDOrdineOrdine cliente
RICRicettaPrescrizione sanitaria
FPFattura PassivaFattura 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).

CodiceDescrizioneQuando usare
FPR12Fattura verso privatiFatture B2B e B2C verso soggetti privati e imprese. È il formato standard per la quasi totalità delle fatture.
FPA12Fattura verso PAFatture 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.

CodiceDescrizioneImplicazioni
RF01Regime OrdinarioIVA applicata normalmente. Ritenuta se professionista.
RF02Contribuenti minimi (art. 1 c.96-117 L.244/2007)No IVA, no ritenuta, natura N2.2
RF04Agricoltura e pesca (artt. 34/34-bis DPR 633/72)Regime speciale compensazione
RF05Vendita sali e tabacchi (art. 74 c.1 DPR 633/72)Regime monofase
RF06Commercio fiammiferi (art. 74 c.1)Regime monofase
RF07Editoria (art. 74 c.1)Regime monofase editoria
RF08Gestione servizi telefonia pubblica (art. 74 c.1)Regime monofase
RF09Rivendita documenti di trasporto (art. 74 c.1)Regime monofase
RF10Intrattenimenti e giochi (art. 74 c.6)Regime speciale
RF11Agenzie di viaggio (art. 74-ter)Regime del margine 74-ter
RF12Agriturismo (art. 5 c.2 L.413/91)Regime speciale agriturismo
RF13Vendite a domicilio (art. 25-bis c.6 DPR 600/73)Ritenuta a titolo d'imposta
RF14Rivendita beni usati, oggetti d'arte, antiquariato (art. 36 DL 41/95)Regime del margine
RF15Agenzie vendite all'asta (art. 40-bis DL 41/95)Regime del margine
RF16IVA per cassa (art. 32-bis DL 83/2012)Esigibilità IVA differita all'incasso
RF17IVA per cassa P.A. (art. 6 c.5 DPR 633/72)IVA differita per forniture a PA
RF18AltroRegime non codificato
RF19Regime 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.

CodiceCassaProfessione
TC01Cassa Nazionale Previdenza AvvocatiAvvocati
TC02Cassa Previdenza Dottori CommercialistiCommercialisti
TC03Cassa Previdenza GeometriGeometri
TC04Cassa Nazionale Previdenza Ingegneri e Architetti (Inarcassa)Ingegneri, Architetti
TC05Cassa Nazionale NotariatoNotai
TC06Cassa Ragionieri e Periti CommercialiRagionieri
TC07ENASARCOAgenti di commercio
TC08ENPACLConsulenti del lavoro
TC09ENPAMMedici e odontoiatri
TC10ENPAPIInfermieri professionali
TC11ENPAVVeterinari
TC12ENPAIAAddetti in agricoltura
TC13Fondo Previdenza Impiegati AgricolturaImpiegati agricoltura
TC14INPGIGiornalisti
TC15ONAOSIOrfani sanitari
TC16CASAGITGiornalisti (assistenza integrativa)
TC17EPPIPeriti industriali
TC18EPAPAttuari, chimici, geologi, forestali
TC19ENPABBiologi
TC20ENPAPPsicologi
TC21ENPAFFarmacisti
TC22INPS Gestione SeparataProfessionisti 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à.

CodiceDescrizioneNormativaEsempio
N1Escluse art. 15Art. 15 DPR 633/72Interessi moratori, penali, bolli, spese anticipate in nome e per conto
N2Non soggetteGenerico (dal 01/01/2021 obbligatorio il dettaglio N2.1/N2.2)
N2.1Non soggette - artt. 7-7septiesArt. 7-7sep DPR 633/72Operazioni fuori campo IVA per territorialità
N2.2Non soggette - altri casiArt. 1 c.54-89 L.190/2014Regime forfettario, contribuenti minimi, omaggi senza rivalsa
N3Non imponibiliGenerico (obbligatorio il dettaglio N3.1-N3.6)
N3.1Non imponibili - esportazioniArt. 8 c.1 lett. a DPR 633/72Esportazioni dirette
N3.2Non imponibili - cess. intra-UEArt. 41 DL 331/93Cessioni intracomunitarie
N3.3Non imponibili - cessioni a San MarinoArt. 71 DPR 633/72Cessioni verso San Marino
N3.4Non imponibili - op. assimilate esportazioniArt. 8 c.1 lett. c DPR 633/72Cessioni con lettera di intento (esportatori abituali)
N3.5Non imponibili - dichiarazioni intentoArt. 8 c.1 lett. c DPR 633/72A seguito di dichiarazione d'intento
N3.6Non imponibili - altre operazioniVariAltre operazioni non imponibili non rientranti nei precedenti
N4EsentiArt. 10 DPR 633/72Prestazioni sanitarie, operazioni bancarie, assicurazioni, locazioni
N5Regime del margine / IVA non espostaArt. 36 DL 41/95Beni usati, oggetti d'arte, antiquariato (regime del margine)
N6Inversione contabile (Reverse Charge)Generico (obbligatorio il dettaglio N6.1-N6.9)
N6.1RC - cessione rottamiArt. 74 c.7-8 DPR 633/72
N6.2RC - cessione oro/argentoArt. 17 c.5 DPR 633/72
N6.3RC - subappalto ediliziaArt. 17 c.6 lett. a DPR 633/72Subappalti settore edile
N6.4RC - cessione fabbricatiArt. 17 c.6 lett. a-bis
N6.5RC - cessione telefoni cellulariArt. 17 c.6 lett. b
N6.6RC - cessione prodotti elettroniciArt. 17 c.6 lett. c
N6.7RC - prestazioni ediliArt. 17 c.6 lett. a-ter
N6.8RC - settore energeticoArt. 17 c.6 lett. d-bis/ter/quater
N6.9RC - altri casiArt. 17 c.6 altriAltre casistiche di reverse charge
N7IVA assolta in altro stato UEArt. 7 DPR 633/72Operazioni 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

  1. Selezionare la sub-tab della tabella desiderata.
  2. Premere il pulsante + Nuovo.
  3. Compilare i campi nel form che appare (codice, descrizione, parametri specifici).
  4. Premere Salva.

Modificare un record

  1. Nella lista, premere l'icona ✎ (Modifica) sulla riga desiderata.
  2. Il form si apre con i dati pre-compilati.
  3. Modificare i campi e premere Salva.

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 record in uso nei documenti: 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

OpzioneCampi aggiuntivi
Persona FisicaNome e cognome del titolare
Ditta IndividualeNome/cognome + ragione sociale
Persona Giuridica (Srl, Spa, Snc, Sas)Solo ragione sociale
Ente PubblicoDenominazione 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 Medico, Farmacia, Studio Legale, Ferramenta, Agente di Commercio, ecc.) 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:

ParametroDescrizione
Formato TrasmissioneFPR12 (privati) o FPA12 (PA). Obbligatorio.
Regime FiscaleRF01-RF19. Determina IVA, diciture, natura. Obbligatorio.
Tipo Cassa PrevidenzaTC01-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 IVAObbligatoria se aliquotaIVA = 0%. Disabilitata se > 0%.
Bollo VirtualeAttiva/disattiva il calcolo automatico del bollo.
Massimale senza bolloSoglia in euro (default 77,47 € da DPR 642/72).
Importo bolloImporto del bollo (default 2,00 € da DM 17/06/2014).
Spese banca per rataImporto fisso aggiunto ad ogni rata dello scadenzario.
11Numerazioni e Sezionali

La sezione Numerazioni (Parametri → Numerazioni) mostra i progressivi di numerazione per ogni tipo documento e anno:

ColonnaDescrizione
Tipo DocumentoEs. TD01 Fattura, DDT, NC...
AnnoAnno di riferimento
SezionaleCodice sezionale (se presente)
Ultimo N° usatoUltimo numero progressivo assegnato
Prossimo N°Numero che verrà assegnato al prossimo documento emesso

L'amministratore può modificare manualmente il progressivo per allinearlo con la numerazione precedente (es. migrazione da altro gestionale).

Modificare il progressivo verso il basso può causare duplicazioni di numero. Aumentare solo se necessario per allineamento. La numerazione delle fatture deve essere progressiva e senza buchi (art. 21 c.2 lett. b DPR 633/72).
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

CampoDescrizioneEsempio
CodiceIdentificativo univoco dell'aliquota22, ES10, SP22
Aliquota %Percentuale IVA (0–100, decimali ammessi)22, 10, 4, 0
DescrizioneNome descrittivo“IVA 22%”, “Esente art. 10”
Tipo RegimeRegime fiscale speciale associatoSplit Payment, Reverse Charge, Forfettario
Natura IVA (SDI)Codice natura per XML FatturaPA (obbligatorio se aliquota = 0%)N4, N2.2, N3.1
Riferimento NormativoArticolo di legge“Art. 10 DPR 633/72”
AttivaSe selezionabile nei documentiSì / No
PredefinitaAliquota pre-selezionata per le nuove righeSì (una sola)

Regimi speciali supportati

RegimeNormativaEffetto
Split PaymentArt. 17-ter DPR 633/72IVA non incassata dal cedente, versata dal cessionario (PA)
Reverse ChargeArt. 17 c.6 DPR 633/72IVA assolta dal cessionario con autofattura. Natura N6.x
ForfettarioL. 190/2014 art. 1 c.54-89No IVA in fattura, natura N2.2, dicitura obbligatoria
Esenzione art. 10Art. 10 DPR 633/72Operazioni esenti (sanitarie, bancarie, assicurative). Natura N4
Esclusione art. 15Art. 15 DPR 633/72Escluse da IVA (interessi moratori, spese anticipate). Natura N1

Come aggiungere un'aliquota

  1. Premere + Nuova Aliquota.
  2. Inserire codice, percentuale, descrizione.
  3. Se aliquota = 0%: selezionare il Tipo Regime e la Natura IVA obbligatoria per il SDI.
  4. Opzionale: inserire il riferimento normativo.
  5. Attivare il flag Predefinita se deve essere l'aliquota di default.
  6. 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

ProfiloIconaDestinato a
PG Ordinario🏢SRL, SPA, SNC, SAS, Cooperative — regime IVA ordinario
PF Ordinario👤Professionista con cassa previdenziale, regime ordinario, ritenuta
PF SanitarioMedico, naturopata, fisioterapista — prestazioni esenti 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

  1. Il sistema suggerisce un profilo automatico in base al tipo azienda e al regime fiscale configurati nei Dati Aziendali.
  2. Selezionare il profilo desiderato dalla griglia di card.
  3. 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à.
  4. Premere “Applica Profilo” per applicare la configurazione.
  5. Il sistema aggiorna le regoleFatturazione di 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

CampoObbligatorioDescrizioneEsempio
Server SMTPIndirizzo del server di posta in uscitasmtp.gmail.com, smtp.aruba.it
PortaPorta di connessione587 (STARTTLS) o 465 (SSL)
UsernameAccount di autenticazioneinfo@miodominio.it
PasswordPassword di autenticazione (per Gmail: App Password)Password app 16 caratteri
Email mittenteNoIndirizzo “Da:” (se diverso da username)noreply@miodominio.it
SSL/TLSNoAbilita connessione cifrataAttivo per la maggior parte dei provider

Configurazione passo per passo

  1. Aprire la tab Configurazione Email nei Parametri.
  2. Inserire l'indirizzo del server SMTP del proprio provider email.
  3. Inserire la porta: 587 per STARTTLS (consigliata) o 465 per SSL diretto.
  4. Inserire username (solitamente l'indirizzo email completo) e password.
  5. Attivare SSL/TLS se il provider lo richiede (quasi sempre).
  6. Opzionale: inserire un indirizzo mittente diverso dall'username.
  7. Inserire un indirizzo nel campo Email di test.
  8. Premere “Testa Connessione” per verificare che la configurazione funzioni.
  9. Se il test ha successo (banner verde), premere Salva.

Configurazione per i principali provider

ProviderServer SMTPPortaSSLNote
Gmailsmtp.gmail.com587Richiede App Password (non la password normale). Attivare 2FA su Google Account, poi generare App Password da Sicurezza → Password per le app.
Arubasmtps.aruba.it465Username: indirizzo email completo
Aruba PECsmtps.pec.aruba.it465Per invio PEC
Microsoft 365smtp.office365.com587Richiede autenticazione moderna (OAuth)
Register.itsmtp.register.it587Username: 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:

CampoDescrizioneVisibilità
Tipo DocumentoTipo documento predefinito per i nuovi documenti (es. TD01 Fattura)Sempre
Condizioni e Modalità PagamentoCondizioni preselezionate con codice TP e MP per XML SDISempre
DivisaCodice valuta ISO predefinito (es. EUR, USD, GBP)Sempre
Dicitura Standard per riga fatturaTesto precompilato nella descrizione della prima riga di ogni nuova fattura TD01Solo Studio Medico / Naturopatico
Importo PropostoPrezzo precompilato nella prima riga di ogni nuova fattura TD01Solo Studio Medico / Naturopatico

Dicitura Standard e Importo Proposto

Questi campi appaiono solo quando il Profilo Attività è “Studio Medico / Naturopatico”. 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 studi medici e naturopatici che emettono fatture con prestazione e importo ricorrenti, velocizzando l'inserimento.
16Novità Aprile 2026 (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àSettoreProfilo documento default
STUDIO_MEDICOSANITARIOPF_SANITARIO
STUDIO_NATUROPATICONATUROPATIAPF_NATUROPATA
COMMERCIALECOMMERCIALEPF_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:

CampoTipoDescrizione
modalitaPagamentoStringaCodice MP SDI associato (MP01…MP23)
richiedeIBANBooleanSe true, il soggetto deve avere IBAN per usare questa condizione
isPagamentoContantiBooleanMarca 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 (17 aprile 2026) 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àDescrizioneCampi richiesti
Manuale (default)L'operatore scarica l'XML e lo carica manualmente sul portale Fatture e Corrispettivi dell'Agenzia delle Entrate.Nessuno
PECInvio 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 APIChiamata al web service REST Aruba Fatturazione Elettronica (autenticazione Basic). Disponibili ambiente Produzione e Demo.URL endpoint, Username, Password

Parametri tipici Aruba PEC

CampoValore
Hostsmtps.pec.aruba.it
Porta465 (SSL implicito)
UtenteIndirizzo PEC completo
PasswordPassword della casella PEC

URL Aruba API

AmbienteURLRegistrazione
Produzionehttps://ws.fatturazioneelettronica.aruba.itContratto Aruba Fatturazione Elettronica
Demo (test)https://demows.fatturazioneelettronica.aruba.itRegistrazione 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 (17 aprile 2026) 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 11 modalità

#IntermediarioTipo autenticazioneCampi configStato
1ManualenessunoAttivo
2PECSMTP TLShost, port, user, password, mittenteAttivo
3ArubaSignin + upload RESTapiUrl, username, passwordAttivo
4Fatture in CloudOAuth2 refresh-tokenclientId, clientSecret, companyId, refreshTokenAttivo (upload XML → 501)
5Agyo Digital HubOAuth2 client_credentialsclientId, clientSecret, vatIdAttivo
6Zucchetti Digital HubX-API-Key headerapiKey, endpointAttivo
7FattureWeb (Wolters Kluwer)Authorization: ApiKeyapiKey, companyCode, environmentAttivo
8Fatturapa.itBearer tokenemail, apiKeyAttivo
9InfocertCertificato X.509🧩 Stub 501
10Sistema ImpresaIn integrazione🧩 Stub 501
11AdE Web ServicesAccreditamento SDI + firma🧩 Stub 501

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:

CodiceSignificatoCausa tipica
400Credenziali incompleteCampo obbligatorio mancante (clientId, apiKey, ecc.)
401 / 403Autenticazione fallitaChiave revocata, token scaduto, password errata
501Non implementatoStub (Infocert/Sistema Impresa/AdE) o funzione non supportata (Fatture in Cloud upload)
502Errore provider remotoIl 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:

VariabileCampo controllato
showPwdFicFatture in Cloud — clientSecret
showPwdFicRefreshFatture in Cloud — refreshToken
showPwdAgyoAgyo Digital Hub — clientSecret
showPwdZucchettiZucchetti Digital Hub — apiKey
showPwdFatturewebFattureWeb — apiKey
showPwdInfocertInfocert (per eventuali credenziali future)
showPwdSistemaImpresaSistema Impresa (per eventuali credenziali future)
showPwdFatturapaItFatturapa.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 o nei documenti. In caso contrario, il sistema impedisce l'eliminazione. È 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: medici → TC09 (ENPAM), 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
ProfiloPer chiIVABolloCassaRitenutaSplit
PG OrdinarioSRL, SPA, SNC, SAS, CoopSu esentiNoNoNo
PF OrdinarioProfessionista con cassaSì 20%No
PF SanitarioMedico, naturopata, fisioterapistaNo (art.10)No*No
ForfettarioPF/DI regime forfettarioNoSempreNoNoNo
DI OrdinarioArtigiano, commerciante con P.IVASu esentiNoNoNo
Ente PubblicoComune, ASL, ScuolaNoNoNo
CommercioIngrosso/dettaglioSu esentiNoNoNo
PF senza CassaProfessionista INPS gest. sep.NoSì 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:

AliquotaApplicazioneRiferimento
22%Aliquota ordinariaArt. 16 DPR 633/72
10%Alimentari, farmaci, ristrutturazioni, turismoTab. 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 disabiliTab. A p. II DPR 633/72
0% con NaturaEsenti, escluse, non imponibiliArtt. 7-15 DPR 633/72

Nature IVA (obbligatorie quando aliquota = 0%):

CodiceDescrizioneUso tipico
N1Escluse art. 15Bollo, anticipazioni in nome/conto, interessi moratori
N2.1Non soggette (artt. 7-7sep)Operazioni extra-UE territorialmente non rilevanti
N2.2Non soggette — altri casiRegime forfettario, contribuenti minimi
N3.5Non imponibili — lett. intentoEsportatori abituali con dichiarazione d'intento
N4Esenti art. 10Prestazioni sanitarie, finanziarie, assicurative, educative
N5Regime del margineBeni usati, oggetti d'arte
N6.xInversione contabileReverse charge: edilizia (N6.3), rottami (N6.1), elettronica (N6.6)
N7IVA assolta in altro stato UEVendite 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:

CodiceDescrizioneQuando si usa
IImmediataDefault — IVA esigibile alla data fattura
DDifferita (art. 6 c.5)Fatture differite TD24/TD25 — IVA esigibile al pagamento
SSplit 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 €.

CondizioneBollo
Fattura con IVA (qualsiasi aliquota > 0%)MAI
Fattura esente art. 10 importo ≤ 77,47No
Fattura esente art. 10 importo > 77,47Sì — 2,00 €
Fattura forfettario (N2.2) importo > 77,47Sì — 2,00 €
DDTMai
Nota di creditoNo (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.

CedenteCommittenteRitenuta
Professionista (PF) regime ordinarioAzienda / ProfessionistaSì — 20%
Professionista (PF) regime ordinarioPrivato senza P.IVANo
Regime forfettarioQualsiasiMai (esente per legge)
Persona giuridica (SRL, SPA…)QualsiasiNo (la PG non subisce ritenuta)
Sanitario verso paziente privatoPrivatoNo
Agente di commercioMandanteSì — tipo RT04 (ENASARCO)

Tipi di ritenuta SDI:

CodiceDescrizione
RT01Ritenuta persone fisiche
RT02Ritenuta persone giuridiche
RT03Contributo INPS
RT04Contributo ENASARCO
RT05Contributo ENPAM
RT06Altro contributo previdenziale
🧮
Formula: Ritenuta = Imponibile netto × Aliquota / 100Netto 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.

CassaCodice SDIAliquotaIn base imponibile IVA?
INPS Gestione SeparataTC224% (facoltativa)
ENPAM (medici)TC072-4%
CNPADC (commercialisti)TC014%
Cassa Forense (avvocati)TC024%
INARCASSA (ingegneri/arch.)TC034%
ENPAV (veterinari)TC052%
ENPAP (psicologi)TC182%
ℹ️
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 documento

G7. CIG e CUP (Tracciabilità Flussi Finanziari)

Per le fatture verso PA, la Legge 136/2010 richiede almeno uno tra:

CampoDescrizioneFormato
CIGCodice Identificativo GaraAlfanumerico max 15 car. (es. 1234567ABC)
CUPCodice 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 0000000 per contratti esclusi dalla tracciabilità

G8. Regime Forfettario (L. 190/2014)

AspettoRegola
IVANon si espone. Natura: N2.2
Ritenuta d'accontoNon si applica (art. 1 c.67 L.190/2014)
BolloObbligatorio se importo > 77,47 €
Cassa previdenzialeNon applicabile (contributi versati a parte)
Imposta sostitutiva15% (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:

CodiceDescrizioneUso nel gestionale
TD01FatturaDocumento di vendita principale
TD02Acconto/anticipo su fatturaAcconto ricevuto
TD04Nota di creditoStorno parziale/totale
TD05Nota di debitoIntegrazione importo
TD06ParcellaProfessionisti con cassa
TD07Fattura semplificataImporti < 400 €, CF non obbligatorio
TD24Fattura differita art. 21 c.4Riepilogativa DDT mensile

Formato Trasmissione:

  • FPR12 — Fattura verso privati (B2B e B2C)
  • FPA12 — Fattura verso Pubblica Amministrazione

G10. Errori Comuni e Come Evitarli

ErroreCausaSoluzione
SDI 00401Riga con IVA 0% senza NaturaImposta la Natura IVA corretta (N1-N7) per ogni riga esente
SDI 00423Ritenuta + Split PaymentDisattiva uno dei due — incompatibili
SDI 00430Bollo assente su esente > 77,47 €Attiva "Bollo virtuale" nei Parametri
Fattura PA rifiutataCIG/CUP mancantiCompila almeno uno tra CIG e CUP
Ritenuta su forfettarioProfilo erratoSeleziona "Regime Forfettario"
IVA esposta su esenteTipo documento con calcolaIva=true su prestazione sanitariaSeleziona "Professionista Sanitario"
Cassa su P.G.Profilo erratoLe persone giuridiche non hanno cassa previdenziale
Scadenze non generateTab "Scadenzario" mancanteVerifica 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)