API Factur-X

Contrôler votre facture gratuitement, sans compte

Essayez avant de souscrire : exemples gratuits et configuration MCP, sans inscription ni carte.

Une facture n'est émise que si les parties sont recevables. EU Verify tranche ; cette API refuse le fichier quand un vendeur ou un acheteur est not_ready, et renvoie un dossier de preuve daté avec le document. Générer, incorporer, valider et lire restent le même moteur, en REST ou via MCP. Ce n'est pas une Plateforme Agréée et pas un point d'accès Peppol : vous remettez le fichier à votre PA.

party_check est actif par défaut pour le profil extended-ctc-fr. Une panne de registre ne bloque pas le fichier ; la réponse porte X-Facturx-Party-Check: upstream_unavailable. Champs, dossier de preuve et erreur party_not_ready : Parties prêtes à facturer.

• 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, l'emplacement, et un json_pointer vers le JSON de facture quand il peut être nommé, pour qu'un agent corrige et réessaie.

• 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

Enregistrez d'abord le JSON de facture du démarrage rapide dans facture.json, puis définissez FACTURX_API_KEY. Cette commande utilise Bash.

curl --fail --silent --show-error --max-time 60 -X POST https://facturx.orvel.dev/v1/invoices/generate \
  -H "Authorization: Bearer $FACTURX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"invoice": '"$(cat facture.json)"', "options": {"profile": "en16931", "output": "facturx-pdf"}}' -o facture-facturx.pdf

Essayez les exemples fixes sans inscription : démo et configuration MCP. Vos documents nécessitent 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. Ne nous croyez pas sur parole : la page Conformité publie des échantillons produits par l'API en production, contrôlés par un validateur indépendant, avec les rapports bruts.
• Disponibilité transparente. Des contrôles toutes les 5 minutes depuis l'extérieur de notre hébergeur ; voir la page de statut publique.
• 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.
• Conformité : rapports de validation indépendants de ce que produit l'API, et comment les rejouer.

Un produit d’Orvel.