L'API de validation FacturBridge exécute la chaîne complète (XML, XSD, Schematron EN 16931, PDF/A-3 via veraPDF) et retourne un ValidationReport structuré avec messages en français à trois niveaux. Cette page documente le contrat d'interface pour les éditeurs — accès sur demande via /api-validation.

Requête

POST multipart avec le fichier PDF ou XML. Authentification par clé API + signature HMAC.

curl -X POST https://api.facturbridge.fr/v1/validate \
  -H 'Authorization: Bearer <API_KEY>' \
  -F 'file=@facture.pdf'

Réponse (ValidationReport)

score (0-100), verdict (conforme | partiellement_conforme | non_conforme | fichier_invalide), issues[] avec code, sévérité, catégorie, titre/impact/correction en français, refTechnique et detailTechnique.

{
  "score": 82,
  "verdict": "partiellement_conforme",
  "issues": [{
    "code": "PDFA_FONT_NOT_EMBEDDED",
    "severity": "avertissement",
    "titre": "Les polices ne sont pas intégrées dans le fichier"
  }]
}

Cas d'usage éditeurs

Validation à la volée avant émission · Contrôle des factures fournisseurs entrantes · Brique de conformité en marque blanche. Contact : /api-validation.

API de validation FacturBridge : référence

Requête

Réponse (ValidationReport)

Cas d'usage éditeurs