Codice fornitura non trovato: guida completa per risolvere

Se Desktop Telematico o una delle applicazioni dell’Agenzia delle Entrate segnala un errore come “codice fornitura non trovato”, “codice fornitura non presente” o un messaggio simile, nella maggior parte dei casi il problema riguarda il riconoscimento del tipo di file telematico che si sta tentando di controllare, elaborare o visualizzare.

Il codice fornitura è infatti uno degli elementi utilizzati per identificare la tipologia di documento contenuta in un file telematico. Le specifiche dell’Agenzia delle Entrate prevedono codici diversi a seconda dell’adempimento; per esempio, anche i moduli di controllo vengono distribuiti indicando espressamente il relativo codice fornitura.

La prima cosa da fare, quindi, non è modificare manualmente il file. È preferibile verificare che Desktop Telematico e i moduli necessari siano aggiornati e che il file che si sta utilizzando sia effettivamente compatibile con la procedura scelta.

Cosa significa “codice fornitura non trovato”

All’interno dei file telematici gestiti dall’Agenzia delle Entrate sono presenti informazioni che permettono al software di capire di quale documento si tratta. Tra queste può esserci proprio il codice fornitura.

Il manuale Entratel indica, ad esempio, che nel record di testa di un file possono essere presenti informazioni comuni all’intera fornitura, tra cui codice fornitura, codice fiscale del fornitore e tipo di fornitore. Il software deve quindi riconoscere la struttura del file per poterlo gestire correttamente.

Quando il codice non viene riconosciuto, le cause possono essere diverse.

Modulo di controllo mancante o non aggiornato

È uno dei primi controlli da effettuare. Desktop Telematico funziona come un contenitore nel quale vengono installati Entratel, FileInternet e i diversi moduli di controllo necessari per gestire le varie tipologie di documenti.

L’Agenzia delle Entrate conferma che Desktop Telematico gestisce gli aggiornamenti delle applicazioni e dei moduli installati.

Se si sta lavorando su un adempimento nuovo o appena aggiornato, il modulo necessario potrebbe quindi non essere ancora presente nella propria installazione oppure potrebbe essere rimasto a una versione precedente.

Il file appartiene a un adempimento diverso

Un’altra possibilità è che si stia tentando di elaborare il file utilizzando una funzione non adatta alla sua tipologia.

I codici fornitura cambiano in base al documento. Per esempio, l’Agenzia utilizza codici specifici per F24 telematici, Certificazioni Uniche, dichiarazioni e altri flussi. Nel 2026, ad esempio, il modulo della Certificazione Unica utilizza il codice CUR26, mentre per alcuni flussi F24 viene utilizzato F24A0.

Il punto importante non è memorizzare questi codici, ma assicurarsi che il file e il modulo utilizzato corrispondano allo stesso adempimento.

File incompleto, alterato o generato in modo errato

Se il software è aggiornato ma un singolo file continua a produrre l’errore, è opportuno controllare anche l’origine del documento.

Il problema può riguardare, per esempio:

  • un file esportato in modo incompleto dal software gestionale;
  • un file modificato o rinominato manualmente;
  • una copia danneggiata durante il trasferimento;
  • un documento generato con una versione non aggiornata del software;
  • un file che non appartiene alla tipologia che si sta tentando di elaborare.

In questi casi conviene recuperare nuovamente il file dalla fonte originale oppure rigenerarlo, se possibile.

Come risolvere “codice fornitura non trovato”

1. Chiudi e riavvia Desktop Telematico con Internet attivo

È il controllo più semplice e vale la pena farlo subito.

Desktop Telematico verifica automaticamente la disponibilità di aggiornamenti delle applicazioni installate quando viene avviato. L’Agenzia delle Entrate indica inoltre che i moduli già presenti possono aggiornarsi automaticamente all’avvio della piattaforma.

Lascia quindi completare eventuali aggiornamenti prima di riprovare l’operazione.

2. Verifica gli aggiornamenti disponibili

Se il riavvio non basta, controlla che Desktop Telematico e l’applicazione utilizzata siano aggiornati.

Nelle versioni documentate dall’Agenzia è prevista anche una funzione per verificare manualmente gli aggiornamenti dell’applicazione. Poiché menu e interfaccia possono cambiare nel tempo, è preferibile fare riferimento alle indicazioni presenti nella versione di Desktop Telematico installata e alla documentazione ufficiale aggiornata.

Non disinstallare immediatamente il programma: spesso è sufficiente completare gli aggiornamenti mancanti.

3. Controlla che sia installato il modulo relativo al documento

Se l’errore compare durante il controllo di una dichiarazione, una comunicazione o un altro adempimento, verifica che nel Desktop Telematico sia disponibile il modulo di controllo specifico.

L’Agenzia pubblica periodicamente nuovi moduli o nuove versioni, ciascuno associato ai documenti che deve gestire.

Se il documento riguarda un nuovo anno fiscale, questo controllo è particolarmente importante: avere Desktop Telematico aggiornato non significa necessariamente che ogni modulo necessario sia già stato installato sulla postazione.

4. Verifica di aver selezionato il file giusto

Controlla attentamente il nome e soprattutto la provenienza del file.

Se hai più copie dello stesso documento, prova a partire dalla versione originale prodotta dal programma di compilazione o scaricata dal servizio ufficiale. Evita di modificare manualmente il contenuto del file per tentare di correggere il codice fornitura.

Modificare il testo interno potrebbe rendere il documento incompatibile con i controlli successivi.

5. Rigenera il file

Se gli altri documenti vengono riconosciuti normalmente e l’errore riguarda soltanto un file, prova a generarlo nuovamente dal software con cui è stato predisposto.

Prima di farlo verifica anche che il programma di compilazione utilizzato sia aggiornato, soprattutto se si tratta di modelli relativi all’anno corrente.

6. Prova nuovamente il controllo

Dopo l’aggiornamento del Desktop Telematico o l’installazione del modulo necessario, ripeti l’operazione sul file originale o appena rigenerato.

Se il file viene riconosciuto, il problema era probabilmente legato alla disponibilità del componente necessario per quella specifica fornitura.

Cosa fare se l’errore continua

Se il messaggio continua a comparire anche dopo gli aggiornamenti, evita di effettuare tentativi casuali sul file, soprattutto se devi rispettare una scadenza fiscale o amministrativa.

Conviene verificare:

  • che il file sia destinato realmente a Entratel/FileInternet o alla funzione che stai utilizzando;
  • che l’adempimento sia supportato dalla versione corrente del software;
  • che il programma con cui il file è stato generato sia aggiornato;
  • che il modulo di controllo previsto dall’Agenzia sia già disponibile;
  • che non si tratti di un problema specifico del singolo file.

Sul sito dei Servizi Telematici dell’Agenzia delle Entrate sono pubblicati gli aggiornamenti dei moduli e la documentazione relativa a Desktop Telematico. Al momento della verifica, la pagina ufficiale riporta Desktop Telematico versione 1.4.0 del 4 giugno 2026.

Domande frequenti

Il codice fornitura è un codice che devo inserire manualmente?

Normalmente no. Fa parte della struttura del file telematico ed è collegato alla tipologia di documento. Non va inventato o sostituito manualmente per eliminare l’errore.

Devo reinstallare Desktop Telematico?

Non necessariamente. Prima conviene riavviare il programma, verificare gli aggiornamenti e controllare la disponibilità del modulo relativo all’adempimento. La reinstallazione completa dovrebbe essere presa in considerazione solo se esistono problemi più generali con l’applicazione.

L’errore significa che la dichiarazione è stata scartata?

Non automaticamente. Un errore di riconoscimento del codice fornitura può verificarsi già nella fase locale di gestione o controllo del file. Non va quindi confuso con una ricevuta di scarto successiva alla trasmissione.

Posso modificare il codice all’interno del file?

È sconsigliato. I file telematici rispettano strutture e specifiche precise. La soluzione corretta è individuare il modulo adatto oppure rigenerare il documento utilizzando il software previsto.

In conclusione

Quando compare “codice fornitura non trovato”, controlla prima Desktop Telematico e i relativi moduli, quindi verifica che il file appartenga effettivamente all’adempimento che stai cercando di elaborare. Se il problema riguarda un unico documento, recuperarlo o generarlo nuovamente è spesso il passaggio più prudente.

In presenza di una scadenza imminente, verifica sempre gli ultimi aggiornamenti e le istruzioni pubblicate sul sito ufficiale dell’Agenzia delle Entrate, perché software, moduli di controllo e procedure possono essere modificati nel corso dell’anno.