Flowie
Riferimento API

I formati di fatturazione elettronica

Un formato di fatturazione elettronica è la struttura leggibile da una macchina in cui viaggia una fattura — non il PDF di una fattura, ma la fattura stessa come dati che il sistema dell'acquirente può registrare senza reinserimento. In Europa contano solo due sintassi XML (UBL 2.1 e UN/CEFACT CII), una norma semantica sopra di esse (EN 16931) e poi una lunga coda di profili nazionaliFactur-X, ZUGFeRD, XRechnung, FatturaPA, Facturae, KSeF FA(3), ZATCA, MyInvois — che vincolano gli stessi dati per l'amministrazione fiscale di un paese. Questa pagina è la mappa completa e dice esattamente quali di essi Flowie produce, accetta e consegna.

Non devi sceglierne uno
Invia la fattura in JSON a POST /v1/documents/send e Flowie genera la sintassi richiesta dalla destinazione — UBL Peppol BIS Billing 3.0 per la rete Peppol, il formato nazionale dove l'amministrazione fiscale ne impone uno. Hai già l'XML? Deposita UBL, CII o un PDF Factur-X: Flowie lo valida e lo instrada così com'è. Il campo format è documentato in cosa gestisce Flowie.

La risposta breve, per paese

Se leggi una sola sezione, leggi questa. Nel 2026 la questione del formato si riduce a quattro casi:

Obblighi, scadenze e rete di ciascun paese sono documentati nella sezione compliance — 47 giurisdizioni, con una matrice di copertura ordinabile per rete.

I quattro livelli: modello, sintassi, profilo, rete

Quasi ogni discussione sui formati di fatturazione elettronica è fatta di due persone che parlano di livelli diversi. Una fattura in rete è la somma di quattro decisioni, e ciascuna è indipendente dalle altre:

LivelloCosa fissaEsempi
1. Modello semantico Quali termini di business esistono e cosa significano — BT-1 è il numero fattura, BT-9 la data di scadenza. Nessuna sintassi. EN 16931, il nucleo semantico di ogni formato europeo
2. Sintassi Come quei termini vengono serializzati in un file che un parser sa leggere. UBL 2.1 (OASIS), UN/CEFACT CII D16B
3. Profilo / CIUS Quali termini opzionali diventano obbligatori, quali liste di codici sono ammesse, quali identificativi nazionali sono richiesti. Un CIUS restringe la EN 16931; una estensione vi aggiunge. Peppol BIS Billing 3.0, XRechnung, il profilo EN 16931 di Factur-X, PINT
4. Rete / trasporto Come il file raggiunge l'acquirente e l'amministrazione fiscale. Peppol AS4 a quattro angoli, il SDI italiano, la PA/PDP francese, il KSeF polacco, Fatoora in Arabia Saudita
«XRechnung è un formato?»
È un profilo (livello 3) trasportabile in entrambe le sintassi (livello 2) e che soddisfa sempre lo stesso modello semantico (livello 1). Per questo una fattura XRechnung e una Peppol BIS possono differire byte per byte pur portando contenuto di business identico — e per questo convertire tra le due è un esercizio di mapping, non di reinserimento. Flowie tiene il modello semantico una volta sola, nel modello dati documento, e genera i livelli sottostanti.

Cosa gestisce Flowie

Due direzioni, un endpoint ciascuna. In uscita, il campo format di POST /v1/documents/send dichiara cosa ci stai consegnando:

formatCosa inviiCosa fa Flowie
json Il modello documento canonico di Flowie nel campo document. Genera UBL 2.1 conforme alla EN 16931 (customization Peppol BIS Billing 3.0), poi lo consegna nel formato nativo della destinazione.
ubl-xml Il tuo XML UBL 2.1 Invoice o CreditNote nel campo xml. Valida contro gli schematron EN 16931 e nazionali, poi instrada. I tuoi byte restano l'originale emesso.
cii-xml XML UN/CEFACT CrossIndustryInvoice — incluso l'XML estratto da un PDF Factur-X o ZUGFeRD. Lo stesso: schematron CII, poi instradamento.
auto Un file in file.content e nessuna opinione al riguardo. Analizza i magic byte e l'elemento radice XML — CrossIndustryInvoice → CII, Invoice/CreditNote → UBL, %PDF → PDF — e sceglie la pipeline. È l'impostazione predefinita sicura.
raw Tutto il resto — un PDF, una scansione, un foglio di calcolo. Lo conserva così com'è: nessun instradamento in rete, nessuna validazione strutturata.
Dichiara il CII come CII
Un deposito Factur-X è CII, non UBL. Dichiarare format: "ubl-xml" gli fa eseguire lo schematron sbagliato e segnala come rotta una fattura perfettamente valida. Nel dubbio usa auto: decide l'elemento radice, e non sbaglia mai.

In entrata, ogni documento ricevuto è disponibile in tre forme dagli endpoint documenti: l'artefatto originale esattamente come lo ha depositato il mittente (il PDF Factur-X, se è quello che ha inviato), l' XML strutturato e il JSON normalizzato che viaggia sui webhook. Non devi mai fare il parsing di una sintassi che non vuoi supportare.

Sul versante francese, il flusso AFNOR XP Z12-013 dichiara esplicitamente la sua sintassi — CII, UBL, Factur-X per le fatture, più CDAR per gli stati del ciclo di vita e FRR per l'e-reporting. Vedi il playbook di integrazione francese.

Catalogo dei formati

Ogni formato di fatturazione elettronica che puoi incontrare, cos'è davvero, dove è richiesto e se Flowie lo gestisce. Clicca su un'intestazione di colonna per ordinare.

Formato Che cos'è Dove conta Flowie Riferimento ufficiale
EN 16931 Modello semantico (non un formato di file) Base europea; ogni profilo europeo ne è un CIUS Nativo Commissione europea
UBL 2.1 Sintassi XML (OASIS) Peppol, Danimarca, Norvegia, Paesi Bassi, Arabia Saudita, Malesia, Turchia Invio & ricezione OASIS UBL 2.1
UN/CEFACT CII (D16B) Sintassi XML (Cross Industry Invoice) Francia, Germania e l'XML dentro ogni PDF Factur-X / ZUGFeRD Invio & ricezione Schemi XML UNECE
Peppol BIS Billing 3.0 CIUS della EN 16931 in UBL 2.1 La rete Peppol — oltre 30 paesi, lo standard di fatto europeo Invio & ricezione OpenPeppol BIS 3.0
Peppol PINT Modello di fatturazione globale + specializzazioni per giurisdizione Australia, Nuova Zelanda, Giappone, Singapore, Emirati Arabi Uniti e il profilo PINT UE Invio & ricezione PINT Billing
Factur-X PDF/A-3 ibrido con XML CII incorporato Francia — il formato che emetterà la maggior parte dei fornitori francesi Invio & ricezione FNFE-MPE
ZUGFeRD Lo stesso standard ibrido, edizione tedesca Germania — B2B, interscambiabile con Factur-X Invio & ricezione FeRD
XRechnung CIUS tedesco della EN 16931 (UBL o CII) Germania — obbligatorio per il B2G federale, molto usato in B2B Invio & ricezione KoSIT / XÖV
FatturaPA Schema XML nazionale italiano (precede la EN 16931) Italia — ogni fattura B2B, B2C e B2G, transitata dal SDI Invio & ricezione Agenzia delle Entrate
Facturae XML nazionale spagnolo, firmato in XAdES Spagna — B2G via FACe, in parallelo al rollout B2B Crea y Crece Invio & ricezione facturae.gob.es
KSeF FA(3) Schema XML nazionale polacco Polonia — clearance B2B obbligatoria tramite KSeF dal 2026 Invio & ricezione Ministerstwo Finansów
ISDOC XML ceco derivato da UBL, in uso dal 2009 Cechia — il settore pubblico accetta ISDOC e Peppol BIS Invio & ricezione Specifica ISDOC
OIOUBL Profilo UBL danese, antecedente a Peppol Danimarca — NemHandel, ERP pubblici storici Invio & ricezione oioubl.info
EHF Profilo norvegese, oggi un sottile strato su Peppol BIS Norvegia — B2G dal 2012 Invio & ricezione DFØ / Anskaffelser
Finvoice Standard XML finlandese guidato dalle banche Finlandia — canali bancari, accanto a Peppol BIS Invio & ricezione Finance Finland
ebInterface Standard XML austriaco Austria — accettato accanto a Peppol BIS sul portale federale Invio & ricezione ebInterface
Fattura ZATCA XML basato su UBL 2.1, con timbro crittografico Arabia Saudita — clearance e reporting Fatoora Invio & ricezione ZATCA
MyInvois UBL 2.1 in XML o JSON Malesia — clearance LHDN, a scaglioni di fatturato Invio & ricezione SDK MyInvois
Fattura GST (INV-01) Schema JSON registrato presso un IRP per ottenere un IRN India — B2B sopra la soglia di fatturato Invio & ricezione Portale GST e-Invoice
Fattura ETA JSON/XML inviato all'amministrazione fiscale Egitto — clearance B2B/B2G universale Invio & ricezione Egyptian Tax Authority
UBL-TR (e-Fatura) Customization turca di UBL 2.1 Türkiye — e-Fatura ed e-Arşiv Invio & ricezione GİB e-Fatura
UN/EDIFACT INVOIC Messaggio EDI pre-XML Filiere della distribuzione, dell'automotive e della logistica Su richiesta UNECE EDIFACT
PDF / scansione Non è un formato di fatturazione elettronica In nessun luogo, giuridicamente, una volta in vigore un obbligo Conservato così com'è

Invio & ricezione significa che Flowie genera il formato in uscita e lo normalizza in entrata — tu lavori in JSON e non tocchi mai lo schema. Il dettaglio paese per paese, incluso quale rete porta quale formato, è nella matrice di copertura.

EN 16931 — la norma semantica europea

La EN 16931 non è un formato di file. È il modello semantico dei dati che dice cosa contiene una fattura: 164 termini di business (BT-1…) raggruppati in gruppi di business (BG-1…), più circa 200 regole che stabiliscono quando ciascuno è obbligatorio e come devono tornare i totali. Ogni formato europeo di fatturazione elettronica è un vincolo su di essa.

Esiste grazie alla direttiva UE 2014/55/UE, che ha obbligato gli acquirenti pubblici dell'Unione ad accettare fatture elettroniche in una norma comune. La EN 16931-1:2026 è stata pubblicata a maggio 2026 e ha ritirato formalmente l'edizione 2017, con un periodo di migrazione mentre i profili si adeguano — quindi un documento che valida contro uno schematron di generazione 2017 continuerà a validare, e il cambiamento concreto arriverà quando ogni profilo nazionale si ripubblicherà sulla nuova edizione.

La specifica tecnica complementare CEN/TS 16931-2 elenca le sintassi conformi, e sono esattamente due: UBL 2.1 e UN/CEFACT CII. Tutto il resto, in Europa, è un profilo di una delle due.

Flowie espone il modello direttamente: il referenziale dei termini di business elenca tutti i 164 BT, a cosa corrisponde ciascuno in UBL e in CII e quali la Francia richiede in più. Gli errori di validazione tornano indicando il termine di business, non lo step di schematron — vedi il catalogo degli errori.

UBL 2.1 — la sintassi XML che parla la maggior parte delle reti

UBL (Universal Business Language) 2.1 è uno standard OASIS che definisce schemi XML per l'intera catena degli acquisti — ordini, avvisi di spedizione, fatture, note di credito. I suoi documenti Invoice e CreditNote sono una delle due sintassi conformi alla EN 16931, e quella scelta dalla rete Peppol.

Una fattura UBL EN 16931 dichiara il proprio profilo in due elementi in testa al documento:

<cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID>
<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>

CustomizationID è il profilo — il CIUS che il documento dichiara di soddisfare. ProfileID è il processo di business a cui appartiene. Sbaglia uno dei due e un access point conforme rifiuterà il documento prima che un umano lo veda. Flowie li scrive per te quando invii format: "json", e li valida quando depositi il tuo XML.

UBL è anche la base di diversi formati nazionali precedenti alla norma europea o che la estendono — OIOUBL (Danimarca), ISDOC (Cechia), UBL-TR (Türkiye), ZATCA (Arabia Saudita) e MyInvois (Malesia).

UN/CEFACT CII — l'altra sintassi conforme

Il CII (Cross Industry Invoice) è la sintassi XML di UN/CEFACT, standardizzata nella release di schemi D16B. Il suo elemento radice è rsm:CrossIndustryInvoice e porta gli stessi termini di business EN 16931 dell'UBL in un albero diverso: tre sezioni di primo livello (ExchangedDocument, SupplyChainTradeTransaction e il contesto di intestazione) invece della struttura più piatta dell'UBL.

Il CII conta molto più di quanto la sua quota di mercato suggerisca, perché è l'XML incorporato in ogni PDF Factur-X e ZUGFeRD — il che ne fa la sintassi dominante in Francia e Germania, i due maggiori mercati della fatturazione elettronica dell'Europa continentale.

Distinguerli in una riga
Leggi l'elemento radice. <rsm:CrossIndustryInvoice> → CII. <Invoice> o <CreditNote> in un namespace UBL → UBL. È esattamente ciò che fa il format: "auto" di Flowie, ed è per questo che è una scelta più sicura che dichiarare la sintassi da soli.

Factur-X & ZUGFeRD — i formati PDF ibridi

Factur-X (Francia) e ZUGFeRD (Germania) sono lo stesso standard pubblicato da due organismi — FNFE-MPE e FeRD — con due nomi. Una fattura Factur-X è un file PDF/A-3 con un allegato XML CII incorporato: un umano apre il PDF e legge una fattura; una macchina apre lo stesso file, ne estrae factur-x.xml e la registra. Un solo artefatto, due destinatari, nessun problema di riconciliazione.

Lo standard definisce una scala di profili, da MINIMUM e BASIC WL (troppo scarni per costituire da soli una fattura legale) passando per BASIC ed EN 16931 (il nucleo pienamente conforme) fino a EXTENDED (che aggiunge termini oltre la EN 16931). La riforma B2B francese accetta Factur-X dal profilo EN 16931 in su.

Flowie tratta il PDF come l'originale: deposita un Factur-X e il CII incorporato viene estratto, mappato e validato, mentre il PDF che hai inviato resta l'artefatto restituito come documento originale — ciò che la norma AFNOR XP Z12-013 richiede a un emittente francese, e ciò che chiederà un revisore. Vedi la panoramica Francia e la pagina Germania per i due obblighi.

Peppol BIS Billing 3.0 e PINT

Peppol BIS Billing 3.0 è un CIUS della EN 16931 espresso in UBL 2.1, ed è il profilo di fatturazione elettronica più diffuso in Europa. È ciò che viaggia sul modello a quattro angoli della rete Peppol: tu invii al tuo access point, il tuo access point consegna a quello del destinatario e una consultazione SMP risolve di chi si tratta. Flowie è un access point, quindi inviare è una sola chiamata API.

PINT (Peppol International) è la generalizzazione globale più recente: un modello di fatturazione comune che ogni giurisdizione specializza invece di forkare. Specializzazioni PINT sono attive o in arrivo in Australia e Nuova Zelanda (PINT A-NZ), in Giappone (JP PINT), a Singapore (InvoiceNow), negli Emirati Arabi Uniti (PINT AE, su un modello a cinque angoli che aggiunge l'amministrazione fiscale come angolo) — e nell'UE, come PINT EU, il profilo successore di BIS Billing 3.0.

La raggiungibilità è per tipo di documento
Un destinatario registrato su Peppol dichiara quali tipi di documento accetta. Prima di inviare, interroga POST /v1/directory/verify con il tipo che invierai davvero: un partecipante raggiungibile per le fatture non lo è automaticamente per le note di credito o gli ordini.

Formati nazionali europei e CIUS

La maggior parte dei paesi UE usa Peppol BIS così com'è o lo restringe con un CIUS nazionale. Alcuni gestiscono formati che precedono la norma europea e sono tuttora giuridicamente richiesti.

XRechnung (Germania)

Il CIUS tedesco della EN 16931, mantenuto da KoSIT. Obbligatorio per le fatture agli acquirenti pubblici federali e profilo di riferimento dell'obbligo B2B che entra in vigore per fasi fino al 2028. XRechnung può essere trasportato sia in UBL sia in CII e aggiunge specificità tedesche — instradamento tramite Leitweg-ID, contatti dell'acquirente obbligatori. Dettagli sulla pagina Germania.

FatturaPA (Italia)

Lo schema XML nazionale italiano, transitato dal Sistema di Interscambio (SDI) per ogni fattura B2B, B2C e B2G. Precede la EN 16931 e non ne è un CIUS: ha nomi di elementi propri, propri codici TipoDocumento (TD01–TD29) e propri messaggi di ritorno (esiti) che arrivano in modo asincrono dopo l'invio. Flowie mappa il modello canonico su di esso ed espone gli esiti come eventi di ciclo di vita — vedi la panoramica Italia e l'esploratore TD.

Il resto, in breve

Formati di clearance e reporting fuori dall'UE

Fuori dall'Europa il modello dominante è la clearance: la fattura è inviata all'amministrazione fiscale e diventa valida solo quando torna timbrata, numerata o firmata. Il formato è quello che dice lo schema di quella piattaforma, e raramente è EN 16931.

Il lavoro di Flowie è lo stesso in ogni caso: tu invii il JSON canonico e il connettore paese genera lo schema della piattaforma, lo invia e riporta l'esito come eventi di ciclo di vita a cui puoi abbonarti. Ciò che cambia è quando la fattura diventa giuridicamente valida — motivo per cui in un paese a clearance è l'endpoint del ciclo di vita, e non la risposta all'invio, la cosa da osservare.

L'EDI storico, e perché un PDF non è una fattura elettronica

UN/EDIFACT INVOIC e ANSI X12 810 sono i messaggi di fattura EDI pre-XML, che muovono ancora volumi enormi nella distribuzione, nell'automotive e nella logistica. Sono strutturati e leggibili da una macchina, quindi risolvono lo stesso problema — ma non sono sintassi EN 16931, e un obbligo che nomina UBL o CII non li accetterà. Fare da ponte è un progetto di mapping: parlane con noi se hai una dorsale EDI da preservare.

Una fattura PDF, anche inviata via e-mail, non è una fattura elettronica ai sensi degli obblighi attuali — e nemmeno una scansione o un foglio di calcolo. Il criterio che ogni norma applica è se la fattura possa essere elaborata automaticamente senza reinserimento, cosa che un PDF piatto non consente. È l'equivoco più diffuso nei progetti di fatturazione elettronica, ed è la ragione per cui esiste Factur-X: tenere in un unico file il PDF che voleva un umano e i dati che la norma richiede. Flowie conserverà volentieri un PDF piatto con format: "raw" — semplicemente non lo instraderà come fattura conforme.

Quale formato devo inviare?

Domande frequenti

Qual è la differenza tra UBL e CII?

Sono due sintassi XML per lo stesso contenuto semantico. UBL 2.1 è uno standard OASIS usato da Peppol e dalla maggior parte delle reti nordeuropee; UN/CEFACT CII è usato in Francia e Germania ed è l'XML incorporato nei PDF Factur-X e ZUGFeRD. La CEN/TS 16931-2 riconosce entrambe come conformi alla EN 16931, quindi una fattura passa dall'una all'altra senza perdere contenuto di business. L'elemento radice le distingue: CrossIndustryInvoice per il CII, Invoice o CreditNote per l'UBL.

Factur-X e ZUGFeRD sono la stessa cosa?

Sì — tecnicamente lo stesso standard ibrido PDF/A-3, pubblicato congiuntamente da FNFE-MPE in Francia e FeRD in Germania con due nomi. Un file ZUGFeRD è un file Factur-X valido e viceversa, allo stesso livello di profilo. I nomi differiscono per ragioni di governance e di mercato, non tecniche.

XRechnung è un formato Peppol?

No. XRechnung è un CIUS tedesco della EN 16931; Peppol BIS Billing 3.0 è il CIUS di OpenPeppol della stessa norma. I documenti XRechnung viaggiano spesso sulla rete Peppol, da cui la confusione, ma sono profili diversi con campi obbligatori diversi — in particolare il Leitweg-ID tedesco.

Una fattura PDF è una fattura elettronica?

No. Ai sensi della direttiva UE 2014/55/UE e degli obblighi nazionali che ne discendono, una fattura elettronica deve essere emessa, trasmessa e ricevuta in un formato strutturato che consenta l'elaborazione automatica. Un PDF — o una scansione, o un'immagine inviata via e-mail — non basta, comunque sia stato prodotto. Un PDF ibrido Factur-X/ZUGFeRD sì, perché l'XML strutturato viaggia al suo interno.

Devo convertire io le fatture?

No. Invia il modello JSON canonico a POST /v1/documents/send e Flowie produce ciò che la destinazione richiede. La conversione diventa un tuo problema solo se insisti a depositare XML già pronto per un paese di cui non hai implementato il profilo.

La EN 16931-1:2026 rompe la mia integrazione?

Non di per sé. L'edizione 2026 è stata pubblicata a maggio 2026 e ha ritirato formalmente quella del 2017, ma i profili nazionali la adottano con i propri tempi e la validazione continua ad accettare le versioni di profilo correnti durante la migrazione. Ogni cambiamento effettivo è annunciato nel changelog prima di raggiungerti.

Quali formati supporta Flowie?

In ingresso: il modello JSON canonico, UBL 2.1, UN/CEFACT CII e i PDF Factur-X/ZUGFeRD (più qualsiasi file conservato tale e quale con format: "raw"). In uscita: Peppol BIS Billing 3.0 e PINT per la rete Peppol, e il formato nazionale richiesto da ciascuna delle 47 giurisdizioni documentate nella sezione compliance — Factur-X e CII per la Francia, XRechnung e ZUGFeRD per la Germania, FatturaPA per l'Italia, KSeF FA(3) per la Polonia, Facturae per la Spagna, ZATCA per l'Arabia Saudita, MyInvois per la Malesia, e il resto del catalogo qui sopra.

Riferimenti ufficiali

Le fonti primarie, nell'ordine in cui i livelli si impilano. Se un profilo nazionale e questa pagina divergono, vince il profilo nazionale — segnalacelo e correggeremo la pagina.

E su questo sito: l'endpoint di invio, il modello documento canonico, tipi di documento e di fattura, 47 guide paese e tutti i 164 termini di business EN 16931.