Aller au contenu principal

Intégration Pennylane

Pennylane est une plateforme de comptabilité et de facturation en ligne conçue pour le marché français (FR / BE / LU / CH). Lorsqu'elle est configurée dans CADENSA, vous pouvez émettre des factures légalement valides directement à partir de vos entrées de temps suivies, conformément au standard Factur-X — obligatoire pour la facturation électronique B2B française à partir de septembre 2026.

Pays pris en charge

Pennylane est conçu pour les entreprises en France 🇫🇷, Belgique 🇧🇪, Luxembourg 🇱🇺 et Suisse 🇨🇭.

Conformité Factur-X

Factur-X (PDF/A-3 avec XML intégré) devient obligatoire en France :

  • Septembre 2026 — grandes entreprises
  • 2027 — déploiement progressif à toutes les entreprises

L'intégration Pennylane de CADENSA est prête pour cette exigence.

Avant de commencer​

Vous avez besoin :

  • D'un compte Pennylane actif — plan Essentiel ou supérieur (l'API n'est pas disponible sur le plan Basique)
  • D'un token API Pennylane (voir ci-dessous)
  • D'une unité CADENSA avec au moins le rôle Admin
Exigence de plan

L'API publique Pennylane est uniquement disponible sur les plans Essentiel (24 €/mois) et Premium (79 €/mois). Le plan Basique (14 €/mois) n'inclut pas l'accès à l'API.

Étape 1 — Créer un compte Pennylane​

  1. Allez sur pennylane.com
  2. Cliquez sur "Démarrer maintenant" (en haut à droite)
  3. Sélectionnez "Essentiel" et cliquez sur "Essayer"
  4. Inscrivez-vous avec votre e-mail et mot de passe
  5. Créez une entreprise (requis — les tokens sont limités à une entreprise)

Un essai gratuit de 15 jours démarre automatiquement. Sans engagement.

Étape 2 — Obtenir votre token API Pennylane​

  1. Connectez-vous à app.pennylane.com
  2. Dans la barre latérale gauche, cliquez sur Paramètres (icône engrenage, en bas à gauche)
  3. Naviguez vers Intégrations → API
  4. Cliquez sur "Générer un token"
  5. Copiez le token Bearer généré
Gardez votre token API secret

Ne partagez jamais votre token et ne le commettez pas dans un système de contrôle de version. Toute personne ayant le token peut créer et gérer des factures en votre nom.

Pour le guide officiel Pennylane, voir : pennylane.readme.io/docs/generating-my-api-token

Étape 3 — Configurer dans CADENSA​

  1. Ouvrez Paramètres → Facturation dans CADENSA
  2. Sélectionnez Pennylane 🇫🇷 comme fournisseur
  3. Collez votre token API dans le champ Clé API
  4. Cliquez sur Tester la connexion — un vert confirme que le token est valide et affiche le nom de votre entreprise
  5. Cliquez sur Enregistrer

Étape 4 — Configurer les valeurs par défaut​

Configurez les valeurs par défaut pour que la boîte de dialogue Générer une facture soit pré-remplie avec des valeurs adaptées :

ParamètreValeur recommandée (FR)Description
Devise par défautEURDevise utilisée sur les nouvelles factures
TVA % par défaut20Taux de TVA français standard
Délai de paiement30Jours jusqu'à la date d'échéance (30 jours est la norme en France)
Type de document par défautFacturePrésélectionne "Facture" dans la boîte de dialogue
Pays de l'émetteurFRPays de votre entreprise — active la suggestion automatique de TVA
Autres taux de TVA français
  • 10% — Taux réduit (hôtellerie, transport)
  • 5,5% — Taux super-réduit (alimentation, livres, certains services culturels)
  • 0% — Exonéré (livraison intracommunautaire, exportation)

Émettre une facture via Pennylane​

Une fois configuré, suivez le flux standard de génération de factures :

  1. Ouvrez Rapports → appliquez des filtres de plage de dates et de projet
  2. Cliquez sur Générer une facture
  3. Dans le champ Type de document, sélectionnez Facture — le canal de sortie affiche Pennylane
  4. Remplissez les détails du client (nom, adresse, pays, numéro de TVA si applicable)
  5. Définissez le taux de TVA (défaut : 20%)
  6. Cliquez sur Aperçu de la facture → vérifiez les lignes et les totaux
  7. Cliquez sur Émettre la facture (Pennylane)

CADENSA envoie la facture à l'API Pennylane. Un enregistrement client est automatiquement trouvé ou créé par correspondance de nom. La facture est créée et finalisée, et le PDF est téléchargé depuis Pennylane.

Ce qui se passe dans Pennylane
  • Une nouvelle facture client est créée dans Pennylane sous Ventes → Factures clients
  • La facture est finalisée immédiatement (statut : waiting_payment)
  • Le PDF est disponible au téléchargement depuis CADENSA (Historique des factures) et depuis Pennylane

Mode brouillon​

Pour créer une facture brouillon sans la finaliser :

L'intégration Pennylane crée des factures finalisées par défaut (draft: false). Pour des tests ou une révision, contactez votre compte Pennylane pour définir des factures en brouillon manuellement, ou supprimez les factures de test depuis le tableau de bord Pennylane après les tests.

Tester sans vraies factures

Comme Pennylane n'a pas d'environnement sandbox, utilisez les types de documents Proforma ou Résumé de travail dans CADENSA pour les tests — ceux-ci sont toujours générés comme PDFs internes et ne sont jamais envoyés à Pennylane.

Codes de taux de TVA​

Pennylane utilise des codes de taux de TVA français spécifiques en interne :

Taux de taxeCode PennylaneCas d'utilisation
20%FR_200TVA standard (taux normal)
10%FR_100Taux réduit (taux intermédiaire)
5,5%FR_055Taux super-réduit (taux réduit)
0%exemptExonéré de TVA, exportation, intra-UE

CADENSA mappe automatiquement votre taux de taxe numérique vers le bon code Pennylane.

Routage des documents​

Type de documentSortie
ProformaPDF interne (jamais envoyé à Pennylane)
Résumé de travailPDF interne (jamais envoyé à Pennylane)
FactureEnvoyé à l'API Pennylane → PDF retourné

Seuls les documents de type Facture sont envoyés à Pennylane. Les Proformas et Résumés de travail sont toujours générés en interne, quel que soit le paramètre du fournisseur.

Historique des factures et téléchargement PDF​

Après une création de facture réussie :

  • La facture apparaît dans Rapports → Factures dans CADENSA
  • La facture apparaît également dans votre compte Pennylane sous Ventes → Factures clients
  • Vous pouvez re-télécharger le PDF à tout moment depuis l'un ou l'autre endroit

Résolution des problèmes​

Erreur "401 Unauthorized"​

Le token API est invalide, expiré ou provient d'un mauvais compte Pennylane.

Correction : Générez un nouveau token dans Pennylane (Paramètres → Intégrations → API → Générer un token) et re-saisissez-le dans CADENSA.

Erreur "API not available" / 403​

Votre plan Pennylane n'inclut pas l'accès à l'API.

Correction : Passez au plan Essentiel (24 €/mois) ou Premium (79 €/mois) — le plan Basique n'inclut pas l'accès à l'API.

Erreur "INVOICE_NO_ENTRIES"​

Aucune entrée de temps n'a été trouvée pour la plage de dates et les filtres de projet sélectionnés.

Correction : Ajustez la plage de dates ou le filtre de projet et réessayez.

Ressources connexes​

Besoin d'aide ?​