API de facturation électronique : validation Factur-X & EN 16931
Une API REST de facturation électronique, et les mêmes opérations exposées comme outils MCP pour les agents. Un seul format d'entrée : le JSON canonique, sous-ensemble strict du modèle sémantique EN 16931, où chaque champ porte son terme métier (BT-/BG-).
Appel
Contrôler une facture
curl -s https://api.validationfacture.fr/v1/validate \
-H "Authorization: Bearer $CLE_API" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: F2026-0142" \
-d '{"invoice": { … }}'La réponse contient le verdict, la liste des anomalies et un paquet de preuves (empreinte de l'entrée, empreintes des sorties, version du référentiel, signature).
Réponse
Une anomalie, telle qu'elle est renvoyée
{
"code": "BR-CO-15",
"severity": "error",
"field": "totals.tax_inclusive_amount",
"business_term": "BT-112",
"message": "Le total TTC n'est pas égal au total HT augmenté de la TVA.",
"fix": "Portez totals.tax_inclusive_amount à 1224.00.",
"expected": "1224.00",
"actual": "1220.00",
"auto_repairable": true,
"source": "EN 16931"
} Branchez votre traitement sur code, jamais sur message : un code ne change pas de signification, et une règle retirée laisse son code retiré plutôt que recyclé. Voir les 242 codes.
Boucle d'intégration recommandée
validate_invoiced'abord — 25 fois moins cher que la conversion, et il vous dit si la suite est nécessaire.- Si toutes les anomalies portent
auto_repairable: true, appelezrepair_invoice: la correction est déterministe et la liste des changements vous est rendue. - Sinon, remontez les anomalies à un humain : le service refuse de deviner une donnée absente ou de trancher entre deux montants contradictoires.
convert_invoicepour produire le Factur-X, l'UBL ou le CII.- En cas de rejet malgré tout,
explain_rejectionavec le code et la facture. Voir les codes de rejet.
Agents
Les mêmes opérations en MCP
{
"mcpServers": {
"validation-facture": {
"command": "invoice-guard-mcp",
"env": { "INVOICE_GUARD_API_KEY": "…" }
}
}
}Un verdict obtenu en MCP est identique au verdict obtenu en REST, et porte le même paquet de preuves : c'est le même moteur, exposé sur deux transports.
CI/CD & ERP
Points d'accès de l'API de facturation électronique (REST & MCP)
Intégrez les 4 opérations dans votre ERP, votre connecteur PDP/Chorus Pro ou votre pipeline d'intégration continue (GitHub Actions / GitLab CI) pour bloquer les factures non conformes avant émission :
| Opération API / MCP | Endpoint REST | Cas d'usage B2B (Réforme 2026-2027) |
|---|---|---|
validate_invoice | POST /v1/validate | Contrôle XSD + Schematron EN 16931 & règles FR- (BR-CO-15, BR-AE-05, FR-05) |
repair_invoice | POST /v1/repair | Correction déterministe des anomalies d'arrondis et de totaux (auto_repairable: true) |
convert_invoice | POST /v1/convert | Génération conforme Factur-X (PDF/A-3 + CII D16B), UBL 2.1 ou CII pur |
explain_rejection | POST /v1/explain | Diagnostic structuré d'un code de rejet Chorus Pro, PPF ou PDP (101 codes) |
Comment intégrer une API de validation de facturation électronique (Factur-X / EN 16931) ?
Un simple appel HTTP POST sur https://api.validationfacture.fr/v1/validate avec votre facture (JSON canonique, XML UBL 2.1, XML CII D16B ou PDF/A-3 Factur-X) exécute les 242 règles EN 16931 et FR- en moins de 150 ms et retourne les codes d'anomalie normalisés (BR-*, BR-CO-*, FR-*) ainsi qu'un paquet de preuves signé.
Peut-on automatiser le contrôle Factur-X et EN 16931 dans un pipeline CI/CD ?
Oui : l'API REST s'appelle directement depuis GitHub Actions, GitLab CI ou vos tests d'intégration ERP pour bloquer toute régression XML (arrondis BR-CO-15, autoliquidation BR-AE-05, SIREN BT-47 FR-05, unités BT-130) avant l'envoi vers Chorus Pro, le PPF ou une PDP.
Tester l'API dans le bac à sableActiver une clé Starter (49 € HT/mois)Spécification OpenAPI