Documentation API

Les bases pour intégrer la génération Factur-X.

L'API expose un appel de génération et un appel de validation à blanc, authentifiés par clé API, avec un payload JSON et des réponses structurées. La documentation complète est disponible dans l'espace client.

Authentification

Les appels utilisent une clé API dans l'en-tête Authorization et une référence unique dans revx-cle-unique.

Authorization: Bearer VOTRE_CLE_API_LIVE
revx-cle-unique: facture-2026-000123

Premier appel

curl -X POST https://votre-domaine.example/api/facturx/generer \
  -H "Authorization: Bearer VOTRE_CLE_API_LIVE" \
  -H "revx-cle-unique: facture-2026-000123" \
  -H "Content-Type: application/json" \
  -d @demande.json

{
  "facturx": {
    "profil": "EN16931",
    "numeroPiece": "2026-000123",
    "...": "donnees de facture selon le profil"
  },
  "pdfBase64": "JVBERi0xLjcK...",
  "optionsPdf": {
    "modePdf": "standard"
  }
}

Payload JSON

Description des profils, champs obligatoires, types, objets imbriqués et valeurs énumérées.

Réponses

Structure des réponses de succès, erreurs de validation, erreurs de traitement et informations de conformité technique.

Codelists

Valeurs acceptées pour les listes courtes et renvoi aux référentiels officiels lorsque la liste est trop large.

Réponse de succès

{
  "guidTraitement": "00000000-0000-0000-0000-000000000000",
  "statut": "succes",
  "pdfFacturxBase64": "JVBERi0xLjcK...",
  "conformite": {
    "jsonSchema": "ok",
    "xsd": "ok",
    "schematron": "ok",
    "modePdf": "standard",
    "warnings": []
  },
  "credits": { "cout": 1 },
  "erreur": null
}

Réponse d'erreur

{
  "statut": "echec",
  "erreur": {
    "code": "validation_json_echec",
    "message": "Le payload ne respecte pas le schéma attendu.",
    "details": []
  }
}

JSON invalide

400 · validation_json_echec

PDF source invalide

422 · pdf_source_invalide

Validation documentaire

422 · validation_*_echec

Validation à blanc

Une clé de test permet de vérifier la forme d'un appel sans générer de fichier de production.

curl -X POST https://votre-domaine.example/api/facturx/valider-appel-test \
  -H "Authorization: Bearer VOTRE_CLE_API_TEST" \
  -H "revx-cle-unique: test-integration-001" \
  -H "Content-Type: application/json" \
  -d @demande.json

Accéder à l'espace client Demander un accès

FactureKit API produit et contrôle des fichiers au format Factur-X. Le service n'est pas une plateforme agréée, ne transmet pas vos factures et ne remplace pas vos contrôles fiscaux ou comptables.