Avant de commencer
💡 Prérequis : L'intégration Penneo est disponible avec le nouveau tarif. Si vous voyez un écran verrouillé sur l'onglet Penneo, cliquez sur "Comparer et mettre à niveau" pour changer de tarif.
Pour accéder à la configuration Penneo :
Connectez-vous à votre compte TwinnTax
Cliquez sur l'icône ⚙️ Configuration dans le menu de gauche
Sélectionnez Intégrations
Cliquez sur l'onglet Penneo
Étape 1 — Clé API Penneo
Renseignez vos identifiants API Penneo :
Champ | Où le trouver |
Clé API (API Key) | Portail Penneo → Settings → API Access |
Mot de passe API (API Secret) | Même endroit, copiez-le exactement |
Voici l'endroit où vous devriez créer cette clé sur Penneo :
⚠️ Vous n'avez pas de section "API Access" dans Penneo ? Contactez votre account manager Penneo pour activer l'accès API.
Cliquez sur Valider et Enregistrer. Si les identifiants sont corrects, vous passez automatiquement à l'étape 2.
Étape 2 — Mapping des dossiers
Cette étape lie chaque module de signature TwinnTax à un dossier dans votre portail Penneo.
Pour chacun des 4 modules ci-dessous, sélectionnez un dossier Penneo dans le menu déroulant (ou choisissez "Create new folder" pour en créer un à la volée) :
Module | Description |
Livre des Actionnaires | Registre des actionnaires |
Assemblée Générale | Procès-verbaux et résolutions |
Annexe du Contrat de Location (270 MLH) | Annexes de contrats de bail |
Déclaration Fiscale (TOW) | Déclarations fiscales à signer |
💡 Vous pouvez mapper plusieurs modules vers le même dossier Penneo. Un dossier par module est conseillé pour plus de clarté, mais pas obligatoire.
Une fois les 4 modules mappés, cliquez sur Connect.
Étape 3 — Webhook
Le webhook permet à Penneo d'informer TwinnTax en temps réel quand une signature est complétée. Sans cette étape, vos documents signés n'apparaîtront jamais dans TwinnTax.
Cliquez sur Connecter/Reconnecter le Webhook Twinntax
TwinnTax affiche la liste des webhooks enregistrés dans votre compte Penneo
Sélectionnez l'URL TwinnTax dans la liste et cliquez Connecter au Webhook Twinntax
Si aucun webhook n'existe encore, TwinnTax en crée un automatiquement
Une coche verte confirme que le webhook est actif ✅
C'est fait ! 🎉
TwinnTax affiche un récapitulatif de votre configuration (clé API, dossiers mappés, statut webhook).
Tout est en ordre si la coche verte est présente sur le webhook.
Pour modifier la configuration plus tard : cliquez sur Réinitialiser et Reconfigurer en haut à droite.
⚠️ Un reset déconnecte Penneo immédiatement. Assurez-vous qu'il n'y a aucune signature en cours avant de réinitialiser.
❓ Problèmes fréquents
Problème | Solution |
L'onglet Penneo est verrouillé | Passez au nouveau tarif via "Comparer et mettre à niveau" |
Erreur à l'étape 1 | Vérifiez que la clé API et le secret sont copiés exactement depuis Penneo. Régénérez-les si nécessaire |
Le menu déroulant (étape 2) est vide | Créez d'abord un dossier dans votre portail Penneo, ou utilisez "Create new folder" |
Pas de coche verte sur le webhook | Cliquez sur "Connecter/Reconnecter le Webhook Twinntax" et suivez la procédure |
Les statuts de signature ne s'actualisent pas | Le webhook est manquant ou a été supprimé — reconnectez-le à l'étape 3 |
Le document signé n'apparaît pas | Vérifiez que le webhook est actif (coche verte) et que tous les signataires ont bien signé dans Penneo |