URL de base
https://freebillgen.com/api/v1Authentification
Chaque requête utilise un jeton Bearer. Créez-le dans Paramètres → Clés API, accordez-lui les autorisations de lecture ou d’écriture nécessaires pour chaque ressource, définissez éventuellement une date d’expiration, puis transmettez-le avec chaque requête :
Authorization: Bearer <your-api-key>Les requêtes sont rattachées au compte qui a créé la clé et contrôlées selon les autorisations qui lui sont attribuées. Gardez le jeton secret et révoquez-le s’il a été exposé ou n’est plus utile.
Fonctionnalités
- Consulter les factures, clients, entreprises, paiements et échéanciers récurrents
- Créer et mettre à jour ces ressources avec l’API d’écriture (Pro)
- Récupérer les rapports de taxes et d’ancienneté des créances au format JSON
- Consulter la même file limitée de prochaines actions que celle du tableau de bord
- Lire les fichiers de facturation électronique de fournisseurs téléversés manuellement dans la boîte de réception (ce service ne reçoit rien via Peppol ou par courriel)
- Télécharger des correspondances génériques OASIS UBL et UN/CEFACT CII pour examen (sans validation de profil)
- Enregistrer des points de terminaison de liens de rappel HTTP (webhooks) pour les événements liés aux factures et aux paiements (Pro)
- Utiliser Idempotency-Key sur les écritures compatibles : si les données changent sous une même clé, l’API renvoie 409
- Parcourir les résultats avec la pagination par curseur links.next et régler per_page jusqu’à 100
- Permettre à un agent d’IA de lire une facture partagée : schema.org/Invoice en JSON-LD, plus Accept: application/json ou text/markdown sur chaque lien de partage signé
- Utiliser sans authentification le serveur MCP en lecture seule à l’adresse https://freebillgen.com/api/mcp (outils get_invoice et verify_invoice) pour les agents d’IA
Conventions
- Idempotence
- Pour les créations et actions compatibles, transmettez une valeur Idempotency-Key unique. Une nouvelle tentative avec des données identiques reproduit le résultat initial ; si les données ont changé, l’API renvoie 409.
- Pagination
- Les listes de ressources enregistrées utilisent un curseur. Suivez links.next ou transmettez ?cursor=..., puis réglez ?per_page= jusqu’à 100. Le flux limité des actions indique sa limite et précise s’il a été tronqué.
- Montants
- Les montants monétaires sont des chaînes JSON exactes, formatées selon le nombre de décimales prévu par la devise ISO 4217, par exemple "121.00" pour EUR ou "500" pour JPY. Les prix unitaires peuvent conserver une précision de saisie supérieure.
- Identifiants
- Chaque ressource est désignée par un identifiant opaque, jamais par un numéro séquentiel.
Exemple : répertorier vos factures
curl https://freebillgen.com/api/v1/invoices \
-H "Authorization: Bearer $FREEBILLGEN_API_KEY"Ouvrir la documentation interactive complète de l’API →
Questions sur l’API de facturation
L’API de facturation est-elle gratuite ?
Oui. L’API de lecture est incluse dans l’offre gratuite. L’API d’écriture et les liens de rappel HTTP sortants sont inclus dans Lifetime Pro à 49 €, taxes comprises : un seul paiement, sans frais mensuels ni renouvellement annuel.
Comment m’authentifier ?
Créez un jeton Bearer dans Paramètres -> Clés API, attribuez-lui des autorisations de lecture ou d’écriture pour chaque ressource, puis envoyez-le dans l’en-tête Authorization: Bearer de chaque requête. Les clés sont limitées à votre compte et peuvent être révoquées ou assorties d’une date d’expiration.
Puis-je créer des factures par programmation ?
Oui, avec l’API d’écriture incluse dans l’option Pro. Elle produit les mêmes factures professionnelles que l’application web, avec une numérotation séquentielle et un traitement configurable des taxes appliqué côté serveur. L’API ne certifie pas la conformité au droit local.
Comment éviter de créer une facture en double lors d’une nouvelle tentative ?
Transmettez une valeur Idempotency-Key unique lors de la création. Une nouvelle tentative avec les mêmes données et la même clé renvoie le résultat initial. Si vous réutilisez la clé avec des données différentes, l’API renvoie 409 au lieu de reproduire silencieusement une autre facture.
Puis-je consulter les factures que j’ai reçues ?
Oui, gratuitement. GET /api/v1/inbox répertorie les fichiers fournisseurs UBL ou CII compatibles que vous avez téléversés manuellement et que FreeBillGen a analysés, tout en conservant l’original à des fins d’audit. GET /api/v1/inbox/{id} renvoie un fichier précis. La reconnaissance de la syntaxe ne vaut pas validation de profil. Ces points de terminaison ne constituent pas un service de réception via Peppol, un réseau gouvernemental ou par courriel.
Un agent d’IA peut-il lire une facture sans compte ?
Oui. Toute facture partagée au moyen de son lien public signé est lisible par un agent à la même URL. La page intègre schema.org/Invoice en JSON-LD. L’en-tête Accept: application/json renvoie une facture structurée avec les parties, les lignes, les totaux, le solde dû et les moyens de paiement. Accept: text/markdown renvoie une version épurée et peu volumineuse. Un serveur Model Context Protocol (MCP) sans authentification et en lecture seule est aussi disponible à l’adresse https://freebillgen.com/api/mcp avec les outils get_invoice et verify_invoice. La signature du lien sert de jeton d’accès. Traitez donc l’URL complète comme une donnée secrète : toute personne qui la reçoit peut ouvrir la facture.