Pennylane API : automatiser vos exports comptables

Q: Comment acceder à l'API Pennylane ?

L'API Pennylane v2 est accessible via OAuth2. Il faut créer une application sur le portail developpeur Pennylane, obtenir un client_id et client_secret, puis implementer le flow OAuth2 Authorization Code pour obtenir un access_token.

Q: Quelles données comptables peut-on exporter via l'API Pennylane ?

L'API Pennylane v2 expose plus de 40 endpoints : factures clients et fournisseurs, produits, clients, fournisseurs, balance generale, écritures comptables, journaux, comptes bancaires, transactions, devis, exercices fiscaux, et bien plus.

Q: Existe-t-il une solution no-code pour exporter Pennylane vers Google Sheets ?

Oui, DigitsLane est un add-on Google Sheets qui connecte Pennylane sans aucune ligne de code. Il propose 55 types de données, 55 rapports comptables (bilan, SIG, TVA, FEC...), la mise à jour directe (write-back) et des templates prêts à l'emploi.

Q: Quelles sont les limites de l'API Pennylane ?

L'API Pennylane impose un rate limit de 100 requêtes par minute par token. La pagination est limitée a 100 elements par page. Certaines ressources (FEC, balance) nécessitent un export asynchrone. Les tokens expirent toutes les 2 heures.

1. Pourquoi automatiser ses exports Pennylane ?

Si vous utilisez Pennylane pour la comptabilite de vos clients ou de votre entreprise, vous connaissez la situation : exporter manuellement des données vers Google Sheets pour construire des tableaux de bord, preparer la TVA ou analyser la trésorerie.

Ce processus manuel pose plusieurs problemes :

Temps perdu : copier-coller les exports CSV, reformater les colonnes, mettre à jour les formules — ça prend 30 min à 2h par dossier, chaque mois.
Erreurs humaines : un mauvais filtre de dates, une colonne decalee, et votre bilan est faux.
Données obsoletes : entre l'export et l'analyse, de nouvelles écritures ont ete saisies.
Passage à l'echelle impossible : avec 5, 10 ou 50 dossiers clients, l'export manuel ne tient plus.

L'API Pennylane permet de resoudre ces problemes en automatisant la recuperation des données comptables directement dans Google Sheets.

Reservez une demo gratuite — on configure tout pour vous

55 types de donnees, 55 rapports comptables, liens Pennylane cliquables.

Essayer gratuitement

Sans carte bancaire. 14 jours d'essai gratuit.

GET

/api/external/v2/supplier_invoices

Factures fournisseurs

GET

/api/external/v2/products

Catalogue produits

GET

/api/external/v2/customers

Repertoire clients

GET

/api/external/v2/suppliers

Repertoire fournisseurs

GET

/api/external/v2/transactions

Transactions bancaires

POST

/api/external/v2/accounting/trial_balance

Balance generale

POST

/api/external/v2/accounting/fec_export

Export FEC

Au total, plus de 40 types de données sont disponibles, couvrant la comptabilite, la facturation, la trésorerie et le referentiel (plan comptable, exercices, journaux).

Bon a savoir : L'API Pennylane v2 a remplace la v1 debut 2025. La v2 utilise une pagination page[number] / page[size] (max 100) et retourne les reponses dans un wrapper {"data": [...], "pagination": {...}}.

3. Authentification OAuth2 pas a pas

L'API Pennylane utilise le protocole OAuth2 Authorization Code. Voici les etapes :

Etape 1 : Creer une application

Rendez-vous sur le portail developpeur Pennylane pour créer une application OAuth2. Vous obtiendrez un client_id et un client_secret.

Etape 2 : Rediriger l'utilisateur

URL
https://app.pennylane.com/oauth/authorize?
  client_id=VOTRE_CLIENT_ID
  &redirect_uri=https://votre-app.com/callback
  &response_type=code
  &scope=accounting:read invoicing:read

Etape 3 : Echanger le code contre un token

Python
import requests

resp = requests.post("https://app.pennylane.com/oauth/token", json={
    "grant_type": "authorization_code",
    "code": code_from_callback,
    "client_id": CLIENT_ID,
    "client_secret": CLIENT_SECRET,
    "redirect_uri": REDIRECT_URI,
})
token = resp.json()["access_token"]

Attention : Les access tokens Pennylane expirent après 2 heures. Pensez a implementer le refresh token pour eviter de redemander l'autorisation à l'utilisateur. Attention aussi aux comparaisons de dates : PostgreSQL stocke les timestamps en UTC naive, mais Python datetime.now(timezone.utc) est timezone-aware.

Etape 4 : Appeler l'API

Python
headers = {"Authorization": f"Bearer {token}"}

# Recuperer les factures clients
resp = requests.get(
    "https://app.pennylane.com/api/external/v2/customer_invoices",
    headers=headers,
    params={"page[number]": 1, "page[size]": 100}
)
invoices = resp.json()["data"]

4. Les endpoints cles pour la comptabilite

Voici les endpoints les plus utiles pour un expert-comptable ou un DAF qui souhaite construire des tableaux de bord dans Google Sheets :

Lecture de données (GET)

/customer_invoices — Factures clients avec lignes, TVA, statut de paiement
/supplier_invoices — Factures fournisseurs avec reste a regler
/products — Catalogue de produits et services (prix HT, TVA, unite)
/customers / /suppliers — Annuaires clients et fournisseurs
/transactions — Transactions bancaires avec lettrage
/ledger_entries — Ecritures comptables individuelles
/ledger_accounts — Plan comptable (numero + libelle)
/journals — Journaux comptables (achats, ventes, banque, OD)
/fiscal_years — Exercices fiscaux ouverts et clotures

Rapports comptables (POST)

/accounting/trial_balance — Balance generale (debit, credit, solde par compte)
/accounting/fec_export — Fichier des Ecritures Comptables (FEC) — export asynchrone

Note : La balance generale et le FEC sont des exports asynchrones. L'API retourne un ID de tache qu'il faut poller jusqu'à completion. Le FEC peut prendre jusqu'à 2 minutes pour un dossier avec beaucoup d'écritures.

Ecriture de données (POST/PUT)

PUT /products/{id} — Modifier prix, description, taux TVA
POST /products — Creer un nouveau produit
POST /customer_invoices — Creer une facture client
PUT /customers/{id} — Mettre à jour un client

5. Exemple complet : exporter la balance generale vers Google Sheets

Voici un script Python complet qui recupere la balance generale via l'API Pennylane et l'écrit dans Google Sheets via l'API Sheets :

Python
import requests
import time
from google.oauth2.credentials import Credentials
from googleapiclient.discovery import build

# 1. Recuperer la balance generale depuis Pennylane
PL_TOKEN = "votre_access_token_pennylane"
headers = {"Authorization": f"Bearer {PL_TOKEN}"}

resp = requests.post(
    "https://app.pennylane.com/api/external/v2/accounting/trial_balance",
    headers=headers,
    json={"date_from": "2026-01-01", "date_to": "2026-03-04"}
)
data = resp.json()

# 2. Transformer en grille de données
rows = [["Compte", "Libelle", "Debit", "Credit", "Solde"]]
for account in data["accounts"]:
    debit = account["debit"]
    credit = account["credit"]
    rows.append([
        account["number"],
        account["label"],
        debit,
        credit,
        round(debit - credit, 2)
    ])

# 3. Ecrire dans Google Sheets
creds = Credentials.from_authorized_user_info(google_token_info)
service = build("sheets", "v4", credentials=creds)

service.spreadsheets().values().update(
    spreadsheetId="VOTRE_SPREADSHEET_ID",
    range="Balance!A1",
    valueInputOption="RAW",
    body={"values": rows}
).execute()

print(f"Balance exportee : {len(rows)-1} comptes")

Ce script ne gère pas : le refresh token (expiration 2h), la pagination (comptes > 100), le formatage du spreadsheet (colonnes, couleurs, largeurs), le rate limiting (100 req/min), ni la gestion des erreurs API. En production, chacun de ces points represente des dizaines de lignes de code supplementaires.

6. Limites et pieges a eviter

Avant de vous lancer dans un developpement maison, voici les difficultes concretes que vous allez rencontrer :

Rate limiting

L'API Pennylane impose 100 requêtes par minute par token. Pour un dossier avec beaucoup de factures, vous devez implementer un mecanisme de pagination avec back-off exponentiel. DigitsLane utilise un algorithme de rate limiting adaptatif qui maximise le debit sans declencher de 429.

Pagination

Chaque endpoint retourne maximum 100 elements par page. Pour un dossier avec 5 000 factures, il faut 50 appels API sequentiels — soit au minimum 30 secondes avec le rate limiting.

Exports asynchrones

La balance generale et le FEC sont des exports asynchrones. L'API retourne un ID de tache, et il faut poller un endpoint de statut toutes les quelques secondes. Le FEC peut prendre jusqu'à 2 minutes.

Tokens et refresh

Les access tokens expirent après 2 heures. Si vous planifiez des exports automatiques, vous devez gerer le cycle de refresh, stocker les tokens de manière sécurisée, et gerer le cas ou l'utilisateur a revoque l'autorisation.

Calculs comptables

L'API retourne des données brutes. Pour construire un bilan, un SIG, un tableau de TVA ou un BFR, il faut agreger les comptes par classe PCG, appliquer les bonnes formules et gerer les cas speciaux (exercices chevauchants, écritures de cloture, taux TVA mixtes).

7. La solution no-code : DigitsLane

DigitsLane est un add-on Google Sheets qui fait tout ce travail pour vous, sans ecrire une seule ligne de code :

55 types de données synchronises en temps reel depuis Pennylane
55 rapports comptables precalcules : bilan, SIG, TVA CA3, FEC, BFR, trésorerie, CAF, balance agee, ratios financiers...
55 templates prêts à l'emploi avec formatage professionnel
Mise à jour directe : modifiez les prix, descriptions et taux TVA dans Sheets, ils se repercutent dans Pennylane
Alertes automatiques : soyez notifie quand la trésorerie passe sous un seuil
Export PDF/Excel/CSV en un clic
Dashboard KPI dans la sidebar avec 6 indicateurs temps reel
Assistant IA : posez vos questions en langage naturel ("quel est mon CA du mois dernier ?")

Instant Sheet : Vous pouvez aussi générer un classeur Google Sheets pré-rempli avec vos données Pennylane en 30 secondes, directement depuis notre site, sans installer l'add-on. Essayez avec un bilan →

8. Comparatif : API maison vs DigitsLane

Critere	API maison (Python)	DigitsLane
Temps de mise en place	2-4 semaines de dev	2 minutes
Authentification OAuth2	A implementer	Integree (1 clic)
Pagination + rate limiting	A implementer	Gere automatiquement
Refresh token	A implementer	Transparent
Rapports comptables (bilan, SIG, TVA...)	Calculs manuels PCG	55 rapports precalcules
Formatage Google Sheets	API Sheets batchUpdate	Automatique (3 profils)
Mise à jour directe (Sheets → Pennylane)	Dev supplementaire	Integre (produits, clients...)
Multi-societes	A gerer	Selecteur integre
Maintenance	Votre equipe	Mises à jour automatiques
Cout	Temps dev + hebergement	A partir de 29€/mois

9. FAQ

Comment acceder à l'API Pennylane ?

L'API Pennylane v2 est accessible via OAuth2. Creez une application sur le portail developpeur Pennylane, obtenez un client_id et client_secret, puis implementez le flow OAuth2 Authorization Code. La documentation complete est sur doc.pennylane.com.

Quelles données comptables peut-on exporter via l'API ?

Plus de 40 endpoints : factures clients et fournisseurs, produits, clients, fournisseurs, balance generale, écritures comptables (FEC), journaux, comptes bancaires, transactions, devis, exercices fiscaux, catégories analytiques, et bien plus.

Existe-t-il une solution no-code pour exporter Pennylane vers Google Sheets ?

Oui, DigitsLane est un add-on Google Workspace qui connecte Pennylane a Google Sheets sans aucune ligne de code. Il propose 55 types de données, 55 rapports comptables precalcules (bilan, SIG, TVA CA3, FEC, trésorerie...), la mise à jour directe et des templates prêts à l'emploi. Installer depuis le Marketplace →

Quelles sont les limites de l'API Pennylane ?

L'API impose un rate limit de 100 requêtes par minute par token. La pagination est limitée a 100 elements par page. Certaines ressources (FEC, balance) nécessitent un export asynchrone pouvant durer jusqu'à 2 minutes. Les access tokens expirent toutes les 2 heures.

Peut-on ecrire dans Pennylane depuis Google Sheets ?

Oui, l'API Pennylane v2 expose des endpoints d'écriture (POST/PUT) pour les produits, clients, fournisseurs et factures. DigitsLane propose une fonctionnalite de mise à jour directe qui detecte automatiquement vos modifications dans Sheets et les repercute dans Pennylane, avec validation et rollback.

Prêt à automatiser vos exports Pennylane ?

Installez DigitsLane en 2 minutes et obtenez vos rapports comptables dans Google Sheets — sans ecrire une seule ligne de code. 14 jours d'essai gratuit.

Réserver une demo →

Pennylane API : automatiser vos exports comptables dans Google Sheets