Intégration avec Pennylane
⚠️ Connecteur en bêta. Cette intégration est livrée en bêta : elle a été testée en interne mais peu en production. Si tu rencontres un bug, signale-le directement depuis PomodoFlow (bouton « Signaler » sous la carte Pennylane) ou écris à contact@pomodoflow.app. Merci pour ton aide !
À quoi sert l’intégration Pennylane ?
PomodoFlow se connecte à ton compte Pennylane pour importer automatiquement tes factures clients dans le prévisionnel financier. Tu retrouves :
- Tes factures payées et en attente sur le même tableau de bord que ton temps tracké
- Des projets PomodoFlow créés automatiquement à partir des factures non encore payées
- Des relances de paiement aux bonnes dates (J-7, J-1, retard)
L’intégration est en lecture seule : PomodoFlow ne crée, ne modifie ni ne supprime aucune donnée dans Pennylane.
Prérequis
Pour générer un token API Pennylane, tu dois :
- Avoir un compte Pennylane sur le plan Essential ou supérieur (le token API n’est pas disponible sur les plans inférieurs)
- Disposer d’un rôle administrateur : Dirigeant, Comptable interne ou Comptable externe
Si tu n’as pas un de ces rôles, demande à ton administrateur Pennylane de générer le token pour toi.
Étape 1 — Générer un token API Pennylane
- Connecte-toi à app.pennylane.com
- Va dans Gestion → Paramètres → Connectivité → Développeurs
- Clique sur Générer un token API
- Renseigne :
- Nom : par exemple « PomodoFlow »
- Permissions API V2 : sélectionne Lecture seule (PomodoFlow n’a pas besoin d’écrire)
- Durée de validité : 12 mois ou Illimité (recommandé pour ne pas avoir à régénérer)
- Clique sur Générer le token
- Copie immédiatement le token : Pennylane ne le réaffichera jamais. Si tu le perds, tu devras en créer un nouveau.
⚠️ Garde ce token confidentiel. Il donne accès en lecture à toutes tes factures clients.
Étape 2 — Connecter Pennylane dans PomodoFlow
- Ouvre PomodoFlow puis Réglages → Intégrations
- Trouve la carte Pennylane (avec le badge orange BÊTA), déplie-la
- Colle ton token dans le champ Clé d’API
- Clique sur Connecter
PomodoFlow valide le token en temps réel via l’endpoint /me de Pennylane. Si la coche verte apparaît, la première synchronisation démarre automatiquement.
Étape 3 — Importer tes factures
Après la première synchronisation, une fenêtre s’ouvre avec toutes les factures clients détectées sur ton compte Pennylane. Tu peux filtrer par :
- Année (l’année en cours est présélectionnée)
- Statut : Brouillon, Validé, Payé
Sélectionne ce qui t’intéresse puis clique sur Importer la sélection.
Ce qui se passe ensuite
- Toutes les factures sélectionnées alimentent ton prévisionnel de trésorerie.
- Chaque facture non payée crée un projet dans le domaine « Importé depuis Pennylane », avec :
- Le nom du client, le titre, le montant HT
- La date d’émission et l’échéance
- Le cycle de paiement (30, 45 ou 60 jours) déduit automatiquement
- Les factures payées sont seulement enregistrées pour les statistiques (pas de création de projet).
Différences avec Abby
| Aspect | Abby | Pennylane |
|---|---|---|
| Plans supportés | Tous (gratuit inclus) | Essential et supérieurs uniquement |
| Type de documents | Factures et devis | Factures clients uniquement |
| Génération de token | Self-serve, instantané | Self-serve, rôle admin requis |
| Statut du connecteur | Stable | Bêta — en cours de test |
Le filtre « Type » de la fenêtre d’import reste affiché pour Pennylane, mais seules les factures (invoice) y figurent puisque Pennylane n’expose pas les devis via son API publique v2.
Synchronisation automatique
Comme pour Abby, PomodoFlow vérifie ton compte Pennylane une fois par jour automatiquement. Tu peux déclencher une synchronisation manuelle à tout moment via le bouton Synchroniser sur la carte Pennylane.
Déconnecter Pennylane
Sur la carte Pennylane, déplie-la puis clique sur Déconnecter. Cela :
- Supprime ton token du Trousseau
- Vide le cache local des factures Pennylane
Les projets déjà créés à partir de factures Pennylane restent intacts.
💡 Tu peux aussi révoquer le token directement depuis Pennylane si tu veux couper l’accès sans toucher à l’app : Gestion → Paramètres → Connectivité → Développeurs → Supprimer.
Problèmes fréquents
« Clé invalide ou erreur de connexion. »
Vérifie que tu as bien collé le token entier (ils sont longs). Vérifie aussi que ton plan Pennylane permet la génération de tokens API — sinon, le token est créé mais l’API te refuse.
Mes factures n’apparaissent pas après la synchronisation.
Vérifie le filtre Année dans la fenêtre d’import. PomodoFlow récupère par défaut les 100 factures les plus récentes — si tu as plus, les plus anciennes peuvent être absentes du premier batch.
Le token a expiré.
Si tu as choisi une durée de 1, 6 ou 12 mois, le token finira par expirer. PomodoFlow affichera une erreur de connexion. Génère un nouveau token Pennylane et recolle-le dans la carte du connecteur.
Mon montant est différent entre Pennylane et PomodoFlow.
PomodoFlow affiche le montant HT (hors taxes). Vérifie que tu compares bien avec la colonne HT dans Pennylane.
Tu rencontres un bug ?
Le connecteur Pennylane est en bêta : ton retour est précieux. Depuis PomodoFlow, déplie la carte Pennylane et clique sur Signaler — un mail pré-rempli s’ouvre avec ton numéro de version.
Tu peux aussi écrire directement à contact@pomodoflow.app avec :
- Une description de ce que tu faisais
- Ce que tu attendais
- Ce qui s’est passé à la place
- Ta version de PomodoFlow (visible dans Réglages → Aide)
Merci de tester ce connecteur !