Documenti
Questa pagina mostra tutti i PDF ricevuti dal workspace, in ordine cronologico inverso (i più recenti prima).
Due viste: Attivi e Storico
La pagina ha due tab:
- Attivi — ultimi 100 documenti. La lista si aggiorna automaticamente ogni 5 secondi senza ricarica manuale.
- Storico — documenti archiviati secondo la retention configurata nelle Impostazioni del workspace. La lista è paginata e ordinabile cliccando sulle intestazioni di colonna.
Le colonne della lista
| Colonna | Descrizione |
|---|---|
| ☐ | Checkbox di selezione per le azioni multiple (vedi sotto). |
| File | Icona sorgente (🖐 upload manuale · 🤖 automazione) + nome del PDF. Se è uno split, badge parte N/M. Sul documento padre di un PDF multi-ordine compare un badge 📑 N con il numero di ordini estratti. |
| Tipo | Rilevato automaticamente: digitale (PDF con testo estraibile) o scansionato. |
| Stato | Esito dell'elaborazione (vedi tabella sotto). |
| Semaforo / Qualità | GREEN / YELLOW / RED con la percentuale di confidence. |
| Caricato | Data e ora di ricezione del PDF. |
| Azioni | Dettaglio e — se il documento è in stato completato — il badge CSV per il download immediato. |
| ✕ | Eliminazione singola del documento (con conferma). |
Nella tab Storico compaiono in più la colonna Archiviato e un'azione Ripristina per riportare il documento nella vista Attivi.
Stati documento
| Stato | Colore | Significato |
|---|---|---|
| completato | 🟢 Verde | Estrazione conclusa e approvata. CSV/JSON disponibili. |
| revisione | 🟡 Giallo | Confidence sotto la soglia automatica — va revisionato manualmente nella coda di Revisione. Vi finiscono sia i documenti YELLOW che quelli RED. |
| elaborazione | 🔵 Blu | Il sistema sta processando il PDF in questo momento. |
| in attesa | ⚪ Grigio | Accodato — il cruncher non lo ha ancora preso in carico. |
| budget hold | ⚪ Grigio | Budget mensile del tenant esaurito — contatta l'amministratore. |
| split | ⚫ Neutro | PDF originale diviso in più parti. Le "parti" appaiono come documenti separati nella lista. |
| errore | 🔴 Rosso | Elaborazione fallita dopo i retry — apri il dettaglio per il motivo. |
Non esiste più uno stato "quarantena" separato: dopo la riforma di review-unification anche i documenti con confidence rossa entrano nella coda di Revisione, con il motivo (
quarantine_reason) valorizzato per dare priorità alla revisione.
Timeline del documento
Clicca su una riga per espanderla e vedere la timeline degli eventi — caricamento, inizio elaborazione, chiamata al modello AI (con durata), risultato (semaforo, confidence, righe), eventuale presa in carico da parte di un operatore e chiusura.
Scaricare CSV o JSON (un documento)
- Nella tab Attivi o Storico, trova il documento con stato completato
- Clicca il bottone CSV nella colonna Azioni per il download immediato
- Dal Dettaglio sono disponibili anche il formato JSON e l'anteprima dei dati estratti
Il nome del file segue il PDF originale, con suffisso parte_N_di_M per gli split.
Il badge CSV compare solo sui documenti in stato
completato. Per i documenti in revisione o ancora in elaborazione, approva o attendi prima di poter scaricare.
Azioni multiple — selezione + bulk
Sopra la tabella, una action bar appare appena selezioni una o più righe via checkbox. Da lì puoi:
- 📥 Scarica CSV — scarica tutti i CSV dei documenti selezionati in un unico file ZIP. I documenti non ancora in stato
completatovengono saltati silenziosamente (allineato al gating del badge CSV). - 🗑 Elimina selezionati — eliminazione bulk con conferma.
La selezione vale solo per la tab corrente (Attivi o Storico). Per i PDF multi-ordine, lo ZIP contiene il CSV unificato del documento padre (📑 N) oltre ai CSV dei singoli children — se preferisci, basta selezionare il padre.
Disambiguazione nomi nello ZIP: se due documenti nella selezione hanno lo stesso
pdf_filename, il secondo prende un suffisso_<doc_id>per evitare collisioni.
Eliminare o ripristinare
- ✕ elimina il singolo documento in modo definitivo (chiede conferma).
- 🗑 Elimina selezionati elimina in bulk via checkbox (vedi sopra).
- Ripristina (solo Storico) riporta un documento archiviato nella vista Attivi.
Casi frequenti
Il documento è in "elaborazione" o "in attesa" da molti minuti Verifica con l'amministratore la pagina Status → Cruncher. Se il cruncher è STOPPED, il problema è lato infrastruttura.
Il documento è in "revisione" con confidence rossa Vai alla coda di Revisione — il motivo è visibile in dettaglio (es. molti campi obbligatori mancanti o PDF mal leggibile). Se il PDF è realmente illeggibile, contatta il mittente e chiedi un nuovo documento; altrimenti correggi i campi e approva.
Il documento è in "budget hold" Il tenant ha superato la soglia hard del budget mensile. Contatta l'amministratore per aumentare il budget o attendere il nuovo mese.