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
| Ricevuta | Significato | Stato in Getbeel |
|---|---|---|
| RC, ricevuta di consegna | Fattura recapitata al destinatario: emessa | delivered |
| MC, ricevuta di impossibilità di recapito | Non recapitata ma emessa: è nel cassetto fiscale del cliente da sdi.available_since | not_delivered |
| NS, ricevuta di scarto | File rifiutato: la fattura si considera mai emessa | rejected |
| NE, notifica di esito (PA) | Accettazione o rifiuto da parte di una Pubblica Amministrazione | Accettazione: delivered; rifiuto: rejected |
| DT, decorrenza termini (PA) | La PA non ha risposto entro 15 giorni | delivered |
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, con00404insdi.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.
| Codice | Messaggio SDI | Causa | Come correggere |
|---|---|---|---|
00001 | Nome file non valido | Il nome del file non segue lo schema IT<codice fiscale trasmittente>_<progressivo>.xml | Rinomina il file secondo lo schema (Getbeel lo fa da solo) |
00002 | Nome file duplicato | Un file con lo stesso nome è già stato inviato allo SDI, anche se scartato | Reinvia con un nuovo nome file (un nuovo progressivo) |
00003 | Le dimensioni del file superano quelle ammesse | Il file supera il limite del canale di trasmissione | Riduci il file, per esempio gli allegati, o dividi il lotto |
00100 | Certificato di firma scaduto | Il file è firmato con un certificato scaduto | Firma con un certificato valido, oppure invia il file senza firma |
00101 | Certificato di firma revocato | Il certificato di firma è stato revocato | Come sopra |
00102 | La firma elettronica apposta al file non risulta valida | Il file è stato modificato dopo la firma | Firma di nuovo il file definitivo, oppure invialo senza firma |
00103 | Alla firma manca il riferimento temporale | Firma qualificata senza riferimento temporale | Firma con riferimento temporale, oppure invia senza firma |
00104 | La CA del certificato non è nell'elenco delle CA affidabili | Certificato emesso da un'autorità non riconosciuta | Usa un certificato di una CA accreditata, oppure invia senza firma |
00105 | Riferimento temporale della firma successivo alla ricezione | La data della firma è nel futuro rispetto all'invio | Correggi l'orologio di chi firma e firma di nuovo |
00106 | Il file compresso è vuoto oppure non è leggibile | Archivio ZIP vuoto o danneggiato | Ricrea l'archivio e reinvialo |
00107 | Il certificato di firma non è valido | Certificato non valido per altri motivi | Firma con un certificato valido, oppure invia senza firma |
Formato
| Codice | Messaggio SDI | Causa | Come correggere |
|---|---|---|---|
00200 | File non conforme al formato | L'XML non rispetta lo schema XSD FatturaPA; il messaggio indica il punto esatto | Correggi il campo indicato; valida prima con POST /invoices/validate |
00201 | Superato il numero massimo di errori di formato (50) | Troppi errori di formato: la ricevuta non li elenca tutti | Valida l'XML con POST /invoices/validate e correggi tutti gli errori |
00428 | FormatoTrasmissione non coerente con l'attributo versione | Per 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
| Codice | Messaggio SDI | Causa | Come correggere |
|---|---|---|---|
00300 | 1.1.1.2 IdCodice (trasmittente) non valido | Il codice fiscale del trasmittente non risulta in Anagrafe Tributaria | Correggi l'identificativo del trasmittente (con Getbeel è il canale di trasmissione: contatta l'assistenza) |
00301 | 1.2.1.1.2 IdCodice (cedente) non valido | La partita IVA di chi emette non risulta in Anagrafe Tributaria | Controlla la partita IVA in Impostazioni → Azienda |
00302 | 1.2.1.2 CodiceFiscale (cedente) non valido | Il codice fiscale di chi emette non risulta in Anagrafe Tributaria | Correggi il codice fiscale in Impostazioni → Azienda e reinvia |
00303 | 1.3.1.1.2 o 1.4.4.1.2 IdCodice (rappresentante fiscale) non valido | La partita IVA del rappresentante fiscale non risulta | Correggi la partita IVA del rappresentante fiscale |
00304 | 1.3.1.2 CodiceFiscale (rappresentante fiscale) non valido | Il codice fiscale del rappresentante fiscale non risulta in Anagrafe Tributaria | Correggi il codice fiscale del rappresentante fiscale e reinvia |
00305 | 1.4.1.1.2 IdCodice (cessionario) non valido | La partita IVA del cliente non risulta in Anagrafe Tributaria | Verifica la partita IVA del cliente (per esempio con il servizio dell'Agenzia o VIES) e correggila |
00306 | 1.4.1.2 CodiceFiscale (cessionario) non valido | Il codice fiscale del cliente non esiste (controllato solo se manca la partita IVA) | Correggi il codice fiscale del cliente |
00311 | 1.1.4 CodiceDestinatario non valido | Il codice destinatario non esiste | Chiedi al cliente il codice corretto, oppure usa 0000000 con la sua PEC o senza (la fattura andrà nel suo cassetto fiscale) |
00312 | 1.1.4 CodiceDestinatario non attivo | Il canale del codice destinatario è disattivato | Come sopra |
00313 | CodiceDestinatario XXXXXXX solo per non residenti | XXXXXXX usato per un cliente italiano o senza IdFiscaleIVA estero | Per un cliente italiano usa il suo codice o 0000000; XXXXXXX solo con IdPaese diverso da IT |
00320 | IdFiscaleIVA e CodiceFiscale del cedente non coerenti | Partita IVA e codice fiscale dell'emittente appartengono a soggetti diversi | Correggi uno dei due nel profilo aziendale |
00321 | CodiceFiscale del cedente di soggetto non partecipante al gruppo IVA | Con la partita IVA di un gruppo IVA, il codice fiscale non è di una società del gruppo | Indica il codice fiscale della società partecipante che emette |
00322 | CodiceFiscale del cedente mancante con IdFiscaleIVA di gruppo IVA | Partita IVA di gruppo senza il codice fiscale della partecipante | Aggiungi il codice fiscale della società partecipante |
00323 | IdCodice del cedente di una partita IVA cessata da oltre 5 anni | La 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 |
00324 | IdFiscaleIVA e CodiceFiscale del cessionario non coerenti | Partita IVA e codice fiscale del cliente appartengono a soggetti diversi | Correggi uno dei due nei dati del cliente |
00325 | CodiceFiscale del cessionario di soggetto non partecipante al gruppo IVA | Cliente con partita IVA di gruppo e codice fiscale di un soggetto esterno al gruppo | Indica il codice fiscale della società del gruppo che acquista |
00326 | CodiceFiscale del cessionario mancante con IdFiscaleIVA di gruppo IVA | Partita IVA di gruppo del cliente senza codice fiscale della partecipante | Aggiungi il codice fiscale della società partecipante |
00327 | CodiceFiscale del cessionario di gruppo IVA non riferito a un partecipante | Senza partita IVA, è indicato il codice fiscale del gruppo IVA invece di quello di una partecipante | Indica il codice fiscale della società partecipante al gruppo |
00330 | PECDestinatario contenente un valore non ammesso | La PEC indicata è una casella dello SDI | Indica la PEC del cliente |
00398 | Codice 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'ente | Usa il codice univoco dell'ufficio destinatario indicato dall'ente (IPA, indicepa.gov.it) e reinvia |
00399 | CessionarioCommittente presente in IPA con FormatoTrasmissione FPR12 | Il cliente è una Pubblica Amministrazione ma la fattura usa il formato tra privati | Emetti la fattura nel formato PA (FPA12) con il codice univoco ufficio e reinvia |
00417 | IdFiscaleIVA e CodiceFiscale del cessionario non valorizzati | Il cliente non ha né partita IVA né codice fiscale | Indica almeno uno dei due |
00427 | CodiceDestinatario di lunghezza non coerente con FormatoTrasmissione | 7 caratteri con FPA12, o 6 con FPR12 | Privati: codice di 7 caratteri con FPR12. PA: codice ufficio di 6 caratteri con FPA12 |
Contenuto e calcoli
| Codice | Messaggio SDI | Causa | Come correggere |
|---|---|---|---|
00400 | Natura non presente con AliquotaIVA pari a zero (righe) | Una riga a IVA zero senza natura | Indica la natura della riga |
00401 | Natura presente con AliquotaIVA diversa da zero (righe) | Natura su una riga con IVA | Togli la natura (è ammessa solo con TD16) |
00403 | 2.1.1.3 Data successiva alla data di ricezione | La data della fattura è nel futuro | Usa la data di oggi o una passata |
00411 | DatiRitenuta mancante con righe soggette a ritenuta | Una riga ha Ritenuta = SI ma manca il blocco della ritenuta | Aggiungi la ritenuta (tipo, aliquota, importo, causale) |
00413 | Natura mancante con aliquota zero nella cassa previdenziale | Contributo cassa a IVA zero senza natura | Indica la natura del contributo |
00414 | Natura presente con aliquota diversa da zero nella cassa previdenziale | Contributo cassa con IVA e natura | Togli la natura dal contributo |
00415 | DatiRitenuta mancante con cassa previdenziale soggetta a ritenuta | Contributo con Ritenuta = SI senza blocco ritenuta | Aggiungi la ritenuta |
00418 | 2.1.1.3 Data antecedente a quella del documento collegato | Per esempio una nota di credito datata prima della fattura che rettifica | Usa una data uguale o successiva a quella del documento collegato |
00419 | DatiRiepilogo mancante per un'aliquota IVA presente | Un'aliquota delle righe o della cassa non ha il suo riepilogo | Aggiungi un riepilogo per ogni aliquota |
00420 | Natura N6.x con esigibilità IVA S (scissione dei pagamenti) | Reverse charge e split payment insieme | Scegli uno dei due regimi: con la natura N6 l'esigibilità non può essere S |
00421 | 2.2.2.6 Imposta non calcolata secondo le regole | Imposta ≠ ImponibileImporto × AliquotaIVA / 100, arrotondata a 2 decimali (tolleranza 1 centesimo) | Ricalcola l'imposta di ogni riepilogo |
00422 | 2.2.2.5 ImponibileImporto non calcolato secondo le regole | L'imponibile del riepilogo non è la somma delle righe, dei contributi e degli arrotondamenti di quell'aliquota (tolleranza 1 euro) | Somma le righe per aliquota |
00423 | 2.2.1.11 PrezzoTotale non calcolato secondo le regole | Totale di riga ≠ (prezzo unitario ± sconti) × quantità (tolleranza 1 centesimo) | Ricalcola il totale della riga |
00424 | AliquotaIVA non indicata in termini percentuali | Aliquota scritta come 0.22 | Scrivi 22.00 |
00425 | 2.1.1.4 Numero non contenente caratteri numerici | Il numero della fattura non ha cifre | Il numero deve contenere almeno una cifra |
00429 | Natura non presente con AliquotaIVA pari a zero (riepilogo) | Riepilogo a IVA zero senza natura | Indica la natura nel riepilogo |
00430 | Natura presente con AliquotaIVA diversa da zero (riepilogo) | Natura in un riepilogo con IVA | Togli la natura (ammessa solo con TD16) |
00437 | Sconto o maggiorazione del documento senza percentuale né importo | È indicato il tipo di sconto ma non quanto | Indica la percentuale o l'importo |
00438 | Sconto o maggiorazione di riga senza percentuale né importo | Come sopra, su una riga | Indica la percentuale o l'importo |
00443 | Aliquote IVA delle righe non presenti nel riepilogo | Un'aliquota delle righe o della cassa manca nei riepiloghi | Aggiungi il riepilogo di quell'aliquota |
00444 | Nature delle righe non presenti nel riepilogo | Una natura delle righe o della cassa manca nei riepiloghi | Aggiungi il riepilogo di quella natura |
00445 | Natura generica N2, N3 o N6 non più ammessa | Codice natura "padre" (dal 2021 non valido) | Usa il sottocodice, per esempio N2.2 |
00460 | Importo oltre il limite della fattura semplificata | Fattura semplificata oltre 400 euro (salvo RF19, RF20 o rettifiche) | Emetti una fattura ordinaria (TD01) |
00471 | Per questo tipo documento cedente e cessionario devono essere diversi | Lo 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) |
00472 | Per questo tipo documento cedente e cessionario devono coincidere | TD21 o TD27 con un cessionario diverso dal cedente | Indica te stesso come cessionario, o cambia tipo documento |
00473 | Paese del cedente non ammesso per questo tipo documento | TD17, TD18, TD19 o TD28 con un cedente italiano, o TD29 con un cedente estero | Indica il fornitore estero come cedente (o IT per TD29); per un fornitore italiano non serve l'autofattura |
00474 | Per questo tipo documento non sono ammesse righe con aliquota zero | Autofattura per splafonamento (TD21) con righe a IVA zero | Ogni riga deve avere un'aliquota diversa da zero |
00475 | Per questo tipo documento serve la partita IVA del cessionario | TD16–TD20, TD22, TD23, TD28 o TD29 senza IdFiscaleIVA del cessionario | Indica la partita IVA del cessionario |
00476 | Cedente e cessionario entrambi con paese diverso da IT | Fattura tra due soggetti esteri | Almeno uno dei due deve avere IdPaese IT; una fattura tra soggetti esteri non passa dallo SDI |
00477 | Non imponibilità art. 8, c. 1, lett. c) con dichiarazione d'intento invalidata | La dichiarazione d'intento citata è stata invalidata dall'Agenzia | Fattura con IVA, oppure chiedi al cliente una dichiarazione d'intento valida |
Unicità
| Codice | Messaggio SDI | Causa | Come correggere |
|---|---|---|---|
00404 | Fattura duplicata | Lo SDI ha già accettato un documento con stesso cedente (o cessionario per le autofatture), stesso anno e stesso numero | Su una fattura già inviata: è emessa, non rigenerarla né reinviarla (vedi sopra). Su una fattura nuova: usa un numero libero |
00409 | Fattura duplicata nel lotto | Due fatture con lo stesso numero e anno nello stesso file | Dai 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.