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
`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://lirefacture.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 ; l'interface web, elle, est 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.

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 supérieurs ne sont pas encore commercialisés. L'accès se fait sur demande, il n'y a pas d'inscription automatique. Écrivez à nordventures.tg@gmail.com en décrivant votre usage et le volume attendu.

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.