🔗 Connexion Pennylane à Fotostudio

Qu'est-ce que Pennylane ?

Pennylane est un logiciel de comptabilité français destiné aux TPE/PME et aux experts-comptables. La connexion avec Fotostudio permet de synchroniser automatiquement vos documents comptables (factures, paiements, avoirs) vers Pennylane, sans aucune ressaisie.

Ce que fait l'intégration

Une fois activée, l'intégration envoie automatiquement vers Pennylane :

Comment connecter Pennylane

Étape 1 — Générer votre clé API dans Pennylane

1. Connectez-vous à votre compte sur app.pennylane.com
2. Allez dans Paramètres → Connectivité
3. Cliquez sur l'onglet Développeurs
4. Cliquez sur Générer un token API
5. Choisissez Illimité pour la période de validité et cochez la case d'avertissement
6. A l'épape suivante, dans les permissions, cochez en lecture et écriture: Gestion des clients, Gestion des factures clients, Gestion des factures fournisseurs, Gestion des transactions, Gestion des fournisseurs
7. Finalisez et copiez la clé affichée (elle ne sera visible qu'une seule fois)

Étape 2 — Configurer Pennylane dans Fotostudio

1. Dans Fotostudio, allez dans Comptabilité → Paramètres → Synchronisation comptable
2. Cliquez sur le bouton Configurer un service
3. Faites défiler jusqu'à la section Pennylane
4. Collez votre clé API dans le champ Clé API
5. Cliquez sur Tester la connexion pour vérifier que la clé est valide
6. Cochez Activer la synchronisation avec Pennylane
7. Cliquez sur Enregistrer

ℹ️ Vous ne pouvez activer qu'un seul logiciel de comptabilité à la fois. Si vous utilisiez SevDesk ou Lexware, l'activation de Pennylane le désactivera automatiquement.

Étape 3 — Prérequis à vérifier côté Pennylane (à faire AVANT la première synchro)

Deux réglages Pennylane, indépendants de Fotostudio, sont la cause de la quasi-totalité des erreurs de synchronisation rencontrées en support. Vérifiez-les avant de considérer l'intégration comme opérationnelle :

1. Permissions de la clé API : le token généré à l'Étape 1 doit avoir la permission Gestion des clients cochée en lecture et écriture. Sans ça, la synchro échoue avec le message "Impossible de créer/récupérer le client Pennylane".
2. Numérotation des factures : dans Pennylane, allez dans Paramètres → Factures de vente → Numérotation et configurez un modèle de numérotation. Sans ça, la synchro échoue avec le message "Impossible de convertir le brouillon. Configurez d'abord la numérotation des factures".

Voir la section Problèmes fréquents plus bas pour la marche à suivre détaillée si l'une de ces erreurs apparaît malgré tout.

Fonctionnement de la synchronisation

Synchronisation automatique

Dès que Pennylane est activé, la synchronisation se déclenche automatiquement :

• Quand une facture est finalisée
• Quand un paiement est enregistré
• Quand un avoir est émis et finalisé

Vous n'avez rien à faire manuellement.

Synchronisation manuelle

Depuis la page Synchronisation comptable (/app/accounting_sync), vous pouvez :

• Voir l'état de synchronisation de chaque document (succès, erreur, en attente)
• Déclencher manuellement la synchronisation d'un document spécifique
• Re-synchroniser un document en cas d'erreur

Idempotence

La synchronisation est sécurisée contre les doublons : si une facture ou un avoir a déjà été envoyé à Pennylane, Fotostudio le détecte et ne crée pas de doublon. Les clients sont également créés une seule fois, identifiés de façon unique via leur référence interne.

Pays et taux de TVA supportés

L'intégration gère les codes TVA officiels Pennylane pour les pays suivants :

Consulter l'historique des synchronisations

Rendez-vous dans Paramètres → Synchronisation comptable → Historique pour voir :

• La liste de tous les documents synchronisés
• Le statut de chaque synchronisation (succès / erreur / en attente)
• Le détail des erreurs en cas d'échec

Problèmes fréquents

"API key manquante"

La clé API n'est pas renseignée ou vide. Vérifiez qu'elle est bien saisie dans les paramètres et que l'intégration est activée.

"Impossible de créer/récupérer le client Pennylane" ou "votre clé API Pennylane n'a pas la permission de..."

Votre clé API Pennylane n'a pas été générée avec les droits nécessaires sur la gestion des clients (lecture et écriture). C'est le problème le plus fréquent après une première connexion.

Solution :

1. Dans Pennylane, allez dans Paramètres → Connectivité → Développeurs
2. Régénérez un token API (l'ancien restera invalide dès qu'un nouveau est créé)
3. À l'étape des permissions, vérifiez que Gestion des clients est bien cochée en lecture ET en écriture (ainsi que les autres permissions listées à l'Étape 1 ci-dessus)
4. Copiez la nouvelle clé et remplacez-la dans Fotostudio (Comptabilité → Paramètres → Synchronisation comptable)
5. Re-synchronisez le document en erreur depuis la page Historique

"Impossible de convertir le brouillon. Configurez d'abord la numérotation des factures"

Pennylane exige qu'un modèle de numérotation des factures soit configuré avant de pouvoir créer une facture finalisée (non brouillon) via l'API. Sans ça, chaque tentative de synchronisation échoue avec ce message.

Solution :

1. Dans Pennylane, allez dans Paramètres → Factures de vente (ou Facturation) → Numérotation
2. Configurez un modèle de numérotation pour vos factures clients (même une numérotation simple suffit)
3. Enregistrez, puis re-synchronisez le document en erreur depuis Fotostudio (page Synchronisation comptable → Historique)

"Facture non synchronisée avec Pennylane"

Un paiement est enregistré mais la facture correspondante n'a pas encore été synchronisée. Synchronisez d'abord la facture, puis re-synchronisez le paiement.

Erreur de connexion

En cas d'erreur réseau ou de timeout, la synchronisation échoue avec le statut "erreur". Vous pouvez re-synchroniser manuellement depuis la page Historique. Si le problème persiste, vérifiez que la clé API est toujours valide côté Pennylane (elle peut être révoquée depuis les paramètres Pennylane).

Questions fréquentes

Est-ce que les factures déjà émises avant l'activation sont synchronisées ?
Non, la synchronisation automatique ne s'applique qu'aux documents créés après l'activation. Les documents antérieurs peuvent être synchronisés manuellement depuis la page Synchronisation comptable.

Que se passe-t-il si je désactive Pennylane puis le réactive ?
Les documents déjà synchronisés conservent leur lien avec Pennylane. Les nouveaux documents seront à nouveau synchronisés automatiquement. Aucun doublon ne sera créé.

Puis-je utiliser Pennylane et un autre logiciel comptable en même temps ?
Non, un seul logiciel de comptabilité peut être actif à la fois dans Fotostudio.

Pennylane est-il disponible pour tous les abonnements Fotostudio ?
L'intégration Pennylane est disponible pour tous les utilisateurs ayant accès au module de facturation.

Mis à jour le : 20/07/2026