Files
Khaemhat/docs/wiki/Allegati-e-file.md
T
Alby96andClaude Opus 5.5 b4a2802bed
CI / Build and test (SQLite) (pull_request) Successful in 1m36s
CI / PostgreSQL 16 integration (pull_request) Skipped
CI / PostgreSQL 17 integration (pull_request) Skipped
CI / YAML check (pull_request) Successful in 5s
CI / Docker image (pull_request) Successful in 1m13s
docs: close M3 with real screenshots, ADR 0024 and the 0.3.0 changelog (#36)
The milestone's Definition of Done asks for real screenshots, complete
wiki pages and a changelog for everything delivered. Fifteen screenshots
taken on a fresh instance now sit next to the mockups in the wiki;
Interfaccia, Dashboard, Preferenze, Design UI and Allegati are marked
complete, with the date-field shortcuts and the profile tabs that are not
built yet described as they really are. ADR 0024 records the Kh component
library, record pages and the shared list query, which shipped without
one, and the changelog gains its entries and a 0.3.0 section.

The visual check against the mockups found three layout bugs, fixed here:
the document total label took the timeline's .tl style and was cut, the
radar's .kh-choices class stacked the profile's theme cards in a column
(renamed .kh-radio-set), and on phones the top bar wrapped; it now keeps
icons only and the status bar shows only the live values.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 20:26:36 +01:00

9.8 KiB

Allegati e file

Stato: completa per M3 (invio e-mail e scanner con M5) · Ultima revisione: 2026-11-11 · Versione software: 0.3.0 (milestone M3) Modulo di licenza: CORE · Permessi principali: attachments.read, attachments.write, attachments.delete · Specifica: SPEC §9.4

Ogni documento e ogni anagrafica può avere allegati: file caricati dall'utente (l'ordine del cliente in PDF, una foto, un foglio di calcolo) e file generati da Khaemhat (PDF di stampa, XML FatturaPA, esportazioni, pacchetti ZIP). Gli allegati sono archiviati sul volume dei dati dell'istanza, con versione e impronta digitale.

Dove si trova

Da qualunque documento: icona Allegati nella toolbar (con il numero degli allegati) oppure scheda Allegati (n). Si apre il pannello laterale Allegati e file generati.

In questa versione i documenti veri arrivano con le vendite (M5): pannello, anteprime e anteprima di stampa si provano sul documento di prova degli sviluppatori (dal catalogo dei componenti /sviluppo/componenti, solo in ambiente di sviluppo), che ha tre file generabili (PDF, righe in CSV, righe in Excel). Mancano ancora Invia per e-mail e Da scanner / foto.

024 · Allegati del documento e generazione file Mockup 024 — pannello laterale sopra la fattura: elenco degli allegati con azioni, Carica file, Da scanner / foto, Scarica tutto (ZIP) e sezione Genera file (anteprima ridotta).

Khaemhat 0.3.0 · allegati Khaemhat 0.3.0 — la scheda Allegati del documento di prova: tre file generati con le loro versioni, Carica file, Scarica tutto (ZIP) e Genera file.

Regole di base

  • Un allegato appartiene a un solo documento (o a una sola anagrafica). Non esistono allegati "sciolti": se lo stesso file serve a due documenti va caricato in entrambi.
  • I file generati dal gestionale sono versionati (v1, v2…); i file caricati sono conservati così come sono, con l'impronta SHA-256 che ne garantisce l'integrità.
  • Alcuni allegati sono bloccati: ad esempio l'XML già inviato allo SDI non si può cancellare né sostituire.
  • Cancellare un documento (quando è ammesso) sposta i suoi allegati nel cestino dell'azienda per 30 giorni.

Tipi di allegato

Tipo Esempio Si può cancellare?
Caricato ordine del cliente in PDF, foto del cantiere, preventivo del fornitore sì, con il permesso attachments.delete
Generato PDF della fattura, righe esportate in XLSX, copia di cortesia ZIP, etichette colli sì, con il permesso; in alternativa si rigenera una nuova versione
Fattura elettronica XML FatturaPA emesso o ricevuto, file P7M no, se inviato o ricevuto dallo SDI (bloccato)
Notifica ricevute dello SDI (consegna, scarto…) bloccata (regola da confermare in sviluppo)

Per ogni allegato il pannello mostra: icona del formato (PDF, XML, XLSX, immagine, ZIP, CSV…), nome, chi l'ha caricato o generato e quando, dimensione, versione, eventuale modello usato.

Azioni sugli allegati

Icona Azione
occhio Anteprima in app
freccia in giù Scarica
busta Invia per e-mail (con le vendite)
frecce circolari Rigenera (nella sezione Genera file): crea una nuova versione del file generato
lucchetto Blocca: da quel momento il file non si può più eliminare; accanto al nome indica un file bloccato
cestino Sposta nel cestino (solo file non bloccati e con permesso), dopo una conferma

La casella Versioni precedenti mostra anche le versioni superate dei file generati (v1 quando c'è già v2).

In fondo all'elenco:

  • Carica file — scegli uno o più file dal computer;
  • Da scanner / foto — acquisisci un documento da fotocamera o scanner del dispositivo;
  • Scarica tutto (ZIP) — un unico archivio con tutti gli allegati del documento.

Generare file da un documento

La sezione Genera file del pannello elenca le uscite disponibili per il documento; ognuna ha il pulsante Genera e produce un allegato versionato, scaricabile o inviabile.

Uscita Formato Note
Stampa PDF PDF modello di stampa, numero di copie, lingua
XML FatturaPA XML (FPR12 / FPA12) eventualmente con il PDF di cortesia incorporato; richiede il modulo EINV
Righe in XLSX / CSV XLSX o CSV colonne visibili della griglia righe
Copia di cortesia PDF + XML ZIP pacchetto da inviare al cliente
Etichette colli PDF per formato etichetta e numero di colli
Estratti conto, rapportini PDF dai moduli che li prevedono

Rigenera non sovrascrive mai: crea la versione successiva (v2, v3…) e lascia consultabili le precedenti.

Anche i report producono file (XLSX, CSV, PDF) scaricabili e, se pianificati, inviati per e-mail come allegati. Le stampe massive (ad esempio tutte le fatture del mese) producono un unico ZIP scaricato direttamente, senza file temporanei.

Anteprima

Il pannello apre in app l'anteprima di:

Formato Come si vede
PDF visualizzatore PDF del browser, dentro la finestra di anteprima
Immagini (JPEG, PNG, GIF, WebP) adattate alla finestra
XML, testo testo così com'è
CSV, XLSX griglia (il primo foglio per gli XLSX)

Khaemhat 0.3.0 · anteprima di un XLSX Khaemhat 0.3.0 — l'anteprima di un file Excel generato: il primo foglio come griglia.

Dei file lunghi l'anteprima mostra l'inizio (200 righe, 200.000 caratteri) e lo dice. Gli altri formati si scaricano; PDF e immagini si aprono anche in una nuova finestra del browser.

Anteprima di stampa

025 · Anteprima di stampa Mockup 025 — anteprima di stampa di una fattura in formato A4 (anteprima ridotta).

Ctrl+P o l'icona Stampa del documento aprono in una scheda l'anteprima di stampa: il documento come foglio A4, con ingrandimento al 75, 100 o 125%. In alto:

  • Stampa — la stampa del browser, che stampa solo il foglio (non menu e barre);
  • Apri PDF e Scarica PDF — il PDF prodotto da Khaemhat, senza salvarlo fra gli allegati;
  • Salva come allegato — salva il PDF fra gli allegati del documento come nuova versione.

Modello di stampa, copie e lingua arrivano con i documenti di vendita (Vendite).

Khaemhat 0.3.0 · anteprima di stampa Khaemhat 0.3.0 — l'anteprima di stampa del documento di prova, con Stampa, Apri PDF, Scarica PDF, Salva come allegato e l'ingrandimento.

Cestino

Quando un allegato viene spostato nel cestino, o quando viene cancellato il suo documento, il file non sparisce subito: resta nel cestino dell'azienda per 30 giorni e poi viene eliminato definitivamente da un'attività programmata. In fondo al pannello degli allegati, la sezione Nel cestino elenca i file del documento che sono nel cestino, con la data in cui saranno eliminati e il pulsante Ripristina (serve attachments.delete).

Limiti e archiviazione

  • Dimensione massima di un file caricato: 25 MB per impostazione predefinita, modificabile dagli amministratori in Amministrazione → Impostazioni (vedi Impostazioni).
  • Il caricamento avviene in streaming, senza tenere l'intero file in memoria.
  • Ogni azienda ha una quota di spazio con statistiche d'uso.
  • Khaemhat non include un antivirus: è previsto un punto di aggancio per collegarne uno in futuro. Carica solo file di provenienza nota.
  • I file stanno nel volume dei dati dell'istanza, in una cartella per azienda e per anno; i backup dell'azienda includono anche gli allegati (vedi Backup e ripristino).

Come si usa

Allegare l'ordine del cliente a una fattura

  1. Apri la fattura e premi l'icona Allegati (o la scheda Allegati).
  2. Carica file e scegli il PDF dell'ordine.
  3. Il file compare nell'elenco con il tuo nome e la data.

Inviare al cliente la copia di cortesia

  1. Nel pannello allegati, sezione Genera file, premi Genera su Copia di cortesia PDF + XML.
  2. Nell'elenco compare lo ZIP: premi l'icona busta per inviarlo con il modello e-mail dell'azienda.

Permessi e licenza

Gli allegati sono nel modulo CORE. Vedere e scaricare richiede attachments.read; caricare, generare e bloccare richiede attachments.write; spostare nel cestino e ripristinare richiede attachments.delete. Un utente aziendale vede solo gli allegati della propria azienda. I file si scaricano solo dopo l'accesso: un indirizzo copiato non funziona per chi non è collegato. Gli allegati sono raggiungibili anche dalle API (download e caricamento su un documento, modulo API; vedi API e MCP).

Domande frequenti

  • Non riesco a cancellare l'XML della fattura. È bloccato perché già inviato allo SDI: è parte della documentazione fiscale.
  • Ho rigenerato il PDF ma il cliente ha ricevuto quello vecchio. Ogni versione resta nell'elenco: controlla quale versione è stata inviata.
  • Il caricamento fallisce con un file grande. Supera il limite configurato (25 MB predefiniti).

Pagine correlate

Vendite · Acquisti · Fatturazione elettronica · Report · Backup e ripristino · Impostazioni · Interfaccia e scorciatoie