Un fichier PDF qui contient un XML structuré, lisible à la fois par un humain et une machine ? Bienvenue dans l’univers Factur-X, ce format de facture électronique hybride qui coche toutes les cases de la réforme 2024-2026 sur la dématérialisation.
Mais avant de se lancer tête baissée dans l’implémentation, encore faut-il comprendre ce que la documentation Factur-X met à disposition : spécifications, schémas XML, profils de conformité, exemples concrets… et subtilités techniques. Cet article vous guide à travers les points clés de cette documentation parfois dense, mais essentielle pour produire des factures valides et interopérables.
Comprendre la structure de la documentation technique Factur-X
La documentation officielle autour de Factur-X repose sur un ensemble de fichiers et normes qui décrivent très précisément la manière de construire une facture conforme. Ce n’est pas une simple liste de règles : c’est une ressource vivante, publiée et mise à jour régulièrement, qui combine plusieurs dimensions :
- Un PDF/A-3 qui embarque un fichier XML
- Un schéma XSD à respecter pour la structuration des données XML
- Plusieurs profils de conformité (de Minimum à EN16931) selon le niveau de détail attendu
- Des exemples de fichiers valides pour les tests
Autrement dit, il ne suffit pas de “mettre un XML dans un PDF” : la structure, les métadonnées, les noms de fichiers et les règles de contenu sont strictement définis.
Les profils de conformité expliqués simplement
Dans la documentation, on retrouve les profils Factur-X classés par complexité. Chaque profil correspond à un niveau de données attendu dans la facture, et dépend du type de relation commerciale ou des exigences légales.
| Profil | Description succincte | Cas d’usage typique |
|---|---|---|
| Minimum | Informations de base : client, fournisseur, total | Très petite entreprise, auto-entrepreneur |
| Basic WL | Ajoute ligne de facture sans TVA | PME sans complexité fiscale |
| EN16931 | Profil complet conforme au standard européen | Grandes entreprises, ERP, B2G |
Le bon choix de profil dépend du contexte de facturation et du niveau d’automatisation souhaité. Tous sont définis dans les fichiers PDF techniques de la doc.
PDF, XML, et PDF/A-3 : attention à la conformité
L’un des points de friction fréquents vient de la construction du fichier PDF. La documentation l’indique très clairement : le PDF doit être au format PDF/A-3, un standard d’archivage qui permet d’y embarquer un fichier annexe – ici, le fameux factur-x.xml.
Quelques points techniques que la documentation insiste à bien respecter :
- Le fichier XML embarqué doit s’appeler
factur-x.xml - Le XML doit être valide XSD (schéma fourni)
- Des métadonnées XMP spécifiques doivent être insérées dans le PDF (profil utilisé, version, UUID, etc.)
- Le tout doit être lisible à la fois pour un humain (le PDF) et pour un système de traitement (le XML)
Sans respecter cela à la lettre, la facture sera rejetée par les systèmes de traitement comme Chorus Pro.
Où trouver les schémas, exemples et validateurs ?
La documentation Factur-X met à disposition tout ce qu’il faut pour tester, comprendre et intégrer :
- Les schemas XSD à intégrer pour valider les structures XML
- Des fichiers de démonstration par profil
- Des outils comme le Factur-X Validator pour tester la conformité
- Des bibliothèques open source : Java, Python, PHP…
Tout est organisé autour d’un dépôt GitHub central, qui permet de récupérer facilement les fichiers, suivre les évolutions et collaborer si nécessaire.
Intégrer Factur-X : pièges à éviter
En travaillant avec la documentation, plusieurs écueils techniques peuvent apparaître. Voici ceux qui reviennent le plus souvent chez les intégrateurs :
- Nom incorrect du fichier XML embarqué : seul
factur-x.xmlest reconnu. - Profil mal indiqué dans les métadonnées XMP → rejet.
- Encodage XML non UTF-8 → erreurs de parsing.
- Mauvais mimetype ou absence de relations entre PDF et XML dans la structure du fichier.
Ces éléments sont clairement indiqués dans la documentation mais souvent négligés. Une lecture attentive et des tests fréquents permettent de les anticiper.
Ce que la documentation ne dit pas toujours… mais qu’il faut savoir
Bien que complète, la documentation Factur-X laisse parfois certains détails en suspens. Par exemple :
- La signature électronique est facultative mais recommandée, surtout dans un contexte B2G.
- La gestion des erreurs n’est pas centralisée : c’est aux outils de validation de renvoyer des logs utiles.
- La personnalisation du PDF est libre… tant que la partie XML reste conforme.
Un bon réflexe : toujours commencer avec les exemples fournis dans la documentation, et les faire valider avec un outil avant de passer en production.
En résumé
La documentation Factur-X n’est pas juste un manuel technique : c’est le socle de conformité pour toute entreprise qui souhaite émettre ou recevoir des factures électroniques en France dans un cadre normé. Bien la comprendre, l’exploiter et la suivre est un prérequis pour une intégration fiable, interopérable et pérenne.
Ce n’est pas forcément compliqué. Mais c’est exigeant. Prenez le temps de lire, de tester, et surtout de valider. La facture électronique n’attend pas.
