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-).

Consulter la documentation API interactive · tester une facture sans clé · voir les forfaits API (dès 49 € HT/mois).

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).

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

  1. validate_invoice d'abord — 25 fois moins cher que la conversion, et il vous dit si la suite est nécessaire.
  2. Si toutes les anomalies portent auto_repairable: true, appelez repair_invoice : la correction est déterministe et la liste des changements vous est rendue.
  3. Sinon, remontez les anomalies à un humain : le service refuse de deviner une donnée absente ou de trancher entre deux montants contradictoires.
  4. convert_invoice pour produire le Factur-X, l'UBL ou le CII.
  5. En cas de rejet malgré tout, explain_rejection avec le code et la facture. Voir les codes de rejet.

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.

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 / MCPEndpoint RESTCas d'usage B2B (Réforme 2026-2027)
validate_invoicePOST /v1/validateContrôle XSD + Schematron EN 16931 & règles FR- (BR-CO-15, BR-AE-05, FR-05)
repair_invoicePOST /v1/repairCorrection déterministe des anomalies d'arrondis et de totaux (auto_repairable: true)
convert_invoicePOST /v1/convertGénération conforme Factur-X (PDF/A-3 + CII D16B), UBL 2.1 ou CII pur
explain_rejectionPOST /v1/explainDiagnostic 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