API Directe JSON → Factur-X
Generez des factures Factur-X conformes EN 16931 directement depuis vos donnees JSON. Pas d'IA, pas de PDF en entree — juste du JSON structuré, pour un resultat deterministe et fiable.
5 endpoints, un pipeline complet
Utilisez chaque endpoint individuellement ou combinez-les selon votre besoin.
/api/v2/xml
JSON → XML Factur-X. Genere le XML CII conforme EN 16931 avec validation integree.
/api/v2/validate
Validation EN 16931 complete. 32 regles verifiees avec messages d'erreur detailles.
/api/v2/embed
JSON + votre PDF → Factur-X. Embarque le XML dans votre PDF existant avec conversion PDF/A-3.
/api/v2/pdf
JSON → PDF Factur-X complet. Genere le PDF, le XML et les embarque ensemble. Tout-en-un.
/api/v2/render
XML → PDF lisible. Transforme un XML Factur-X en PDF de visualisation.
Pourquoi l'API Directe ?
Deterministe
Pas d'IA, pas d'interpretation. Memes donnees en entree = meme resultat a chaque fois. Ideal pour l'automatisation.
Valide EN 16931
32 regles de validation integrees. Chaque facture est verifiee avant generation. Conforme Chorus Pro.
Modulaire
Utilisez uniquement les endpoints dont vous avez besoin. Generez du XML seul, validez, ou obtenez un PDF complet.
Exemple d'integration
Generez une facture Factur-X complete en un seul appel API.
curl -X POST https://formatx.fr/api/v2/pdf \
-H "Content-Type: application/json" \
-H "X-API-Key: fxk_votre_cle" \
-d '{
"invoiceNumber": "F2026-042",
"invoiceDate": "2026-02-13",
"seller": {
"name": "Ma Societe SAS",
"address": "10 rue de Paris",
"city": "Paris",
"postalCode": "75001",
"country": "FR",
"vatNumber": "FR12345678901"
},
"buyer": {
"name": "Client SARL",
"address": "5 avenue des Champs",
"city": "Lyon",
"postalCode": "69001",
"country": "FR"
},
"items": [
{
"description": "Prestation de conseil",
"quantity": 10,
"unitPrice": 150.00,
"vatRate": 20
}
]
}' --output facture-F2026-042.pdfPour qui ?
Editeurs de logiciels
Integrez la generation de Factur-X dans votre ERP, CRM ou logiciel de facturation sans developper la norme EN 16931 en interne.
Plateformes SaaS
Ajoutez la conformite Factur-X a votre plateforme de facturation, marketplace ou outil de gestion en quelques lignes de code.
Developpeurs
API REST standard avec authentification par cle API. Compatible avec tous les langages : JavaScript, Python, PHP, Java, C#, Go...
PDP & OD
Plateformes de Dematerialisation Partenaires et Operateurs de Dematerialisation : utilisez FormatX comme brique de generation Factur-X.
Questions frequentes
Quelle est la difference avec l'API v1 ?
L'API v1 utilise l'IA pour extraire les donnees d'un PDF existant. L'API v2 (Directe) accepte du JSON structure — c'est deterministe, plus rapide, et conçu pour les editeurs de logiciels qui ont deja les donnees de facturation.
Le PDF genere est-il PDF/A-3 ?
Oui. Les endpoints /v2/embed et /v2/pdf generent des PDF/A-3 avec le XML Factur-X embarque et les metadonnees XMP conformes. Le tout est verifie par notre pipeline Ghostscript.
Combien coute l'API ?
Un plan gratuit est disponible pour tester. Pour la production, consultez notre documentation pour les plans et quotas disponibles. Tarification a l'usage.
Quelles validations sont effectuees ?
32 regles EN 16931 sont verifiees : presence des champs obligatoires (BR-01 a BR-65), coherence des montants, TVA, devises, et format des identifiants. Les erreurs bloquent la generation avec un message detaille.