Desktop Telematico: scegliere la versione a 32 o 64 bit senza errori

Installare l’applicazione dell’Agenzia delle Entrate sembra un passaggio banale, finché la procedura guidata si blocca o il software rifiuta di avviarsi dopo il login. Il dubbio tra pacchetto a 32 bit e pacchetto a 64 bit è il primo ostacolo tecnico in cui si imbattono intermediari, commercialisti e aziende al momento del setup su una nuova postazione.

Risposta rapida:

La scelta tra Desktop Telematico a 32 o 64 bit dipende dall’architettura del sistema operativo e, soprattutto, dalla versione di Java Virtual Machine (JVM) installata sul computer. Sui moderni sistemi Windows a 64 bit conviene installare la versione a 64 bit, a condizione che anche l’ambiente Java predefinito sia a 64 bit. Se Java è a 32 bit, Desktop Telematico a 64 bit non si avvierà.

Architettura a 32 o 64 bit: dove nasce il vincolo tecnico

Desktop Telematico è basato sul framework Eclipse (Rich Client Platform) ed è interamente dipendente dalla Java Virtual Machine. A differenza di software nativi compilati per girare direttamente sul kernel del sistema operativo, il programma delle Entrate eredita i requisiti dall’interprete Java sottostante.

Un computer con sistema operativo Windows a 64 bit può eseguire sia software a 64 bit sia software a 32 bit (grazie al sottosistema WoW64). Tuttavia, all’interno del singolo processo, l’accoppiamento tra Desktop Telematico e Java deve essere identico:

• Un eseguibile a 64 bit richiede tassativamente una JVM a 64 bit.
• Un eseguibile a 32 bit richiede tassativamente una JVM a 32 bit.

Se il sistema operativo è a 32 bit (scenario ormai residuale, limitato a vecchie macchine con Windows 7 o 10 a 32 bit), l’unica opzione possibile è il pacchetto a 32 bit. Su macchine con Windows 10 o Windows 11 a 64 bit, l’opzione naturale è la versione a 64 bit, che consente una gestione della memoria RAM superiore ai 2–3 GB tipici del limite architetturale a 32 bit, utile quando si gestiscono file telematici voluminosi o invii multipli.

L’errore classico: “Java was started but returned exit code=13”

Nella pratica, il problema più frequente non è scaricare il file errato dal portale, ma l’incompatibilità silente tra il pacchetto scaricato e l’installazione Java già presente nel sistema.

Quando si tenta di avviare Desktop Telematico a 64 bit su una macchina che ha impostato nel percorso di sistema (PATH) una Java Runtime Environment a 32 bit, il software restituisce un messaggio di errore noto:

Plaintext

Java was started but returned exit code=13

Questo codice indica proprio un disallineamento di bitness: l’eseguibile ha cercato di caricare la libreria jvm.dll con un’architettura differente da quella attesa. Capita spesso negli studi dove convivono software gestionali legacy (che obbligavano a mantenere Java 8 a 32 bit) e nuove applicazioni telematiche.

Come verificare l’architettura di Windows e Java prima del download

Prima di accedere all’area riservata dei servizi telematici dell’Agenzia delle Entrate per scaricare l’installer, servono due verifiche rapide.

1. Controllo del sistema operativo

Su Windows 10 e Windows 11:

1. Premere la combinazione di tasti Win + I per aprire le Impostazioni.
2. Selezionare Sistema e poi Informazioni su (o Specifiche dispositivo).
3. Verificare la voce Tipo di sistema: indicherà se il processore e il sistema operativo sono a 64 o 32 bit.

2. Controllo della versione di Java

Aprire il Prompt dei comandi (digitare cmd nella barra di ricerca) e inserire:

Bash

java -version

Se l’output riporta esplicitamente stringhe come 64-Bit Server VM, la JVM attiva è a 64 bit. Se la dicitura “64-Bit” è assente, si tratta di una versione a 32 bit.

Forzare il percorso di Java nel file DesktopTelematico.ini

Se sulla stessa macchina è necessario mantenere sia Java a 32 bit (per altri applicativi fiscali o doganali) sia Desktop Telematico a 64 bit, non serve disinstallare o sovrascrivere nulla. È sufficiente indicare a Desktop Telematico quale interprete usare modificando il file di configurazione interno.

1. Raggiungere la cartella di installazione del software (di norma C:\DesktopTelematico).
2. Individuare il file DesktopTelematico.ini e aprirlo con un editor di testo come Blocco Note.
3. Inserire il parametro -vm seguito dal percorso assoluto del file javaw.exe corretto, posizionandolo prima della riga -vmargs.

Esempio pratico:

Ini, TOML

-vm
C:\Program Files\Java\jre-1.8\bin\javaw.exe
-vmargs
-Xms256m
-Xmx1024m

La riga con -vm e la riga con il percorso devono rimanere separate. Un errore di sintassi in questo file impedirà del tutto l’avvio della schermata di splash.

Domande frequenti

Posso installare Desktop Telematico 32 bit su Windows a 64 bit?

Sì. Windows esegue applicativi a 32 bit senza problemi, purché nel sistema sia installata una versione di Java a 32 bit corrispondente. Tuttavia, la versione a 64 bit offre maggiore stabilità nella gestione di flussi telematici pesanti.

Cosa fare se Desktop Telematico non si apre dopo l’installazione?

Il blocco deriva quasi sempre dal disallineamento tra l’architettura del programma (32/64 bit) e quella del runtime Java, oppure da variabili d’ambiente corrotte. Modificare il file DesktopTelematico.ini indicando il percorso diretto a javaw.exe risolve la maggior parte dei casi.

Conviene aggiornare la versione a 32 bit già installata?

Se l’installazione a 32 bit esistente scarica regolarmente i moduli di controllo e non genera errori di memoria esaurita (OutOfMemoryError), non è obbligatorio cambiarla. Il passaggio alla versione a 64 bit è raccomandato in caso di reinstallazione o sostituzione del PC.

Se l’ambiente continua a dare problemi dopo aver allineato l’architettura, vale la pena verificare i permessi di scrittura nella cartella di installazione: Desktop Telematico richiede privilegi pieni nella propria directory di lavoro per aggiornare correttamente i plugin interni (Entratel, FileInternet e moduli di controllo).

Per la documentazione tecnica e i file di installazione aggiornati, fare sempre riferimento al portale ufficiale dell’Agenzia delle Entrate:

Agenzia delle Entrate – Software Desktop Telematico

Domenico De Rosa

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.