API Pennylane : ce que vous pouvez automatiser (guide)

Votre comptabilité vit dans Pennylane. Vos analyses, elles, vivent souvent ailleurs : dans des exports Excel refaits chaque mois et des copier-coller vers un tableau de bord, quand ce n’est pas dans une relance au cabinet pour obtenir une balance à jour. L’API Pennylane existe précisément pour supprimer cette manutention. Elle permet à vos autres outils de venir chercher, ou déposer, les données comptables directement, sans intervention humaine.

Ce guide s’adresse aux dirigeants et aux DAF déjà équipés de Pennylane, pas aux développeurs. Au programme : ce que l’API expose, ce que vous pouvez en attendre, ses prérequis, ses limites, et par où commencer.

L’API Pennylane, c’est quoi exactement ?

Une API (interface de programmation) est une porte d’entrée normalisée vers un logiciel : un autre programme s’y connecte avec une clé d’accès et peut lire ou écrire des données, exactement comme vous le feriez à l’écran, mais de façon automatique et répétable, à la vitesse d’une machine. Là où un export est une photo prise à la main, l’API est un robinet ouvert en permanence.

Pennylane expose deux API publiques, documentées sur son portail développeurs : l’API entreprise, qui donne accès aux données d’une société (celle qui nous intéresse ici), et l’API cabinet, pensée pour les cabinets d’expertise comptable qui gèrent de nombreux dossiers. Un point d’attention au passage : la première version de l’API entreprise est dépréciée depuis juillet 2025. Tout nouveau projet doit se construire sur la v2.

Ce que l’API Pennylane expose concrètement

D’après le centre d’aide officiel Pennylane, les API publiques permettent d’interagir avec :

• la facturation client : factures, devis, abonnements de facturation récurrente ;
• les achats : factures fournisseurs et leurs justificatifs ;
• la comptabilité : écritures comptables, plan de comptes, journaux ;
• les tiers et le catalogue : clients, fournisseurs, produits ;
• l’analytique : catégories et affectations ;
• la banque : transactions bancaires ;
• la facturation électronique : documents au format Factur-X.

Presque tout ce que vous voyez à l’écran est donc accessible par programme, en lecture mais aussi, pour une bonne partie des objets, en écriture. Cette double capacité change tout : c’est elle qui ouvre les cas d’usage sérieux.

Cinq cas d’usage qui justifient le chantier

1. Alimenter Power BI automatiquement. C’est le cas le plus fréquent. Plutôt que d’exporter le grand livre puis de retravailler le fichier, un connecteur interroge l’API chaque nuit et vos tableaux de bord se rafraîchissent seuls : marges, trésorerie, encours clients, à jour chaque matin, sans manipulation. Nous avons détaillé cette mécanique dans notre article Pennylane et Power BI pour le pilotage.

2. Consolider un groupe multi-sociétés. Quand chaque société vit dans son propre dossier Pennylane, l’API permet de collecter les écritures et les balances de tous les dossiers pour leur appliquer un plan de comptes commun. Le reporting groupe sort ensuite sans re-saisie ni classeur fragile.

3. Fiabiliser les rapprochements. En croisant l’API Pennylane avec votre CRM ou votre outil de gestion, vous détectez automatiquement les devis signés jamais facturés, les factures sans commande, les doublons fournisseurs. Ces contrôles tournent en tâche de fond et remontent des alertes.

4. Brancher vos outils métier en amont. L’API fonctionne aussi en écriture : un ERP, un logiciel de caisse ou une plateforme e-commerce peut pousser ses ventes en écritures, voire transmettre des factures au format Factur-X. À l’heure de la facturation électronique, ce n’est pas un détail.

5. Remplacer les exports récurrents. Pensez à la balance que quelqu’un envoie au banquier tous les mois, ou au détail des ventes préparé pour un associé. Tout fichier produit régulièrement « pour quelqu’un d’autre » est un candidat naturel, l’export du contrôleur de gestion en tête. L’API produit la même chose, à l’heure dite, sans erreur de manipulation.

Ce que nous constatons en mission : dans la plupart des directions financières, la collecte des données mange le plus gros du délai de production du reporting. C’est précisément la partie que l’API fait disparaître. Les équipes n’y gagnent pas seulement du temps : elles y gagnent un chiffre unique et traçable, produit de la même façon chaque mois.

Prérequis, limites et garde-fous

• Un abonnement éligible. La génération de jetons d’accès nécessite un abonnement Pennylane Essentiel ou supérieur, et le rôle administrateur ou dirigeant sur le compte.
• Un jeton traité comme un mot de passe. Il se crée dans le module Connectivité, où vous pouvez à tout moment lister et révoquer les accès actifs. Jamais dans un fichier partagé, jamais dans un e-mail.
• La sandbox d’abord. Pennylane fournit un environnement de test gratuit pour expérimenter sans toucher aux données réelles. Passez-y systématiquement avant la mise en production.
• Des limites de débit. L’API entreprise v2 accepte de l’ordre de 5 requêtes par seconde (4 pour l’API cabinet). Largement suffisant pour un reporting quotidien ; un chargement initial volumineux, lui, doit être conçu en conséquence.
• OAuth pour les usages intensifs. Les jetons simples couvrent les besoins internes ; les intégrations distribuées à grande échelle passent par OAuth 2.0.

Dernière limite, la plus importante. L’API restitue la donnée telle qu’elle est tenue : si l’analytique est mal saisie ou le lettrage en retard, l’automatisation industrialisera ces défauts. Un diagnostic rapide de votre dossier Pennylane avant le chantier évite de brancher un beau tuyau sur une donnée douteuse.

API Pennylane et IA : brancher un agent sur votre comptabilité

C’est la suite logique, et les suggestions de recherche du type « api pennylane claude » montrent que la question arrive vite chez les utilisateurs. Grâce au Model Context Protocol (MCP), un standard ouvert qui connecte les assistants IA aux logiciels métier, un agent IA peut interroger vos données Pennylane en langage naturel : « quelles factures clients dépassent 60 jours de retard ? », « sors-moi les achats du trimestre par catégorie analytique ». Des connecteurs MCP communautaires existent déjà pour l’API Pennylane, et Pennylane publie sa documentation dans un format directement lisible par les agents IA.

Notre conseil de prudence : commencez en lecture seule, sur un périmètre défini, avec validation humaine pour toute action d’écriture. Un agent qui lit la comptabilité pour répondre à des questions rend service immédiatement ; un agent qui écrit des écritures sans contrôle est un risque. Nous détaillons cette approche sur notre page agent IA d’entreprise.

Company API ou Firm API : lequel vous concerne

C’est la première question à trancher, et elle dépend de qui vous êtes.

Une entreprise utilise un jeton d’entreprise, généré dans les réglages de sa société. Il donne accès aux données de cette société, et d’elle seule.

Un cabinet d’expertise comptable dispose d’un service distinct, la Firm API, avec sa propre documentation et son propre jeton, généré dans les réglages du cabinet. C’est ce qui permet de travailler sur un portefeuille de dossiers sous une authentification unique, au lieu de collectionner un jeton par client.

Trois points pratiques sur les jetons de cabinet. Ils se créent avec un nom, une liste de portées et une date d’expiration. Ils ne sont affichés qu’une seule fois : si vous ne le copiez pas à cet instant, il faut en générer un autre. Et un cabinet peut en détenir plusieurs, ce qui est la bonne pratique : un jeton par usage, avec les portées minimales, plutôt qu’un jeton unique qui ouvre tout.

Enfin, l’authentification OAuth 2.0 existe mais elle est réservée aux partenaires d’intégration, sur demande auprès de l’équipe partenariats de Pennylane. Pour un chantier interne, c’est la voie par jeton qui s’applique.

v1, v2 et les changements de 2026

La version 1 de l’API est dépréciée depuis fin 2025. La v2 est la version stable, et c’est sur elle que tout nouveau projet se construit.

Les différences ne sont pas cosmétiques. La v2 travaille sur des identifiants internes là où la v1 utilisait des identifiants source. Les portées deviennent granulaires : là où la v1 avait une portée « factures clients » unique, la v2 en distingue quatre. La création groupée disparaît, chaque ressource se crée par son propre point d’entrée. Plusieurs ressources changent de nom, plan_item devient ledger_account et les devis passent de Estimates à Quotes. Les nombres décimaux doivent être transmis sous forme de chaînes. Et les fichiers deviennent une ressource à part entière : on téléverse d’abord, on référence ensuite.

Pour qui vient de la v1, la bascule impose de mettre à jour les portées OAuth et de se réauthentifier. Ce n’est pas un simple changement d’adresse.

La date que beaucoup ont manquée

Pennylane a mené en 2026 une seconde vague de changements, en trois temps : une phase d’aperçu ouverte le 14 janvier, sur option ; une phase de bascule le 8 avril, où le nouveau comportement est devenu celui par défaut ; et une phase de nettoyage le 1^er juillet 2026, définitive et sans retour arrière possible.

Nous sommes après cette date. Concrètement, une intégration écrite avant 2026 et jamais reprise ne fonctionne plus comme prévu, et l’en-tête qui permettait de conserver l’ancien comportement n’a plus d’effet.

Ce qui a changé, dans l’ordre de ce qui casse le plus souvent :

• La portée ledger a été remplacée par quatre portées distinctes, pour les journaux, les comptes, les écritures et les pièces jointes. Un jeton qui s’appuyait sur l’ancienne n’a plus les droits attendus.
• Les identifiants de lignes d’écriture perdent leur suffixe à trois chiffres. Un identifiant 12345003 devient 12345. Tout rapprochement stocké côté client sur les anciens identifiants tombe à côté.
• Le filtrage et le tri sur les horodatages de création et de modification ont été retirés des points d’entrée comptables. Il faut basculer sur l’identifiant ou sur la date.
• Le tri par défaut s’inverse sur les journaux, les comptes et les lignes d’écriture. Un traitement qui prenait « la première page » récupère désormais l’autre extrémité du jeu de résultats.
• Plusieurs champs passent d’un identifiant simple à un objet complet : journal_id devient un objet journal, et ainsi de suite. Une lecture directe du champ renvoie autre chose que prévu.
• Le point d’entrée de téléversement des pièces jointes comptables a été remplacé par un point d’entrée de fichiers.

Aucun de ces changements ne produit une erreur bruyante. Ils produisent des résultats faux mais plausibles, ce qui est la pire des situations sur des données comptables. Si vous avez une intégration Pennylane qui tourne depuis plus d’un an sans avoir été reprise, c’est le premier endroit à regarder.

Quotas, pagination et environnement de test

Trois éléments techniques déterminent la faisabilité d’un chantier, et ce sont ceux qu’on oublie de demander à son prestataire.

Le débit autorisé

L’API v2 accepte 25 requêtes toutes les 5 secondes, soit cinq par seconde, et la limite s’applique par jeton. Chaque jeton dispose donc de son propre budget, ce qui est un argument de plus pour en créer un par usage.

Au-delà, l’API répond par un code 429 accompagné d’un en-tête indiquant le délai d’attente. Les réponses réussies portent elles aussi les en-têtes de quota restant et d’heure de réinitialisation, ce qui permet de ralentir avant d’être bloqué plutôt qu’après. Un intégrateur sérieux exploite ces en-têtes ; un script écrit à la va-vite les ignore et se fait couper au milieu d’un chargement.

Point à connaître : la limite s’applique aussi à l’environnement de test. Un essai de charge sur le bac à sable ne dira donc rien de plus qu’en production.

La pagination par curseur

La v2 pagine par curseur et non par numéro de page. Chaque réponse contient les éléments, un indicateur signalant s’il reste des pages, et le curseur de la page suivante. On demande une taille de page, dont la valeur par défaut est de vingt éléments et varie selon le point d’entrée.

Le piège est ailleurs, et il coûte cher : le curseur ne mémorise que la position, pas les filtres. Si vous filtrez sur une période et que vous omettez ce filtre en demandant la page suivante, vous récupérez des résultats non filtrés sans le moindre avertissement. Un export mensuel qui ramène soudain l’historique complet vient presque toujours de là.

À retenir aussi : les curseurs sont temporaires et ne se stockent pas d’une exécution à l’autre, et un curseur invalide provoque une erreur 400.

Le bac à sable

Une entreprise crée son environnement de test depuis son compte, par l’entrée dédiée aux environnements de test. Un cabinet, lui, travaille directement depuis son compte cabinet. Les partenaires d’intégration passent par l’équipe partenariats de Pennylane.

Notre règle en mission est sans exception : le premier montage se fait sur le bac à sable, jamais sur un dossier réel. Le coût est nul et cela évite d’expliquer à un client pourquoi ses écritures ont bougé pendant un test.

Par où commencer

1. Choisissez un cas d’usage unique et mesurable. Le plus souvent : automatiser le tableau de bord mensuel. Un objectif, une échéance.
2. Ouvrez la sandbox et générez un jeton. Une heure de manipulation suffit pour comprendre la logique, sans risque pour vos données.
3. Faites un pilote en lecture seule. Une balance qui arrive seule dans Power BI chaque nuit : c’est le livrable qui convainc tout le monde.
4. Industrialisez. Planification, gestion des erreurs, supervision, documentation : c’est ce qui sépare un script bricolé d’un actif d’entreprise.

Questions fréquentes

Faut-il être développeur pour utiliser l’API Pennylane ?

Pour la consommer directement, oui, il faut un minimum de compétence technique. Dans les faits, un DAF n’a pas besoin de coder : des outils d’intégration (Power Query, n8n, Make) et un accompagnement ponctuel suffisent pour monter les premiers flux. Votre rôle est de définir le besoin et les contrôles ; la tuyauterie se délègue.

Quel abonnement Pennylane faut-il pour accéder à l’API ?

La création de jetons d’accès requiert un abonnement Essentiel ou supérieur, avec le rôle administrateur ou dirigeant sur le compte. La sandbox de test, elle, est gratuite. En cas de doute, vérifiez dans le module Connectivité de votre espace.

Quelles données sont accessibles via l’API Pennylane ?

Factures clients et fournisseurs, devis, abonnements de facturation, écritures comptables, plan de comptes, journaux, clients, fournisseurs, produits, catégories analytiques, transactions bancaires et documents Factur-X. Le périmètre s’élargit régulièrement : la référence reste la documentation officielle.

Écrit en juillet 2026. Les périmètres et conditions d’accès des API évoluent : vérifiez la documentation Pennylane en vigueur avant de lancer votre chantier.

Envie de brancher vos outils sur vos données comptables sans y passer vos soirées ? réservez un appel de 30 minutes : nous vous dirons honnêtement ce qui est automatisable chez vous. Et pour aller plus loin, découvrez notre expertise Pennylane.

Quelle est la limite de requêtes de l’API Pennylane ?

Vingt-cinq requêtes toutes les cinq secondes, soit cinq par seconde, appliquées par jeton. Au-delà, l’API répond par un code 429 avec le délai d’attente à respecter. Les réponses réussies indiquent le quota restant, ce qui permet de ralentir avant d’être bloqué. La limite vaut aussi sur l’environnement de test.

Quelle différence entre la Company API et la Firm API de Pennylane ?

La Company API s’appuie sur un jeton d’entreprise et donne accès aux données d’une seule société. La Firm API est un service distinct, avec sa propre documentation et un jeton généré dans les réglages du cabinet, qui permet de travailler sur un portefeuille de dossiers sous une authentification unique. C’est celle qui concerne les cabinets d’expertise comptable.

Mon intégration Pennylane est-elle affectée par les changements de 2026 ?

Si elle a été écrite avant 2026 et jamais reprise, oui. La phase de nettoyage est effective depuis le 1^er juillet 2026 et n’admet pas de retour arrière. Les points qui cassent le plus souvent sont le remplacement de la portée comptable, la disparition du suffixe à trois chiffres sur les identifiants de lignes d’écriture, le retrait des filtres sur les horodatages et l’inversion du tri par défaut. Aucun ne produit d’erreur visible : ils produisent des résultats faux mais plausibles.

À propos de Data SL Consulting

Data SL Consulting est un cabinet de conseil data basé en Île-de-France, partenaire Pennylane et partenaire Microsoft. Nous intervenons comme intégrateur data Pennylane auprès des PME et ETI : connexion Pennylane × Power BI, consolidation multi-sociétés, prévisionnel de trésorerie et automatisations via l’API Pennylane. Notre méthode : un audit court pour cadrer les indicateurs, puis un premier tableau de bord en production en 5 à 10 jours ouvrés, avec rafraîchissement automatique quotidien des données.