📁 Sezionali Documenti

Un sezionale è una numerazione progressiva indipendente per un Tipo Documento e un Anno. Ogni Tipo Documento (es. TD01 Fattura, TD04 Nota Credito, DDT, Preventivo) può avere uno o più sezionali per anno. Ognuno con:

• Un codice identificativo (es. A, B, IT, EXP, RC) — può essere vuoto per il sezionale principale
• Una descrizione (es. «Fatture estere UE», «Cartacee 2026», «Studio Naturopata»)
• Un formato numero personalizzabile (template con placeholder)
• Un progressivo proprio (ultimo numero usato)
• Un flag default (uno solo per tipo+anno) — sezionale pre-selezionato sui nuovi documenti
• Un'eventuale Multi-Attività collegata (per filtrare il dropdown nel form documento)

Il numero finale di un documento viene generato applicando il formato del sezionale al progressivo: es. formato {prog}_{anno}{suffisso} con prog=5, anno=2026, suffisso=F → 5_2026F.

Accedi alla pagina da sidebar → AMMINISTRAZIONE → Multi-Attività e poi clicca «📁 Sezionali» in alto a destra. URL diretto: /gestione-tabelle/sezionali.

Lista sezionali

La tabella mostra una riga per ogni sezionale con le colonne:

Filtri

Sopra la tabella ci sono due filtri:

• Tipo Documento: dropdown per restringere a un singolo tipo (default: tutti)
• Anno: campo numerico (default: anno corrente)
• Bottone «↺ Reset» per tornare ai default

Creazione/Modifica sezionale

Bottone «➕ Nuovo sezionale» in alto a destra. Il form richiede:

• Tipo Documento * — obbligatorio, dalla lista dei Tipi Documento attivi
• Anno * — obbligatorio (default: anno corrente)
• Codice — vuoto = sezionale principale (un solo «default» per tipo+anno con codice vuoto). Può essere fino a 10 caratteri (es. A, IT, EXP, STUDIO)
• Descrizione — etichetta libera per il riepilogo
• Multi-Attività — opzionale, dalla tabella Multi-Attività
• Formato Numero * — template con placeholder (vedi § 4)
• Progressivo — di solito 0 (NOX lo incrementa). Modificabile per migrazione da altro gestionale
• ⭐ Sezionale di default — checkbox: se attivo, NOX auto-demota tutti gli altri sezionali default per lo stesso tipo+anno
• Attivo — se disattivato non appare nel dropdown del form documento

Il formato è un template di stringa con placeholder racchiusi tra graffe. Quando il documento passa a EMESSO, NOX sostituisce ogni placeholder con il valore reale.

Placeholder disponibili

Esempi pratici

Anteprima dinamica

Mentre componi il formato, l'anteprima del numero sulla destra si aggiorna in tempo reale (con prog = ultimo+1) così vedi subito che aspetto avrà il prossimo documento emesso.

Sotto il campo Formato Numero i placeholder appaiono come pillole grafiche con icona «grip» (⠿⠿) che indica la possibilità di trascinarle. Due modi per inserire un placeholder:

Modalità trascinamento

1. Tieni premuto il mouse su una pillola — il cursore diventa grabbing (mano chiusa)
2. Trascina sopra il campo Formato — il bordo dell'input diventa blu tratteggiato (drop-zone attiva)
3. Rilascia il mouse — il token viene inserito alla posizione del cursore nell'input (o sostituisce la selezione se ne avevi una)
4. Il cursore si riposiziona subito dopo il token inserito

Modalità click

Equivalente al drag ma più veloce: clicca sulla pillola e il token viene inserito alla posizione corrente del cursore (o accodato se l'input non ha focus).

Per ogni coppia (Tipo Documento, Anno) esiste al massimo un sezionale «default» — quello pre-selezionato sui nuovi documenti del tipo+anno.

Quando viene auto-creato

Se un Tipo Documento ha bisogno di emettere un documento ma nessun sezionale è ancora configurato per quell'anno, NOX ne crea automaticamente uno con:

• Codice = vuoto (sezionale principale)
• Formato = {prog}_{anno}{suffisso} (retrocompat con NOX precedente)
• isDefault = true
• Suffisso ereditato da Tipi Documento → Suffisso predefinito

Come si imposta

Nel form di modifica del sezionale, attiva il checkbox «⭐ Sezionale di default per questo Tipo + Anno». NOX demota automaticamente tutti gli altri sezionali default dello stesso tipo+anno (mai due default contemporanei, garantito dal backend).

Quando un soggetto svolge più attività sotto la stessa Partita IVA con contabilità separata (art. 36), è possibile collegare ogni sezionale a una specifica Multi-Attività dal dropdown nel form sezionale.

Come configurare

1. Vai in Multi-Attività e crea le attività (es. codice STUDIO «Studio Naturopatia», codice NEGOZIO «Vendita prodotti olistici»)
2. Vai in Sezionali e crea un sezionale per ogni attività del Tipo Documento (es. due sezionali FT 2026: codice STUDIO con attività=Studio, codice NEG con attività=Negozio)
3. Assegna ai soggetti l'attività corretta (futuro miglioramento — oggi si sceglie il sezionale manualmente nel form documento)

Vedi Manuale Multi-Attività per i dettagli sulla tabella attività e i casi d'uso normativi.

Nel form di un nuovo documento (e su documenti BOZZA), nella riga testata accanto a Tipo Documento / Data / Serie, NOX mostra il dropdown Sezionale:

• Lista i sezionali attivi per il Tipo Documento + Anno scelti
• Pre-seleziona il default automaticamente
• Per ogni opzione mostra: codice / descrizione / attività / anteprima prossimo numero
• Cambiando sezionale prima dell'EMESSO, NOX userà quello al momento dell'assegnazione del numero ufficiale

Lock su documenti già emessi

Su documenti già EMESSO / CONFERMATO / INVIATO, il dropdown è bloccato (cursore disabilitato + icona 🔒). Per cambiare sezionale a posteriori si usa il bottone «↺ Cambia» accanto al lucchetto (vedi § 9).

Su un documento già emesso, il bottone «↺ Cambia» apre un dialog modale che permette il cambio sezionale tracciato.

Procedura

1. Apri il documento già emesso in modifica
2. Clicca «↺ Cambia» accanto al lucchetto sul dropdown Sezionale
3. Si apre un dialog modale con avviso ambra: «Operazione tracciata: il documento è già emesso. Il cambio comporta rinumerazione dal nuovo sezionale e viene registrato nello storico audit.»
4. Seleziona il Nuovo sezionale dal dropdown (lo stesso tipo+anno; il sezionale corrente è disabilitato per evitare no-op)
5. Inserisci una Motivazione testuale (opzionale ma consigliata, es. «Spostamento numerazione su sezionale dedicato Estero»)
6. Clicca «Conferma cambio» — un secondo prompt nativo richiede ulteriore conferma (double-confirm)
7. NOX rinumera dal nuovo sezionale, aggiorna il numero del documento, e registra il movimento nella tabella log_modifiche_sezionali

Cosa viene loggato

Dalla pagina Sezionali, sulla riga del sezionale, il bottone «🔢» permette all'admin di forzare manualmente il progressivo. Utile per:

• Migrazione da altro gestionale: allinei il progressivo all'ultimo numero usato in precedenza, così il primo documento emesso in NOX continua la numerazione
• Saltare o riservare numeri: alzare il contatore è sempre possibile

Comportamento

Cliccando il bottone, si apre un prompt che richiede il nuovo valore. Conferma e NOX aggiorna sezionale.progressivo, se il valore non è sotto un numero già usato nella serie. Il prossimo documento emesso userà il numero successivo.

Quando più utenti emettono documenti contemporaneamente (es. 3 utenti che cliccano «EMESSO» nello stesso istante), NOX garantisce che nessun numero venga duplicato tramite un advisory lock Postgres.

Logica di assegnazione del numero

Quando il documento passa da BOZZA a EMESSO (o CONFERMATO/INVIATO):

1. NOX prende il sezionale dal documento (se selezionato esplicitamente) o il default per (tipo, anno). Se nessun sezionale esiste, ne crea automaticamente uno default.
2. Acquisisce un advisory lock Postgres su sezionaleId (pg_advisory_xact_lock(sezionaleId, 0)) — bloccante per altre transazioni che chiedono il lock sullo stesso sezionale, fino al commit
3. Calcola il prossimo progressivo come max(progressivi già usati, anche nel cestino, sezionale.progressivo) + 1
4. Aggiorna sezionale.progressivo = nuovoProgressivo
5. Applica il formato ai placeholder per ottenere la stringa numero finale
6. Salva documento.numero e documento.sezionaleId
7. Commit della transazione — il lock viene rilasciato

Documenti annullati, cestino ed eliminazione: quando un numero torna libero

Il contatore di una serie non torna mai indietro sopra un numero emesso. Quando un documento numerato va nel cestino o viene eliminato per sempre, NOX libera il suo numero solo se è l'ultimo della serie e solo se:

• fatture e note di credito: non è mai stato generato l'XML per lo SdI (quindi non può essere partito), oppure lo SdI l'ha scartato. Una fattura con l'XML generato, anche solo scaricato, tiene il suo numero per sempre;
• DDT, ordini, preventivi e gli altri documenti non fiscali: è una bozza mai emessa. Un documento che è stato emesso, anche se poi è tornato in bozza o è stato annullato, tiene il suo numero;
• documenti ricevuti (fatture e DDT dei fornitori): il numero è del fornitore, il contatore non si tocca.

Finché il documento sta nel cestino il suo numero resta comunque occupato: torna libero (se la regola lo permette) solo con l'eliminazione definitiva. Se il numero non è riusabile, l'eliminazione definitiva lo lascia riservato: né il pulsante 🔄 Riallinea numerazione né la modifica a mano del contatore possono scendere sotto di lui. Nel dubbio NOX lascia un buco: un buco si spiega, un numero ripetuto no.