Entratel e Desktop Telematico: differenza e problemi comuni

Entratel e Desktop Telematico non sono la stessa cosa: il Desktop Telematico è il contenitore software (un framework) che serve ad accogliere, installare e aggiornare le varie applicazioni dell’Agenzia delle Entrate, tra cui l’applicazione Entratel (dedicata a intermediari, PA e contribuenti specifici) e l’applicazione FileInternet (dedicata ai privati).

I problemi comuni sono legati principalmente ai continui aggiornamenti di Java, a blocchi nell’installazione dei moduli di controllo o a errori di configurazione delle cartelle di lavoro.

In sintesi

  • Entratel è l’applicazione interna per la trasmissione e il controllo dei documenti fiscali.
  • Desktop Telematico è l’infrastruttura software che devi installare sul PC per far girare Entratel o FileInternet.
  • Requisiti chiave: Accesso all’Area Riservata dell’Agenzia delle Entrate (tramite SPID, CIE o CNS), Java Runtime Environment (JRE) aggiornato e credenziali dell’ambiente di sicurezza.
  • Problema principale: Errori di avvio o di convalida dei file causati da versioni di Java non compatibili o percorsi delle cartelle errati.

Cosa sapere prima di iniziare

Prima di configurare il Desktop Telematico ed Entratel, è fondamentale comprendere la distinzione dei ruoli e avere a disposizione i requisiti tecnici corretti per evitare che il software si blocchi all’avvio.

La differenza fondamentale

  • Desktop Telematico: È l’applicazione “madre” che scarichi sul tuo computer. Sostituisce i vecchi applicativi stand-alone dell’Agenzia delle Entrate e funge da cruscotto unico.
  • Entratel: È un plug-in (un modulo aggiuntivo) che si installa dentro il Desktop Telematico. Serve per autenticare, verificare e inviare i file dei dichiarativi fiscali.

Requisiti necessari

  • Accesso al portale: Credenziali SPID (Livello 2), CIE (Carta d’Identità Elettronica) o CNS per accedere all’area riservata “Fisconline/Entratel” sul sito dell’Agenzia delle Entrate.
  • Software di base: Java Runtime Environment (spesso fornito direttamente nella suite di installazione dell’Agenzia, ma che richiede attenzione in fase di aggiornamento del sistema operativo).
  • Ambiente di sicurezza: I file delle chiavi pubbliche/private (sella.key) per la firma dei documenti telematici.

Come installare e configurare il Desktop Telematico passo dopo passo

Di seguito la procedura corretta per installare l’infrastruttura e configurare Entratel senza generare conflitti nel sistema.

  1. Accedi all’Area Riservata: Vai sul sito dell’Agenzia delle Entrate e autenticati con SPID o CIE.
  2. Scarica il Desktop Telematico: Naviga nella sezione Servizi Correlati > Software e seleziona il download della versione adatta al tuo sistema operativo (Windows, Mac o Linux).
  3. Esegui l’installazione: Avvia l’installer. Durante la procedura, ti verrà chiesto di definire una cartella di lavoro (Workspace). Scegli un percorso semplice (es. C:\DesktopTelematico) e non spostarla in seguito.
  4. Crea l’utente: Al primo avvio del Desktop Telematico, crea un profilo utente amministratore e imposta una password locale (ti servirà ogni volta che aprirai il programma).
  5. Installa l’applicazione Entratel: Dentro il Desktop Telematico, vai nel menu superiore su Aiuto > Installa nuovo software. Seleziona il sito di aggiornamento dell’Agenzia delle Entrate e spunta la casella relativa a Entratel (e ai relativi moduli di controllo che ti interessano). Procedi e riavvia l’applicazione.
  6. Configura l’Ambiente di Sicurezza: Vai su Entratel > Impostazioni > Configura Ambiente. Inserisci il percorso in cui hai salvato le tue chiavi di cifratura (sella.key) per poter firmare e inviare i file.

Cause dei problemi comuni ed errori da evitare

La maggior parte degli errori bloccanti non dipende da un guasto del sito dell’Agenzia, ma da conflitti locali sul PC dell’utente.

  • Errore “Java Virtual Machine Launcher”: Succede quando il Desktop Telematico non trova il percorso corretto di Java o quando è presente una versione di Java a 64-bit su un applicativo che richiede la versione a 32-bit (o viceversa).
  • Moduli di controllo non aggiornati: Se provi a controllare una dichiarazione (es. 730, Certificazione Unica o IVA) e il software restituisce un errore di validazione, spesso significa che non hai scaricato l’ultimo modulo di controllo aggiornato da Aiuto > Installa nuovo software.
  • Cartella Workspace non trovata: Se sposti, elimini o rinomini la cartella di lavoro iniziale, il Desktop Telematico smetterà di funzionare e mostrerà una schermata vuota all’avvio.

Cosa fare se non funziona

Se il Desktop Telematico si blocca, non si apre o non ti permette di inviare i documenti, segui questa checklist di risoluzione rapida:

1. Forzare l’aggiornamento dei moduli

Se l’errore riguarda la compilazione o il controllo dei file, vai su Aiuto > Verifica aggiornamenti all’interno del Desktop Telematico. L’Agenzia delle Entrate rilascia costantemente patch in concomitanza con le scadenze fiscali.

2. Ripristinare il percorso di Java

Se il programma non si avvia affatto:

  • Fai clic con il tasto destro sull’icona del Desktop Telematico e seleziona Proprietà.
  • Verifica nel campo “Destinazione” che il puntamento alla cartella jre sia corretto.
  • In alternativa, reinstalla il software lasciando che l’installer configuri la versione di Java integrata.

3. Sbloccare i permessi di amministratore (Windows/Mac)

Talvolta i sistemi operativi bloccano la scrittura dei file ricevuti dall’Agenzia. Fai clic destro sull’icona del programma e seleziona “Esegui come amministratore” (su Windows) o verifica i permessi di sicurezza in Privacy e Sicurezza (su macOS).

Alternative e contatti utili

Se il problema persiste e non riesci a risolverlo autonomamente, puoi sfruttare i canali di assistenza ufficiali:

  • Assistenza Tecnica Telematica: Accessibile all’interno dell’area riservata del sito dell’Agenzia delle Entrate tramite il servizio “Assistenza Tecnica” (webticket).
  • Numero Verde: È possibile contattare l’assistenza telefonica al numero 800.90.96.96 (da telefono fisso) o allo 06.96668907 (da cellulare), selezionando l’opzione relativa ai servizi telematici.
  • L’alternativa web: Ricorda che per molte comunicazioni e per i contratti di locazione (RLI), l’Agenzia delle Entrate mette a disposizione le versioni web (applicativi web) direttamente nel portale, che non richiedono l’installazione del Desktop Telematico.

FAQ – Domande Frequenti

Posso usare il Desktop Telematico su Mac?

Sì, esiste una versione ufficiale per macOS. Tuttavia, sui chip Apple Silicon (M1, M2, M3, ecc.) potrebbe essere necessario installare l’emulatore Rosetta 2 o configurare manualmente i permessi di sicurezza per consentire l’esecuzione di app di sviluppatori non identificati.

Dove si trova il file delle chiavi (sella.key)?

Il file viene generato durante la fase di abilitazione ai servizi telematici e la creazione dell’ambiente di sicurezza. Di norma viene salvato in una cartella scelta dall’utente (es. su una chiavetta USB o in una directory dedicata sul PC). Se viene smarrito, è necessario revocare l’ambiente di sicurezza e rigenerarlo dal sito dell’Agenzia.

Devo pagare per scaricare Entratel o il Desktop Telematico?

No, tutti i software messi a disposizione dall’Agenzia delle Entrate sono completamente gratuiti.