Pourquoi utiliser une API de validation Factur-X
La Plateforme Agréée applique ses propres contrôles à chaque facture émise. Valider le document en amont réduit le risque de rejet documentaire. La question est : avec quel outil, maintenu par qui, et à quel coût réel.
Quatre approches, honnêtement comparées
Chaque approche a des cas d'usage légitimes. Aucune n'est universellement meilleure.
| Script maison | Outil ponctuel | API spécialisée | Suite e-invoicing | |
|---|---|---|---|---|
| Temps d'intégration | À assembler, tester et maintenir soi-même | Manuel (pas d'intégration) | API REST documentée | Semaines à mois |
| Pipeline complet (5 étapes) | À assembler soi-même | Dépend de l'outil | Inclus | Inclus |
| Mises à jour des schémas | Vous les gérez | Pas de contrôle | Publiées dans GET /meta | Incluses |
| Diagnostics d'erreur | Code brut / XPath | Variable | Structurés (JSON) | Variable |
| Coût de maintenance | Continu (schémas, dépendances, JVM) | Nul (usage ponctuel) | Artefacts gérés par le service ; intégration à maintenir | Contrat annuel |
| Données envoyées à un tiers | Non | Selon l'outil | Selon le parcours : prestataire OCR ou de vérification PDF/XML, Brevo (e-mails) · détail par prestataire | Oui |
| Coût typique | Temps ingénieur | Gratuit | 0 € puis Launch selon le contexte | Budget projet dédié |
Des clients publiés : Python, Node.js et assistants IA
Vous n'avez pas à écrire le client HTTP : trois paquets open source (licence MIT) appellent l'API pour une simulation (dry run), la conversion en Factur-X PDF/A-3 et la validation.
Python
pip install facturx-api
Client Python (3.10 ou plus) et commande facturx : dry-run, convert, validate. Sur PyPI.
Node.js
npm install @facturxapi/sdk
Client Node.js en modules ESM, avec les types TypeScript. Sur npm.
Assistants IA (MCP)
pip install facturx-mcp
Serveur MCP : un assistant compatible lance une simulation, une conversion Factur-X PDF/A-3 ou une validation ; un quatrième outil renvoie les champs du contrat public liés à une règle, un BT ou un chemin JSON. Sur PyPI.
Python — une simulation gratuite, puis la conversion si la facture est prête :
from facturx_api import FacturX
# Depuis la 0.1.2, l'hôte par défaut est la production ; base_url (ou FACTURX_BASE_URL) le remplace.
fx = FacturX(api_key="…")
check = fx.dry_run(invoice) # gratuit, aucun livrable
if check.ready:
doc = fx.convert(invoice) # 1 facture traitée sur le quota
doc.save("out") # out/factur-x.pdf et out/factur-x.xml Versions 0.1.2, statut alpha. Code source : github.com/facturxapi/sdk.
PHP, Laravel, Symfony, .NET et Dolibarr : l'appel REST de conversion est montré dans chacun des guides par langage (PHP, Laravel, Symfony, .NET, Dolibarr) et dans le guide JSON ERP.
Quand un script maison peut suffire
Vous validez uniquement du XML standalone
Si vos factures sont des fichiers XML (pas des PDF Factur-X hybrides), la validation XSD seule est relativement simple à implémenter avec lxml ou xmlstarlet. La couche Schematron reste complexe, mais l'XSD couvre les erreurs de structure.
Vous avez une équipe dédiée à l'outillage
Si votre organisation a des ingénieurs infrastructure qui maintiennent des pipelines de validation, et que la conformité Factur-X n'est qu'un module parmi d'autres, l'investissement est justifié car mutualisé.
Vous ne pouvez absolument pas envoyer de données à un tiers
Certains environnements (défense, santé, certaines administrations) ont des contraintes réglementaires qui interdisent l'envoi de documents à un service externe, même en transit. Dans ce cas, la validation locale est la seule option.
Quand l'API devient le meilleur choix
Vous validez des PDF Factur-X (pas uniquement du XML)
Le pipeline complet nécessite veraPDF pour PDF/A-3, l'extraction du XML embarqué, puis XSD et Schematron. L'assembler soi-même demande d'intégrer, de tester et de maintenir chacune de ces briques. L'API le fait en un appel.
Vous intégrez dans un ERP, un portail ou un pipeline CI/CD
Un appel REST avec un JSON structuré s'intègre depuis les snippets et guides fournis. Un pipeline local nécessite une JVM (pour veraPDF/Schematron), des schémas XSD/Schematron à jour, et de la glue entre les étapes.
Vous ne voulez pas gérer les mises à jour de schémas
Les schémas Schematron EN16931 sont mis à jour par le CEN TC 434. Les schémas Factur-X sont publiés par la FNFE-MPE. Les profils ZUGFeRD par FeRD. Rester à jour demande une veille active. L’API intègre ces mises à jour côté serveur, sans modification de votre code. Les artefacts exécutés (versions EN16931 / Factur-X / règles FR) sont publiés dans GET /meta.
Vous avez besoin de diagnostics exploitables
L'API retourne un JSON structuré avec le code d'erreur, le champ XPath concerné, le stage de validation (PDF/A, XSD, Schematron), et le profil détecté. Un pipeline local retourne du XML Schematron brut que vos développeurs doivent parser et interpréter.
Votre temps ingénieur coûte plus cher qu’un rail API prêt
Assembler, tester, débugger et maintenir un pipeline de validation complet mobilise du temps ingénieur avant le premier appel en production, et la maintenance est continue.
Et si vous avez déjà une Plateforme Agréée ?
Faut-il une Plateforme Agréée précise pour utiliser FacturX API ?
Non. FacturX API n’est pas une Plateforme Agréée et ne dépend d’aucune Plateforme Agréée en particulier : il génère ou contrôle le fichier Factur-X avant elle, puis votre PA assure la transmission officielle.
Que fait FacturX API avant la Plateforme Agréée ?
Il réduit le risque de rejet documentaire : il génère le fichier Factur-X depuis vos données JSON et le contrôle, avant que le document parte vers votre PA.
Quand n’avez-vous pas besoin de FacturX API ?
Si la PA ou le logiciel qui émet vos factures produit déjà le fichier Factur-X, et que vous ne souhaitez pas le contrôler vous-même en amont. FacturX API apporte quelque chose quand c’est vous qui générez le fichier.
Objections fréquentes
"Vous utilisez des briques open source dessous"
Oui. Le moteur PDF/A-3 est veraPDF (Open Source, Fondation PDF Association). Les schémas Schematron sont ceux du CEN TC 434 et de la FNFE-MPE. C'est un choix délibéré : nous utilisons les implémentations de référence, pas des alternatives propriétaires. La valeur de l'API n'est pas dans le fait de cacher ces briques, mais dans le fait de les assembler, les mettre à jour, les exposer en un point d'entrée unique, et retourner des diagnostics structurés.
"On peut faire ça en interne"
Probablement, oui. La question est : combien de temps pour l'implémenter, combien de temps pour le maintenir, et quel est le coût d'opportunité ? Assembler, tester, débugger et maintenir un pipeline de validation complet mobilise du temps ingénieur avant le premier appel en production, et la maintenance est continue. Si votre priorité est d'expédier un produit conforme, l'API vous fait gagner ce temps.
"Je ne veux pas envoyer mes factures à un tiers"
La préoccupation est légitime. Concrètement : Les fichiers transmis servent au traitement demandé. Selon le parcours, des copies temporaires peuvent être conservées pour le traitement, sa reprise ou l’accès au résultat ; les principales situations sont décrites dans la politique de confidentialité. Les données ne sont pas utilisées pour entraîner un modèle, enrichir un tiers ou revendre des informations métier. Les métadonnées techniques nécessaires au diagnostic, à la sécurité et à l'observabilité peuvent être conservées. Si votre contrainte réglementaire interdit tout transit externe, la validation locale est votre seule option. Voir la matrice de conservation.
"Je ne veux pas ajouter une dépendance réseau"
La validation peut être placée avant l'envoi, hors du chemin critique temps réel. Si votre pipeline tolère un appel HTTP synchrone, la dépendance réseau est gérable. Prévoyez un timeout client large pour /convert. Le budget options.timeout_seconds est de 300 secondes par défaut, réglable de 5 à 600 : il couvre l’appel de bout en bout (extraction, génération PDF/A-3, validation veraPDF, finalisation). Si vous avez besoin de validation offline ou dans un environnement déconnecté, c'est un cas légitime pour le local.
"J'ai besoin de plus qu'un validateur"
Si vous avez besoin de routage via Plateforme Agréée, de signature électronique ou de gestion du cycle de vie des factures, une suite e-invoicing est plus adaptée. FacturX API est un outil spécialisé : validation, extraction, réparation et génération Factur-X. Il s'intègre bien en amont d'une plateforme plus large, mais ne la remplace pas.
Ce que coûte réellement le bricolage
Pipeline local
Assembler, tester, débugger et maintenir un pipeline de validation complet mobilise du temps ingénieur avant le premier appel en production, et la maintenance est continue.
FacturX API
- IntégrationSnippets et guides
- Mise à jour schémasCôté serveur (versions dans GET /meta)
- Diagnostics d'erreurJSON structuré exploitable
- MaintenanceMaintenance de votre intégration uniquement
- Coût année 1Sandbox 0 € · Launch 468 € · Scale 1 788 €
TVA non applicable, art. 293 B du CGI.
Le coût réel varie selon la complexité de votre stack et le niveau de couverture visé. Offres actuelles : Sandbox, Launch, Scale, Business et Pilote accompagné selon votre contexte.
Testez sur votre propre facture
Rapport EN16931 détaillé, directement dans le navigateur.
Et après ?
Prochaines étapes
Choisissez l'étape suivante pour activer FacturX API sur votre stack.
Vérifier une facture
Diagnostic EN16931 clair avec les contrôles et champs concernés.
Documentation API
Endpoints, exemples curl, snippets Python/Node.js/PHP.
Comparatif technique détaillé
Validation interne ou API : trois scénarios de coûts, maintenance et calcul sur trois ans.
Comparer les plans
Comparer les offres actuelles : Sandbox, Launch, Scale, Business et Pilote accompagné.