Factur-X Studio

Intégrer Factur-X dans votre application avec une API

Mis à jour le 20 novembre 2026 · 6 min de lecture

Vous éditez un logiciel de gestion, un ERP, une application métier ou un simple script comptable. Vous n'avez pas envie de réimplémenter Factur-X, PDF/A-3, les schémas XSD et les règles EN 16931. Une API spécialisée règle le problème en quelques lignes.

Ce que doit couvrir une API Factur-X

  • Générer : à partir de données JSON, produire un PDF avec le XML embarqué.
  • Valider : contrôler un fichier existant et renvoyer les erreurs avec leur code.
  • Extraire : récupérer le XML d'un PDF reçu, pour l'import comptable.
  • Compter : gérer les quotas et les clés sans construire une usine à gaz.

Les endpoints

MéthodeCheminUsage
POST/api/v1/invoicesGénérer un PDF + XML
POST/api/v1/validateValider un PDF ou un XML
POST/api/v1/extractExtraire le XML d'un PDF
GET/api/v1/meOffre, consommation, limite

Authentification

Une clé API, créée depuis votre espace, à passer en en-tête :

Authorization: Bearer fx_live_votre_cle

La clé est affichée une seule fois à la création. Elle est stockée hachée côté serveur : si vous la perdez, il faut en créer une nouvelle.

Exemple de génération

curl -X POST https://facturx.arparun.re/api/v1/invoices \
  -H "Authorization: Bearer $FX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "F-2026-0042",
    "issue_date": "2026-11-20",
    "due_date": "2026-12-20",
    "seller": {
      "name": "Atelier Lagon",
      "legal_id": "91234567800017",
      "vat_id": "FR32912345678",
      "address": "12 rue des Artisans",
      "postcode": "97400",
      "city": "Saint-Denis",
      "country": "FR"
    },
    "buyer": {
      "name": "Hotel Le Recif",
      "address": "4 boulevard de la Plage",
      "postcode": "97434",
      "city": "Saint-Gilles",
      "country": "FR"
    },
    "lines": [
      {"description": "Conseil", "quantity": 2, "unit_price": 450, "vat_rate": 20}
    ]
  }'

La réponse contient pdf_base64, xml_base64 et un résumé des totaux. Avec l'en-tête Accept: application/pdf, l'API renvoie directement le PDF.

Valider un fichier reçu

curl -X POST https://facturx.arparun.re/api/v1/validate \
  -H "Authorization: Bearer $FX_KEY" \
  -F "file=@facture.pdf"

La réponse donne valid, le profil détecté, un résumé de la facture et la liste des erreurs avec leur code. C'est ce qu'il faut pour afficher un diagnostic à vos utilisateurs, ou pour bloquer un import avant qu'il ne pollue la comptabilité.

Ce qu'il faut anticiper

  • Les quotas : prévoyez un code 402 et un message clair, pas une erreur générique.
  • Les fichiers volumineux : limitez la taille côté client et côté serveur.
  • Les erreurs de données : une réponse 422 avec le champ fautif vaut mieux qu'un 500.
  • La journalisation : conservez l'identifiant de la facture et le résultat, pas le contenu complet.

Pourquoi passer par une API plutôt que tout coder

Produire un Factur-X conforme, c'est gérer PDF/A-3, les polices, les métadonnées XMP, le XML CII, les schémas XSD, les règles Schematron et leurs mises à jour. C'est un métier à part entière. Une API vous évite de maintenir cette complexité et vous laisse concentrer vos efforts sur votre produit.

Les tarifs sont simples : 29 €/mois pour 500 traitements, 99 €/mois pour 5 000. Une clé gratuite permet de tester. Voir la documentation complète.

Bon à savoir : l'API est hébergée en France et ne conserve pas les fichiers générés au-delà de la réponse. Les données comptables restent chez vous.

Questions fréquentes

Quels langages sont supportés ?

Tous. L'API est du HTTP/JSON classique : Python, PHP, Node.js, Java, Go ou un simple curl.

Peut-on l'auto-héberger ?

L'offre publique est hébergée en France. Pour un déploiement interne, l'application peut être installée sur votre infrastructure ; contactez-nous.

Que se passe-t-il en cas de dépassement de quota ?

L'API renvoie un code 402 avec un lien vers la page de facturation. Les traitements déjà effectués restent accessibles.

Testez gratuitement

Générez une facture Factur-X conforme, validez un fichier existant ou intégrez l'API. 20 traitements offerts chaque mois.