API facture électronique Factur-X : générer ses factures conformes à la réforme 2026
La facture électronique devient la norme en France avec la réforme 2026. Pour les éditeurs de logiciels, les ERP et les marketplaces, la question n'est plus de savoir s'il faut s'y conformer, mais comment le faire sans tout reconstruire. Une API Factur-X permet de générer des factures conformes en quelques lignes de code, sans réécrire son application. Ce guide explique ce qu'est Factur-X, pourquoi passer par une API, et comment générer vos factures avec DocX.
La réforme de la facture électronique 2026 en bref
La réforme française généralise la facture électronique entre entreprises (e-invoicing) et la transmission de certaines données à l'administration (e-reporting). Concrètement, une facture ne sera plus un simple PDF ou un document papier : elle devra contenir des données structurées, lisibles automatiquement par les logiciels de comptabilité et les plateformes de dématérialisation.
Pour les entreprises qui éditent ou intègrent des outils de facturation, cela impose un changement de format. Le standard retenu en France pour répondre à cette exigence est Factur-X : un format hybride qui combine le confort d'un PDF lisible et la rigueur d'un fichier de données structurées.
Qu'est-ce que Factur-X ?
Factur-X est un format de facture électronique mixte. Une facture Factur-X est un seul fichier qui contient deux choses à la fois :
- Un PDF lisible par un humain : exactement la facture que votre client voit aujourd'hui, avec votre logo, vos couleurs et vos mentions.
- Un fichier XML de données structurées : intégré dans le PDF, il contient les mêmes informations (montants, TVA, identifiants, lignes de facturation) sous une forme que les machines peuvent lire automatiquement.
Ce fichier respecte la norme PDF/A-3, un format d'archivage qui autorise l'insertion de pièces jointes (ici le XML) tout en garantissant que le document restera lisible dans le temps. C'est ce qui rend Factur-X à la fois conforme à la réforme et exploitable par tous les acteurs de la chaîne : votre client, son logiciel comptable et les plateformes de dématérialisation.
PDF/A-3 : le socle technique
Le format PDF/A-3 est essentiel : il garantit l'archivage long terme et permet d'embarquer le XML directement dans le PDF, sans fichier séparé. Une facture conforme est donc un seul fichier qui voyage partout sans rien perdre.
Pourquoi générer ses factures Factur-X par API ?
Produire une facture Factur-X conforme demande de respecter une norme technique précise : structurer le XML, l'embarquer dans un PDF/A-3 valide, vérifier la cohérence des données. Recoder tout cela en interne représente des semaines de travail et un risque d'erreur de conformité.
Une API de génération de factures électroniques évite ce détour. Vous envoyez vos données (le contenu de la facture) à un service spécialisé, et vous recevez en retour un fichier conforme, prêt à être envoyé ou archivé. Les avantages sont directs :
- Automatiser : générez des centaines de factures sans intervention manuelle.
- Se conformer sans tout refaire : votre logiciel existant continue de fonctionner, vous ajoutez juste un appel à l'API.
- Toujours à jour : la conformité au format est maintenue par le service, pas par vos équipes.
- Rapidité d'intégration : quelques heures de développement au lieu de plusieurs mois.
Comment générer une facture Factur-X avec DocX
DocX est une API de génération de documents. Le principe est simple : vous définissez un modèle de facture (votre mise en page, votre logo) puis vous envoyez vos données au format JSON. DocX assemble le tout et renvoie une facture Factur-X au format PDF/A-3 conforme.
L'appel se fait sur l'endpoint
POST
https://docx.layerone.fr/render-facturx, en passant votre clé d'API dans l'en-tête
X-API-Key. Voici un exemple complet avec curl :
curl -X POST https://docx.layerone.fr/render-facturx \
-H "X-API-Key: VOTRE_CLE_API" \
-d "template_id=facture-facturx" \
--data-urlencode 'json_data={"Npiece":"F-2026-0042","client":"ACME","total":1200}' \
-d "output_filename=facture.pdf" \
--output facture.pdf
En retour, vous obtenez un fichier
facture-facturx.pdf : un PDF lisible par votre
client, contenant le XML structuré intégré et conforme au
standard. Vous pouvez l'envoyer, l'archiver ou le transmettre à
une plateforme de dématérialisation.
Cas d'usage
Éditeurs de logiciels
Vous éditez un logiciel de gestion, de facturation ou un SaaS métier ? Ajoutez la conformité Factur-X à votre produit sans détourner vos équipes de votre cœur de métier. Un appel à l'API suffit pour que vos utilisateurs émettent des factures conformes.
ERP et systèmes de gestion
Les ERP gèrent déjà toutes les données de facturation. L'API Factur-X s'intègre dans le module d'émission existant : au moment de générer une facture, l'ERP envoie ses données à DocX et récupère le fichier conforme, sans refonte.
Marketplaces et plateformes
Les marketplaces émettent de gros volumes de factures pour le compte de leurs vendeurs. Une API permet d'automatiser entièrement cette production à grande échelle, avec une conformité homogène sur toutes les factures émises.
Intégrer l'API dans votre stack existante
L'API Factur-X de DocX ne se limite pas à un appel HTTP. Pour s'adapter à tous les environnements, elle est aussi accessible via de nombreux canaux : un paquet npm pour les projets JavaScript et Node.js, le protocole MCP pour les agents et assistants, et les principales plateformes d'automatisation no-code et low-code : Zapier, Make, n8n et Pipedream. Vous pouvez également l'utiliser depuis des constructeurs d'applications comme Bubble et Adalo, ou la tester immédiatement avec Postman grâce à sa description OpenAPI.
Concrètement, un éditeur qui automatise déjà ses processus avec Make ou n8n peut brancher la génération de factures Factur-X dans un scénario existant, sans écrire une seule ligne de code : un déclencheur (nouvelle commande, devis accepté) appelle l'API, qui renvoie la facture conforme prête à archiver ou à envoyer. Cette souplesse fait de l'e-invoicing en France un simple maillon de votre chaîne d'automatisation, et non un chantier à part.
Questions fréquentes
Qu'est-ce que Factur-X ?
Factur-X est un format de facture électronique mixte : un seul fichier qui contient à la fois un PDF lisible par un humain et des données XML structurées intégrées, exploitables automatiquement par les logiciels comptables. Il repose sur la norme PDF/A-3, un format d'archivage à long terme qui autorise l'intégration du XML directement dans le PDF.
La facture électronique est-elle obligatoire ?
La réforme 2026 généralise progressivement la facture électronique entre entreprises en France, dans le cadre d'un mouvement européen de dématérialisation. Le format structuré devient la norme pour les factures entre professionnels. Pour les modalités précises (calendrier, périmètre), il convient de se référer aux textes officiels en vigueur.
Comment générer une facture Factur-X par API ?
Avec DocX, vous appelez l'endpoint
POST /render-facturx sur
docx.layerone.fr, au format
application/x-www-form-urlencoded. Vous envoyez votre
template_id, vos données dans
json_data et un output_filename, en
passant votre clé via l'en-tête X-API-Key. L'API
renvoie un PDF/A-3 conforme avec le XML Factur-X intégré.
Est-ce gratuit pour tester ?
Oui. DocX propose un palier gratuit de 20 documents par mois, sans carte bancaire. C'est suffisant pour tester l'intégration, valider la conformité de vos factures et prototyper votre solution avant de passer à l'échelle.
Faut-il changer tout mon logiciel ?
Non. L'API s'intègre à votre système existant : votre logiciel ou votre ERP continue de gérer vos clients et vos calculs. Au moment d'émettre la facture, il envoie ses données à l'API et récupère le fichier conforme, sans refonte ni migration.