Piano dei Conti

Il Piano dei Conti è la struttura fondamentale della contabilità aziendale. Definisce l'elenco ordinato e gerarchico di tutti i conti in cui vengono classificate le operazioni economiche e patrimoniali dell'azienda.

In NOX Enterprise Suite il piano dei conti è organizzato su tre livelli gerarchici e alimenta direttamente la Prima Nota, il Registro IVA, il Bilancio e tutti i report contabili.

Funzionalità principali

• Struttura gerarchica a tre livelli: Mastro → Conto → Sottoconto
• Sei tipi di conto con codifica cromatica (Attivo, Passivo, Costo, Ricavo, Patrimoniale, Ordine)
• Nove nature per raggruppamenti e report (Clienti, Fornitori, Banche, Cassa, Merci, Servizi, Imposte, Patrimonio, Altro)
• Filtri avanzati per livello, tipo, natura, stato attivo/inattivo e ricerca testuale
• Creazione rapida di figli: dal pulsante sulla riga del padre si crea direttamente il conto o sottoconto figlio
• Attivazione/disattivazione non distruttiva: i conti disattivati restano nei documenti esistenti ma scompaiono dai dropdown
• Protezione cancellazione: non si può eliminare un conto che ha figli
• Statistiche in tempo reale: conteggio mastri, conti, sottoconti e totale attivi

Il piano dei conti è organizzato su tre livelli, ciascuno con un ruolo specifico:

La relazione tra i livelli è di tipo padre-figlio:

• Un Mastro non ha padre (livello radice)
• Un Conto ha come padre obbligatorio un Mastro
• Un Sottoconto ha come padre obbligatorio un Conto

Tipi di conto (Tipo Conto)

Ogni conto è classificato con un tipo che ne determina la collocazione nel bilancio:

Nature conto (Natura Conto)

La natura è un attributo trasversale usato per raggruppamenti e report specifici:

La schermata del Piano dei Conti presenta due modalità: Lista e Form.

Modalità Lista

• Banner informativo: titolo, sottotitolo e quattro contatori in tempo reale (Mastri, Conti, Sottoconti, Attivi totali)
• Barra strumenti: pulsanti per creare Mastro, Conto o Sottoconto, e il pulsante Aggiorna per ricaricare i dati
• Filtri: ricerca testuale, filtro per livello, tipo, stato attivo. Contatore “Mostrati X di Y”
• Tabella dati: colonne Livello, Codice (con indentazione gerarchica), Descrizione (con note inline), Tipo (badge colorato), Natura, Padre, Stato, Azioni

Visualizzazione gerarchica nella tabella

• I Mastri (Lv.1) sono in grassetto con sfondo azzurro chiaro
• I Conti (Lv.2) hanno un'indentazione di 16px e il prefisso “└”
• I Sottoconti (Lv.3) hanno un'indentazione di 32px, font più piccolo
• I conti disattivati appaiono con opacità ridotta (50%) e sfondo grigio

Pulsanti azione per riga

Modalità Form

Il form di creazione/modifica mostra i campi su più righe, con un'anteprima visuale del conto in basso che riflette in tempo reale le scelte effettuate (codice, descrizione, tipo con colore, livello, padre).

Il Mastro è il livello radice del piano dei conti. Rappresenta le macro-sezioni del bilancio.

1. Premere il pulsante + Nuovo Mastro nella barra strumenti.
2. Il campo Livello è pre-impostato a “1 — Mastro”. Il campo Conto Padre non viene mostrato (il mastro è radice).
3. Inserire il Codice: massimo 20 caratteri, convertito automaticamente in maiuscolo. Convenzione: numeri a 4 cifre (es. 1000, 2000, 3000).
4. Inserire la Descrizione (es. “Attività correnti”, “Patrimonio netto”, “Costi della produzione”).
5. Selezionare il Tipo Conto (Attivo, Passivo, Costo, Ricavo, Patrimoniale, Ordine).
6. Selezionare la Natura Conto (Clienti, Fornitori, Banche, ecc.).
7. Opzionale: inserire Note (riferimenti normativi, istruzioni d'uso).
8. Verificare l'anteprima in basso e premere Crea Conto.

Esempio di mastri tipici

Il Conto è il livello intermedio. Raggruppa i sottoconti per tipologia all'interno di un Mastro.

1. Premere + Conto nella barra strumenti, oppure premere l'icona 📂 sulla riga del Mastro padre.
2. Il Livello è pre-impostato a “2 — Conto”.
3. Selezionare il Conto Padre (Mastro di appartenenza). Se creato dal pulsante sulla riga, il padre è già pre-compilato.
4. Inserire Codice (es. 1101), Descrizione, Tipo, Natura.
5. Premere Crea Conto.

Il Sottoconto è il livello operativo: le registrazioni di Prima Nota avvengono sui sottoconti.

1. Premere + Sottoconto nella barra strumenti, oppure premere l'icona 📄 sulla riga del Conto padre.
2. Il Livello è pre-impostato a “3 — Sottoconto”.
3. Selezionare il Conto Padre (Conto di livello 2). Il dropdown mostra solo i conti attivi di livello 2.
4. Inserire Codice (es. 1101.01), Descrizione, Tipo, Natura.
5. Premere Crea Conto.

Convenzione di codifica sottoconti

Si consiglia di usare il formato XXXX.YY dove XXXX è il codice del conto padre e YY è un progressivo (01, 02, 03...):

Per modificare un conto esistente:

1. Nella tabella, individuare il conto e premere l'icona ✎ (Modifica) nella colonna Azioni.
2. Il form si apre in modalità modifica con tutti i campi pre-compilati.
3. Modificare i campi desiderati: descrizione, tipo, natura, note, stato attivo, conto padre.
4. Premere Aggiorna per salvare le modifiche.

Cosa si può modificare

• Descrizione: liberamente modificabile
• Tipo conto: modificabile (attenzione: cambia la collocazione nel bilancio)
• Natura conto: modificabile (cambia i raggruppamenti nei report)
• Conto padre: si può riassegnare un conto a un padre diverso dello stesso livello
• Note: liberamente modificabili
• Stato attivo: attivabile/disattivabile

I conti possono essere disattivati senza eliminarli. Un conto disattivato:

• Non appare nei dropdown di selezione conto nella Prima Nota e in altre schermate
• Non appare nel dropdown “Conto Padre” quando si crea un figlio
• Resta visibile nelle registrazioni già effettuate (nessuna perdita di dati)
• Appare nella lista del Piano dei Conti solo con il filtro “Tutti” o “Solo disattivati”

Come disattivare

1. Nella colonna Azioni, premere l'icona 🚫 (Disattiva).
2. Confermare nella finestra di dialogo.
3. Il conto passa a stato “Off” con badge rosso.

Come riattivare

1. Impostare il filtro stato su “Tutti” o “Solo disattivati” per trovare il conto.
2. Premere l'icona ✅ (Riattiva).
3. Confermare nella finestra di dialogo.

L'eliminazione è un'operazione irreversibile soggetta a vincoli di integrità:

Quando è possibile eliminare

• Il conto non ha figli (né conti né sottoconti collegati)
• Il conto non è utilizzato in registrazioni di Prima Nota

Quando NON è possibile eliminare

• Se il conto ha figli: il sistema mostra un avviso e impedisce l'eliminazione. Eliminare prima tutti i figli.
• Se il conto è in uso in registrazioni contabili: il server restituisce un errore. In questo caso, disattivare il conto anziché eliminarlo.

Procedura

1. Premere l'icona 🗑 (Elimina) nella colonna Azioni.
2. Il sistema verifica la presenza di figli. Se ne ha, mostra un errore e l'operazione viene annullata.
3. Se non ha figli, appare una finestra di conferma con il nome del conto.
4. Confermare per procedere con l'eliminazione definitiva.

La barra filtri offre cinque strumenti combinabili tra loro:

Quando i filtri sono attivi, il contatore “Mostrati X di Y conti” indica quanti conti sono visibili rispetto al totale.

Non esiste una codifica obbligatoria per legge, ma le seguenti convenzioni sono ampiamente utilizzate nella prassi contabile italiana:

Conti IVA essenziali

Conti bancari e cassa

Il piano dei conti alimenta direttamente la Prima Nota, dove si registrano le operazioni contabili in partita doppia.

Come funziona il collegamento

• In Prima Nota, il campo “Conto” presenta un dropdown che mostra solo i conti attivi del piano
• La ricerca nel dropdown filtra per codice e descrizione
• Solo i sottoconti (livello 3) dovrebbero essere usati per le registrazioni operative; i livelli 1 e 2 servono per il raggruppamento
• Il tipo conto determina la colonna Dare/Avere di default per la registrazione

Registrazioni automatiche dai Documenti

Alla conferma di fatture e documenti, il sistema può generare automaticamente registrazioni di Prima Nota mappando:

• Fattura emessa → Dare: Crediti v/clienti — Avere: Ricavi + IVA debito
• Fattura passiva (FP) → Dare: Costi + IVA credito — Avere: Debiti v/fornitori
• Incasso → Dare: Banca — Avere: Crediti v/clienti
• Pagamento → Dare: Debiti v/fornitori — Avere: Banca

La struttura del piano dei conti determina direttamente la forma del bilancio d'esercizio:

Stato Patrimoniale (art. 2424 c.c.)

• Attivo: aggregazione di tutti i conti con tipo ATTIVO, raggruppati per Mastro
• Passivo: aggregazione di tutti i conti con tipo PASSIVO, raggruppati per Mastro
• Patrimonio netto: aggregazione dei conti con tipo PATRIMONIALE

Conto Economico (art. 2425 c.c.)

• Valore della produzione: conti RICAVO con natura MERCI e SERVIZI
• Costi della produzione: conti COSTO con natura MERCI, SERVIZI, ALTRO
• Proventi e oneri finanziari: conti RICAVO/COSTO con natura BANCHE
• Imposte: conti COSTO con natura IMPOSTE

Conti d'ordine

I conti di tipo ORDINE non entrano nel bilancio ma sono riportati in calce allo stato patrimoniale o nella nota integrativa, come previsto dall'art. 2424 c.c. Servono per tracciare impegni, garanzie prestate, beni di terzi in deposito.

Aggiornamento del modulo Piano dei Conti: tracciamento cronologico delle modifiche, soft-delete con cestino (limitato ai conti orphan) e operazioni massive per gestione rapida di gruppi di conti.

Soft-delete + Cestino

L'eliminazione di un conto diventa una cancellazione logica (soft-delete), con vincoli contabili:

• Non sono cancellabili conti con sottoconti attivi: elimina prima i sottoconti.
• Non sono cancellabili conti assegnati come conto cliente o conto fornitore a soggetti: riassegnare i soggetti a un altro conto prima.
• I conti che superano i vincoli vengono spostati nel cestino e si possono ripristinare in qualsiasi momento.
• L'eliminazione definitiva (hard-delete) e possibile solo per conti gia nel cestino e senza alcun collegamento (riservata all'amministratore).

Audit log automatico

Ogni modifica a un conto (codice, descrizione, tipo, natura, livello, riclassificazione di mastro, toggle attivo, note) viene registrata nella tabella log_modifiche_conti_contabili con valore precedente, valore nuovo, utente e timestamp. Accesso via GET /api/piano-dei-conti/:id/audit-log.

Nella lista il pulsante 🕔 Storico modifiche per riga apre un modal con la cronologia completa. Risponde alla domanda: “quando e da chi e stata cambiata la natura di questo conto da MERCI a SERVIZI?”

Timeline conto

Endpoint GET /api/piano-dei-conti/:id/timeline: aggrega le modifiche d'audit e fornisce counter di sottoconti e soggetti collegati (clienti/fornitori).

Operazioni massive

Nella lista e stata aggiunta la selezione multipla con checkbox. Con uno o piu conti selezionati compare la barra azioni blu con:

• ✓ Attiva / ⏸ Disattiva: cambio flag attivo in blocco (utile per abilitare/disabilitare sottoinsiemi, es. conti filiale).
• ⇄ Riclassifica…: cambia in blocco il tipo conto (ATTIVO/PASSIVO/COSTO/RICAVO/…) e/o la natura (CLIENTI/FORNITORI/BANCHE/CASSA/MERCI/…). Utile per ristrutturazioni del piano dei conti.
• 🗑 Cestino: soft-delete massivo con verifica dei vincoli contabili. I conti bloccati (con sottoconti o soggetti collegati) vengono riportati come bloccati nella risposta.

Endpoint: POST /api/piano-dei-conti/bulk. Ogni operazione registra audit per ciascun conto modificato.

A partire dalla versione 2.2, il modulo Piano dei Conti adotta lo standard di certificazione NOX con i seguenti presidi:

Cestino e soft-delete

Gli elementi cancellati non vengono rimossi fisicamente ma spostati in un cestino interno (campi cancellatoIl / cancellatoDa). Dalla toolbar il pulsante Cestino alterna tra vista attivi e vista cestino. Dal cestino è possibile:

• Ripristinare l'elemento (riportarlo nella lista attiva) — operazione riservata ad amministratori.
• Eliminare definitivamente con motivazione obbligatoria — azione irreversibile, riservata ad amministratori, tracciata nell'audit log.

Azioni massive (bulk)

È possibile selezionare più elementi con le checkbox della prima colonna. Appare una barra inferiore con le azioni disponibili: Attiva, Disattiva, Riclassifica, Soft-delete. Vincolo: blocca se sottoconti attivi o soggetti collegati. La risposta indica N operazioni riuscite / M fallite; i dettagli delle fallite compaiono nella console browser (F12).

Storico modifiche (audit log)

L'icona history nelle azioni di riga apre un modal con la storia completa delle modifiche: data, campo, valore precedente, valore nuovo, operatore, eventuale motivazione. I record di audit non sono modificabili né eliminabili via UI. Conservazione: indefinita (art. 2220 c.c. — 10 anni minimo).

Mascheramento dati sensibili (GDPR art. 32)

Se i campi modificati contengono dati sensibili (IBAN, Codice Fiscale, Partita IVA, password/token), l'audit log salva il valore mascherato anziché in chiaro:

Timeline aggregata

Per ciascun elemento è disponibile una vista Timeline che aggrega in ordine cronologico audit, eventi del ciclo di vita ed eventuali entità collegate (es. documenti, movimenti, storni).

RBAC uniforme

Tutte le azioni distruttive o massive (soft-delete, ripristino, eliminazione definitiva, bulk, storno) richiedono il ruolo ADMIN o superiore. Gli operatori possono continuare a creare / modificare / consultare secondo le proprie abilitazioni.

Import massivo del piano dei conti da file CSV con modalità UPSERT (default), APPEND o REPLACE.

• Template scaricabile: GET /api/contabilita-v15/pdc-import/template restituisce un CSV di esempio con colonne standard.
• Formato CSV: separatore ;, colonne codice;descrizione;tipoConto;naturaConto;livello;contoMastroCodice;attivo.
• Upload: POST /pdc-import/upload (multipart/form-data, field file) con parametro modalita.
• Matching mastro: il campo contoMastroCodice viene risolto automaticamente nel contoMastroId corrispondente.
• Log import: tabella pdc_import_log tiene traccia di righe totali, create, aggiornate, errori (fino a 50 dettagliati), utente, sorgente (CSV/CEE_TEMPLATE/XBRL/API).
• Storico: GET /pdc-import/storico restituisce le ultime 50 esecuzioni.

Tassonomia di voci di bilancio CEE pre-caricata per la riclassificazione automatica del piano dei conti aziendale.

• 48 voci CEE ufficiali seedate automaticamente: Stato Patrimoniale Attivo (A, B.I, B.II.1-4, B.III, C.I-IV, D), Passivo (PA.I/IV/VIII/IX, PB, PC, PD, PE), Conto Economico (CE.A.1-5, CE.B.6-14, CE.C-E, CE.20-21).
• Gerarchia 5 livelli con parent_codice per albero espandibile.
• Macro categorie: SP_ATTIVO, SP_PASSIVO, CE_VALORE_PRODUZIONE, CE_COSTI, CE_FINANZIARI, CE_RETTIFICHE, CE_STRAORDINARI, CE_IMPOSTE, CE_RISULTATO.
• Mapping conti ↔ voci CEE: tabella conti_cee_mapping con peso percentuale (default 100%), consente split di un conto su più voci di bilancio (es. 50% immobilizzazioni / 50% attivo circolante).
• API: GET /voci-cee?macro=SP_ATTIVO, GET /voci-cee/mapping/:contoId, POST /voci-cee/mapping.

Generazione automatica dello Stato Patrimoniale e del Conto Economico riclassificati secondo la tassonomia CEE, con calcolo di indicatori di bilancio.

• Stato Patrimoniale: GET /bilancio/stato-patrimoniale/:anno restituisce attivo, passivo, quadratura per l'esercizio. Le righe di prima nota su conti ATTIVO/PATRIMONIALE contribuiscono (dare - avere), quelle su PASSIVO contribuiscono (avere - dare).
• Conto Economico: GET /bilancio/conto-economico/:anno restituisce valore produzione, costi produzione, differenza A-B, EBIT.
• Snapshot salvato: POST /bilancio/snapshot firma i dati con hash SHA-256 per congelare il bilancio a una certa data (audit, deposito). La tabella bilancio_snapshot memorizza il JSON completo + totali aggregati.
• Elenco snapshot: GET /bilancio/snapshot?esercizio=Y&tipo=STATO_PATRIMONIALE.

Generazione del file XBRL per il deposito del bilancio presso la Camera di Commercio secondo la tassonomia ITCC-CI-2018-11-04.

• Prerequisito: snapshot Stato Patrimoniale + Conto Economico per l'esercizio.
• Generazione: POST /xbrl/genera/:anno body {tipo_deposito: "BILANCIO_ORDINARIO"} produce file XBRL con context, unit EUR, tag itcc:TotaleAttivo/Passivo/ValoreProduzione/CostiProduzione/RisultatoEsercizio.
• Tipi deposito: BILANCIO_ORDINARIO, ABBREVIATO, MICRO, CONSOLIDATO.
• Hash SHA-256: ogni XBRL generato viene firmato per garantirne l'integrità.
• Log depositi: tabella xbrl_export_log tiene traccia di stato (GENERATO → DEPOSITATO), protocollo CCIAA, eventuali errori.
• API: POST /xbrl/genera/:anno, GET /xbrl/log.