API Factur-X¶
Générez, incorporez, validez et lisez des factures électroniques Factur-X / EN 16931 depuis une API REST ou directement depuis un agent IA via MCP. Conçue pour la réforme française de la facturation électronique (septembre 2026 / 2027) et compatible avec la norme européenne utilisée par ZUGFeRD, Peppol BIS et ViDA.
-
Générer
Un JSON de facture en entrée, un PDF/A-3 Factur-X conforme (avec XML CII incorporé), un XML CII ou un XML UBL 2.1 en sortie. Les totaux et la ventilation de TVA sont calculés pour vous.
-
Valider
Tout PDF Factur-X, fichier CII ou UBL est contrôlé contre les XSD et le schematron EN 16931, plus les règles françaises
fr-ctc(BR-FR-*). Les constats reviennent avec l'identifiant de règle et l'emplacement. -
Incorporer
Gardez votre propre maquette PDF : joignez un XML Factur-X (ou laissez-nous le générer depuis le JSON) et recevez une facture Factur-X PDF/A-3.
-
Extraire
Lisez les factures reçues : XML incorporé, parties, totaux, ventilation de TVA et lignes en JSON.
Un seul appel¶
curl -X POST https://facturx-api.fly.dev/v1/invoices/generate \
-H "Authorization: Bearer $FACTURX_API_KEY" \
-H "Content-Type: application/json" \
-d @facture.json -o facture-facturx.pdf
La validation et l'extraction sont gratuites sans clé API (avec limitation de débit) ; la génération et l'incorporation demandent une clé. Voir Tarifs.
Pourquoi cette API¶
- Des normes, pas des opinions. Les documents produits passent le schematron officiel EN 16931 et le jeu de règles CTC français (
fr-ctc) publié pour la réforme. Chaque réponse indique exactement quelles règles ont été exécutées. - Sans état. Les documents sont traités en mémoire et jamais stockés.
- Le même moteur pour les humains et les agents. Les endpoints REST et les outils MCP partagent une seule implémentation : ce qu'un agent produit dans Claude ou Cursor est ce que votre ERP reçoit.
- Profils : génère BASIC WL, EN 16931, EXTENDED et EXTENDED-CTC-FR (le profil étendu français) ; valide et lit tous les profils Factur-X y compris MINIMUM et BASIC, plus UBL 2.1.
Pour continuer¶
- Démarrage rapide : une première facture en cinq minutes.
- API REST : endpoints, en-têtes, erreurs. OpenAPI interactif sur
/api. - Serveur MCP : connecter Claude Desktop, Cursor, VS Code ou tout client MCP.
- Champs de la facture : le JSON envoyé, mis en correspondance avec les termes métier EN 16931.
- FAQ réforme française : dates, obligations, formats, règles SIREN.