Intégrer Factur-X dans votre application avec une API
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éthode | Chemin | Usage |
|---|---|---|
| POST | /api/v1/invoices | Générer un PDF + XML |
| POST | /api/v1/validate | Valider un PDF ou un XML |
| POST | /api/v1/extract | Extraire le XML d'un PDF |
| GET | /api/v1/me | Offre, 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.