Sei a ridosso di una scadenza, apri il Desktop Telematico per validare una dichiarazione e ti compare quella scritta secca: contattando i siti software ha incontrato un problema. Niente aggiornamento, niente controlli, niente invio. Se stai leggendo questo articolo con il countdown in testa, salta pure all’elenco delle cause più comuni qualche riga più sotto.

Risposta diretta: l’errore compare quando il Desktop Telematico non riesce a raggiungere in HTTPS il server di aggiornamento dell’Agenzia delle Entrate (jws.agenziaentrate.it). Le cause più frequenti sono tre: un firewall o un antivirus che blocca la connessione, un certificato di sicurezza Java non aggiornato, oppure un disservizio temporaneo lato server. Nella maggior parte dei casi si risolve senza reinstallare tutto.
Perché succede davvero (e non è quasi mai “colpa” del PC)
Il Desktop Telematico non è un programma isolato: ogni volta che lo apri, prova a contattare i server dell’Agenzia per verificare se ci sono aggiornamenti del software o dei moduli di controllo (quelli che validano i singoli modelli, tipo Redditi o 770). Quel controllo passa obbligatoriamente per una connessione HTTPS verso jws.agenziaentrate.it, e lo dice la stessa Agenzia nei suoi avvisi tecnici: l’app si aggiorna “esclusivamente in modalità HTTPS”, quindi qualunque cosa interrompa quella stretta di mano — un proxy aziendale, un firewall troppo zelante, un antivirus con controllo del traffico SSL attivo — fa cadere l’aggiornamento e restituisce quel messaggio generico FONTE: Agenzia delle Entrate – Aree Riservate Telematici.
Un dettaglio che in pratica sfugge quasi a tutti: il messaggio è identico sia che il problema sia sul tuo computer, sia che il problema sia sui server dell’Agenzia. Nei giorni di scadenza (fine giugno, fine novembre, i classici picchi) capita che il servizio stesso sia sovraccarico, e in quei casi nessuna modifica alle impostazioni locali risolve nulla — semplicemente bisogna riprovare più tardi. Prima di smontare configurazioni di rete, vale la pena dare un’occhiata alla pagina degli avvisi ufficiali per capire se c’è un disservizio noto.
Le cause tecniche più frequenti
- Certificati Java obsoleti. Se nel log o nel dettaglio dell’errore compare qualcosa come “peer not authenticated” o un riferimento a
compositeContent.xml, il problema è quasi sempre il filecacertsdella Java Virtual Machine usata dal Desktop Telematico: non riconosce più il certificato del server e blocca la connessione per motivi di sicurezza, non per un guasto vero e proprio. - Antivirus o firewall che intercettano il traffico HTTPS. Alcuni antivirus (soprattutto quelli con “ispezione SSL” o “protezione web” attiva) si inseriscono nella connessione cifrata per scansionarla, e il Desktop Telematico interpreta quell’intromissione come un certificato non valido. Disattivarli temporaneamente durante l’aggiornamento, giusto per il tempo del test, spesso basta a isolare il problema.
- Proxy aziendale non configurato nel programma. Negli studi con connessione centralizzata (uno scenario che si vede spesso nei commercialisti con più postazioni), il browser passa dal proxy ma Java, che gestisce la connessione del Desktop Telematico, a volte no. Va indicato manualmente nelle impostazioni di rete di Java, non in quelle di Windows.
- Versioni Java multiple in conflitto. Se sul PC convivono due o tre installazioni Java (magari una portata da un altro software gestionale), il Desktop Telematico può agganciarsi a quella sbagliata e fallire l’handshake di sicurezza.
- Cartelle di configurazione corrotte. Le sottocartelle nascoste
.entratele.javawsnel profilo utente, se danneggiate da un aggiornamento interrotto o da uno spegnimento improvviso, mandano in loop l’avvio del programma prima ancora che arrivi a contattare i server.
Come risolvere, in ordine di probabilità di successo
Prima di intervenire su Java o sui certificati, che richiede un minimo di manualità, conviene escludere le cause più semplici. Nella pratica, seguendo questo ordine si risolve la maggior parte dei casi entro i primi tre punti.
- Controlla che non sia un disservizio lato Agenzia. Vai sulla pagina avvisi del portale Fisconline/Entratel prima di toccare qualsiasi impostazione: se il problema è dei server, ogni modifica locale è tempo perso.
- Avvia il programma come amministratore. Tasto destro sull’icona, “Esegui come amministratore”. Sembra banale ma risolve una fetta consistente di errori legati ai permessi di scrittura sulle cartelle di sistema.
- Disattiva temporaneamente antivirus e firewall, riprova ad aprire il programma e a far partire l’aggiornamento. Se funziona, il colpevole è quello: puoi poi creare un’eccezione mirata invece di lasciare tutto disattivato.
- Verifica quale versione di Java è installata e confrontala con quella indicata nella pagina ufficiale dei requisiti — l’Agenzia aggiorna periodicamente le versioni supportate, quindi qui conviene controllare la fonte piuttosto che affidarsi a un numero di versione letto altrove, che potrebbe essere già superato.
- Sostituisci il file dei certificati (cacerts). Se il resto non ha funzionato e il messaggio d’errore parla esplicitamente di autenticazione del server, si può copiare il file
cacertsaggiornato da una installazione JDK recente nella cartellasecurityusata dal Desktop Telematico, sovrascrivendo quello esistente. È un intervento tecnico un po’ più delicato: se non te la senti di mettere mano ai file di sistema, fallo fare a chi gestisce l’informatica dello studio, o rivolgiti all’assistenza. - Come ultima risorsa, reinstallazione pulita. Disinstalla Desktop Telematico e tutte le versioni Java presenti, riavvia il computer, installa la versione Java corretta (attenzione a 32 o 64 bit, deve corrispondere al sistema operativo) e reinstalla il programma con i permessi da amministratore.
Un errore che si vede spesso in questa fase: la gente reinstalla il Desktop Telematico più volte di fila sperando che “prima o poi funzioni”, senza toccare Java. Ma se il problema è nei certificati o nelle versioni Java in conflitto, la reinstallazione del solo Desktop Telematico non cambia nulla, perché il pacchetto Java resta quello di prima.
Quando il problema non è (solo) tecnico
Qui le cose si fanno più sfumate. Alcuni utenti segnalano, come effetto collaterale della configurazione delle eccezioni Java per sbloccare l’aggiornamento, l’esigenza di autorizzare temporaneamente connessioni non cifrate verso indirizzi specifici del dominio dell’Agenzia. È una pratica diffusa nei forum specializzati, ma va presa con cautela: non è una modifica da fare alla leggera su un PC che gestisce anche altri dati sensibili, e onestamente le fonti in materia non sono tutte concordi su quanto sia necessaria in ogni singolo caso — dipende dalla versione del programma e dalla configurazione di rete. Se il tuo studio gestisce anche l’invio telematico per conto di clienti, meglio far valutare la cosa a chi si occupa della sicurezza informatica, invece di applicare la prima soluzione trovata online.
Domande frequenti
Il messaggio “si è verificato un problema contattando i siti software” significa che ho perso i dati inseriti? No. È un errore di connessione tra il programma e i server di aggiornamento, non riguarda le dichiarazioni già compilate e salvate in locale. I file restano dove li avevi salvati.
Devo disinstallare per forza tutto Java per risolvere? Quasi mai al primo tentativo. Conviene prima controllare permessi, antivirus e versione Java installata; la disinstallazione completa è l’ultima opzione, da riservare ai casi in cui nient’altro ha funzionato.
L’errore dipende dal mio computer o può essere un problema dell’Agenzia delle Entrate? Entrambi gli scenari sono possibili e il messaggio è identico. Nei giorni di scadenza, controlla sempre prima la pagina avvisi ufficiale: se il servizio è sovraccarico, nessuna modifica locale risolve.
Funziona anche su Mac o solo su Windows? Il Desktop Telematico ha versioni per Windows, macOS e Linux, e le cause di connessione (proxy, certificati, firewall) valgono in linea di principio su tutti i sistemi, anche se i percorsi dei file e le procedure di intervento su Java cambiano da un sistema operativo all’altro.
A chi mi rivolgo se nessuna di queste soluzioni funziona? All’assistenza ufficiale dell’Agenzia delle Entrate per i servizi online, che gestisce nello specifico i problemi del Desktop Telematico, oppure a un tecnico se il caso riguarda la configurazione di rete dello studio.
Se il messaggio continua a ripresentarsi dopo aver provato tutto questo, spesso conviene fermarsi un attimo e chiedersi se non sia più semplice, temporaneamente, usare la procedura web alternativa per l’invio (dove disponibile per il modello che devi presentare) invece di insistere a far ripartire un programma che in quel momento non ne vuole sapere.
Fonti principali usate:
- Agenzia delle Entrate – Avviso aggiornamento Desktop Telematico
- Assistenza Agenzia Entrate – Gestire il Desktop Telematico
- Fabio Bernini – Contattando i siti software ha incontrato un problema
- Codice Azienda – Desktop Telematico non si aggiorna
- VRMMP – Problemi con il Desktop Telematico
Giornalista e analista, scrive di economia italiana, innovazione e imprese. Appassionato di tecnologia e finanza, racconta il presente e il futuro delle aziende che fanno muovere il Paese.




