Desktop Telematico: “Contattando i siti software ha incontrato un problema” – Cause e Soluzioni

byDomenico De Rosa

Quando Desktop Telematico si avvia o tenta di aggiornare i moduli di controllo, l’interfaccia può arrestarsi mostrando l’avviso: “Contattando i siti software ha incontrato un problema”.

L’errore indica che Desktop Telematico (basato sul framework open source Eclipse RCP) non riesce a raggiungere i repository remoti dell’Agenzia delle Entrate per scaricare i pacchetti di aggiornamento o la lista delle applicazioni. Il blocco deriva quasi sempre da certificati di sicurezza obsoleti nella Java Virtual Machine, interferenze di antivirus/firewall, proxy aziendali non configurati o disservizi temporanei dei server Sogei.

Perché Desktop Telematico non raggiunge i siti software

L’infrastruttura dell’Agenzia delle Entrate distribuisce moduli (come Entratel, FileInternet e i vari software di controllo dichiarativi) tramite URL specifici integrati nell’ambiente di lavoro. Se il canale di connessione HTTP/HTTPS viene interrotto, la procedura di sincronizzazione fallisce all’istante.

Nella pratica il problema nasce spesso quando sulla macchina convivono più versioni dell’ambiente Java. Se Desktop Telematico punta a una JVM datata installata a livello di sistema operativo anziché a quella a 64 bit aggiornata inclusa nella cartella di installazione (jre), il software fallisce la negoziazione del protocollo di cifratura TLS 1.2 o 1.3 con i server ministeriali, scatenando il blocco.

Un secondo scenario frequente riguarda le reti di studio o aziendali protette da UTM, proxy o antivirus con ispezione SSL/TLS attiva. Il certificato “intermedio” generato dal firewall per scansionare il traffico HTTPS non è riconosciuto dal keystore (cacerts) di Java, che interrompe il download per motivi di sicurezza.

Verifica preliminare: manutenzione dei server Sogei

Prima di modificare le impostazioni del computer, escludi l’ipotesi più banale: l’indisponibilità temporanea dei server dell’Agenzia delle Entrate.

Accade tipicamente a ridosso delle grandi scadenze fiscali (F24 periodici, invio del Modello 730 o Redditi) o durante le finestre di manutenzione notturna e del fine settimana. In questi frangenti, il tentativo di connessione restituisce codici HTTP 500, 502 o 503. Se la pagina principale dell’area riservata del portale dell’Agenzia delle Entrate segnala rallentamenti o avvisi tecnici, conviene attendere qualche ora prima di reimpostare parametri locali.

Passaggi operativi per ripristinare il collegamento

Se i servizi telematici risultano attivi per gli altri utenti, la correzione richiede alcuni interventi mirati all’interno della configurazione dell’applicativo.

  1. Esegui come amministratore: su ambiente Windows, fai clic destro sull’icona di Desktop Telematico e seleziona Esegui come amministratore. Permessi di scrittura insufficienti nella cartella C:\DesktopTelematico impediscono al gestore aggiornamenti di salvare i metadati dei componenti.
  2. Configura la rete interna all’applicazione:
    • Apri Desktop Telematico ed entra con il tuo profilo utente.
    • Raggiungi il menu superiore: File > Impostazioni.
    • Seleziona la scheda Generale > Connessioni di rete (Network Connections).
    • Imposta il Provider attivo su Manuale o Diretto (evita l’opzione “Nativo” se utilizzi Windows 11 con proxy automatico disattivato).
    • Se lo studio fa uso di un server proxy per navigare, inserisci host e porta corretti sia per HTTP sia per HTTPS, compilando le credenziali se richieste.
  3. Controllo dei siti di aggiornamento configurati:
    • Sempre nelle Impostazioni, naviga in Installa/Aggiorna > Siti software disponibili.
    • Verifica che gli URL con dominio agenziaentrate.gov.it siano spuntati e attivi.
    • Se un URL risulta corrotto, selezionalo e clicca su Ricarica (Reload).
  4. Esclusione antivirus e firewall:
    • Aggiungi la cartella radice di installazione di Desktop Telematico e l’eseguibile javaw.exe (presente nella sottocartella jre/bin) alle eccezioni di scansione in tempo reale dell’antivirus.

Quando il ripristino richiede la reinstallazione pulita

Se le modifiche alla rete non sbloccano l’errore, i file di indice locali della piattaforma Eclipse potrebbero essere corrotti da un aggiornamento precedente interrotto a metà.

Per risolvere senza perdere gli archivi delle ricevute e dei documenti inviati:

  • Effettua una copia di backup preventiva della cartella dell’area di lavoro (tipicamente denominata workspace o situata nel percorso scelto in fase di prima configurazione).
  • Disinstalla Desktop Telematico tramite il pannello di controllo.
  • Scarica l’installer aggiornato direttamente dalla sezione software del portale dell’Agenzia delle Entrate.
  • Installa l’applicativo preferibilmente in un percorso breve e privo di caratteri speciali o spazi (ad esempio C:\DesktopTelematico).

Domande frequenti

Devo aggiornare autonomamente Java sul computer?

Non sempre. Le versioni correnti del pacchetto di installazione fornite dall’Agenzia delle Entrate integrano già al loro interno una versione Java dedicata. Aggiornare la JVM di sistema spesso non incide su Desktop Telematico, a meno che il file di configurazione (DesktopTelematico.ini) non sia stato forzato a puntare all’ambiente globale.

Perché l’errore compare solo con i moduli di controllo e non all’avvio?

I moduli di controllo risiedono su cataloghi software dedicati che vengono interrogati solo su richiesta. Se il dominio specifico di quel modulo è irraggiungibile o se la firma digitale del certificato del componente è scaduta sui server ministeriali, l’errore compare unicamente durante il download di quel pacchetto.

Posso scaricare i moduli di controllo manualmente senza Desktop Telematico?

No per l’ambiente integrato. I file .jar dei controlli devono essere installati tramite la funzione interna Installa nuovo software. In alternativa, per singoli adempimenti, alcuni controlli sono ancora disponibili come pacchetti autonomi sul sito dell’Agenzia delle Entrate, ma operano fuori dal cruscotto unificato.

Cosa fare se il problema si presenta su macOS?

Su Mac l’errore è spesso legato alle autorizzazioni di sicurezza di Gatekeeper e all’accesso completo al disco. È necessario assegnare all’applicazione Desktop Telematico i permessi completi di lettura e scrittura in Impostazioni di Sistema > Privacy e Sicurezza, verificando che l’ambiente supporti l’architettura del processore in uso.

I file di log memorizzati nella sottocartella .metadata/.log del workspace contengono il codice di errore dettagliato (ad esempio ConnectException o SSLHandshakeException), utile per consentire all’assistenza tecnica o al sistemista di rete di individuare la porta bloccata in pochi istanti.

Fonti ufficiali e documentazione tecnica:

Possono interessarti