> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.fotostudio.io/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Synchronisation avec Pennylane # 🔗 Connexion Pennylane à Fotostudio ## Qu'est-ce que Pennylane ? [Pennylane](https://www.pennylane.com/) 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 : | Ce qui est synchronisé | Détail | | ---- | | **Factures** | Avec toutes les lignes, les montants HT/TTC et les taux de TVA | | **Paiements** | La facture est automatiquement marquée comme payée dans Pennylane | | **Avoirs** | Créés dans Pennylane et liés à la facture d'origine si elle est déjà synchronisée | | **Clients** | Créés automatiquement dans Pennylane (entreprises et particuliers) s'ils n'existent pas déjà | --- ## Comment connecter Pennylane ### Étape 1 — Générer votre clé API dans Pennylane ![](https://storage.crisp.chat/users/helpdesk/website/-/1/1/0/6/1106822c7ec6b200/pennylane_1qe37gm.png) 1. Connectez-vous à votre compte sur [app.pennylane.com](https://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](#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 : | Pays | Taux supportés | | ---- | | 🇫🇷 France | 20 %, 10 %, 5,5 %, 2,1 %, 0 % | | 🇧🇪 Belgique | 21 %, 12 %, 6 %, 0 % | | 🇪🇸 Espagne | 21 %, 10 %, 4 %, 0 % | | 🇮🇹 Italie | 22 %, 10 %, 5 %, 4 %, 0 % | | 🇵🇹 Portugal | 23 %, 13 %, 6 %, 0 % | | 🇩🇪 Allemagne | 19 %, 7 %, 0 % | | 🇨🇭 Suisse | 8,1 %, 2,6 %, 0 % | --- ## 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](#étape-1--générer-votre-clé-api-dans-pennylane) 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.