DEV Community: S-Data

Fattura elettronica XML: gli errori più comuni che fanno scartare il file dallo SdI (e come evitarli)

S-Data — Tue, 27 Oct 2026 22:16:37 +0000

Chi genera fatture elettroniche da PDF o da Excel scopre presto che «produrre un XML» e «produrre un XML che lo SdI accetta» sono due lavori diversi. Qui metto in ordine i motivi di scarto che un convertitore può provocare, con codici e significati presi dai documenti ufficiali.

Fonti usate: Allegato A – Specifiche tecniche versione 1.9.1 (Agenzia delle Entrate), Elenco dei controlli versione 2.0 (fatturapa.gov.it) e lo schema Schema_VFPR12 versione 1.2.3. I link sono in fondo.

Due livelli di controllo, non uno

Validazione dello schema (XSD). Controlla struttura, ordine degli elementi, tipi e formati. Un file che non la supera è, in pratica, «non conforme al formato»: 00200, e nel messaggio lo SdI indica il punto preciso. Se gli errori di formato sono più di 50, lo SdI si ferma con il 00201.
Controlli di contenuto. Coerenza dei numeri, identificativi fiscali, codice destinatario, unicità. Qui lo schema non ti aiuta: un file può essere valido sull'XSD e venire scartato lo stesso.

Per questo conviene validare in locale sull'XSD, ma non fermarsi lì.

Codici di scarto da conoscere

Significati come da Elenco controlli v2.0 e Allegato A 1.9.1:

Codice	Significato
00200	File non conforme al formato (il messaggio indica la non conformità puntuale)
00300 / 00301 / 00305	Identificativo fiscale non valido: `IdCodice` del trasmittente (00300), del cedente/prestatore (00301), del cessionario/committente (00305). Il controllo verifica la presenza in anagrafe tributaria; non si applica agli identificativi assegnati da autorità estere
00311	`CodiceDestinatario` non valido
00400	`Natura` assente con `AliquotaIVA` pari a zero
00401	`Natura` presente con `AliquotaIVA` diversa da zero (con l'eccezione del TipoDocumento TD16)
00404	Fattura duplicata: stesso cedente, stesso anno della data, stesso numero di una fattura già trasmessa e non scartata
00421 / 00422 / 00423	`Imposta`, `ImponibileImporto` e `PrezzoTotale` non calcolati secondo le regole delle specifiche
00424	`AliquotaIVA` non espressa in termini percentuali
00427	`CodiceDestinatario` di lunghezza non ammessa per il `FormatoTrasmissione` (7 caratteri con FPA12, 6 con FPR12)

Altri due: 00417 (del cessionario/committente deve esserci almeno uno tra partita IVA e codice fiscale) e 00425 (il Numero documento deve contenere almeno un carattere numerico).

Dove sbaglia un convertitore PDF/Excel → XML

Date. Nello schema Data è un xs:date: formato 2026-10-27. Una data letta dal PDF come 27/10/2026 non passa l'XSD (l'ho provato). La data non può nemmeno essere successiva alla ricezione da parte dello SdI (00403).

Decimali e arrotondamenti. Qui nascono molti scarti 00421–00423. Le regole:

PrezzoTotale deve essere uguale a (PrezzoUnitario ± ScontoMaggiorazione) × Quantita, con tolleranza di ±1 centesimo (00423);
Imposta è AliquotaIVA × ImponibileImporto / 100, arrotondata alla seconda cifra decimale (per difetto se la terza è inferiore a 5, per eccesso se uguale o maggiore), tolleranza ±1 centesimo (00421);
ImponibileImporto per ogni aliquota è la somma dei PrezzoTotale delle righe con quell'aliquota (più contributo cassa e arrotondamento, se presenti), con tolleranza di ±1 euro (00422).

Nello schema Imposta e ImportoTotaleDocumento ammettono esattamente due decimali: 8.250 è respinto, 8.25 passa. PrezzoUnitario ne accetta da 2 a 8, la Percentuale di sconto solo 2. L'Agenzia stessa segnala nelle sue FAQ che il 00423 compare spesso con gli sconti quando il sistema di origine lavora con più decimali di quelli previsti dal tracciato. In un convertitore: calcola con tipi decimali (mai float), arrotonda come da specifica e confronta i totali ricostruiti con quelli del documento sorgente.

Aliquote e Natura. AliquotaIVA va scritta come 22.00, non 22 e non 0.22. Attenzione: 0.22 è valido per l'XSD, perché ha due decimali, ma non è «in termini percentuali» e lo SdI risponde 00424. Con aliquota 0.00 serve la Natura (00400), con aliquota diversa da zero non va messa (00401). I codici generici N2, N3 e N6 non sono più ammessi come natura dell'operazione (controllo 00445), ma l'XSD li accetta ancora: serve il sottocodice (per esempio N2.2).

Codice destinatario e PEC. Il CodiceDestinatario ha 7 caratteri per i privati (FPR12) e 6 per la PA. 0000000 si usa quando il destinatario riceve via PEC indicata in PECDestinatario o quando non si conosce il canale. XXXXXXX è solo per soggetti non residenti: con un IdPaese italiano del cessionario viene scartato con 00313. Un codice a 6 caratteri in una fattura FPR12 supera l'XSD (che accetta 6–7 caratteri) ma fa scattare il 00427.

Partita IVA e codice fiscale. L'esistenza la verifica lo SdI (00300, 00301, 00305), non lo schema. Dal PDF possono arrivare spazi, prefissi «IT» ripetuti o zeri persi: normalizza prima di scrivere IdCodice.

Ordine degli elementi. Lo schema è una sequenza: mettere PrezzoUnitario prima di Quantita produce un errore (Element 'Quantita': This element is not expected). Se generi l'XML da un dizionario, non dare per scontato l'ordine delle chiavi.

Encoding e caratteri. Le descrizioni ammettono solo caratteri Basic Latin e Latin-1 Supplement: è, à passano, mentre il trattino lungo – e il simbolo €, comunissimi nel testo copiato da un PDF, vengono respinti dall'XSD. Sostituiscili prima di scrivere. Anche Numero è limitato a 20 caratteri Basic Latin.

Numero e duplicati. Il numero deve avere almeno una cifra (00425). Ritrasmettere lo stesso numero è un problema solo se la fattura precedente non è stata scartata (00404): dopo uno scarto, la stessa fattura corretta può essere inviata di nuovo con lo stesso numero.

Dimensioni e nome file. Il singolo file fattura non può superare 5 MB. Il nome segue IdPaese + codice trasmittente, underscore, progressivo alfanumerico di massimo 5 caratteri, ad esempio IT01234567890_00001.xml.

Un frammento corretto

Il blocco righe e riepilogo di una fattura TD01 con due aliquote (22% e operazione con natura N2.2). Ho validato il file completo da cui è estratto sull'XSD 1.2.3 con libxml2: l'esito riguarda solo lo schema. I controlli di contenuto dello SdI (anagrafe, destinatario) non si possono riprodurre in locale, e i dati sono inventati.

<DatiBeniServizi>
  <DettaglioLinee>
    <NumeroLinea>1</NumeroLinea>
    <Descrizione>Consulenza tecnica</Descrizione>
    <Quantita>3.00</Quantita>
    <UnitaMisura>ore</UnitaMisura>
    <PrezzoUnitario>12.50</PrezzoUnitario>
    <PrezzoTotale>37.50</PrezzoTotale>
    <AliquotaIVA>22.00</AliquotaIVA>
  </DettaglioLinee>
  <DettaglioLinee>
    <NumeroLinea>2</NumeroLinea>
    <Descrizione>Rimborso spese documentate</Descrizione>
    <PrezzoUnitario>100.00</PrezzoUnitario>
    <PrezzoTotale>100.00</PrezzoTotale>
    <AliquotaIVA>0.00</AliquotaIVA>
    <Natura>N2.2</Natura>
  </DettaglioLinee>
  <DatiRiepilogo>
    <AliquotaIVA>22.00</AliquotaIVA>
    <ImponibileImporto>37.50</ImponibileImporto>
    <Imposta>8.25</Imposta>
    <EsigibilitaIVA>I</EsigibilitaIVA>
  </DatiRiepilogo>
  <DatiRiepilogo>
    <AliquotaIVA>0.00</AliquotaIVA>
    <Natura>N2.2</Natura>
    <ImponibileImporto>100.00</ImponibileImporto>
    <Imposta>0.00</Imposta>
    <RiferimentoNormativo>Esempio di riferimento normativo</RiferimentoNormativo>
  </DatiRiepilogo>
</DatiBeniServizi>

Per validare in locale basta qualche riga (serve lo schema scaricato dal sito dell'Agenzia):

from lxml import etree

schema = etree.XMLSchema(etree.parse("Schema_VFPR12_v1.2.3.xsd"))
doc = etree.parse("fattura.xml")
if not schema.validate(doc):
    for e in schema.error_log:
        print(e.line, e.message)

Nota: lo schema importa lo schema xmldsig del W3C; se la rete non è disponibile, scaricane una copia e sostituisci il percorso nell'import.

Checklist finale

Date in formato AAAA-MM-GG, non successive all'invio.
Importi con punto decimale, due decimali dove richiesto; calcoli con tipi decimali.
Ricalcola PrezzoTotale, Imposta e ImponibileImporto e verifica le tolleranze prima di scrivere.
AliquotaIVA in percentuale (22.00); Natura solo con aliquota zero, e mai N2, N3 o N6 generici.
CodiceDestinatario di 7 caratteri per FPR12; 0000000 con PECDestinatario; XXXXXXX solo per non residenti.
Partita IVA e codice fiscale normalizzati; almeno uno dei due per il cessionario.
Elementi nell'ordine dello schema.
Testo ripulito dai caratteri fuori da Basic Latin e Latin-1 (trattini lunghi, €).
Numero con almeno una cifra, massimo 20 caratteri; file sotto 5 MB; nome file corretto.
Validazione sull'XSD ufficiale aggiornato alla versione in vigore, a ogni cambio di specifiche.

Per approfondire

Se ti serve generare questi file da documenti esistenti, qui trovi come funziona un convertitore da PDF a XML per la fattura elettronica; il quadro generale è nella pagina sulla fatturazione elettronica. S-Data sviluppa convertitori su misura: se il tuo caso non rientra negli strumenti già pronti, se ne può parlare.

Fonti ufficiali

Allegato A – Specifiche tecniche 1.9.1 (Agenzia delle Entrate)
Elenco dei controlli, versione 2.0 (fatturapa.gov.it)
Schema VFPR12 1.2.3 (Agenzia delle Entrate)
Controlli SdI / motivi di errore (FAQ)

Software su misura o pacchetto: come decidere (e come fare il conto su 3-5 anni)

S-Data — Tue, 27 Oct 2026 12:56:38 +0000

La domanda «meglio su misura o a pacchetto?» ha una risposta onesta in due righe, e va detto subito: se il pacchetto ti basta, è la scelta giusta.

Il pacchetto basta quando siete in pochi e il vostro modo di lavorare è standard. Il primo anno costa quasi sempre meno.
Il su misura conviene quando il vostro processo è diverso da quello che il pacchetto prevede, o quando oggi lavorate tra Excel, email e doppie digitazioni.

Il resto di questo articolo serve a capire in quale dei due casi sei.

Cinque domande da farsi prima di decidere

Quante persone useranno il software e per quanti anni? Più sono, e più a lungo lo usate, più pesa il costo ricorrente.
Il mio processo entra nel pacchetto senza trucchi, o devo adattarmi io? Se serve un foglio Excel accanto al gestionale per fare la parte che il gestionale non fa, la risposta è già un'altra.
Quanto tempo a settimana si perde tra Excel, email e doppie digitazioni? Moltiplicalo per le persone coinvolte: è il costo nascosto del «ci arrangiamo».
Quali sistemi deve collegare? Contabilità, ERP, CRM, e-commerce, banca, corrieri. Un pacchetto collega quello che il produttore ha previsto.
Cosa succede ai dati e al software se smetto di pagare o cambio fornitore? Con un abbonamento, se smetti di pagare smetti di usarlo: controlla le condizioni di esportazione dei dati.

Il confronto, punto per punto

Criterio	Pacchetto in abbonamento	Su misura
Come si lavora	ti adatti tu al programma	il programma segue le tue fasi, documenti e ruoli
Costo iniziale	più basso	più alto: si paga lo sviluppo, meglio se per fasi
Costo nel tempo	canone mensile, di solito per utente	hosting ed eventuale assistenza
Se aumentano le persone	il costo cresce a ogni utente	dipende dal contratto: chiedi se ci sono licenze per utente
Moduli	paghi anche quelli che non usi	solo quelli che servono, aggiunti quando servono
Integrazioni	quelle previste dal produttore	API, database o file verso i sistemi che già usi
Dati e proprietà	legati alla piattaforma	sotto il tuo controllo; codice su repository se previsto

Il confronto è generale: ogni prodotto ha le sue condizioni, quindi controlla quelle del pacchetto che stai valutando.

Una terza strada: tenere il pacchetto e aggiungere il pezzo che manca

Non è una scelta tutto o niente. La contabilità, l'ERP o l'e-commerce che usi oggi possono restare al loro posto: un modulo su misura si collega a loro via API, database o file e copre solo la parte che il pacchetto non copre. Si parte dal processo che oggi ti fa perdere più tempo, lo metti in uso e decidi cosa aggiungere guardando come funziona.

Il conto su 3-5 anni (con un po' di codice)

Il confronto onesto non si fa sul primo anno. Per ogni opzione somma tutto quello che pagherai nell'orizzonte che ti interessa:

def costo_pacchetto(canone_mensile_utente, utenti, anni, extra_a_pagamento=0.0):
    """Canone per utente x utenti x 12 mesi x anni, più moduli/personalizzazioni a pagamento."""
    return canone_mensile_utente * utenti * 12 * anni + extra_a_pagamento


def costo_su_misura(sviluppo, anni, hosting_annuo=0.0, manutenzione_pct=0.0, licenze_terzi_annue=0.0):
    """Sviluppo una tantum più costi ricorrenti. manutenzione_pct è una frazione (0.15 = 15%)."""
    ricorrenti = hosting_annuo + sviluppo * manutenzione_pct + licenze_terzi_annue
    return sviluppo + ricorrenti * anni

Come input usa numeri tuoi o preventivi veri: il canone per utente del pacchetto che stai valutando, il numero di persone, le cifre scritte nei preventivi. Per la manutenzione, le software house che la dichiarano pubblicamente indicano tra il 12% e il 20% annuo del valore sviluppato; molte la rendono facoltativa, quindi chiedilo esplicitamente. Poi confronta costo_pacchetto(...) e costo_su_misura(...) a 3 e a 5 anni, e guarda in quale anno le due curve si incrociano (se si incrociano).

Una regola pratica che ne discende: più sono gli utenti e più a lungo userai il programma, prima il su misura va in pari. Con pochi utenti e un processo standard, il pacchetto resta spesso più conveniente.

Come tenere il costo sotto controllo, se scegli il su misura

Perimetro scritto prima di iniziare: cosa fa il software e cosa resta fuori.
Parti da un modulo, quello che oggi ti costa più tempo.
Paga a fasi, man mano che il software entra in uso.
Chiedi per iscritto cosa è compreso e cosa no: hosting, licenze di terzi, funzioni dopo l'avvio, assistenza.

Quanto costa il su misura

Per le fasce di prezzo pubblicate dal mercato e per le voci che muovono il costo c'è la guida Quanto costa un software gestionale su misura. Il confronto qui sopra è pensato per decidere, non per vendere: se dopo le cinque domande il pacchetto ti basta, prendi il pacchetto.

S-Data è una software house che sviluppa gestionali su misura dal 2007, quindi ha un interesse nella scelta: ho provato a scrivere il confronto in modo che regga anche per chi sceglie l'altra strada.

Cosa pesa davvero sul costo di un gestionale su misura (dati 2026)

S-Data — Tue, 27 Oct 2026 12:56:10 +0000

Chi deve far costruire un gestionale per la propria azienda si scontra quasi sempre con la stessa risposta: «dipende». È vero, ma si può dire qualcosa di più preciso. Ho messo insieme i prezzi che dodici software house e professionisti italiani pubblicano sui loro siti (rilevazione del 22 ottobre 2026) e li ho tenuti separati da qualsiasi stima mia. Qui sotto trovi cosa dicono, cosa non dicono e quali sono le voci che spostano davvero il costo.

Cosa dicono i prezzi pubblicati

Nove delle dodici fonti pubblicano cifre per almeno due fasce di progetto e sono entrate nel calcolo. Mediane dei prezzi dichiarati, IVA esclusa:

Fascia	Mediana dei minimi	Mediana dei massimi
Piccolo progetto o primo modulo	5.000 €	13.500 €
Gestionale con più moduli collegati	15.000 €	22.000 €
Gestionale completo / ERP	37.500 €	40.000 € (molte fonti scrivono «oltre»)

Se si guardano solo le cinque software house che si rivolgono esplicitamente alle PMI (classificazione mia, per come si presentano sui loro siti) le fasce scendono: 3.100–8.000 € per il piccolo, 8.000–20.000 € per il medio, 18.000–40.000 € per il grande. Le agenzie orientate a clienti più grandi pubblicano cifre molto più alte in tutte le fasce.

Tre cose da non dimenticare quando leggi quella tabella

Sono prezzi pubblicati, non preventivi chiusi. Un preventivo reale può essere più alto o più basso.
Il campione è piccolo e non è casuale. Sono le pagine che una ricerca sul web mostra, scritte da chi vende il servizio.
«Piccolo», «medio» e «grande» non significano la stessa cosa per tutti. Alcune cifre sono per modulo, altre per reparto, altre per un verticale. Dove una fonte scrive «oltre X» ho usato X come minimo e nessun massimo, quindi le mediane dei massimi per i progetti grandi si basano su meno fonti.

Un conflitto di interessi va detto: scrivo per una software house che sviluppa gestionali su misura. Per questo le nostre fasce non sono nei dati e non entrano in nessun calcolo.

Cosa muove davvero il costo

Due gestionali che sulla carta sembrano uguali possono costare uno il doppio dell'altro. Nella nostra esperienza la differenza sta quasi sempre in cinque voci, e nessuna è «il numero di schermate»:

Quanti processi copre. Un'attività sola (per esempio i preventivi) oppure più reparti che si passano il lavoro. Ogni processo in più porta regole, schermate e test.
Quanti sistemi deve collegare. Contabilità, ERP, CRM, e-commerce, banca, corrieri. Spesso è la voce che pesa di più, soprattutto se il programma da collegare è vecchio o chiuso, senza API.
Ruoli e permessi. Chi vede cosa, chi modifica, chi approva. Cinque persone con compiti molto diversi possono costare più lavoro di cinquanta che fanno la stessa cosa.
Dati da recuperare. Partire da zero è semplice. Portare anni di anagrafiche e storico da Excel o dal vecchio gestionale richiede pulizia, regole di deduplica e controlli con chi quei dati li conosce.
Regole del lavoro. Listini per cliente, calcoli, scadenze, passaggi di approvazione. È la parte che si vede meno ed è quella che fa la differenza tra un programma generico e uno utile.

Da dove nascono le cifre: le tariffe a giornata

Un preventivo è, in buona parte, giornate di lavoro moltiplicate per una tariffa. Le fonti pubbliche che ho trovato:

Assintel Report 2025, riportato da Buspa (indagine su 346 PMI ICT, dati 2024): programmatore 347 €/giorno, analista circa 420, capoprogetto circa 480, consulente 540.
Zornade: freelance e piccole strutture 250–400 €/giorno; software house strutturate 400–700 €.

A titolo di sola aritmetica: a 347 €/giorno, 5.000 € corrispondono a circa 14 giornate di un programmatore. Non è un preventivo, serve per capire cosa può starci dentro un «piccolo progetto».

La manutenzione: quanto chiedono

Tra le fonti che la indicano, la manutenzione annua è dichiarata tra il 12% e il 20% del valore sviluppato (LEMIO 12–18%, SicDev 15–20%, Sydus 15–20%). Altre fonti non la indicano o parlano di supporto incluso per alcuni mesi.

Come confrontare due preventivi

Prima di confrontare due cifre, confronta cosa c'è dentro:

c'è un perimetro scritto (cosa fa il software e cosa resta fuori)?
si paga a milestone o tutto all'inizio?
hosting, server e licenze di terzi sono nel prezzo o a parte?
l'import dei dati è compreso, e quali dati?
cosa costano le funzioni chieste dopo l'avvio?
la manutenzione è obbligatoria o facoltativa, e in che percentuale?
chi ha il controllo di codice e dati se cambi fornitore?

Il rischio vero non è il prezzo iniziale, ma un progetto che cresce senza controllo. Un perimetro scritto e un primo modulo da mettere in uso subito sono le due difese più semplici.

Dati e fonti

Tabella completa, fonti una per una (con link alle pagine lette), metodo e limiti sono nell'Osservatorio prezzi del gestionale su misura 2026. Il CSV è anche su GitHub, con uno script che ricalcola le mediane: S-Data-IT/osservatorio-prezzi-gestionale-italia. Licenza CC BY 4.0: puoi riusarli citando la fonte.

Se sei una delle aziende citate e una cifra non è corretta, scrivi a info@s-data.it e la correggiamo.