API Pennylane : documentation, authentification et intégrations

L’API Pennylane est une API REST, en version 2, qui donne accès aux factures, aux tiers, aux transactions bancaires et aux écritures d’un compte Pennylane. Sa documentation est publiée sur pennylane.readme.io. On l’ouvre avec un jeton d’entreprise, disponible à partir de l’abonnement Essentiel.

Chez Bienfait, on a réalisé plus d’une dizaine d’intégrations Pennylane pour nos clients. Plus une pour nous-mêmes. Ce guide reprend ce qu’il faut savoir avant d’écrire la première requête : où lire la documentation, comment s’authentifier, ce que l’API expose, ce qui casse une intégration en production.

Le reste suit : ce qu’on automatise vraiment avec, puis notre propre branchement entre Pennylane et Airtable.

Où trouver la documentation de l’API Pennylane ?

Sur pennylane.readme.io. C’est là que renvoient le centre d’aide et la page des intégrations de Pennylane.

La documentation se range en deux parties. Les guides : démarrage, tutoriels par cas d’usage, concepts, notes de migration. La référence : chaque endpoint, ses paramètres, ses droits requis, ses codes de réponse, avec un exemple de requête. Un journal des changements recense les évolutions, dont la plupart portent en 2026 sur la facture électronique.

Avant de lire, sachez de quelle API vous parlez :

La version 1 est dépréciée depuis juillet 2025. Pennylane demandait de migrer avant la fin de 2025. Une intégration qui appelle encore une adresse en /v1 est à reprendre en priorité : ne vous fiez pas aux exemples de code anciens, y compris quelques-uns de la documentation elle-même.

L’adresse de base de la version 2 est https://app.pennylane.com/api/external/v2. Chaque réponse porte un en-tête Api-Version-Expires-At. Pennylane promet un e-mail au moins un mois avant la fin d’une version.

Comment s’authentifier sur l’API Pennylane ?

Avec un jeton, transmis à chaque requête dans l’en-tête Authorization: Bearer.

Pour relier votre propre compte, le jeton d’entreprise suffit. Il se crée dans les paramètres de Pennylane, rubrique Connectivité, onglet Développeurs. Trois conditions :

• un abonnement Essentiel ou supérieur (les comptes Starter n’ont pas accès à l’API) ;
• un rôle de dirigeant, de comptable interne ou d’expert-comptable sur le compte ;
• un choix de droits (lecture seule ou lecture et écriture) puis de durée : un mois, six mois, un an ou sans limite.

Notre conseil : un jeton par intégration, en lecture seule dès que l’intégration ne fait que lire, avec une durée limitée. Le jour où un prestataire part ou qu’un outil est abandonné, on révoque un jeton sans couper les autres.

Un éditeur qui veut connecter les comptes de ses propres clients passe par OAuth 2.0. Les identifiants se demandent à Pennylane via son formulaire de partenariat. Le jeton d’accès expire au bout de 24 heures, le jeton de rafraîchissement au bout de 90 jours. Ce dernier change à chaque usage : une intégration qui le stocke mal perd la connexion sans bruit.

Les droits se déclarent par ressource : customer_invoices:readonly, supplier_invoices:all, transactions:readonly, etc. Une requête qui sort de son périmètre reçoit une erreur 403.

Quelles données l’API Pennylane expose-t-elle ?

L’essentiel de ce qu’un logiciel de gestion a besoin de lire ou d’écrire dans la comptabilité.

Deux renommages piègent les intégrations venues de la version 1 : les devis s’appelaient « estimates », ils s’appellent désormais « quotes ». Le compte du plan comptable s’appelait plan_item, il s’appelle ledger_account.

Quelles limites connaître avant de coder ?

Chacune des quatre a cassé au moins une intégration que nous avons reprise.

Le débit. 25 requêtes toutes les 5 secondes. Au-delà, l’API répond par une erreur 429 et indique dans l’en-tête retry-after combien de temps attendre. Les en-têtes ratelimit-remaining et ratelimit-reset disent quand ralentir, avant d’être bloqué. Une synchronisation initiale de trois ans de factures dépasse cette limite en quelques secondes si elle n’est pas cadencée.

La pagination. Les listes se parcourent par curseur, 20 éléments par défaut, 100 au plus sur la plupart des endpoints. Une intégration qui ne lit que la première page croit que votre client a vingt factures.

Les webhooks. Ils existent, en bêta. Ils ne couvrent que trois événements, tous liés aux factures électroniques et aux fichiers déposés. Pennylane recommande lui-même de s’appuyer sur ses endpoints de suivi des changements : ils listent ce qui a été créé, modifié ou supprimé. Cet historique se garde quatre semaines. Une synchronisation qui s’arrête plus d’un mois repart donc d’un parcours complet.

Les changements de 2026. Pennylane a remplacé le droit unique ledger par des droits séparés sur les journaux, les comptes, les écritures et les pièces jointes. L’ancien point de dépôt des justificatifs est déprécié. La migration devait être terminée au 1er juillet 2026. Une intégration écrite en 2025 qui touche aux écritures est à relire.

Pour tester sans risque, Pennylane fournit un environnement de test : il se crée depuis le menu du profil, rubrique « Test environment ». La création est gratuite, mais générer un jeton dessus demande, là aussi, l’abonnement Essentiel.

Que peut-on automatiser avec l’API Pennylane ?

Les mêmes cinq flux reviennent dans presque toutes nos missions.

Créer clients, factures et abonnements depuis votre outil de gestion. Le client existe dans votre CRM ou votre base Airtable : il est créé dans Pennylane au moment où il signe, pas ressaisi à la première facture. Les factures récurrentes partent depuis la même base.

Transformer un devis accepté en facture. Le devis signé dans votre outil commercial devient une facture Pennylane avec les mêmes lignes, la même TVA, les mêmes conditions. Aucune ressaisie, donc aucune erreur de recopie.

Rapprocher les paiements. L’API sait associer une transaction bancaire à la facture qu’elle règle. Votre outil de gestion sait alors qu’un client a payé le jour même, sans attendre que quelqu’un pointe le relevé. Pour Stripe, Pennylane propose une intégration native incluse dans tous ses abonnements, qui fait remonter les paiements dans un seul sens, de Stripe vers Pennylane. C’est aussi ce statut qui arrête une séquence de relance des factures impayées.

Déposer les pièces justificatives. Une photo de ticket prise sur un chantier, un PDF reçu par e-mail : l’API les dépose dans Pennylane et les rattache à la bonne dépense.

Alimenter vos tableaux de bord. L’API fonctionne dans les deux sens. Le chiffre d’affaires, les charges et les écritures remontent chaque nuit vers Airtable, Google Sheets ou un outil décisionnel. C’est ce qui remplace l’attente de la clôture mensuelle.

Côté paie, Pennylane relie nativement Silae pour récupérer les écritures, sur les abonnements avec comptabilité internalisée. Le lettrage, lui, reste à faire.

Notre propre intégration Pennylane

On applique à nous-mêmes ce qu’on installe chez nos clients.

Chaque facture émise dans Pennylane remonte automatiquement dans Airtable, notre outil central de gestion de projets. Un rapprochement automatique la rattache au projet client correspondant. Comme nos charges et nos temps passés vivent déjà dans Airtable, on lit la marge réelle par projet à tout moment.

Ce que ça change concrètement : on sait quel projet dérive pendant qu’il dérive, pas trois semaines après la clôture. On ajuste l’équipe ou le périmètre pendant qu’il est encore temps.

Deux leçons de ce branchement, qu’on retrouve chez nos clients. La correspondance entre une facture et un projet doit reposer sur un identifiant écrit dans la facture, jamais sur le nom du client : un client a plusieurs projets. Et l’intégration doit savoir reprendre là où elle s’est arrêtée, parce qu’elle s’arrêtera.

Faut-il un développeur pour intégrer Pennylane ?

Pas toujours. L’API suit les conventions REST : un module HTTP de Make ou de n8n suffit pour une synchronisation simple, par exemple créer une facture quand un devis passe au statut signé dans Airtable.

Le développeur devient utile dans trois cas. Quand l’intégration parcourt des milliers de lignes et doit respecter la limite de débit. Quand elle doit reprendre proprement après une erreur, sans créer deux fois la même facture. Quand elle relie Pennylane à un ERP ou à un outil interne qui n’a pas de connecteur.

C’est souvent là que les intégrations montées en une après-midi montrent leurs limites. Elles fonctionnent le jour de la démonstration, puis créent des doublons le jour où l’API répond 429.

Ce que la facture électronique change à l’intégration

Pennylane est plateforme agréée pour la facture électronique, immatriculée à titre définitif depuis décembre 2025 selon l’éditeur. La réception des factures électroniques est obligatoire pour toutes les entreprises depuis le 1er septembre 2026, l’émission le sera pour les PME au 1er septembre 2027.

L’API suit. Elle envoie une facture client à la plateforme et importe une facture fournisseur au format Factur-X. Deux des trois webhooks préviennent d’un changement de statut d’une facture électronique.

Conséquence pratique : une facture créée par API doit désormais être conforme dès sa création. Les champs obligatoires de la réforme (SIREN du client, adresse de livraison quand elle diffère, nature de l’opération) se renseignent dans votre outil de gestion, pas après coup dans Pennylane.

En bref

L’API Pennylane est une API REST en version 2, documentée sur pennylane.readme.io, ouverte à partir de l’abonnement Essentiel.

Quatre limites à connaître avant de coder : 25 requêtes toutes les 5 secondes, une pagination par curseur, des webhooks en bêta sur trois événements, des droits renommés en 2026.

Ce qu’on en tire : un client créé une seule fois, une facture qui part du devis signé, des paiements rapprochés le jour même, une marge par projet lisible sans attendre la clôture.

Chez Bienfait, on a réalisé plus d’une dizaine d’intégrations Pennylane. Celles qui durent ont toutes été pensées pour le jour où une requête échoue.

Brancher une interface est la dernière étape, jamais la première. Ce qui vient avant : l’automatisation des processus d’une PME.

Questions fréquentes

Écrit par

Simon

Co-fondateur

in