Conservazione Documentale

Il modulo Conservazione implementa un archivio tecnico locale con tracciabilità crittografica (hash SHA-256) dei pacchetti di versamento.

Cosa fa il modulo:

• Crea pacchetti di versamento locali con manifest JSON firmato (hash)
• Salva i pacchetti in /opt/gestione/backend/conservazione/
• Tiene traccia di retention 10 anni per ogni pacchetto
• Permette verifica integrità a posteriori (hash calcolato vs hash memorizzato)
• Opzionalmente registra il riferimento AgID se il pacchetto è poi inviato a conservatore esterno

Ogni tipologia produce un manifest JSON con lista completa dei documenti (metadati essenziali) e hash aggregato SHA-256 per rilevare alterazioni successive.

1. Endpoint: POST /api/conservazione/pacchetti (ADMIN)
2. Body: { anno: 2026, periodo?: "Q1", tipologia: "FATTURE_EMESSE"|"REGISTRI_IVA"|"PRIMA_NOTA", note?: "..." }
3. Il sistema raccoglie i documenti, costruisce il manifest, calcola l'hash, scrive il file su disco.
4. Stato iniziale: LOCALE (archivio tecnico locale).
5. Scadenza conservazione: automatica a +10 anni dalla creazione (art. 2220 c.c.).

Il pacchetto ritorna: id, hash, documentiCount, storagePath, dimensione, scadenzaConservazione.

L'integrità di un pacchetto si verifica confrontando l'hash al momento della creazione con l'hash calcolato attualmente sul file e sul manifest in DB.

Verifica singola

Endpoint: GET /api/conservazione/pacchetti/:id/verifica

Risposta: { esito: "OK"|"HASH_DB_MISMATCH"|"HASH_FILE_MISMATCH"|"FILE_MANCANTE", storedHash, hashDb, hashFile, fileEsiste, dettagli }

Ogni verifica lascia traccia in log_verifica_conservazione.

Verifica massiva

Endpoint: POST /api/conservazione/verifica-tutti (ADMIN)

Esegue verifica su tutti i pacchetti e restituisce aggregato degli esiti.

Quando il pacchetto viene inviato a un conservatore accreditato AgID esterno, è possibile registrare il riferimento di conservazione restituito dal conservatore stesso (il codice identificativo univoco che serve per le verifiche fiscali).

Operativamente: aprire il pacchetto conservato e inserire nel campo “Riferimento conservatore” il codice ricevuto. Lo stato passa a CONSERVATO AGID.

Dal 2026 il gestionale può produrre in un click un Manifesto di conservazione: un file JSON “firmato” che raccoglie l'elenco di tutti i documenti fiscalmente rilevanti dell'anno con:

• Un'impronta digitale (hash SHA-256) per ciascun documento — serve per provare che non è stato modificato
• Un'impronta aggregata di tutto il gruppo
• Una firma digitale con data e firmatario
• Una marca temporale (timestamp) che attesta il momento esatto

A cosa serve

In caso di verifica fiscale o accertamento puoi dimostrare tramite il manifesto che alla data X hai conservato i documenti Y1, Y2, Y3... senza modifiche successive. È un completamento al formato UniSInCro delle Linee Guida AgID.

Come si genera

1. Vai su Contabilità → Registri IVA
2. Imposta l'anno di interesse
3. Clicca Scarica Manifesto Conservazione dal menu azioni
4. Il gestionale restituisce un file JSON con tutti i dati sopra descritti

Il file pesa pochi KB (contiene solo metadata + hash, non i payload dei documenti). Stampalo, archivialo o caricalo sul conservatore AgID.

Verifica successiva del manifesto

Se hai un manifesto scaricato in passato e vuoi verificare che non sia stato manomesso, basta ricaricarlo:

1. Apri la funzione Verifica manifesto
2. Incolla o carica il JSON
3. Il sistema ricalcola gli hash e confronta con quelli nel file
4. Risposta: VALIDO oppure MANOMESSO (con dettaglio di cosa non torna)