Flowie
Référence API

Les formats de facturation électronique

Un format de facturation électronique est la structure lisible par une machine dans laquelle circule une facture — non pas le PDF d'une facture, mais la facture elle-même, sous forme de données qu'un système acheteur peut comptabiliser sans ressaisie. Il n'existe en Europe que deux syntaxes XML qui comptent (UBL 2.1 et UN/CEFACT CII), une norme sémantique par-dessus (EN 16931), puis une longue traîne de profils nationauxFactur-X, ZUGFeRD, XRechnung, FatturaPA, Facturae, KSeF FA(3), ZATCA, MyInvois — qui contraignent les mêmes données pour l'administration fiscale d'un pays. Cette page est la carte complète, et dit exactement lesquels Flowie produit, accepte et délivre.

Vous n'avez pas à choisir
Envoyez votre facture en JSON à POST /v1/documents/send et Flowie produit la syntaxe exigée par la destination — de l'UBL Peppol BIS Billing 3.0 pour le réseau Peppol, le format national là où l'administration fiscale en impose un. Vous avez déjà du XML ? Déposez de l'UBL, du CII ou un PDF Factur-X : Flowie le valide et le route tel quel. Le champ format est documenté dans ce que Flowie gère.

La réponse courte, par pays

Si vous ne lisez qu'une section, lisez celle-ci. En 2026, la question du format se ramène à quatre cas :

Les mandats, échéances et réseaux pays par pays sont documentés dans la section conformité — 47 juridictions, avec une matrice de couverture triable par réseau.

Les quatre couches : modèle, syntaxe, profil, réseau

Presque toutes les disputes sur les formats de facturation électronique sont deux personnes qui parlent de couches différentes. Une facture sur le réseau, ce sont quatre décisions empilées, et chacune est indépendante des autres :

CoucheCe qu'elle fixeExemples
1. Modèle sémantique Quels termes métier existent et ce qu'ils signifient — BT-1 est le numéro de facture, BT-9 la date d'échéance. Aucune syntaxe. EN 16931, le cœur sémantique de tous les formats européens
2. Syntaxe Comment ces termes sont sérialisés dans un fichier qu'un parseur sait lire. UBL 2.1 (OASIS), UN/CEFACT CII D16B
3. Profil / CIUS Quels termes optionnels deviennent obligatoires, quelles listes de codes sont admises, quels identifiants nationaux sont exigés. Un CIUS restreint l'EN 16931 ; une extension y ajoute. Peppol BIS Billing 3.0, XRechnung, le profil EN 16931 de Factur-X, PINT
4. Réseau / transport Comment le fichier atteint l'acheteur et l'administration fiscale. Peppol AS4 en 4 coins, le SDI italien, la PA/PDP française, le KSeF polonais, Fatoora en Arabie saoudite
« XRechnung est-il un format ? »
C'est un profil (couche 3), transportable dans l'une ou l'autre syntaxe (couche 2), et qui satisfait toujours le même modèle sémantique (couche 1). C'est pourquoi une facture XRechnung et une facture Peppol BIS peuvent différer octet pour octet tout en portant un contenu métier identique — et pourquoi passer de l'une à l'autre est un exercice de mapping, pas de ressaisie. Flowie tient le modèle sémantique une seule fois, dans le modèle de données document, et produit les couches inférieures.

Ce que Flowie gère

Deux directions, un endpoint chacune. À l'émission, le champ format de POST /v1/documents/send déclare ce que vous nous confiez :

formatCe que vous envoyezCe que fait Flowie
json Le modèle document canonique de Flowie dans le champ document. Produit de l'UBL 2.1 conforme à l'EN 16931 (customisation Peppol BIS Billing 3.0), puis le délivre dans le format natif de la destination.
ubl-xml Votre propre XML UBL 2.1 Invoice ou CreditNote dans xml. Valide contre les schematrons EN 16931 et nationaux, puis route. Vos octets restent l'original émis.
cii-xml Du XML UN/CEFACT CrossIndustryInvoice — y compris le XML extrait d'un PDF Factur-X ou ZUGFeRD. Pareil : schematrons CII, puis routage.
auto Un fichier dans file.content, sans opinion sur son contenu. Renifle les octets magiques et l'élément racine XML — CrossIndustryInvoice → CII, Invoice/CreditNote → UBL, %PDF → PDF — et choisit le pipeline. C'est la valeur par défaut sûre.
raw Tout le reste — un PDF, un scan, un tableur. Le stocke tel quel : pas de routage réseau, pas de validation structurée.
Annoncez le CII comme du CII
Un dépôt Factur-X, c'est du CII, pas de l'UBL. Déclarer format: "ubl-xml" pour lui fait tourner le mauvais schematron et signale comme cassée une facture parfaitement valide. Dans le doute, utilisez auto — c'est l'élément racine qui tranche, et il ne se trompe jamais.

À la réception, chaque document est disponible sous trois formes depuis les endpoints documents : l'artefact original tel que l'émetteur l'a déposé (le PDF Factur-X, si c'est ce qu'il a envoyé), le XML structuré, et le JSON normalisé que portent les webhooks. Vous n'avez jamais à parser une syntaxe que vous ne voulez pas supporter.

Sur le volet français, le flux AFNOR XP Z12-013 déclare explicitement sa syntaxe — CII, UBL, Factur-X pour les factures, plus CDAR pour les statuts du cycle de vie et FRR pour l'e-reporting. Voir le playbook d'intégration français.

Catalogue des formats

Tous les formats de facturation électronique que vous risquez de croiser, ce qu'ils sont vraiment, où ils sont exigés, et si Flowie les gère. Cliquez sur un en-tête de colonne pour trier.

Format Ce que c'est Où ça compte Flowie Référence officielle
EN 16931 Modèle sémantique (pas un format de fichier) Socle européen ; tout profil européen en est un CIUS Natif Commission européenne
UBL 2.1 Syntaxe XML (OASIS) Peppol, Danemark, Norvège, Pays-Bas, Arabie saoudite, Malaisie, Turquie Émission & réception OASIS UBL 2.1
UN/CEFACT CII (D16B) Syntaxe XML (Cross Industry Invoice) France, Allemagne, et le XML dans tout PDF Factur-X / ZUGFeRD Émission & réception Schémas XML UNECE
Peppol BIS Billing 3.0 CIUS de l'EN 16931 en UBL 2.1 Le réseau Peppol — plus de 30 pays, le défaut européen Émission & réception OpenPeppol BIS 3.0
Peppol PINT Modèle de facturation mondial + spécialisations par juridiction Australie, Nouvelle-Zélande, Japon, Singapour, Émirats arabes unis, et le profil PINT UE Émission & réception PINT Billing
Factur-X PDF/A-3 hybride avec XML CII embarqué France — le format que la plupart des fournisseurs français émettront Émission & réception FNFE-MPE
ZUGFeRD La même norme hybride, édition allemande Allemagne — B2B, interchangeable avec Factur-X Émission & réception FeRD
XRechnung CIUS allemand de l'EN 16931 (UBL ou CII) Allemagne — obligatoire pour le B2G fédéral, très utilisé en B2B Émission & réception KoSIT / XÖV
FatturaPA Schéma XML national italien (antérieur à l'EN 16931) Italie — toute facture B2B, B2C et B2G, dédouanée par le SDI Émission & réception Agenzia delle Entrate
Facturae XML national espagnol, signé en XAdES Espagne — B2G via FACe, en parallèle du déploiement B2B Crea y Crece Émission & réception facturae.gob.es
KSeF FA(3) Schéma XML national polonais Pologne — clearance B2B obligatoire via KSeF à partir de 2026 Émission & réception Ministerstwo Finansów
ISDOC XML tchèque dérivé d'UBL, en service depuis 2009 Tchéquie — le secteur public accepte ISDOC et Peppol BIS Émission & réception Spécification ISDOC
OIOUBL Profil UBL danois, antérieur à Peppol Danemark — NemHandel, ERP publics historiques Émission & réception oioubl.info
EHF Profil norvégien, aujourd'hui une fine couche sur Peppol BIS Norvège — B2G depuis 2012 Émission & réception DFØ / Anskaffelser
Finvoice Standard XML finlandais porté par les banques Finlande — canaux bancaires, aux côtés de Peppol BIS Émission & réception Finance Finland
ebInterface Standard XML autrichien Autriche — accepté à côté de Peppol BIS sur le portail fédéral Émission & réception ebInterface
Facture ZATCA XML fondé sur UBL 2.1, tamponné cryptographiquement Arabie saoudite — clearance et reporting Fatoora Émission & réception ZATCA
MyInvois UBL 2.1 en XML ou JSON Malaisie — clearance LHDN, par paliers de chiffre d'affaires Émission & réception SDK MyInvois
Facture GST (INV-01) Schéma JSON enregistré auprès d'un IRP pour obtenir un IRN Inde — B2B au-dessus du seuil de chiffre d'affaires Émission & réception Portail GST e-Invoice
Facture ETA JSON/XML soumis à l'administration fiscale Égypte — clearance B2B/B2G universelle Émission & réception Egyptian Tax Authority
UBL-TR (e-Fatura) Customisation turque d'UBL 2.1 Türkiye — e-Fatura et e-Arşiv Émission & réception GİB e-Fatura
UN/EDIFACT INVOIC Message EDI pré-XML Chaînes d'approvisionnement de la distribution, de l'automobile et de la logistique Sur demande UNECE EDIFACT
PDF / scan Pas un format de facturation électronique Nulle part, juridiquement, dès qu'un mandat est en vigueur Stocké tel quel

Émission & réception signifie que Flowie produit le format à l'aller et le normalise au retour — vous travaillez en JSON et ne touchez jamais au schéma. Le détail pays par pays, y compris quel réseau porte quel format, est dans la matrice de couverture.

EN 16931 — la norme sémantique européenne

L'EN 16931 n'est pas un format de fichier. C'est le modèle sémantique de données qui dit ce que contient une facture : 164 termes métier (BT-1…) regroupés en groupes métier (BG-1…), plus environ 200 règles de gestion qui disent quand chacun est obligatoire et comment les totaux doivent s'additionner. Tout format européen de facturation électronique en est une contrainte.

Elle existe grâce à la directive européenne 2014/55/UE, qui a obligé les acheteurs publics de l'Union à accepter les factures électroniques dans une norme commune. L'EN 16931-1:2026 a été publiée en mai 2026 et a formellement retiré l'édition 2017, avec une période de migration le temps que les profils suivent — un document qui valide contre un schematron de génération 2017 continuera donc de valider, et le changement concret arrivera quand chaque profil national se republiera sur la nouvelle édition.

La spécification technique complémentaire CEN/TS 16931-2 liste les syntaxes qui s'y conforment, et il y en a exactement deux : UBL 2.1 et UN/CEFACT CII. Tout le reste, en Europe, est un profil de l'une des deux.

Flowie expose le modèle directement : le référentiel des termes métier liste les 164 BT, ce à quoi chacun correspond en UBL et en CII, et ceux que la France exige en plus. Les échecs de validation reviennent en nommant le terme métier, pas l'étape de schematron — voir le catalogue d'erreurs.

UBL 2.1 — la syntaxe XML que parlent la plupart des réseaux

UBL (Universal Business Language) 2.1 est une norme OASIS qui définit des schémas XML pour toute la chaîne achats — commandes, avis d'expédition, factures, avoirs. Ses documents Invoice et CreditNote sont l'une des deux syntaxes conformes à l'EN 16931, et celle qu'a retenue le réseau Peppol.

Une facture UBL EN 16931 annonce son profil dans deux éléments en tête de document :

<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 est le profil — le CIUS que le document prétend satisfaire. ProfileID est le processus métier auquel il appartient. Trompez-vous sur l'un ou l'autre et un point d'accès conforme rejettera le document avant qu'un humain ne le voie. Flowie écrit les deux pour vous quand vous envoyez format: "json", et les valide quand vous déposez votre propre XML.

UBL sert aussi de base à plusieurs formats nationaux antérieurs à la norme européenne ou qui l'étendent — OIOUBL (Danemark), ISDOC (Tchéquie), UBL-TR (Türkiye), ZATCA (Arabie saoudite) et MyInvois (Malaisie).

UN/CEFACT CII — l'autre syntaxe conforme

Le CII (Cross Industry Invoice) est la syntaxe XML d'UN/CEFACT, normalisée dans la publication de schémas D16B. Son élément racine est rsm:CrossIndustryInvoice, et il porte les mêmes termes métier EN 16931 que l'UBL dans un arbre différent : trois sections de premier niveau (ExchangedDocument, SupplyChainTradeTransaction et le contexte d'en-tête) au lieu de la structure plus plate d'UBL.

Le CII compte bien davantage que sa part de marché ne le laisse croire, parce que c'est le XML embarqué dans chaque PDF Factur-X et ZUGFeRD — ce qui en fait la syntaxe dominante en France et en Allemagne, les deux plus grands marchés de la facturation électronique d'Europe continentale.

Les distinguer en une ligne
Lisez l'élément racine. <rsm:CrossIndustryInvoice> → CII. <Invoice> ou <CreditNote> dans un namespace UBL → UBL. C'est exactement ce que fait le format: "auto" de Flowie, et pourquoi c'est un choix plus sûr que de déclarer la syntaxe vous-même.

Factur-X & ZUGFeRD — les formats PDF hybrides

Factur-X (France) et ZUGFeRD (Allemagne) sont la même norme publiée par deux organismes — le FNFE-MPE et le FeRD — sous deux noms. Une facture Factur-X est un fichier PDF/A-3 contenant une pièce jointe XML CII : un humain ouvre le PDF et lit une facture ; une machine ouvre le même fichier, en extrait factur-x.xml et la comptabilise. Un seul artefact, deux publics, aucun problème de rapprochement.

La norme définit une échelle de profils, de MINIMUM et BASIC WL (trop pauvres pour constituer à eux seuls une facture légale) à BASIC et EN 16931 (le socle pleinement conforme) jusqu'à EXTENDED (qui ajoute des termes au-delà de l'EN 16931). La réforme B2B française accepte Factur-X au profil EN 16931 et au-dessus.

Flowie traite le PDF comme l'original : déposez un Factur-X et le CII embarqué est extrait, mappé et validé, tandis que le PDF que vous avez envoyé reste l'artefact renvoyé comme document original — ce qu'exige l'AFNOR XP Z12-013 d'un émetteur français, et ce que demandera un auditeur. Voir la vue d'ensemble France et la page Allemagne pour les deux mandats.

Peppol BIS Billing 3.0 et PINT

Peppol BIS Billing 3.0 est un CIUS de l'EN 16931 exprimé en UBL 2.1, et c'est le profil de facturation électronique le plus largement déployé en Europe. C'est lui qui circule sur le modèle à quatre coins du réseau Peppol : vous envoyez à votre point d'accès, votre point d'accès délivre à celui du destinataire, et une consultation SMP résout de qui il s'agit. Flowie est un point d'accès, donc envoyer tient en un appel d'API.

PINT (Peppol International) est la généralisation mondiale, plus récente : un modèle de facturation commun que chaque juridiction spécialise au lieu de le forker. Des spécialisations PINT sont en service ou en approche en Australie et Nouvelle-Zélande (PINT A-NZ), au Japon (JP PINT), à Singapour (InvoiceNow), aux Émirats arabes unis (PINT AE, sur un modèle à cinq coins qui ajoute l'administration fiscale comme coin) — et dans l'UE, sous le nom de PINT EU, profil successeur de BIS Billing 3.0.

L'accessibilité dépend du type de document
Un destinataire inscrit sur Peppol annonce les types de documents qu'il accepte. Avant d'envoyer, interrogez POST /v1/directory/verify avec le type que vous allez réellement envoyer — un participant joignable pour les factures ne l'est pas automatiquement pour les avoirs ou les commandes.

Formats nationaux européens et CIUS

La plupart des pays de l'UE utilisent Peppol BIS tel quel ou le restreignent par un CIUS national. Une poignée exploite des formats antérieurs à la norme européenne, toujours juridiquement exigés.

XRechnung (Allemagne)

Le CIUS allemand de l'EN 16931, maintenu par la KoSIT. Obligatoire pour les factures aux acheteurs publics fédéraux, et profil de référence du mandat B2B qui se déploie jusqu'en 2028. XRechnung peut être porté en UBL comme en CII, et ajoute des spécificités allemandes — routage par Leitweg-ID, coordonnées de contact acheteur obligatoires. Détails sur la page Allemagne.

FatturaPA (Italie)

Le schéma XML national italien, dédouané par le Sistema di Interscambio (SDI) pour toute facture B2B, B2C et B2G. Antérieur à l'EN 16931, il n'en est pas un CIUS : il a ses propres noms d'éléments, ses propres codes TipoDocumento (TD01–TD29) et ses propres messages de retour (esiti) qui arrivent de façon asynchrone après soumission. Flowie mappe le modèle canonique dessus et expose les esiti comme événements de cycle de vie — voir la vue d'ensemble Italie et l'explorateur TD.

Le reste, en bref

Formats de clearance et de reporting hors UE

Hors d'Europe, le modèle dominant est la clearance : la facture est soumise à l'administration fiscale et ne devient valide qu'une fois revenue tamponnée, numérotée ou signée. Le format est celui que dit le schéma de cette plateforme, et c'est rarement de l'EN 16931.

Le travail de Flowie est le même dans tous les cas : vous envoyez le JSON canonique, et le connecteur pays produit le schéma de la plateforme, le soumet et remonte le résultat sous forme d'événements de cycle de vie auxquels vous pouvez vous abonner. Ce qui change, c'est quand la facture devient juridiquement valide — d'où le fait que l'endpoint cycle de vie, et non la réponse d'envoi, est ce qu'il faut surveiller dans un pays à clearance.

L'EDI historique, et pourquoi un PDF n'est pas une facture électronique

UN/EDIFACT INVOIC et ANSI X12 810 sont les messages de facture EDI pré-XML, qui portent encore des volumes énormes dans la distribution, l'automobile et la logistique. Ils sont structurés et lisibles par une machine, donc ils résolvent le même problème — mais ce ne sont pas des syntaxes EN 16931, et un mandat qui nomme UBL ou CII ne les acceptera pas. Faire le pont est un projet de mapping ; parlez-nous-en si vous avez un socle EDI à conserver.

Une facture PDF, même envoyée par e-mail, n'est pas une facture électronique au sens des mandats actuels — pas plus qu'un scan ou un tableur. Le test qu'applique chaque réglementation est de savoir si la facture peut être traitée automatiquement sans ressaisie, ce qu'un PDF plat ne permet pas. C'est le malentendu le plus répandu des projets de facturation électronique, et la raison d'être de Factur-X : garder dans un seul fichier le PDF que voulait un humain et les données qu'exige la réglementation. Flowie stockera volontiers un PDF plat avec format: "raw" — simplement, il ne le routera pas comme une facture conforme.

Quel format envoyer ?

Questions fréquentes

Quelle est la différence entre UBL et CII ?

Ce sont deux syntaxes XML pour le même contenu sémantique. UBL 2.1 est une norme OASIS utilisée par Peppol et la plupart des réseaux d'Europe du Nord ; UN/CEFACT CII est utilisée en France et en Allemagne, et c'est le XML embarqué dans les PDF Factur-X et ZUGFeRD. Le CEN/TS 16931-2 reconnaît les deux comme conformes à l'EN 16931 : une facture passe donc de l'une à l'autre sans perte de contenu métier. L'élément racine les distingue : CrossIndustryInvoice pour le CII, Invoice ou CreditNote pour l'UBL.

Factur-X et ZUGFeRD, est-ce la même chose ?

Oui — techniquement la même norme hybride PDF/A-3, publiée conjointement par le FNFE-MPE en France et le FeRD en Allemagne sous deux noms. Un fichier ZUGFeRD est un fichier Factur-X valide, et réciproquement, au même niveau de profil. Les noms diffèrent pour des raisons de gouvernance et de marché, pas pour des raisons techniques.

XRechnung est-il un format Peppol ?

Non. XRechnung est un CIUS allemand de l'EN 16931 ; Peppol BIS Billing 3.0 est le CIUS d'OpenPeppol de la même norme. Les documents XRechnung transitent souvent par le réseau Peppol, d'où la confusion fréquente, mais ce sont deux profils distincts avec des champs obligatoires différents — notamment le Leitweg-ID allemand.

Une facture PDF est-elle une facture électronique ?

Non. Au sens de la directive européenne 2014/55/UE et des mandats nationaux qui en découlent, une facture électronique doit être émise, transmise et reçue dans un format structuré permettant un traitement automatique. Un PDF — ou un scan, ou une image envoyée par e-mail — ne qualifie pas, quelle que soit sa fabrication. Un PDF hybride Factur-X/ZUGFeRD, si : le XML structuré voyage à l'intérieur.

Dois-je convertir mes factures moi-même ?

Non. Envoyez le modèle JSON canonique à POST /v1/documents/send et Flowie produit ce que la destination exige. La conversion ne devient votre problème que si vous tenez à déposer un XML déjà produit pour un pays dont vous n'avez pas implémenté le profil.

L'EN 16931-1:2026 casse-t-elle mon intégration ?

Pas en elle-même. L'édition 2026 a été publiée en mai 2026 et a formellement retiré l'édition 2017, mais les profils nationaux l'adoptent à leur propre rythme et la validation continue d'accepter les versions de profil en vigueur pendant la migration. Tout changement effectif est annoncé dans le changelog avant de vous atteindre.

Quels formats Flowie gère-t-il ?

En entrée : le modèle JSON canonique, l'UBL 2.1, l'UN/CEFACT CII et les PDF Factur-X/ZUGFeRD (plus n'importe quel fichier stocké tel quel avec format: "raw"). En sortie : Peppol BIS Billing 3.0 et PINT pour le réseau Peppol, et le format national exigé par chacune des 47 juridictions documentées dans la section conformité — Factur-X et CII pour la France, XRechnung et ZUGFeRD pour l'Allemagne, FatturaPA pour l'Italie, KSeF FA(3) pour la Pologne, Facturae pour l'Espagne, ZATCA pour l'Arabie saoudite, MyInvois pour la Malaisie, et le reste du catalogue ci-dessus.

Références officielles

Les sources primaires, dans l'ordre où les couches s'empilent. Si un profil national et cette page divergent, le profil national l'emporte — dites-le-nous et nous corrigerons la page.

Et sur ce site : l'endpoint d'envoi, le modèle document canonique, les types de documents & de factures, 47 guides pays, et les 164 termes métier EN 16931.