API Factur-X
Trois points d'entrée : générer une facture, valider un fichier, extraire le XML. Authentification par clé Bearer.
Base URL : https://facturx.arparun.re/api/v1 — créez votre clé depuis votre espace.
Authentification
Authorization: Bearer fx_live_votre_cle
Générer une facture
POST /api/v1/invoices
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": "Hôtel Le Récif", "address": "4 bd de la Plage",
"postcode": "97434", "city": "Saint-Gilles", "country": "FR"},
"lines": [
{"description": "Conseil", "quantity": 2, "unit_price": 450, "vat_rate": 20}
]
}'
Réponse JSON : pdf_base64, xml_base64, summary. Ajoutez Accept: application/pdf pour recevoir directement le PDF.
Champs principaux
| Champ | Type | Description |
|---|---|---|
| number | string | Numéro de facture (obligatoire, 35 caractères max) |
| issue_date | date | Date d'émission AAAA-MM-JJ |
| due_date | date | Échéance (optionnelle) |
| currency | string | Devise ISO 4217, défaut EUR |
| seller / buyer | objet | name, legal_id (SIREN/SIRET), vat_id, address, postcode, city, country |
| lines[] | liste | description, quantity, unit_price (HT), vat_rate, unit |
| vat_exempt | bool | Franchise en base : catégorie E, taux 0 |
| payment.iban | string | IBAN pour le règlement |
Valider un fichier
POST /api/v1/validate — multipart file, ou JSON {"xml": "..."}.
curl -X POST https://facturx.arparun.re/api/v1/validate \ -H "Authorization: Bearer $FX_KEY" \ -F "file=@facture.pdf"
Réponse : valid, summary, errors[] avec le code de règle (ex. BR-CO-15) et un message lisible.
Extraire le XML
POST /api/v1/extract — renvoie le XML CII contenu dans un PDF Factur-X.
Quota et erreurs
GET /api/v1/me renvoie l'offre, la consommation et la limite.
| Code | Signification |
|---|---|
| 401 | Clé absente, invalide ou révoquée |
| 402 | Quota mensuel atteint |
| 422 | Données de facture invalides ou fichier non conforme |
Exemple Python
import base64, requests, os
r = requests.post(
"https://facturx.arparun.re/api/v1/invoices",
headers={"Authorization": "Bearer " + os.environ["FX_KEY"]},
json={...},
timeout=30,
)
r.raise_for_status()
data = r.json()
open("facture.pdf", "wb").write(base64.b64decode(data["pdf_base64"]))