Stai per inviare una fornitura telematica e la procedura si blocca con una schermata di scarto: il file non viene autenticato oppure compare un codice di errore generico durante la fase di firma e sigillo.
Quando si verifica un errore di autenticazione del file con Entratel o Desktop Telematico, il blocco dipende quasi sempre da tre elementi: le chiavi dell’ambiente di sicurezza (scadute, revocate o caricate dal percorso sbagliato), un disallineamento tra il codice PIN inserito e il supporto utilizzato, oppure l’assenza dei moduli di controllo aggiornati per la tipologia di documento da trasmettere.
1. La cartella dell’ambiente di sicurezza e il percorso di lavoro
La prima verifica da compiere riguarda la configurazione dell’ambiente di sicurezza all’interno dell’applicazione Entratel (integrata nella piattaforma Desktop Telematico).
Spesso l’applicazione punta a una directory locale non più valida, ad esempio dopo un cambio di postazione, un aggiornamento del sistema operativo o il ripristino da un backup. Nella sezione Sicurezza > Imposta ambiente, controlla che il percorso indicato per le chiavi private corrisponda alla cartella effettiva in cui risiedono i file secr.key e publ.key (o i file specifici legati alla matricola dell’intermediario). Se l’utente lavora con più codici sede o gestisce diverse posizioni da intermediario, basta selezionare inavvertitamente il profilo contabile errato per rendere impossibile l’autenticazione del flusso predisposto.
2. Scadenza o revoca dei certificati telematici
I certificati di autenticazione e firma rilasciati dall’Agenzia delle Entrate hanno una durata limitata (generalmente 3 anni). Quando l’ambiente di sicurezza scade:
- La procedura rifiuta l’elaborazione del file prima ancora di generare il documento cifrato (
.atto.ccf). - Il software restituisce messaggi come “Ambiente di sicurezza non valido”, “Certificato scaduto” o codici d’errore numerici durante l’accesso alle chiavi.
Se la validità è scaduta senza che sia stato effettuato il rinnovo nei termini previsti tramite l’apposita funzione su Desktop Telematico o portale Entratel, non è possibile forzare l’autenticazione: occorre revocare il vecchio ambiente e procedere con una nuova generazione completa delle chiavi di sicurezza, attendendo poi il riallineamento delle credenziali.
3. Discrepanza tra PIN di sicurezza e password di accesso
Un malinteso frequente tra gli operatori riguarda la differenza tra:
- Il PIN del cassetto fiscale/credenziali Agenzia Entrate (utilizzato per accedere al portale web).
- Il codice PIN dell’ambiente di sicurezza (la passphrase scelta in fase di generazione delle chiavi private per proteggere l’archivio locale).
Quando Desktop Telematico richiede la “Password di protezione delle chiavi private” durante la funzione Documenti > Autentica, bisogna digitare la stringa legata all’archivio locale delle chiavi. Inserire più volte il PIN di accesso al portale blocca l’operazione. Inoltre, se sono attivi blocchi maiuscole (Caps Lock) o caratteri speciali non riconosciuti dal charset del software, l’autenticazione fallisce all’istante senza chiarire la causa esatta.
4. Controllo preliminare e moduli di controllo non aggiornati
L’autenticazione tramite Entratel non è una semplice cifratura crittografica: esegue contestualmente una validazione formale del tracciato record.
Se il file generato dal gestionale contabile o dal software paghe contiene anomalie strutturali, oppure se in Desktop Telematico non sono installati i moduli di controllo specifici per l’anno d’imposta o per il modello in lavorazione (ad esempio F24, 730, Certificazione Unica, IVA o Dichiarazione di Successione), il processo si arresta.
Prima di tentare nuovamente l’autenticazione:
- Esegui la funzione autonoma Controlla file.
- Verifica il file diagnostico (estensione
.dgno report di scarto) generato nella cartella di lavoro per individuare eventuali campi non conformi. - Da Desktop Telematico, accedi a Guida > Installa software e scarica tutti gli aggiornamenti disponibili per l’applicazione Entratel e per i moduli di controllo attivi.
Domande frequenti
Cosa fare se Desktop Telematico dice che il file non è conforme?
Il file contiene errori di tracciato o campi obbligatori omessi. Apri il report diagnostico generato dopo il controllo formale per individuare i righi anomali, correggi i dati nel gestionale d’origine ed esporta nuovamente la fornitura prima di autenticarla.
Perché il PIN delle chiavi Entratel viene rifiutato anche se è corretto?
Succede quasi sempre quando Desktop Telematico sta puntando alla cartella di un altro ambiente di sicurezza (ad esempio un vecchio archivio o un’altra matricola) oppure se la tastiera ha inserito spazi vuoti o caratteri speciali imprevisti.
Come rigenerare l’ambiente di sicurezza se le chiavi sono scadute?
Se i certificati sono già scaduti, non puoi usare la funzione di rinnovo. Devi accedere all’area riservata del sito dell’Agenzia delle Entrate, revocare l’ambiente precedente e avviare la procedura di nuova generazione chiavi da Desktop Telematico.
Si può autenticare un file Entratel senza Desktop Telematico?
No, l’autenticazione che appone il sigillo elettronico ministeriale per gli intermediari richiede l’ambiente Desktop Telematico (o procedure batch certificate fornite dai software house conformi agli standard crittografici dell’Agenzia delle Entrate).
Indicazioni finali
Quando i controlli sui percorsi e sulle credenziali non sbloccano la procedura, è consigliabile consultare direttamente la sezione dedicata all’assistenza tecnica telematica sul portale istituzionale dell’Agenzia delle Entrate (agenziaentrate.gov.it), verificando gli avvisi di sistema per eventuali disservizi momentanei dei server di accoglienza flussi.
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.
