GetbeelDocs
Dati di riferimento

Codici di scarto SDI

Ogni codice delle ricevute di scarto dello SDI, con la causa e come correggerlo.

Quando un controllo non passa, lo SDI invia una ricevuta di scarto (NS) con uno o più codici a 5 cifre e una breve descrizione. In Getbeel i codici sono in sdi.error_codes e, con la descrizione dello SDI, in sdi.errors della fattura; il webhook invoice.rejected porta la fattura completa in data.object.

Una fattura scartata si considera mai emessa: correggi quello che dice il codice e inviala di nuovo con lo stesso numero e la stessa data, preferibilmente entro 5 giorni dalla ricevuta di scarto. L'unica eccezione è 00404 su una fattura già inviata: vedi sotto. Il quadro completo degli esiti è nel ciclo di vita SDI.

Le ricevute dello SDI

RicevutaSignificatoStato in Getbeel
RC, ricevuta di consegnaFattura recapitata al destinatario: emessadelivered
MC, ricevuta di impossibilità di recapitoNon recapitata ma emessa: è nel cassetto fiscale del cliente da sdi.available_sincenot_delivered
NS, ricevuta di scartoFile rifiutato: la fattura si considera mai emessarejected
NE, notifica di esito (PA)Accettazione o rifiuto da parte di una Pubblica AmministrazioneAccettazione: delivered; rifiuto: rejected
DT, decorrenza termini (PA)La PA non ha risposto entro 15 giornidelivered

00404: duplicato di una fattura emessa

00404 ("Fattura duplicata") significa che lo SDI ha già accettato un documento con lo stesso cedente, lo stesso anno della data e lo stesso numero (per le autofatture TD16–TD20, TD22, TD23, TD28 e TD29 conta il cessionario). Il controllo non scatta se il documento precedente era stato scartato, e una nota di credito (TD04) può avere lo stesso numero di una fattura.

  • Su una fattura che avevi già inviato (per esempio un secondo invio dello stesso documento): la fattura è emessa, perché lo SDI ne ha una copia accettata. Non rigenerarla e non inviarla di nuovo: verrebbe scartata ancora con 00404. Getbeel la lascia nello stato che aveva, con 00404 in sdi.error_codes, e nell'app la mostra come Già emessa · duplicato.
  • Su una fattura nuova che per errore ha il numero di un'altra già emessa nello stesso anno: questa fattura non è emessa. Dalle un numero libero (Getbeel assegna il successivo) e inviala.

Tutti i codici

Codici e descrizioni dell'Allegato A alle specifiche tecniche, versione 1.9.1, Appendice 1 (pp. 112–123), e delle Specifiche tecniche del Sistema di Interscambio, versione 1.8.4 (controlli sul file: 00302, 00304, 00398, 00399). Il codice 00448 riguarda i dati fattura (Appendice 2), non le fatture elettroniche, e non è elencato. Le descrizioni dello SDI sono abbreviate; il numero prima del nome del campo (per esempio 1.4.1.1.2) è la sua posizione nel tracciato FatturaPA.

Nome, dimensioni e firma del file

Getbeel genera nome file e XML e non firma le fatture (lo SDI accetta file non firmati), quindi questi codici arrivano solo da file preparati altrove.

CodiceMessaggio SDICausaCome correggere
00001Nome file non validoIl nome del file non segue lo schema IT<codice fiscale trasmittente>_<progressivo>.xmlRinomina il file secondo lo schema (Getbeel lo fa da solo)
00002Nome file duplicatoUn file con lo stesso nome è già stato inviato allo SDI, anche se scartatoReinvia con un nuovo nome file (un nuovo progressivo)
00003Le dimensioni del file superano quelle ammesseIl file supera il limite del canale di trasmissioneRiduci il file, per esempio gli allegati, o dividi il lotto
00100Certificato di firma scadutoIl file è firmato con un certificato scadutoFirma con un certificato valido, oppure invia il file senza firma
00101Certificato di firma revocatoIl certificato di firma è stato revocatoCome sopra
00102La firma elettronica apposta al file non risulta validaIl file è stato modificato dopo la firmaFirma di nuovo il file definitivo, oppure invialo senza firma
00103Alla firma manca il riferimento temporaleFirma qualificata senza riferimento temporaleFirma con riferimento temporale, oppure invia senza firma
00104La CA del certificato non è nell'elenco delle CA affidabiliCertificato emesso da un'autorità non riconosciutaUsa un certificato di una CA accreditata, oppure invia senza firma
00105Riferimento temporale della firma successivo alla ricezioneLa data della firma è nel futuro rispetto all'invioCorreggi l'orologio di chi firma e firma di nuovo
00106Il file compresso è vuoto oppure non è leggibileArchivio ZIP vuoto o danneggiatoRicrea l'archivio e reinvialo
00107Il certificato di firma non è validoCertificato non valido per altri motiviFirma con un certificato valido, oppure invia senza firma

Formato

CodiceMessaggio SDICausaCome correggere
00200File non conforme al formatoL'XML non rispetta lo schema XSD FatturaPA; il messaggio indica il punto esattoCorreggi il campo indicato; valida prima con POST /invoices/validate
00201Superato il numero massimo di errori di formato (50)Troppi errori di formato: la ricevuta non li elenca tuttiValida l'XML con POST /invoices/validate e correggi tutti gli errori
00428FormatoTrasmissione non coerente con l'attributo versionePer esempio FPR12 in FormatoTrasmissione con versione="FPA12"Usa lo stesso valore nei due punti: FPR12 per privati, FPA12 per la PA

Identificativi fiscali e destinatario

CodiceMessaggio SDICausaCome correggere
003001.1.1.2 IdCodice (trasmittente) non validoIl codice fiscale del trasmittente non risulta in Anagrafe TributariaCorreggi l'identificativo del trasmittente (con Getbeel è il canale di trasmissione: contatta l'assistenza)
003011.2.1.1.2 IdCodice (cedente) non validoLa partita IVA di chi emette non risulta in Anagrafe TributariaControlla la partita IVA in Impostazioni → Azienda
003021.2.1.2 CodiceFiscale (cedente) non validoIl codice fiscale di chi emette non risulta in Anagrafe TributariaCorreggi il codice fiscale in Impostazioni → Azienda e reinvia
003031.3.1.1.2 o 1.4.4.1.2 IdCodice (rappresentante fiscale) non validoLa partita IVA del rappresentante fiscale non risultaCorreggi la partita IVA del rappresentante fiscale
003041.3.1.2 CodiceFiscale (rappresentante fiscale) non validoIl codice fiscale del rappresentante fiscale non risulta in Anagrafe TributariaCorreggi il codice fiscale del rappresentante fiscale e reinvia
003051.4.1.1.2 IdCodice (cessionario) non validoLa partita IVA del cliente non risulta in Anagrafe TributariaVerifica la partita IVA del cliente (per esempio con il servizio dell'Agenzia o VIES) e correggila
003061.4.1.2 CodiceFiscale (cessionario) non validoIl codice fiscale del cliente non esiste (controllato solo se manca la partita IVA)Correggi il codice fiscale del cliente
003111.1.4 CodiceDestinatario non validoIl codice destinatario non esisteChiedi al cliente il codice corretto, oppure usa 0000000 con la sua PEC o senza (la fattura andrà nel suo cassetto fiscale)
003121.1.4 CodiceDestinatario non attivoIl canale del codice destinatario è disattivatoCome sopra
00313CodiceDestinatario XXXXXXX solo per non residentiXXXXXXX usato per un cliente italiano o senza IdFiscaleIVA esteroPer un cliente italiano usa il suo codice o 0000000; XXXXXXX solo con IdPaese diverso da IT
00320IdFiscaleIVA e CodiceFiscale del cedente non coerentiPartita IVA e codice fiscale dell'emittente appartengono a soggetti diversiCorreggi uno dei due nel profilo aziendale
00321CodiceFiscale del cedente di soggetto non partecipante al gruppo IVACon la partita IVA di un gruppo IVA, il codice fiscale non è di una società del gruppoIndica il codice fiscale della società partecipante che emette
00322CodiceFiscale del cedente mancante con IdFiscaleIVA di gruppo IVAPartita IVA di gruppo senza il codice fiscale della partecipanteAggiungi il codice fiscale della società partecipante
00323IdCodice del cedente di una partita IVA cessata da oltre 5 anniLa partita IVA del cedente è cessata da più di 5 anni (nelle autofatture il cedente è il fornitore)Controlla la partita IVA del cedente e usa quella attiva
00324IdFiscaleIVA e CodiceFiscale del cessionario non coerentiPartita IVA e codice fiscale del cliente appartengono a soggetti diversiCorreggi uno dei due nei dati del cliente
00325CodiceFiscale del cessionario di soggetto non partecipante al gruppo IVACliente con partita IVA di gruppo e codice fiscale di un soggetto esterno al gruppoIndica il codice fiscale della società del gruppo che acquista
00326CodiceFiscale del cessionario mancante con IdFiscaleIVA di gruppo IVAPartita IVA di gruppo del cliente senza codice fiscale della partecipanteAggiungi il codice fiscale della società partecipante
00327CodiceFiscale del cessionario di gruppo IVA non riferito a un partecipanteSenza partita IVA, è indicato il codice fiscale del gruppo IVA invece di quello di una partecipanteIndica il codice fiscale della società partecipante al gruppo
00330PECDestinatario contenente un valore non ammessoLa PEC indicata è una casella dello SDIIndica la PEC del cliente
00398Codice Ufficio non identificabile in IPA con CodiceDestinatario dell'ufficio "Centrale"Fattura a una Pubblica Amministrazione inviata al codice dell'ufficio "Centrale" senza che lo SDI possa individuare un solo ufficio dell'enteUsa il codice univoco dell'ufficio destinatario indicato dall'ente (IPA, indicepa.gov.it) e reinvia
00399CessionarioCommittente presente in IPA con FormatoTrasmissione FPR12Il cliente è una Pubblica Amministrazione ma la fattura usa il formato tra privatiEmetti la fattura nel formato PA (FPA12) con il codice univoco ufficio e reinvia
00417IdFiscaleIVA e CodiceFiscale del cessionario non valorizzatiIl cliente non ha né partita IVA né codice fiscaleIndica almeno uno dei due
00427CodiceDestinatario di lunghezza non coerente con FormatoTrasmissione7 caratteri con FPA12, o 6 con FPR12Privati: codice di 7 caratteri con FPR12. PA: codice ufficio di 6 caratteri con FPA12

Contenuto e calcoli

CodiceMessaggio SDICausaCome correggere
00400Natura non presente con AliquotaIVA pari a zero (righe)Una riga a IVA zero senza naturaIndica la natura della riga
00401Natura presente con AliquotaIVA diversa da zero (righe)Natura su una riga con IVATogli la natura (è ammessa solo con TD16)
004032.1.1.3 Data successiva alla data di ricezioneLa data della fattura è nel futuroUsa la data di oggi o una passata
00411DatiRitenuta mancante con righe soggette a ritenutaUna riga ha Ritenuta = SI ma manca il blocco della ritenutaAggiungi la ritenuta (tipo, aliquota, importo, causale)
00413Natura mancante con aliquota zero nella cassa previdenzialeContributo cassa a IVA zero senza naturaIndica la natura del contributo
00414Natura presente con aliquota diversa da zero nella cassa previdenzialeContributo cassa con IVA e naturaTogli la natura dal contributo
00415DatiRitenuta mancante con cassa previdenziale soggetta a ritenutaContributo con Ritenuta = SI senza blocco ritenutaAggiungi la ritenuta
004182.1.1.3 Data antecedente a quella del documento collegatoPer esempio una nota di credito datata prima della fattura che rettificaUsa una data uguale o successiva a quella del documento collegato
00419DatiRiepilogo mancante per un'aliquota IVA presenteUn'aliquota delle righe o della cassa non ha il suo riepilogoAggiungi un riepilogo per ogni aliquota
00420Natura N6.x con esigibilità IVA S (scissione dei pagamenti)Reverse charge e split payment insiemeScegli uno dei due regimi: con la natura N6 l'esigibilità non può essere S
004212.2.2.6 Imposta non calcolata secondo le regoleImposta ≠ ImponibileImporto × AliquotaIVA / 100, arrotondata a 2 decimali (tolleranza 1 centesimo)Ricalcola l'imposta di ogni riepilogo
004222.2.2.5 ImponibileImporto non calcolato secondo le regoleL'imponibile del riepilogo non è la somma delle righe, dei contributi e degli arrotondamenti di quell'aliquota (tolleranza 1 euro)Somma le righe per aliquota
004232.2.1.11 PrezzoTotale non calcolato secondo le regoleTotale di riga ≠ (prezzo unitario ± sconti) × quantità (tolleranza 1 centesimo)Ricalcola il totale della riga
00424AliquotaIVA non indicata in termini percentualiAliquota scritta come 0.22Scrivi 22.00
004252.1.1.4 Numero non contenente caratteri numericiIl numero della fattura non ha cifreIl numero deve contenere almeno una cifra
00429Natura non presente con AliquotaIVA pari a zero (riepilogo)Riepilogo a IVA zero senza naturaIndica la natura nel riepilogo
00430Natura presente con AliquotaIVA diversa da zero (riepilogo)Natura in un riepilogo con IVATogli la natura (ammessa solo con TD16)
00437Sconto o maggiorazione del documento senza percentuale né importoÈ indicato il tipo di sconto ma non quantoIndica la percentuale o l'importo
00438Sconto o maggiorazione di riga senza percentuale né importoCome sopra, su una rigaIndica la percentuale o l'importo
00443Aliquote IVA delle righe non presenti nel riepilogoUn'aliquota delle righe o della cassa manca nei riepiloghiAggiungi il riepilogo di quell'aliquota
00444Nature delle righe non presenti nel riepilogoUna natura delle righe o della cassa manca nei riepiloghiAggiungi il riepilogo di quella natura
00445Natura generica N2, N3 o N6 non più ammessaCodice natura "padre" (dal 2021 non valido)Usa il sottocodice, per esempio N2.2
00460Importo oltre il limite della fattura semplificataFattura semplificata oltre 400 euro (salvo RF19, RF20 o rettifiche)Emetti una fattura ordinaria (TD01)
00471Per questo tipo documento cedente e cessionario devono essere diversiLo stesso soggetto come cedente e cessionario con TD01, TD02, TD03, TD06, TD16–TD20, TD24, TD25, TD28, TD29 (o TD07)Correggi il cliente, o usa il tipo documento giusto (per esempio TD27 per l'autoconsumo)
00472Per questo tipo documento cedente e cessionario devono coincidereTD21 o TD27 con un cessionario diverso dal cedenteIndica te stesso come cessionario, o cambia tipo documento
00473Paese del cedente non ammesso per questo tipo documentoTD17, TD18, TD19 o TD28 con un cedente italiano, o TD29 con un cedente esteroIndica il fornitore estero come cedente (o IT per TD29); per un fornitore italiano non serve l'autofattura
00474Per questo tipo documento non sono ammesse righe con aliquota zeroAutofattura per splafonamento (TD21) con righe a IVA zeroOgni riga deve avere un'aliquota diversa da zero
00475Per questo tipo documento serve la partita IVA del cessionarioTD16–TD20, TD22, TD23, TD28 o TD29 senza IdFiscaleIVA del cessionarioIndica la partita IVA del cessionario
00476Cedente e cessionario entrambi con paese diverso da ITFattura tra due soggetti esteriAlmeno uno dei due deve avere IdPaese IT; una fattura tra soggetti esteri non passa dallo SDI
00477Non imponibilità art. 8, c. 1, lett. c) con dichiarazione d'intento invalidataLa dichiarazione d'intento citata è stata invalidata dall'AgenziaFattura con IVA, oppure chiedi al cliente una dichiarazione d'intento valida

Unicità

CodiceMessaggio SDICausaCome correggere
00404Fattura duplicataLo SDI ha già accettato un documento con stesso cedente (o cessionario per le autofatture), stesso anno e stesso numeroSu una fattura già inviata: è emessa, non rigenerarla né reinviarla (vedi sopra). Su una fattura nuova: usa un numero libero
00409Fattura duplicata nel lottoDue fatture con lo stesso numero e anno nello stesso fileDai un numero diverso a ogni fattura del lotto

Fonti: Agenzia delle Entrate, Allegato A, Specifiche tecniche versione 1.9.1 (31 marzo 2026), Appendice 1 "Elenco dei codici errore relativi alla fattura ordinaria e a quella semplificata", pp. 112–123 (unicità: pp. 122–123); Specifiche tecniche del Sistema di Interscambio versione 1.8.4 (31 marzo 2026), controlli sul file; documentazione SDI su fatturapa.gov.it; La fattura elettronica e i servizi gratuiti, dicembre 2025, pp. 16–18; circolare 13/E del 2 luglio 2018, § 1.6 (reinvio entro 5 giorni con stessa data e numero). Le cause e le correzioni spiegano le descrizioni ufficiali; i messaggi sono abbreviati.

In questa pagina