API REST
Laissez votre propre système facturer
Émettez une facture directement depuis votre boutique en ligne, votre application ou un script. Authentification par jeton, pagination par curseur et écritures idempotentes, avec 100 requêtes par mois dans la formule Free, sans carte bancaire.
curl https://app.lucanto.eu/api/v1/workspaces/{workspace_id}/invoices \
-H "Authorization: Bearer lct_live_xxx"Ce que vous pouvez construire
Les commandes deviennent des factures
Votre boutique en ligne ou votre application appelle Lucanto dès qu’une commande est payée, et la facture existe : sans export, sans ressaisie, sans rattrapage en fin de mois.
Des clients toujours synchronisés
Créez et mettez à jour vos clients depuis votre propre système, et gardez des coordonnées et des informations d’entreprise identiques des deux côtés.
Des documents que vous pouvez relire
Récupérez vos factures, leur statut de paiement et les données associées pour alimenter votre propre reporting, sans passer par des tableurs exportés.
L’API est incluse dans la formule Free
L’API REST n’est pas réservée aux grands comptes. La formule Free comprend 100 requêtes par mois, de quoi développer l’intégration, la tester et faire circuler un petit volume de factures en conditions réelles. Quand il vous faut une limite plus élevée, vous passez à la formule supérieure : vous ne débloquez pas une fonctionnalité.
De zéro à votre premier appel
Créer un jeton d’accès
Dans Lucanto, ouvrez Paramètres → API et générez un jeton d’entreprise (lct_live_). Il est rattaché à une seule entreprise plutôt qu’à une personne : l’intégration continue donc de fonctionner quand celui qui l’a installée passe à autre chose, et elle n’accède jamais aux autres entreprises de qui que ce soit. Pour un essai rapide depuis votre propre script, un jeton personnel (lct_pat_) suffit. Les périmètres (scopes) permettent de garder en lecture seule une intégration qui doit le rester.
Effectuer le premier appel
Envoyez votre première requête à l’API Lucanto (https://app.lucanto.eu/api/v1) avec le jeton dans l’en-tête Authorization. Le guide de démarrage rapide de la documentation vous accompagne de bout en bout en moins de cinq minutes.
La fiabiliser pour la production
Envoyez un en-tête Idempotency-Key avec chaque requête POST afin qu’une nouvelle tentative ne puisse pas émettre deux fois la même facture, parcourez les collections avec le curseur plutôt qu’avec un décalage (offset), et traitez l’enveloppe d’erreur au lieu de vous contenter de vérifier un code HTTP 200.
Comment se comporte l’API
Les détails qui déterminent si une intégration survit à sa première mauvaise semaine. Chaque ligne renvoie vers sa page dans la documentation.
| Aspect | Fonctionnement |
|---|---|
| URL de base | https://app.lucanto.eu/api/v1 |
| Jeton d’entreprise (lct_live_) | Rattaché à une seule entreprise, pour les intégrations de boutique en ligne et de comptabilité qui agissent au nom de la société |
| Jeton personnel (lct_pat_) | Vos propres droits, dans toutes les entreprises auxquelles vous appartenez, pour les scripts et les assistants IA |
| Pagination | Par curseur, stable même quand des éléments sont insérés |
| Idempotence | En-tête Idempotency-Key sur les requêtes POST, pour pouvoir réessayer sans risque |
| Erreurs | Une seule enveloppe d’erreur pour tous les endpoints |
Nous publions ce qui change
Les nouveaux endpoints, les nouveaux champs et les changements incompatibles sont consignés dans un journal des modifications public de l’API. Les changements incompatibles y sont signalés comme tels : vous les voyez avant qu’ils ne vous atteignent, et le flux RSS vous les apporte sans que vous ayez à revenir vérifier.
Requêtes par formule
La limite de requêtes augmente avec la formule. Le support technique de l’API est disponible à partir de Starter. Les prix des options s’entendent hors TVA.
| Ce que vous obtenez | Disponibilité |
|---|---|
| Requêtes, formule Free | 100 / mois |
| Requêtes, formule Starter | 500 / mois |
| Requêtes, formule PRO | 5 000 / mois |
| Requêtes, formule Business | 20 000 / mois |
| Packs de requêtes supplémentaires | Business uniquement10 000 pour 5 € · 50 000 pour 20 €, hors TVA |
| Support technique de l’API | À partir de Starter |
| Serveur MCP pour agents IA | Toutes les formules, Free compriseDécompté de la même limite mensuelle de requêtes |
Inutile de tout construire vous-même
Si vous n’avez pas de développeur disponible, deux voies ne demandent aucun code. Connectez Lucanto à un assistant IA via MCP et demandez-lui vos factures en langage courant. Ou confiez l’intégration à l’un des développeurs ci-dessous : c’est précisément leur métier.
Partenaires d’intégration
Des développeurs et studios indépendants qui ont déjà travaillé avec l’API Lucanto et peuvent réaliser votre intégration à votre place. Ils vous facturent directement : nous ne prélevons aucune commission et nous ne servons pas d’intermédiaire.
| Société | Pays | Contact | Technologies | |
|---|---|---|---|---|
| SME Digital s.r.o. | Slovaquie | Miloš Blaško | info@visblee.sk | PHP, Laravel, Ruby |
| Seiri s.r.o. | Slovaquie | Marek Panti | marekpanti@gmail.com | Node.js, NestJS, Java |
| Seky IT s.r.o. | Slovaquie | Lukáš Sekerák | sekys.sekys@gmail.com | PHP, Node.js |
| Studio TEM, s.r.o. | Slovaquie | Michal Fehér | spolupraca@studiotem.com+421 911 258 330 | PHP, Laravel, WooCommerce, WordPress, Node.js |
| MATATE s.r.o. | Slovaquie | Dávid Brontvaj | info@matate.sk | PHP, Next.js, Node.js |
Vous souhaitez figurer ici ?
Si vous réalisez des intégrations et souhaitez que nous vous recommandions des missions, écrivez-nous. Indiquez-nous les technologies que vous utilisez et où nous pouvons voir votre travail : nous vous ajouterons à ce tableau. hello@lucanto.eu
Questions fréquentes sur l’API
L’API REST est-elle disponible dans la formule Free ?
Oui. L’API REST de Lucanto est incluse dans la formule Free, avec 100 requêtes par mois : inutile de changer de formule pour connecter votre propre système. Les limites plus élevées viennent avec les formules payantes : Starter 500, PRO 5 000 et Business 20 000 requêtes par mois.
Quelles sont les limites de requêtes selon la formule ?
Free 100, Starter 500, PRO 5 000 et Business 20 000 requêtes par mois. Avec Business, vous pouvez acheter des packs supplémentaires : 10 000 requêtes pour 5 € ou 50 000 pour 20 €, hors TVA. Les formules inférieures n’ont pas d’option de requêtes supplémentaires ; si vous avez besoin de plus, vous passez à la formule supérieure.
Puis-je émettre une facture depuis mon propre système ?
Oui, c’est tout l’intérêt de l’API. Depuis votre application, votre boutique en ligne ou un outil interne, vous appelez Lucanto et émettez une facture sans rien ressaisir ; vous pouvez aussi synchroniser vos clients et récupérer vos documents et leur statut. Les endpoints, les formats et l’authentification sont documentés sur docs.lucanto.eu.
Quel jeton dois-je utiliser ?
Pour une intégration qui agit au nom de la société (boutique en ligne, synchronisation comptable, outil interne), utilisez un jeton d’entreprise (lct_live_). Il est rattaché à cette seule entreprise : il ne peut donc pas accéder aux autres entreprises de qui que ce soit, et il continue de fonctionner quand la personne qui l’a créé s’en va. Un jeton personnel (lct_pat_) porte vos propres accès dans toutes les entreprises auxquelles vous appartenez, ce qui convient aux scripts personnels et aux assistants IA. Une règle vaut pour les deux : à sa création, un jeton est plafonné par les droits de l’utilisateur qui l’a émis, et ne peut donc jamais accorder plus d’accès que cette personne n’en a déjà.
En quoi est-ce différent du serveur MCP ?
Même modèle d’accès, mais un autre consommateur et un autre jeton. L’API REST est ce que votre code appelle, généralement avec un jeton d’entreprise qui appartient à la société. MCP est ce qu’appelle un assistant IA comme Claude ou ChatGPT, avec un jeton personnel qui vous appartient. Les deux utilisent les mêmes périmètres d’autorisation et sont décomptés de la même limite mensuelle de requêtes. MCP est inclus dans chaque formule, Free comprise.
Allez-vous casser mon intégration ?
Les changements notables (nouveaux endpoints, nouveaux champs et changements incompatibles) sont publiés dans un journal des modifications public de l’API, que vous pouvez filtrer par étiquette et suivre par RSS. Les changements incompatibles y sont signalés comme tels : un changement qui vous concerne est annoncé avant d’atteindre votre intégration, au lieu d’être découvert quand quelque chose cesse de fonctionner.
Proposez-vous un support technique pour l’API ?
Le support technique de l’API est disponible à partir de la formule Starter. Avec Free, vous disposez de l’API elle-même avec 100 requêtes par mois, mais pas du support correspondant. Si vous travaillez sur une intégration et avez besoin d’un coup de main, écrivez-nous via le formulaire de contact.