L'API Entreprise est accessible avec un abonnement Essentiel et supérieur.
Nos API publiques vous permettent de connecter Pennylane aux outils que vous utilisez dans le cadre de vos activités.
Pennylane propose deux API publiques :
Une API destinée aux entreprises, appelée Company API ou API Entreprise.
Une API destinée aux cabinets comptables, appelée Firm API ou API Cabinet.
Pour commencer à intégrer nos API, rendez-vous sur : pennylane.readme.io.
À propos des API Pennylane
Nos API permettent aux développeurs de connecter des outils à Pennylane pour automatiser des tâches de gestion ou de comptabilité qui peuvent être réalisées dans Pennylane.
Par exemple, au lieu de vous connecter à Pennylane pour générer manuellement une facture à chaque fois que vous enregistrez un paiement dans votre backoffice, vous pouvez connecter votre backoffice à Pennylane au travers de notre API Entreprise. Une fois la connexion en place, vous pouvez écrire du code pour faire en sorte que chaque paiement enregistré sur votre backoffice déclenche la création d’une facture dans Pennylane.
Inversement, votre équipe technique peut décider de connecter Pennylane à votre outil de support client via notre API Entreprise. De cette manière, votre service client pourra consulter le statut d’une facture Pennylane sans devoir accéder à votre espace Pennylane.
En clair, nos API vous permettent de prendre des éléments propres à Pennylane et de les utiliser partout où vous en avez besoin, pour limiter le cloisonnement de vos données.
Exemples d’actions possibles
Nos API vous permettent d’interagir de manière automatisée avec des « objets » propres à Pennylane : factures, devis, écritures comptables, fournisseurs, clients, produits, catégories, dossiers comptables… L’intérêt de nos API tient au fait que ces interactions n’ont pas besoin d’être déclenchées depuis votre espace Pennylane pour avoir lieu. Vous pouvez les déclencher depuis d’autres applications, depuis vos outils métier par exemple.
Pour que la bonne information arrive au bon endroit dans nos API, les interactions en question passent par des points d’entrée standardisés (API endpoints), c’est-à-dire des adresses qui permettent de réaliser une action donnée sur un objet donné — par exemple récupérer les informations contenues dans une facture enregistrée sur Pennylane. Votre équipe technique peut utiliser nos API pour automatiser des actions que vous avez l’habitude de réaliser dans Pennylane.
Ce que l’API Entreprise permet de faire
Voici un aperçu simplifié de ce que notre API Entreprise permet de faire :
Factures, devis et abonnements. Créez des factures, des devis et des abonnements automatiquement, importez vos factures fournisseurs (dans Pennylane) depuis votre système d’achats, ou indiquez qu’une facture a été payée.
Clients, fournisseurs et produits. Ajoutez un nouveau client ou un nouveau fournisseur à vos listes, mettez à jour un client ou un fournisseur existant, ou listez les produits que vous avez enregistrés.
Écritures comptables. Ajoutez des écritures à vos journaux Pennylane, listez ou créez des comptes comptables, importez un justificatif et liez-le à une écriture comptable, ou générez un FEC que vous pouvez ensuite récupérer pour l’exploiter dans un outil tiers.
Ce que l’API Cabinet permet de faire
Voici un aperçu simplifié de ce que notre API Cabinet permet de faire :
Rapports et données comptables. Récupérez facilement les données de vos clients : balance générale, FEC, ou encore grand livre analytique.
Dossiers clients. Récupérez la liste de tous vos clients et affichez les détails d’un dossier en particulier si vous le souhaitez. Récupérez également la liste des exercices fiscaux liés à une entreprise donnée.
Documentation technique (en anglais)
L’intégralité des fonctionnalités disponibles (endpoints) grâce aux API et les références sont décrites en détail (en anglais) sur des sites à part :
Intégrer nos API dans vos outils métier
Intégrer l’API Entreprise
Pour accéder aux paramètres de l’API sur votre espace Pennylane, vous devez :
Avoir le rôle d’administrateur/dirigeant sur votre compte.
Avoir un abonnement Pennylane Essentiel (ou supérieur).
Générer un token d’API Entreprise
Découvrez comment créer un token (jeton d'accès) d’API pour utiliser l’API Entreprise (voir la doc).
✍️ Dans le module Connectivité de Pennylane, vous pouvez à tout moment visualiser et révoquer les tokens actifs.
Tester l'API Entreprise sans risque
Avant d’utiliser l’API Entreprise en production avec des données réelles, vous pouvez la tester dans un environnement de test appelé sandbox (bac à sable). La sandbox vous permet de vous familiariser avec le fonctionnement de l’API sans altérer vos données, sans risque donc.
Consultez la documentation de l’API (en anglais) pour voir comment créer un environnement de test.
💡 Créer une sandbox n’occasionne pas de surcoût. L’espace de travail créé avec votre sandbox « hérite » simplement de l’abonnement auquel vous avez souscrit sur votre espace de travail principal. Pour générer des tokens d’API sur votre sandbox, l’espace lié à votre sanbox doit être doté d’un abonnement Essentiel (au moins). Si vous constatez une différence entre l’abonnement lié à votre espace principal et celui de votre sandbox, écrivez à notre équipe support pour qu’elle vous aide à configurer votre sandbox comme il faut.
Intégrer l’API Cabinet
La procédure à suivre pour intégrer l’API Cabinet n’est pas la même que celle indiquée dans le cas de l’API Entreprise. Consultez la documentation de l’API Cabinet (en anglais) pour en savoir plus sur la création de tokens (jetons).
Demander un accès partenaire pour créer une intégration
Vous souhaitez utiliser l’API de Pennylane pour un usage de masse ? Une authentification OAuth 2.0 est alors nécessaire. Ce guide technique (en anglais) vous donne les éléments à connaître et détaille la procédure à suivre pour en faire de la demande.
Par ailleurs, si vous souhaitez nouer un partenariat avec Pennylane pour développer une intégration (avec un outil tiers) reposant sur nos API, contactez-nous en remplissant le formulaire situé sur notre site marketing. Une fois votre candidature validée, vous pourrez demander l’authentification OAuth 2.0.
Utiliser l’API Groupe (API firm group)
Si vous travaillez pour un groupe d’expertise-comptable qui possède de nombreux cabinets comptables, et si vous souhaitez gagner du temps dans votre migration vers Pennylane, vous pouvez utiliser notre API Groupe (de cabinets).
Cette API est conçue pour faciliter le traitement en masse de dossiers clients (companies) et de cabinets comptables (firms), par exemple lors de migrations techniques. Pour accéder à l’API Groupe, adressez-vous à votre contact commercial ou à notre équipe support.
Conseils en cas de problème
Si vous rencontrez une erreur d’authentification, vérifiez la validité de votre token et le périmètre d’accès qui y est associé (son scope).
Si vous atteignez le plafond imposé par le rate limiting, étalez vos requêtes dans le temps. Vous pouvez faire jusqu’à 4 appels/sec pour l’API Cabinet et l’API Entreprise v1. Avec l’API Entreprise v2, vous pouvez aller jusqu’à 5 appels/sec.
Si la fonctionnalité que vous souhaitez intégrer n'est pas décrite dans la documentation des API, c’est qu’elle n’est pas encore développée et disponible. Vous pouvez nous suggérer cette fonctionnalité sur notre forum communautaire.
P.S. Vous avez trouvé l'article clair, utile et bien rédigé ? Cliquez sur le 
ci-dessous pour nous le faire savoir.
Vos retours positifs nous encouragent à continuer à vous fournir le meilleur contenu possible.