API Factur-X : valider une facture électronique en une requête

Mis à jour le 23 septembre 2026

Démarrer en deux minutes

1. Ouvrez Mon espace et connectez-vous avec votre e-mail (lien de connexion, sans mot de passe).
2. Créez une clé API. Sans abonnement, elle donne 30 appels par mois pour essayer.
3. Envoyez votre facture :

curl -X POST "https://verifier-factur-x.com/api/v1/valider?regles=auto" \
  -H "Authorization: Bearer vfx_votre_cle" \
  -H "Content-Type: application/pdf" \
  --data-binary @facture.pdf

En JavaScript (Node 18+ ou navigateur) :

const r = await fetch("https://verifier-factur-x.com/api/v1/valider", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.VFX_CLE },
  body: await fs.promises.readFile("facture.xml"),
});
const resultat = await r.json();
if (resultat.verdict === "non-conforme") {
  for (const e of resultat.erreurs.filter((e) => e.gravite === "bloquant")) console.log(e.code, e.titre);
}

En Python :

import requests
with open("facture.pdf", "rb") as f:
    r = requests.post("https://verifier-factur-x.com/api/v1/valider",
                      headers={"Authorization": "Bearer vfx_votre_cle"}, data=f)
print(r.json()["verdict"])

La réponse

Toujours un JSON, même pour une facture non conforme : verdict, resume, la liste erreurs (code de règle, gravité, titre en français, message officiel, emplacement, correction, fiche explicative), la facture lue et les versions exactes des règles appliquées. Les en-têtes x-quota-limite et x-quota-restant donnent votre consommation du mois.

{
  "verdict": "non-conforme",
  "resume": "3 règles françaises ne sont pas respectées : la facture sera refusée…",
  "syntaxe": "CII",
  "profil": { "code": "EN16931", "libelle": "EN 16931", "identifiant": "urn:cen.eu:en16931:2017", "reforme": "admis" },
  "regles_appliquees": "FR",
  "erreurs": [
    {
      "code": "BR-FR-10",
      "identifiant": "BR-FR-10_BT-30",
      "gravite": "bloquant",
      "etape": "france",
      "titre": "SIREN du vendeur absent ou mal codé",
      "message_officiel": "[BR-FR-10/BT-30] …",
      "correction": "Déclarez le SIREN (9 chiffres) avec le schéma 0002…",
      "emplacement": "Vendeur › Immatriculation (BT-30)",
      "occurrences": 1,
      "bloquante_le": "2026-10-01",
      "fiche": "https://verifier-factur-x.com/erreurs/…"
    }
  ],
  "facture": { "numero": "F2026-0042", "date": "2026-09-23", "totalTTC": "1200.00", … },
  "composants": ["Paquet FNFE-MPE v1.4.0.04 (04/09/2026)", "…"],
  "duree_ms": 412
}

Formats et règles

Le format est reconnu automatiquement : Factur-X et ZUGFeRD (PDF/A-3), CII et UBL EN 16931 avec les règles françaises BR-FR, messages de statut CDAR, XRechnung, Peppol BIS 3.0, NLCIUS, CIUS-RO, UBL.BE, FatturaPA, Facturae, ebInterface, KSeF FA(3) et Finvoice. Le paramètre regles force un jeu de règles pour les factures EN 16931 : FR, DE (XRechnung), PEPPOL, NL, RO, BE ou EN16931 seule. Détail : formats internationaux, versions des règles.

Quotas

Au-delà, ou pour une licence annuelle avec facture et bon de commande : demandez un devis.