📖 Documentation API

L'API eFacturIA permet d'extraire automatiquement les données structurées d'une facture (PDF ou image) et de générer le XML au format Factur-X (EN 16931), le standard obligatoire pour la facturation électronique en France dès septembre 2026.

🔐 Authentification

L'API est accessible sans authentification en mode gratuit (5 requêtes/jour par IP). Pour les forfaits payants, une clé API sera requise (header X-API-Key).

📬 Endpoints

POST /api/parse

Parse une facture (PDF, PNG, JPG, WEBP) et retourne les données extraites au format JSON structuré, avec le XML Factur-X correspondant.

Content-Type :

multipart/form-data

Paramètres :

Nom	Type	Description
file	File	Fichier PDF ou image de la facture
email	String (optionnel)	Email du compte payant (pour les forfaits)

Réponse 200 :

{ "success": true, "invoice": { "invoice_number": "FACT-2026-0001", "invoice_date": "2026-07-15", "due_date": "2026-08-15", "vendor_name": "Fournisseur SAS", "vendor_siret": "12345678901234", "vendor_tva": "FR12345678901", "vendor_address": "123 rue Exemple, 75001 Paris", "vendor_email": "contact@fournisseur.fr", "client_name": "Client SARL", "client_siret": "98765432109876", "client_address": "456 avenue Client, 69000 Lyon", "total_ht": 1000.00, "total_tva": 200.00, "total_ttc": 1200.00, "currency": "EUR", "line_items": [ { "description": "Prestation de conseil", "quantity": 1.0, "unit_price_ht": 1000.00, "total_ht": 1000.00, "tva_rate": 20.0 } ], "payment_terms": "30 jours", "confidence": 0.95 }, "factur_x_xml": "<?xml version=...>...", "model_used": "gpt-4o-mini", "tokens_used": 1250, "processing_time_ms": 3200, "parsed_at": "2026-07-23T12:00:00" }

Erreurs :

400 — Format non supporté ou fichier vide 413 — Fichier trop volumineux (>10 MB) 429 — Limite quotidienne atteinte (5/jour/IP en gratuit) 500 — Erreur interne (API LLM, parsing...)

Headers de réponse :

X-RateLimit-Remaining: 4

GET /api/rate-limit

Retourne les informations de rate limiting pour l'IP courante.

Réponse 200 :

{ "ip": "91.134.23.122", "free_used_today": 2, "free_limit": 5, "free_remaining": 3, "is_paid": false, "paid_tier": null }

GET /health

Health check du service.

{ "status": "ok", "service": "efacturia", "version": "0.1.0" }

⏱️ Limites

Plan	Parsings / jour	Accès API	Prix
Gratuit	5	Non	0 €
Starter	50	✓	9,90 €/mois
Pro	200	✓	29,90 €/mois
Business	2000	✓	99,90 €/mois

🧪 Exemple cURL

curl -X POST http://localhost:8770/api/parse \ -F "file=@facture.pdf" \ -H "Accept: application/json"

L'API retourne un JSON avec les champs extraits et le XML Factur-X.

📄 Format Factur-X

Le format Factur-X (norme EN 16931) est le standard de facturation électronique obligatoire en France à partir de septembre 2026. Il combine un PDF/A-3 lisible par un humain avec un fichier XML structuré (UBL 2.1 ou CII) lisible par une machine.

L'API eFacturIA extrait les données de n'importe quelle facture (PDF, scan, photo) et génère le XML Factur-X (profil MINIMUM) correspondant, prêt à être intégré dans un flux de facturation électronique.