API Pennylane : automatiser la comptabilité de sa startup

L'API Pennylane (souvent recherchée sous la forme « pennylane api ») permet à une startup de brancher sa comptabilité directement sur ses outils : Stripe, CRM, back-office SaaS, outil de notes de frais ou tableau de bord investisseurs. Au lieu d'exporter des CSV chaque fin de mois, les factures, les clients et les transactions circulent automatiquement, et le grand livre devient une source de données exploitable en continu.

L'enjeu est double. D'un côté, gagner des dizaines d'heures de saisie et fiabiliser des chiffres que les investisseurs regardent de près : MRR, cash burn, runway. De l'autre, préparer l'entreprise à la généralisation de la facturation électronique, qui impose dès le 1er septembre 2026 de savoir recevoir des factures électroniques. Encore faut-il comprendre ce que l'API sait faire, ses limites techniques et les changements intervenus en 2026.

Chez DIGIFEC, cabinet d'expertise comptable dédié aux startups et scale-ups, nous accompagnons des équipes qui automatisent leur comptabilité sur Pennylane. Ce guide rassemble ce que nous vérifions avant chaque intégration : périmètre fonctionnel, obtention du token, synchronisation, contraintes de débit, migration 2026, cas pratique chiffré et erreurs à éviter.

Qu'est-ce que l'API Pennylane et que permet-elle d'automatiser ?

Une API (interface de programmation) est une porte d'entrée technique qui permet à un logiciel de lire ou d'écrire des données dans un autre, sans intervention humaine. Pennylane expose aujourd'hui une API v2, accessible à l'adresse app.pennylane.com/api/external/v2, qui couvre la facturation clients, les achats, la banque, la comptabilité générale et analytique, ainsi que les pièces jointes.

Trois façons d'accéder à l'API

La documentation distingue trois profils. Une entreprise génère un token API depuis ses propres paramètres : c'est le cas le plus courant pour une startup qui veut automatiser ses flux. Un cabinet d'expertise comptable dispose d'un token « Firm » qui lui donne accès aux dossiers de ses clients. Enfin, un éditeur de logiciel qui veut proposer une intégration à de nombreux utilisateurs passe par OAuth 2.0, après validation par l'équipe partenariats de Pennylane.

Dans tous les cas, chaque requête doit transporter un jeton dans l'en-tête Authorization sous la forme « Bearer ». Un appel à l'endpoint /me permet de vérifier que l'authentification fonctionne et d'afficher les droits associés au jeton.

Le périmètre fonctionnel, domaine par domaine

Les droits sont découpés en scopes granulaires, chacun existant en lecture seule (readonly) ou en lecture-écriture (all). Ce découpage est précieux : un tableau de bord de trésorerie n'a besoin que de lire les transactions, alors qu'un connecteur de facturation doit pouvoir créer des factures. Le tableau ci-dessous résume les grands domaines et leur intérêt pour une startup.

Pour une société qui découvre l'outil, nous recommandons de commencer par comprendre la répartition des rôles entre l'équipe, le logiciel et le cabinet : c'est l'objet de notre article sur ce que change un expert-comptable sur Pennylane pour une startup.

Comment obtenir un token pour utiliser l'API Pennylane ?

La génération d'un token entreprise se fait dans Pennylane, menu Paramètres > Connectivité > Développeurs, bouton « Générer un token API ». Vous lui donnez un nom explicite (par exemple « Connecteur Stripe – production »), vous choisissez les permissions de l'API v2, puis une date d'expiration.

Les prérequis à vérifier

• Offre : la documentation indique qu'il faut au minimum l'offre Essential ; sur l'offre Starter, l'onglet Développeurs n'apparaît pas.
• Rôle : seuls les profils disposant d'un accès administrateur (dirigeant, comptable interne, comptable externe) peuvent créer un token.
• Durée de validité : 1 mois, 6 mois, 12 mois ou illimitée.
• Permissions : lecture seule ou lecture et écriture. Un token en lecture seule qui tente d'écrire reçoit une erreur 403.

Le token ne s'affiche qu'une seule fois. Pennylane ne le stocke pas : s'il est perdu, il faut en générer un nouveau. Copiez-le immédiatement dans un gestionnaire de secrets.

Tester sans risque grâce au bac à sable

Avant de brancher un script sur la comptabilité réelle, créez un environnement de test depuis le menu de profil (« Test environment »). Il permet de vérifier la création des clients, des factures et des pièces jointes sans polluer le dossier de production ni fausser la TVA déclarée. Les limites de débit s'y appliquent de la même façon qu'en production, ce qui permet de tester aussi la gestion des erreurs.

Quelles automatisations comptables prioriser dans une startup SaaS ?

Tout automatiser d'un coup est rarement une bonne idée. Le bon ordre consiste à traiter d'abord les flux volumineux, répétitifs et bien structurés, puis ceux qui alimentent le pilotage.

1. La facturation clients issue du produit

Pour un SaaS facturé par abonnement, chaque paiement génère une facture. Pousser automatiquement ces factures dans Pennylane, avec le bon client, le bon compte de produit et le bon taux de TVA, supprime la saisie la plus volumineuse. C'est aussi le socle d'un MRR fiable, calculé à partir de données comptables et non d'un export ponctuel : nous détaillons la méthode dans notre guide MRR : définition, calcul et pièges à éviter.

2. Les achats récurrents et les justificatifs

Hébergement cloud, licences logicielles, freelances : les factures fournisseurs arrivent par dizaines. L'API permet de créer les fournisseurs, d'importer les factures et de rattacher les fichiers PDF via la ressource file_attachments. Chaque écriture dispose ainsi de sa pièce justificative, ce qui facilite la clôture et les contrôles.

3. Le reporting de trésorerie et les KPI

En lecture seule, les scopes transactions et trial_balance suffisent pour alimenter un tableau de bord interne ou un reporting mensuel aux investisseurs. Vous suivez l'évolution des encaissements, des décaissements et de la consommation de trésorerie sans attendre la clôture : c'est la base d'un pilotage du cash burn et du runway réellement à jour.

4. Les exports pour l'audit et la levée de fonds

Les scopes exports:fec et exports:agl permettent de générer le fichier des écritures comptables et le grand livre. Pendant une due diligence, pouvoir produire ces fichiers à la demande, sur une période donnée, fait gagner du temps à tout le monde.

Comment synchroniser les données sans tout recharger à chaque fois ?

Une erreur classique consiste à relire chaque nuit la totalité des factures ou des transactions. Avec quelques milliers d'objets, cela consomme inutilement la limite de débit et ralentit le traitement. L'API v2 propose deux mécanismes plus efficaces.

Les endpoints de changelog

Pennylane expose des changelogs pour sept ressources : factures clients, factures fournisseurs, clients, fournisseurs, produits, lignes d'écritures et transactions. Chaque élément indique l'opération réalisée (insert, update ou delete). L'historique est conservé 4 semaines : au-delà, les changements ne sont plus consultables.

La méthode recommandée par la documentation est simple : vous enregistrez la valeur processed_at du dernier changement traité, uniquement lorsque has_more est faux, puis vous la réutilisez comme start_date lors de l'interrogation suivante. La taille de page est de 20 éléments par défaut et peut monter à 1 000. Attention : start_date et cursor ne peuvent pas être utilisés dans la même requête.

Les webhooks, encore en bêta

Les webhooks inversent la logique : au lieu d'interroger l'API, vous déclarez une adresse HTTPS et Pennylane vous envoie une notification lorsqu'un événement survient, par exemple la création d'un fichier ou le changement de statut d'une facture électronique. La fonctionnalité est présentée comme une bêta, et Pennylane recommande de conserver les changelogs comme mécanisme de secours pendant cette phase.

En pratique, la combinaison la plus robuste associe les webhooks pour la réactivité et un passage régulier sur les changelogs pour rattraper les notifications manquées. L'adresse de réception doit obligatoirement être en HTTPS, faute de quoi l'abonnement est refusé.

Quelles contraintes techniques anticiper avant de coder ?

La première contrainte est la limite de débit : 25 requêtes par fenêtre de 5 secondes, par token, en production comme en bac à sable et sur tous les endpoints. Au-delà, l'API renvoie une erreur 429 accompagnée d'un en-tête retry-after qui indique le délai d'attente. Les réponses normales contiennent aussi ratelimit-remaining, ce qui permet de ralentir avant d'atteindre le plafond (voir la documentation officielle sur la limitation de débit).

Les autres points de friction tiennent au modèle de données de la v2 : chaque objet se crée par son propre endpoint, les montants décimaux se transmettent sous forme de chaînes de caractères et la pagination fonctionne par curseur. Le tableau suivant récapitule les parades.

Un dernier conseil : journalisez chaque appel en écriture avec l'identifiant de l'objet source (identifiant Stripe, numéro de commande). En cas de coupure réseau, vous saurez exactement quelles factures ont été créées et éviterez les doublons, qui sont l'erreur la plus coûteuse à corriger en comptabilité.

Ce qui a changé pour l'API Pennylane en 2026

Deux évolutions successives concernent les intégrations existantes. La première est l'abandon de l'API v1 : la documentation indique qu'elle devait être entièrement dépréciée fin 2025 et que la v2 est désormais la version officielle et stable. Tout script écrit avant 2025 doit donc être vérifié.

La migration de la v1 vers la v2

Les changements les plus structurants : la v2 n'utilise que des identifiants internes, découpe les droits en scopes granulaires, impose la pagination par curseur, renomme certains objets (plan_item devient ledger_account, Estimates devient Quotes) et traite les fichiers comme une ressource à part entière, référencée par file_attachment_id, au lieu d'un contenu encodé directement dans la facture.

Les « 2026 API changes »

La seconde évolution porte sur la v2 elle-même, principalement sur la partie comptable. Le scope ledger est déprécié au profit de scopes plus fins (journals, ledger_accounts, ledger_entries, file_attachments), plusieurs endpoints passent à la pagination par curseur, les identifiants d'écritures perdent leur suffixe à trois chiffres et certains filtres disparaissent. Le guide de migration publié par Pennylane fixait la fin de la migration au 1er juillet 2026 au plus tard.

Si votre connecteur de reporting lit les écritures comptables et n'a pas été modifié depuis le printemps 2026, vérifiez en priorité les scopes du token, le format des identifiants et la gestion de la pagination : ce sont les trois sources de panne les plus fréquentes après la bascule.

API Pennylane et facturation électronique : quel lien en 2026-2027 ?

La réforme de la facturation électronique change la nature des flux de facturation entre entreprises assujetties à la TVA en France. Selon Service-Public.fr, toutes les entreprises, quelle que soit leur taille, doivent être en mesure de recevoir des factures électroniques depuis le 1er septembre 2026. L'obligation d'émission s'applique à la même date aux grandes entreprises et aux ETI, et à compter du 1er septembre 2027 aux PME et microentreprises.

Les factures électroniques transitent par une plateforme agréée, seul intermédiaire reconnu par l'administration fiscale pour émettre, recevoir et transmettre les factures et les données associées. Les ventes aux particuliers et les opérations internationales relèvent quant à elles de l'e-reporting, c'est-à-dire la transmission de données de transaction à l'administration.

Ce que cela change pour vos automatisations

L'API Pennylane intègre déjà cette dimension. Un endpoint dédié (POST /customer_invoices/{id}/send_to_pa) permet de déclencher l'envoi d'une facture client finalisée vers la plateforme agréée, et les webhooks peuvent signaler les changements de statut d'une facture électronique. Pour une startup SaaS B2B, le connecteur de facturation doit donc produire des factures complètes et conformes dès leur création : identification du client, mentions obligatoires, taux de TVA correct.

Une startup qui facture des clients professionnels a tout intérêt à fiabiliser son flux dès maintenant, avant l'échéance de septembre 2027. Nous détaillons les étapes dans nos articles sur l'automatisation de la facturation électronique d'une startup et sur l'automatisation des factures avant l'entrée en vigueur de la réforme.

Cas pratique : automatiser la facturation d'une startup SaaS avec l'API Pennylane

Prenons une startup SaaS B2B fictive, que nous appellerons Flowly. Elle facture 1 200 abonnements par mois via Stripe et acquiert environ 150 nouveaux clients chaque mois. Jusqu'ici, une personne de l'équipe exportait les paiements, créait les factures dans Pennylane et rattachait les PDF à la main.

Étape 1 : compter les appels nécessaires

Chaque nouveau client doit être créé avant sa première facture, soit 150 appels. Chaque facture représente un appel de création, soit 1 200 appels, et chaque justificatif PDF un appel de rattachement, soit 1 200 appels supplémentaires. Le total s'élève à 2 550 appels en écriture par mois.

Étape 2 : calculer la durée de traitement

La limite de 25 requêtes par fenêtre de 5 secondes correspond à un débit théorique de 5 requêtes par seconde. En gardant une marge de sécurité de 20 % pour absorber les autres appels (lectures, contrôles), on retient 4 requêtes par seconde. Le traitement complet prend donc 2 550 ÷ 4 = environ 638 secondes, soit un peu plus de 10 minutes par mois si tout est poussé en une fois. Réparti au fil de l'eau, il est imperceptible.

Étape 3 : estimer le temps libéré

Avec une hypothèse de 3 minutes de saisie et de rattachement par facture, la saisie manuelle représentait 1 200 × 3 = 3 600 minutes, soit 60 heures par mois. C'est l'équivalent d'environ un tiers de temps plein, réaffecté à l'analyse, au recouvrement ou à la préparation du reporting.

Étape 4 : contrôler la synchronisation

Si Flowly interroge les changelogs des factures clients et des transactions tous les quarts d'heure, cela représente 96 interrogations par jour et par ressource, soit 192 appels quotidiens pour les deux ressources, une charge négligeable au regard de la limite. L'essentiel est ailleurs : chaque nuit, un contrôle compare le nombre et le montant total des paiements Stripe avec les factures créées dans Pennylane, et signale le moindre écart.

Quelles erreurs éviter quand on automatise sa comptabilité avec Pennylane ?

Les erreurs que nous rencontrons le plus souvent ne sont pas techniques : elles tiennent à l'organisation et à la qualité des données envoyées.

1. Automatiser sans plan de comptes validé : un mauvais compte de produit ou un mauvais taux de TVA se répète alors sur des centaines de factures.
2. Créer des doublons : sans clé d'idempotence (identifiant source stocké), une relance après une erreur réseau crée deux fois la même facture.
3. Ignorer l'erreur 429 : un script qui ne lit pas retry-after perd des requêtes en silence.
4. Utiliser un token unique et illimité pour tout : une fuite expose l'ensemble du dossier, sans possibilité de couper un seul usage.
5. Laisser passer plus de 4 semaines sans synchronisation : les changelogs ne remontent pas au-delà, il faut alors relire l'historique complet.
6. Croire que l'API remplace la revue comptable : la validation des écritures, la TVA, les cut-off et la clôture restent du ressort de l'expert-comptable.

Checklist avant la mise en production

• Plan de comptes, comptes de produits et taux de TVA validés avec votre expert-comptable.
• Script testé dans l'environnement de test, y compris sur les cas d'erreur.
• Un token par usage, avec les seuls scopes nécessaires et une durée d'expiration définie.
• Gestion des erreurs 403, 422 et 429, avec journalisation de chaque appel.
• Identifiant source stocké pour chaque objet créé, afin d'empêcher les doublons.
• Contrôle quotidien de rapprochement entre l'outil source et Pennylane.
• Responsable désigné pour surveiller le changelog de l'API et les évolutions annoncées.

Conserver une piste d'audit solide

L'automatisation ne modifie pas les obligations comptables. L'article L123-22 du Code de commerce impose de conserver les documents comptables et les pièces justificatives pendant dix ans. En cas de contrôle fiscal, l'entreprise qui tient une comptabilité informatisée doit pouvoir remettre son fichier des écritures comptables dans le format prévu par le Livre des procédures fiscales. Rattacher systématiquement chaque justificatif à son écriture via l'API est le meilleur moyen de rester prêt.

En résumé : automatiser sa comptabilité avec l'API Pennylane, étape par étape

L'API Pennylane v2 permet d'automatiser la facturation, les achats, la lecture des transactions et l'export des données comptables d'une startup. Pour en tirer le meilleur, commencez par les flux volumineux, travaillez d'abord dans l'environnement de test, limitez les droits de chaque token, respectez la limite de 25 requêtes par 5 secondes et synchronisez via les changelogs au moins une fois par semaine. Vérifiez enfin que vos intégrations ont bien intégré les changements de 2026 et que votre facturation est prête pour l'obligation d'émission de septembre 2027.

L'automatisation n'a de valeur que si les données qui entrent dans la comptabilité sont justes. Plan de comptes, TVA, rapprochements et clôture restent des sujets d'expertise.

Vous voulez cadrer une intégration ou fiabiliser un connecteur existant ? Découvrez notre accompagnement en comptabilité digitale et automatisée pour startups : l'équipe DIGIFEC définit avec vous les flux à automatiser, valide le paramétrage comptable et contrôle les données chaque mois.