Desktop Telematico: aggiornamento bloccato, cosa fare davvero

byDomenico De Rosa

Sono le nove di sera, la scadenza è domani mattina e il Desktop Telematico si pianta su “verifica aggiornamento software” da venti minuti. Se sei arrivato qui è probabile che la situazione sia più o meno questa, quindi andiamo dritti al punto prima delle spiegazioni.

Risposta diretta: nella maggior parte dei casi il blocco in aggiornamento del Desktop Telematico dipende da un conflitto con la versione di Java installata, da un file di certificati (cacerts) danneggiato o da un blocco di firewall/antivirus verso i server dell’Agenzia. La soluzione più rapida è forzare l’aggiornamento da Help > Verifica aggiornamenti; se non basta, va reinstallata l’applicazione dal sito ufficiale.

Prima di buttarsi sulla reinstallazione, però, vale la pena capire cosa sta succedendo davvero, perché il rischio è di disinstallare tutto e ritrovarsi allo stesso punto dieci minuti dopo.

Perché il Desktop Telematico si blocca in fase di aggiornamento

Il Desktop Telematico non è un semplice programma: è un contenitore che scarica e gestisce a sua volta altri moduli (Entratel, i vari software di compilazione, i controlli fiscali), ognuno con la propria logica di versionamento. Quando l’aggiornamento si inceppa, quasi sempre la causa sta in una di queste zone, e capire quale aiuta a non perdere tempo su tentativi a caso.

Il caso più frequente resta l’incompatibilità con Java. Fino a poco tempo fa il programma dipendeva da una Java Virtual Machine installata separatamente sul computer, e bastava avere due versioni di Java in conflitto — magari una vecchia lasciata da un altro software gestionale — per mandare in crash la verifica degli aggiornamenti. Da novembre 2025 l’Agenzia ha rilasciato la versione 1.3.0 del Desktop Telematico, distribuita in formato ZIP e con la JRE 8 integrata al suo interno proprio per chiudere questo problema alla radice: chi installa da zero questa versione non dovrebbe più doversi preoccupare di Java esterno. Il problema è che moltissimi utenti stanno ancora usando installazioni più vecchie, oppure hanno reinstallato “sopra” senza ripulire, e lì i conflitti tornano puntuali.

Poi c’è il capitolo certificati, meno conosciuto ma tutt’altro che raro: il file cacerts dentro la cartella di installazione (nel percorso tipo DesktopTelematico\jre\lib\security) può corrompersi o restare a una dimensione anomala, e in quel caso il programma non riesce a validare la connessione sicura con il server dell’Agenzia durante il download degli aggiornamenti. Da fuori sembra un problema di rete, e infatti molti perdono tempo a controllare il Wi-Fi, quando in realtà è il certificato locale che non torna.

Firewall, antivirus e proxy aziendali sono la terza causa ricorrente, soprattutto negli studi con una rete gestita centralmente: se l’eseguibile DesktopTelematico.exe non è autorizzato a uscire verso i server dell’Agenzia, l’aggiornamento resta a metà o va in timeout senza un messaggio d’errore chiaro. Un dettaglio che molti sottovalutano è che basta un aggiornamento dell’antivirus stesso, anche non collegato al Desktop Telematico, a resettare le eccezioni configurate mesi prima.

L’errore “A Java Exception has occurred”: cosa significa

Questo messaggio compare quando l’avvio o l’aggiornamento del programma chiama una libreria Java che manca o è incompatibile — tipicamente le componenti JavaFX, non sempre incluse nelle build più recenti di Java 8 disponibili sul sito Oracle. Sulle installazioni pre-1.3.0 la sequenza che funziona quasi sempre è questa:

  1. Disinstallare tutte le versioni di Java presenti dal Pannello di controllo (usare uno strumento come JavaRa aiuta a togliere anche i residui che l’uninstaller standard lascia indietro).
  2. Installare una build compatibile: molti utenti riportano di aver risolto tornando a una build specifica come jre-8u441, oppure passando a una distribuzione JDK 11 (per esempio Eclipse Temurin).
  3. Reinstallare il Desktop Telematico con il tasto destro sull’eseguibile, scegliendo “Esegui come amministratore”.
  4. Su Windows 11, se il problema persiste, provare la modalità di compatibilità Windows 8 dalle proprietà del file di installazione.

Su questo punto le fonti non sono del tutto concordi: alcuni forum indicano una build Java precisa come risolutiva, altri ottengono lo stesso risultato con versioni leggermente diverse. Nella pratica capita spesso che la build “giusta” cambi da un aggiornamento Java all’altro, quindi conviene partire dalla versione consigliata nella pagina ufficiale dell’Agenzia del momento in cui si legge, non da un numero fisso trovato su un forum di due anni fa.

Se il problema è il file cacerts

Qui il sintomo è ingannevole: l’aggiornamento parte, sembra scaricare qualcosa, poi si ferma o restituisce un errore di connessione generico. Chi lavora spesso con questo software, prima di sospettare la rete, controlla proprio quel file: se ha una dimensione palesemente diversa dal normale (né troppo piccola né anomale rispetto a un’installazione pulita), è quasi sempre corrotto. La soluzione riportata da chi ci è passato è sostituirlo con una copia integra presa da un’installazione funzionante, oppure reinstallare l’applicazione da zero così da rigenerarlo. Non è un passaggio documentato ufficialmente, ma è uno di quei casi in cui l’esperienza sul campo arriva prima della documentazione.

Come reinstallare il Desktop Telematico senza perdere le pratiche

Quando i tentativi di aggiornamento “in place” non bastano più, la reinstallazione pulita resta la strada più affidabile. Un passaggio che quasi nessuno fa, e che invece evita un bel po’ di ansia, è salvare prima le ricevute e i file già predisposti: di norma si trovano in sottocartelle dedicate dentro la directory di installazione, separate dal programma vero e proprio, ma è meglio fare una copia manuale prima di disinstallare, non fidarsi soltanto di questo.

Fatto questo, la sequenza è: disinstallare la versione attuale dal Pannello di controllo di Windows, scaricare l’ultima versione dal sito ufficiale dell’Agenzia delle Entrate (oggi distribuita come archivio ZIP, non più come installer .exe autonomo), estrarre l’archivio in una cartella e avviare DesktopTelematico.exe con privilegi di amministratore. Al primo avvio il programma richiederà comunque di scaricare i singoli moduli (Entratel, i software di controllo delle dichiarazioni) tramite Aiuto > Installa nuovo software: questo passaggio va rifatto per intero, ed è normale che richieda qualche minuto in più rispetto a un aggiornamento ordinario.

Cosa fare se l’errore compare a ridosso di una scadenza

Se non c’è tempo per diagnosticare la causa esatta, l’ordine di priorità pratico è: primo, provare l’aggiornamento forzato da menu; secondo, verificare firewall e antivirus (spesso il fix più veloce); terzo, se non funziona nulla, passare direttamente alla reinstallazione pulita invece di perdere ore su singoli tentativi di riparazione Java. In diversi studi professionali capita di tenere un secondo PC, anche datato, con un’installazione funzionante del Desktop Telematico proprio per questi momenti — non è elegante, ma nella pratica evita più di un blocco nelle ore critiche prima di una scadenza. Quando l’invio è davvero urgente e nulla si sblocca in tempo, resta comunque possibile rivolgersi all’assistenza ufficiale dell’Agenzia o, per chi opera come intermediario, verificare se il proprio software gestionale offre un canale di invio alternativo che non passa dal Desktop Telematico.

Domande frequenti

Il Desktop Telematico è bloccato su “verifica aggiornamento”, quanto devo aspettare prima di considerarlo un errore? Se dopo tre o quattro minuti la barra non si muove o resta ferma sulla stessa percentuale, non è più un problema di lentezza della connessione: conviene chiudere il programma da Gestione attività e riprovare l’aggiornamento manuale da menu.

Serve ancora installare Java a parte se ho la versione 1.3.0 del Desktop Telematico? No: dalla versione 1.3.0 (novembre 2025) la JRE 8 è integrata nell’applicazione. Se però hai installazioni Java esterne residue da versioni precedenti, meglio rimuoverle per evitare conflitti.

L’aggiornamento fallito può farmi perdere le pratiche già compilate? Di norma no, perché i file delle pratiche restano in cartelle separate dal codice dell’applicazione. Detto questo, prima di disinstallare è sempre meglio farne una copia manuale: è un minuto speso bene contro ore di recupero.

Perché sul mio PC l’errore Java compare solo ora, se prima funzionava tutto? Quasi sempre perché un aggiornamento automatico di Windows o di Java ha sostituito la build che stava funzionando con una più recente ma incompatibile con il Desktop Telematico. Non è un problema del tuo PC in sé, è un disallineamento tra due software che si aggiornano in tempi diversi.

Conviene disinstallare completamente Java prima di reinstallare il Desktop Telematico? Se hai più versioni installate e sospetti un conflitto, sì: una disinstallazione pulita di tutte le versioni, seguita dall’installazione della sola build consigliata, risolve la maggior parte dei casi meglio di un’installazione “sopra” quella esistente.

Se l’errore si ripresenta identico dopo ogni tentativo, vale la pena controllare anche i log dell’applicazione prima di continuare a reinstallare alla cieca: spesso raccontano esattamente quale modulo o quale libreria sta fallendo, ed evitano di procedere per tentativi.

Le procedure di installazione e i requisiti tecnici cambiano nel tempo insieme alle versioni rilasciate dall’Agenzia delle Entrate: per i passaggi ufficiali aggiornati conviene sempre fare riferimento alla pagina di Assistenza ai Servizi Online o al portale di download del Desktop Telematico, oppure contattare l’assistenza tecnica per i casi non standard.

Fonti consultate:

Possono interessarti