Caricamento Multiplo (Bulk Upload)
Carica e processa più fatture PDF contemporaneamente con elaborazione automatica in background.
Cos'è il Bulk Upload?
Il Bulk Upload (caricamento multiplo) è una funzionalità che ti permette di caricare e processare più fatture PDF contemporaneamente, invece di caricarle una alla volta.
Risparmio di tempo
Carica fino a 20 fatture in una sola operazione
Elaborazione automatica
Le fatture vengono processate in background, anche se chiudi la pagina
Monitoraggio in tempo reale
Vedi lo stato di ogni fattura direttamente nella tabella principale
Retry automatico
In caso di errori temporanei, il sistema riprova automaticamente fino a 3 volte
Come Funziona
Flusso di Elaborazione
- 1Caricamento: Selezioni più file PDF e li carichi tutti insieme
- 2Verifica crediti: Il sistema verifica che tu abbia crediti sufficienti per tutte le fatture
- 3Upload: I file vengono caricati su Supabase Storage
- 4Coda di elaborazione: Ogni fattura viene inserita in una coda con stato "In Attesa"
- 5Elaborazione automatica: Un worker in background processa le fatture ogni minuto
- 6Estrazione dati: Per ogni fattura, l'AI estrae automaticamente i dati (fornitore, importo, IVA, ecc.)
- 7Completamento: Le fatture vengono aggiornate con lo stato finale ("Completata", "Duplicata", o "Errore")
Stati delle Fatture
Durante l'elaborazione, ogni fattura passa attraverso questi stati:
| Stato | Badge | Descrizione |
|---|---|---|
| In Attesa | 🟡 Giallo | La fattura è in coda e aspetta di essere processata |
| In Elaborazione | 🔵 Blu | La fattura è attualmente in fase di elaborazione |
| Completata | 🟢 Verde | La fattura è stata processata con successo |
| Duplicata | 🟠 Arancione | La fattura è già presente nel sistema |
| Errore | 🔴 Rosso | Si è verificato un errore durante l'elaborazione |
Come Usare il Bulk Upload
Per Fatture in Cloud (FC)
- 1Vai alla pagina "Nuova Autofattura" (
/autofatture/fc/nuova) - 2Seleziona la modalità "Multiplo" (toggle in alto)
- 3Trascina i file PDF nell'area di upload oppure clicca per selezionarli
- 4Puoi selezionare fino a 20 file contemporaneamente
- 5Rimuovi eventuali file selezionati per errore cliccando sulla ❌
- 6Clicca su "Carica e Elabora"
- 7Verrai reindirizzato alla pagina principale dove vedrai lo stato di ogni fattura
Per XML/SDI
- 1Vai alla pagina "Nuova Autofattura XML" (
/autofatture/xml/nuova) - 2Seleziona la modalità "Multiplo" (toggle in alto)
- 3Segui gli stessi passaggi descritti sopra per FC
- 4Le fatture verranno processate e generate come file XML per l'invio all'SDI
Requisiti e Limiti
Limiti Tecnici
- Massimo 20 file per ogni operazione di bulk upload
- Dimensione massima file: 10 MB per PDF
- Formato supportato: Solo file PDF
- Massimo 25 fatture processate e non inviate contemporaneamente
Requisiti
- Devi avere crediti sufficienti per tutte le fatture
- Devi avere un'azienda attiva configurata
- Per FC: devi avere la connessione a Fatture in Cloud attiva
- Per XML: devi avere l'azienda configurata per SDI
Monitoraggio e Aggiornamenti
Contatore in Coda
Nella pagina principale delle autofatture (FC o XML), vedrai un contatore in alto che mostra:
Questo contatore appare solo quando ci sono fatture con stato "In Attesa" o "In Elaborazione" e scompare automaticamente quando tutte le fatture sono state processate.
Aggiornamento Automatico
- La tabella si aggiorna automaticamente ogni 5 secondi finché ci sono fatture in coda
- Non è necessario ricaricare manualmente la pagina
- Quando tutte le fatture sono processate, l'aggiornamento automatico si ferma
Gestione Errori
Retry Automatico
Se una fattura fallisce durante l'elaborazione:
- Il sistema riprova automaticamente fino a 3 volte
- Tra un tentativo e l'altro, c'è un breve intervallo
- Se dopo 3 tentativi la fattura fallisce ancora, lo stato diventa "Errore"
Errori Comuni
Non hai abbastanza crediti → Acquista crediti dalla pagina Account
Hai selezionato più di 20 file → Riduci il numero di file o fai più upload separati
Un PDF supera i 10 MB → Comprimi il PDF o dividilo
Non hai selezionato un'azienda → Vai nelle impostazioni e seleziona un'azienda
Hai già 25 fatture processate e non inviate → Invia o elimina alcune fatture esistenti
Domande Frequenti (FAQ)
Quanto tempo ci vuole per processare le fatture?
Il tempo dipende dal numero di fatture e dalla complessità dei PDF. Il worker processa fino a 5 fatture per minuto. In media, ogni fattura richiede 30-60 secondi per essere processata.
Posso chiudere la pagina mentre le fatture vengono processate?
Sì! L'elaborazione avviene in background. Puoi chiudere la pagina, il browser o spegnere il computer (dopo che l'upload è completato). Le fatture continueranno a essere processate e quando torni sulla pagina vedrai gli aggiornamenti.
Cosa succede se una fattura è duplicata?
Se il sistema rileva che una fattura è già presente (stesso numero documento, stesso fornitore, stessa data), lo stato diventa "Duplicata". Il credito viene comunque dedotto (l'elaborazione è stata eseguita), ma non viene creata una nuova fattura in Fatture in Cloud o un nuovo XML.
Posso modificare una fattura mentre è in elaborazione?
No, devi aspettare che l'elaborazione sia completata. Solo le fatture con stato "Completata" o "Duplicata" possono essere modificate o inviate.
Differenze tra Upload Singolo e Bulk Upload
| Caratteristica | Upload Singolo | Bulk Upload |
|---|---|---|
| Numero file | 1 alla volta | Fino a 20 contemporaneamente |
| Elaborazione | Sincrona (attendi il risultato) | Asincrona (in background) |
| Timeout | Possibile se il PDF è complesso | Nessun timeout (elaborazione in background) |
| Quando usarlo | Per test o singole fatture urgenti | Per processare molte fatture insieme |
| Feedback | Risultato immediato | Aggiornamento in tempo reale nella tabella |