Factur-X : le format hybride PDF + XML expliqué

Factur-X est le format de facture hybride franco-allemand qui combine un PDF lisible par l'humain et un fichier XML structuré lisible par la machine. Un seul fichier, deux usages. Ce format est l'un des trois formats acceptés par la réforme de la facturation électronique en France. Ce guide détaille sa structure, ses profils, et comment le créer, le valider et le convertir.

1. Qu'est-ce que Factur-X ?

Factur-X est un standard de facturation électronique développé conjointement par la France (FNFE-MPE) et l'Allemagne (FeRD). Il répond à un problème simple : les comptables veulent un PDF qu'ils peuvent lire et archiver, les systèmes informatiques veulent un XML structuré qu'ils peuvent traiter automatiquement.

Factur-X résout ce dilemme en embarquant un fichier XML (au format Cross Industry Invoice, ou CII) à l'intérieur d'un PDF conforme à la norme PDF/A-3. Le résultat est un seul fichier qui satisfait les deux besoins.

En Allemagne, le même format s'appelle ZUGFeRD. Depuis la version 1.0, les deux spécifications sont identiques. Un fichier Factur-X valide est un fichier ZUGFeRD valide.

2. Structure : PDF/A-3 + XML CII embarqué

Un fichier Factur-X est un PDF/A-3 standard (ISO 19005-3). La norme PDF/A-3 autorise l'embarquement de fichiers arbitraires en tant que pièces jointes. Factur-X exploite cette possibilité pour intégrer un fichier XML nommé factur-x.xml au format UN/CEFACT Cross Industry Invoice (CII).

facture.pdf (PDF/A-3)
├── Pages PDF (rendu visuel de la facture)
├── Métadonnées XMP (conformité PDF/A-3, relation AFRelationship)
└── Pièce jointe embarquée
    └── factur-x.xml (XML CII, données structurées)

Le lien entre le PDF et le XML est défini par la métadonnée AFRelationship positionnée sur Data ou Alternative. Cela indique aux logiciels que le XML est la représentation structurée des données de la facture, pas un simple fichier joint.

Pourquoi PDF/A-3 et pas un PDF classique ?

• Archivage long terme : PDF/A garantit la lisibilité sur 10+ ans (polices embarquées, pas de dépendances externes)
• Pièces jointes autorisées : PDF/A-3 (contrairement à PDF/A-1 et PDF/A-2) permet d'embarquer des fichiers de tout type
• Conformité légale : accepté par les administrations fiscales européennes pour l'archivage électronique

3. Les 5 profils Factur-X

Factur-X définit cinq profils qui déterminent la quantité d'informations présentes dans le XML. Plus le profil est élevé, plus le XML est riche et permet un traitement automatisé complet.

4. Exemple XML commenté

Voici un extrait simplifié d'un fichier factur-x.xml au profil EN 16931. Les éléments clés sont annotés.

<?xml version="1.0" encoding="UTF-8"?>
<rsm:CrossIndustryInvoice
  xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100"
  xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100"
  xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100">

  <!-- En-tête : numéro et type de facture -->
  <rsm:ExchangedDocument>
    <ram:ID>FA-2026-001</ram:ID>
    <ram:TypeCode>380</ram:TypeCode>  <!-- 380 = facture -->
    <ram:IssueDateTime>
      <udt:DateTimeString format="102">20260515</udt:DateTimeString>
    </ram:IssueDateTime>
  </rsm:ExchangedDocument>

  <rsm:SupplyChainTradeTransaction>
    <!-- Vendeur -->
    <ram:ApplicableHeaderTradeAgreement>
      <ram:SellerTradeParty>
        <ram:Name>Dupont Services SARL</ram:Name>
        <ram:SpecifiedTaxRegistration>
          <ram:ID schemeID="VA">FR32123456789</ram:ID>
        </ram:SpecifiedTaxRegistration>
      </ram:SellerTradeParty>

      <!-- Acheteur -->
      <ram:BuyerTradeParty>
        <ram:Name>Martin Distribution SAS</ram:Name>
        <ram:SpecifiedTaxRegistration>
          <ram:ID schemeID="VA">FR45987654321</ram:ID>
        </ram:SpecifiedTaxRegistration>
      </ram:BuyerTradeParty>
    </ram:ApplicableHeaderTradeAgreement>

    <!-- Ligne de facture -->
    <ram:IncludedSupplyChainTradeLineItem>
      <ram:AssociatedDocumentLineDocument>
        <ram:LineID>1</ram:LineID>
      </ram:AssociatedDocumentLineDocument>
      <ram:SpecifiedTradeProduct>
        <ram:Name>Conseil en facturation électronique</ram:Name>
      </ram:SpecifiedTradeProduct>
      <ram:SpecifiedLineTradeSettlement>
        <ram:ApplicableTradeTax>
          <ram:TypeCode>VAT</ram:TypeCode>
          <ram:RateApplicablePercent>20.00</ram:RateApplicablePercent>
        </ram:ApplicableTradeTax>
        <ram:SpecifiedTradeSettlementLineMonetarySummation>
          <ram:LineTotalAmount>1500.00</ram:LineTotalAmount>
        </ram:SpecifiedTradeSettlementLineMonetarySummation>
      </ram:SpecifiedLineTradeSettlement>
    </ram:IncludedSupplyChainTradeLineItem>

    <!-- Totaux -->
    <ram:ApplicableHeaderTradeSettlement>
      <ram:InvoiceCurrencyCode>EUR</ram:InvoiceCurrencyCode>
      <ram:SpecifiedTradeSettlementHeaderMonetarySummation>
        <ram:LineTotalAmount>1500.00</ram:LineTotalAmount>
        <ram:TaxTotalAmount currencyID="EUR">300.00</ram:TaxTotalAmount>
        <ram:GrandTotalAmount>1800.00</ram:GrandTotalAmount>
        <ram:DuePayableAmount>1800.00</ram:DuePayableAmount>
      </ram:SpecifiedTradeSettlementHeaderMonetarySummation>
    </ram:ApplicableHeaderTradeSettlement>
  </rsm:SupplyChainTradeTransaction>
</rsm:CrossIndustryInvoice>

Points clés de cet exemple

• TypeCode 380 identifie une facture (381 pour un avoir, 389 pour une auto-facturation)
• schemeID="VA" désigne un numéro de TVA intracommunautaire
• Format de date 102 signifie AAAAMMJJ (norme UN/EDIFACT)
• Les namespaces rsm, ram et udt sont obligatoires et normalisés

5. Comment créer un Factur-X

La création d'un fichier Factur-X se fait en trois étapes : générer le XML CII, générer ou obtenir un PDF/A-3, puis embarquer le XML dans le PDF.

Étape 1 : Générer le XML CII

Construisez le XML en respectant le schéma du profil choisi. Des bibliothèques open source existent pour Python (factur-x), PHP (factur-x-php), Java (Mustang) et .NET.

Étape 2 : Produire un PDF/A-3

La plupart des générateurs de PDF (wkhtmltopdf, WeasyPrint, iText, Apache PDFBox) supportent la sortie PDF/A-3. Si votre PDF existant n'est pas PDF/A-3, vous pouvez le convertir avec Ghostscript ou un outil en ligne.

Étape 3 : Embarquer le XML

Ajoutez le fichier factur-x.xml comme pièce jointe avec le type MIME text/xml et la relation AFRelationship: Data. Mettez à jour les métadonnées XMP pour déclarer la conformité Factur-X et le profil utilisé.

Exemple Python avec la bibliothèque factur-x

from facturx import generate_from_file

# PDF source (doit être PDF/A-3 ou sera converti)
pdf_path = "facture.pdf"

# XML CII généré précédemment
xml_path = "factur-x.xml"

# Générer le Factur-X
with open(pdf_path, "rb") as pdf_file:
    with open(xml_path, "rb") as xml_file:
        facturx_pdf = generate_from_file(
            pdf_file,
            xml_file.read(),
            flavor="factur-x",
            level="en16931"
        )

# Sauvegarder
with open("facture-facturx.pdf", "wb") as out:
    out.write(facturx_pdf)

Via l'API e-invoice.be

Si vous préférez ne pas gérer l'assemblage vous-même, l'API e-invoice.be accepte vos données en JSON et produit une facture Peppol UBL validée, envoyée directement sur le réseau. Pas besoin de manipuler le XML manuellement.

6. Validation

Valider un fichier Factur-X implique trois niveaux de vérification. Chaque niveau peut révéler des erreurs différentes.

7. Différences avec ZUGFeRD

Factur-X et ZUGFeRD sont le même format sous deux noms commerciaux. Quelques différences mineures subsistent dans l'usage :

En résumé : si votre partenaire vous demande du ZUGFeRD et que vous produisez déjà du Factur-X, vous n'avez rien à changer. Le format est identique. Seul le nom du fichier XML peut différer, et la plupart des logiciels acceptent les deux.

Pour un guide complet sur ZUGFeRD (structure, XRechnung, outils allemands), consultez notre guide détaillé ZUGFeRD.

8. Questions fréquentes