Pourquoi utiliser une API de validation Factur-X
La question n'est pas de savoir s'il faut valider. C'est une obligation dès que vous émettez vers une PDP. 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 | 1 – 3 semaines | Manuel (pas d'intégration) | 30 minutes | Semaines à mois |
| Pipeline complet (5 étapes) | À assembler soi-même | Partiel (souvent XSD seul) | Inclus | Inclus |
| Mises à jour des schémas | Vous les gérez | Pas de contrôle | Transparentes | 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) | Nul (service géré) | Contrat annuel |
| Données envoyées à un tiers | Non | Selon l'outil | Oui (suppression immédiate, UE) | Oui |
| Coût typique | Temps ingénieur | Gratuit | 0 € à 29 €/mois | 1 000 € – 50 000 €/an |
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 prend 1 à 3 semaines. 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 en 30 minutes dans n'importe quel langage. 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 absorbe ces mises à jour sans action de votre part.
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 que 29 €/mois
Assembler, tester, débugger et maintenir un pipeline de validation complet prend entre 2 et 5 jours-ingénieur. À 500 €/jour, c'est 1 000 à 2 500 € avant le premier appel en production — et la maintenance est continue.
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é ? Si votre équipe peut investir 2 à 5 jours dans un pipeline de validation et assurer sa maintenance continue, un script local peut être un bon choix. 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 sont traités en mémoire, supprimés immédiatement après traitement, jamais stockés durablement, et l'infrastructure est hébergée en UE (Cloudflare). Aucune donnée métier n'est loggée — seuls les métadonnées techniques (profil détecté, codes d'erreur, durée) sont conservées. Si votre contrainte réglementaire interdit tout transit externe, la validation locale est votre seule option.
"Je ne veux pas ajouter une dépendance réseau"
Dans la plupart des architectures, la validation intervient en amont de l'envoi — pas dans le chemin critique temps réel. Si votre pipeline tolère un appel HTTP de 200 ms avec un timeout de 15 secondes, la dépendance réseau est gérable. 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 PDP, de signature électronique, de gestion du cycle de vie des factures, une suite e-invoicing est plus adaptée. FacturX API est un outil spécialisé : validation, conversion, extraction. 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
- Assemblage initial2 – 5 jours
- Mise à jour schémas / an2 – 4 jours
- Debug quand un rejet est incompris0,5 – 2 jours / incident
- Dépendances (JVM, veraPDF, libs)Maintenance continue
- Coût année 11 500 – 4 000 €
FacturX API
- Intégration30 minutes
- Mise à jour schémas0 (automatique)
- Diagnostics d'erreurJSON structuré, immédiat
- Maintenance0
- Coût année 10 – 348 €
Ordres de grandeur indicatifs basés sur un taux jour ingénieur de 500 € et les retours de projets d'intégration comparables. Le coût réel varie selon la complexité de votre stack et le niveau de couverture visé. Plan Free : 0 €/mois. Plan Pro : 29 €/mois. Packs ponctuels disponibles.
Testez sur votre propre facture
Rapport EN16931 complet en moins d'une seconde, directement dans le navigateur.
Et après ?
Prochaines étapes
Choisissez l'étape suivante pour activer FacturX API sur votre stack. Tous les liens sont internes pour garder le suivi clair.
Tester une facture
Rapport EN16931 complet en moins d'une seconde, sans inscription.
Documentation API
Endpoints, exemples curl, snippets Python/Node.js/PHP.
Comparatif technique détaillé
KoSIT, Mustangproject, pipeline custom : installation, code, matrice de décision.
Comparer les plans
Free, Pro, Business — quotas et fonctionnalités.