Factur-X Studio

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

ChampTypeDescription
numberstringNuméro de facture (obligatoire, 35 caractères max)
issue_datedateDate d'émission AAAA-MM-JJ
due_datedateÉchéance (optionnelle)
currencystringDevise ISO 4217, défaut EUR
seller / buyerobjetname, legal_id (SIREN/SIRET), vat_id, address, postcode, city, country
lines[]listedescription, quantity, unit_price (HT), vat_rate, unit
vat_exemptboolFranchise en base : catégorie E, taux 0
payment.ibanstringIBAN 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.

CodeSignification
401Clé absente, invalide ou révoquée
402Quota mensuel atteint
422Donné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"]))