requests + retry, async possible via httpx, parfait pour orchestrer vos batchs EN16931.

Intégrer FacturX API avec Python

Compatible scripts CLI, worker Celery, pipelines Airflow ou FastAPI.

Support sync/async

Idéal pour pipelines data et automatisations

Hash request_id pour tracer les factures

Exemple curl

multipart/form-data

curl -X POST https://api.facturxapi.com/api/v1/validate \
  -H "Authorization: Bearer $FACTURX_API_KEY" \
  -F "file=@facture-x.pdf" \
  -F "lang=fr"

Snippet Python

Auth + appel /api/v1/validate

import os
import requests

API_KEY = os.environ['FACTURX_API_KEY']
API_URL = 'https://api.facturxapi.com/api/v1/validate'

files = {
    'file': open('invoices/FX-2024-0001.pdf', 'rb'),
}

response = requests.post(
    API_URL,
    headers={'Authorization': f'Bearer {API_KEY}'},
    files=files,
    data={'lang': 'fr'}
)

data = response.json()
if not data.get('valid'):
    print('Erreurs détectées:', data.get('errors', []))

Les 4 endpoints — appels multipart

Mêmes headers d'auth, mêmes codes d'erreur, même pipeline PDF/A-3 + Schematron EN16931.

OpenAPI ↓ Postman ↓

POST /api/v1/validate

PDF/A-3 + XSD + Schematron

Valide un PDF Factur-X ou un XML CII. Retourne un rapport JSON structuré avec codes BR-* par ligne/champ.

curl -X POST https://api.facturxapi.com/api/v1/validate \
  -H "Authorization: Bearer $KEY" \
  -F "file=@facture.pdf"

POST /api/v1/extract

XML CII embarqué → JSON

Extrait le XML CII d'un PDF Factur-X reçu. Paramètre validate=true combine extraction + validation en une requête.

curl -X POST https://api.facturxapi.com/api/v1/extract \
  -H "Authorization: Bearer $KEY" \
  -F "file=@facture-recue.pdf" \
  -F "validate=true"

POST /api/v1/convert

PDF → Factur-X PDF/A-3

Convertit un PDF visuel + données ERP (mode invoice_data JSON) en Factur-X PDF/A-3 conforme. veraPDF-certifié.

curl -X POST https://api.facturxapi.com/api/v1/convert \
  -H "Authorization: Bearer $KEY" \
  -F "file=@facture.pdf" \
  -F 'invoice_data={"invoiceNumber":"FA-001",...}'

POST /api/v1/repair

Corrections déterministes

Corrige automatiquement les erreurs réparables d'un XML CII (dates, décimaux, namespaces, schemeID). Retour : diff + XML réparé.

curl -X POST https://api.facturxapi.com/api/v1/repair \
  -H "Authorization: Bearer $KEY" \
  -F "file=@facture-invalide.xml"

Checklist intégration

✓
Uploader depuis un dossier temporaire protégé (pas de /tmp partagé)
✓
Utiliser retrying ou tenacity pour gérer 429/500
✓
Anonymiser les logs (pas de PDF complet en clair)

Retries & timeouts

Utilisez tenacity ou httpx.Retry avec jitter pour protéger vos workers.

• Timeout côté requests : 20 s
• Limiter la concurrence via semaphore pour éviter 429
• Réémettre seulement les requêtes réseau safe (POST idem que file)

Erreurs fréquentes

Mappez vos logs aux codes pour des corrections rapides.

400 unsupported_media_type

Extension non supportée (docx, zip).

💡 Filtrer les uploads côté CLI et imposer pdf/xml uniquement.

502 upstream_timeout

Validation lourde (PDF + Schematron) > 30 s.

💡 Découper le lot et relancer plus tard (queue Celery + countdown).

quota_exceeded

Seuil mensuel dépassé.

💡 Abonner un handler Celery pour déclencher Analytics.quota_exceeded et alerter votre équipe.

FAQ

Puis-je traiter un lot depuis Pandas ?

Oui, bouclez sur vos lignes et envoyez les fichiers un par un (max 3 en parallèle).

Comment stocker le rapport ?

Sauvegardez le JSON de réponse dans S3 ou Postgres avec le hash de la facture.

Guide EN16931

Comprendre les profils et règles

Tester en ligne

Uploader rapidement un échantillon

Tarifs

Anticiper vos lots mensuels

Et après ?

Passer en production

Choisissez l'étape suivante pour activer FacturX API sur votre stack. Tous les liens sont internes pour garder le suivi clair.

🔑

Activer ma clé API

10 validations gratuites + clés distinctes pour dev/staging.

💶

Choisir un plan

Free, Pro ou Scale selon vos appels mensuels et SLA requis.

📘

Lire la documentation

Endpoints détaillés + schémas JSON pour parser les réponses.

🧪

Vérifier une facture

Uploader un fichier depuis l'UI pour comparer avec la réponse API.