API : lire une facture électronique par programme

Le même moteur que la page d'accueil, accessible en REST. Vous envoyez un fichier Factur-X, ZUGFeRD, UBL ou CII ; vous recevez ses données structurées et la liste des anomalies EN 16931, en JSON.

À quoi ça sert

Si vous recevez des factures en flux continu (boîte mail dédiée, dépôt fournisseur, ERP), la question n'est pas de lire un fichier, mais de brancher la lecture sur un traitement existant :

Pré-comptabilisation : extraire fournisseur, dates, montants et TVA sans ressaisie ;
Contrôle à l'entrée : refuser ou signaler une facture dont les montants ne tombent pas juste, avant qu'elle n'entre dans le circuit de validation ;
Détection de format : savoir si un PDF reçu contient réellement des données structurées, ou s'il n'est électronique que de nom.

Points d'entrée

Méthode	Chemin	Rôle
`POST`	`/v1/invoices/parse`	Analyse une facture : données extraites + anomalies
`POST`	`/v1/invoices/parse-batch`	Analyse un lot de factures en une requête
`POST`	`/v1/invoices/export.csv`	Renvoie un CSV prêt pour Excel français (`?lang=en` pour la variante anglaise : virgules, points décimaux)
`GET`	`/v1/usage`	Consommation et limites de votre clé
`GET`	`/v1/health`	Disponibilité du service

La documentation interactive, avec le schéma complet des réponses, est disponible sur /docs : vous pouvez y essayer chaque appel directement.

Authentification

Chaque requête porte votre clé, au choix dans l'un des deux en-têtes :

X-API-Key: votre_cle

Authorization: Bearer votre_cle

Une requête sans clé valide reçoit 401. Les erreurs sont renvoyées en JSON, avec un code stable exploitable par programme plutôt qu'un message à interpréter.

Exemple

curl -X POST https://facturolia.fr/v1/invoices/parse \
     -H "X-API-Key: votre_cle" \
     -F "file=@facture.pdf"

La réponse contient le format et le profil détectés, les parties, les dates, les totaux, l'IBAN lorsqu'il est présent, et la liste des anomalies avec le calcul correspondant. Les libellés de l'API sont en anglais par défaut ; ajoutez ?lang=fr pour recevoir les messages en français.

Limites d'usage

Palier	Par minute	Par jour
Découverte	10	100
Starter	60	5 000
Growth	300	50 000

Un dépassement renvoie 429 avec un en-tête Retry-After. Chaque fichier est limité à 10 Mo, et un lot à 200 fichiers.

Assistants IA : serveur MCP

Un serveur MCP permet à un assistant (Claude et autres clients compatibles) de lire et vérifier une facture directement : vous pointez un fichier, il répond avec le contenu en clair et le contrôle EN 16931.

Aucune dépendance à installer : Python 3.10+ suffit. Téléchargez facturolia_mcp.py (documentation) et déclarez-le dans votre client :

{
  "mcpServers": {
    "facturolia": {
      "command": "python",
      "args": ["/chemin/vers/facturolia_mcp.py"],
      "env": { "FACTUROLIA_API_KEY": "votre-cle", "FACTUROLIA_LANG": "fr" }
    }
  }
}

Deux outils sont exposés : read_invoice (contenu complet) et check_invoice (verdict de conformité seul). Les réponses sont en anglais par défaut ; ajoutez "FACTUROLIA_LANG": "fr" dans le champ env pour les recevoir en français. Le fichier est envoyé à l'API pour analyse : traitement en mémoire, aucune conservation, mais ce n'est pas un traitement local : à vérifier si votre politique interne l'interdit.

Confidentialité

Les fichiers envoyés à l'API sont traités en mémoire puis effacés. Aucune facture n'est stockée, et leur contenu n'apparaît pas dans les journaux techniques. Les serveurs sont situés dans l'Union européenne. Voir la politique de confidentialité.

Obtenir une clé : l'API est en accès anticipé : le palier Découverte est gratuit, et les paliers payants sont détaillés sur la page des tarifs. L'accès se fait sur demande, il n'y a pas d'inscription automatique. Écrivez à info@facturolia.fr en décrivant votre usage et le volume attendu.

Demander une clé API → Voir la documentation interactive

Ce que cette API ne fait pas. Elle lit et contrôle des factures. Elle n'en émet pas, ne les transmet pas, et ne constitue pas une solution de conformité : l'acheminement relève d'une Plateforme Agréée.