# Codici di scarto SDI (https://docs.getbeel.com/it/api/reference-data/sdi-errors)

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](/it/api/reference); 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](/it/api/sdi-lifecycle).

## Le ricevute dello 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-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 [#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 [#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 [#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 [#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 [#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](/it/api/reference-data/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à [#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                                                                                   |

<Callout type="info">
  Fonti: Agenzia delle Entrate, [Allegato A, Specifiche tecniche versione
  1.9.1](https://www.agenziaentrate.gov.it/portale/documents/d/guest/allegato-a-specifiche-tecniche-vers-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](https://www.fatturapa.gov.it/export/documenti/Specifiche-tecniche-relative-al-Sistema-di-Interscambio-versione-1.8.4.pdf)
  (31 marzo 2026), controlli sul file; [documentazione SDI su
  fatturapa.gov.it](https://www.fatturapa.gov.it/it/norme-e-regole/DocumentazioneSDI/);
  [La fattura elettronica e i servizi
  gratuiti](https://www.agenziaentrate.gov.it/portale/documents/d/guest/guida_fattura_elettronica_dicembre_2025),
  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.
</Callout>
