I codici FE_* sono interni a FatturaCheck: servono a sviluppatori e operatori per automatizzare le correzioni. Non sono i codici ufficiali di scarto SDI, anche se spesso puntano agli stessi campi. Il motore è un MVP a regole: non è la XSD completa e non invia documenti all'SDI; l'XML non viene salvato dopo la richiesta. Usarli bene significa trattarli come segnali sul mapping, non come sostituto del parere del commercialista.
Nella risposta trovi code, severity, severity, spesso messageIt, e la severity (error o warning). Parti dagli errori bloccanti, poi valuta gli avvisi (per esempio namespace o versione inattesa).
Radice, namespace e versione
FE_ROOT_MISSING— manca l'elementoFatturaElettronica. Di solito il file non è una fattura o è avvolto in un contenitore inatteso.FE_NS_MISSING/FE_NS_UNKNOWN— namespace assente o non riconosciuto come FatturaPA (avvisi tipici).FE_VERSIONE_MISSING/FE_VERSIONE_UNKNOWN— attributoversioneassente o fuori da FPA12 / FPR12 / FSM10.FE_HEADER_MISSING/FE_BODY_MISSING— sezioni Header o Body assenti: senza di esse il documento non è utilizzabile.
Dati di trasmissione
Qui si decide chi trasmette e verso quale canale. Errori in questo blocco bloccano spesso l'accettazione ancora prima dei controlli sul contenuto merceologico.
FE_DATI_TRASMISSIONE_MISSING,FE_ID_TRASMITTENTE_MISSING,FE_ID_PAESE_MISSING,FE_ID_CODICE_MISSING/FE_ID_CODICE_FORMAT— blocco IdTrasmittente incompleto o mal formattato.FE_PROGRESSIVO_MISSING— ProgressivoInvio assente; serve un identificativo univoco dell'invio lato trasmittente.FE_FORMATO_MISSING/FE_FORMATO_INVALID/FE_FORMATO_VERSIONE_MISMATCH— FormatoTrasmissione assente, non valido o incoerente conversione.FE_CODICE_DEST_MISSING,FE_CODICE_DEST_LEN_PA,FE_CODICE_DEST_LEN_PR,FE_PEC_REQUIRED— codice destinatario o PEC non allineati al canale (PA vs privato).
Cedente, cessionario e sede
FE_CEDENTE_MISSING,FE_CESSIONARIO_MISSING,FE_DATI_ANAGRAFICI_MISSING— blocchi anagrafici mancanti.FE_IVA_PAESE_MISSING,FE_IVA_CODICE_MISSING,FE_PIVA_FORMAT,FE_CF_FORMAT,FE_TAX_ID_MISSING— identificativi fiscali assenti o con formato sospetto (P.IVA 11 cifre, CF 11/16).FE_ANAGRAFICA_MISSING/FE_ANAGRAFICA_NAME— Denominazione o Nome/Cognome non valorizzati.FE_SEDE_MISSING,FE_INDIRIZZO_MISSING,FE_CAP_MISSING/FE_CAP_FORMAT,FE_COMUNE_MISSING,FE_NAZIONE_MISSING— indirizzo incompleto; il CAP italiano deve avere 5 cifre.
Documento, linee e riepilogo
FE_DATI_GENERALI_MISSING,FE_DATI_DOC_MISSING— sezioni generali del body assenti.FE_TIPO_DOC_MISSING/FE_TIPO_DOC_FORMAT,FE_DIVISA_MISSING,FE_DATA_MISSING/FE_DATA_FORMAT,FE_NUMERO_MISSING— campi del documento principale (data in AAAA-MM-GG).FE_BENI_MISSING,FE_LINEE_MISSING,FE_NUMERO_LINEA_MISSING,FE_DESC_LINEA_MISSING,FE_PREZZO_TOT_MISSING,FE_ALIQUOTA_MISSING— dettaglio linee incompleto.FE_RIEPILOGO_MISSING,FE_RIEP_ALIQUOTA_MISSING,FE_RIEP_IMPONIBILE_MISSING,FE_RIEP_IMPOSTA_MISSING— riepilogo IVA assente o parziale.
Come usare i codici in pratica
Ordina per severity, raggruppa per path (stesso nodo = stessa correzione) e aggiorna il template o l'anagrafica una sola volta. Poi rivalida su /validate. Se il pre-check è pulito ma l'SDI rifiuta ancora, confronta il messaggio ufficiale: potrebbe trattarsi di una regola XSD o di business non ancora coperta dall'MVP.
Per il contesto operativo vedi anche la guida alla validazione e gli errori comuni di rifiuto SDI. Piano Free per prove giornaliere; Starter a €19/mese e Pro a €49/mese quando crescono i volumi. Nessun invio SDI, nessun storage persistente dell'XML in questo MVP.