L'API publique est accessible pour les plans d'abonnement Essentiel et Premium.
L'API publique Pennylane permet aux développeurs d'automatiser la gestion des ventes, des achats et l'envoi d'écritures comptables.
Avec cette API, vous pouvez par exemple :
Importer automatiquement vos factures fournisseurs depuis votre système d'achats et suivre les bons de commande
Créer des factures clients en masse dans depuis le back-end de votre site e-commerce lorsque des clients payent un service ou créent un compte.
Synchroniser vos données produits et clients entre Pennylane et vos autres outils
Envoyer vers Pennylane des écritures comptables, créer des comptes comptables et les journaux, ainsi que récupérer les écritures générées dans Pennylane
Développer des intégrations partenaires, afin de mieux servir nos clients communs.
Documentation technique
L’intégralité des fonctionnalités disponibles (endpoints) grâce à l’API pour les ventes, les achats et la comptabilité est décrite en détail dans cette documentation technique :
⚠️ La documentation technique est uniquement disponible en anglais
Créer un jeton d'accès (token)
La connexion à notre API se fait via un jeton d'identification, aussi appelé Token :
Allez dans les Paramètres Entreprise (roue crantée en bas à droite de l'écran).
Cliquez sur Connectivité puis rendez-vous dans l'onglet Token API.
Cliquez sur Générer votre Token API.
Sélectionnez dans la liste qui s’affiche la ou les données auxquelles votre token doit ouvrir l’accès (son scope) :
Analytique et reporting (accounting) ;
Gestion des ventes (customer invoices) ;
Ecritures comptables (ledgers) ;
Gestion des fournisseurs (supplier invoices).
Précisez ensuite la Période de validité qui vous convient : elle peut aller de 1 mois à une durée indéterminée.
Cliquez ensuite sur Générer un token.
Le token est prêt ! Cliquez sur Copier au bout de la ligne de votre token.
Le token est alors copié dans votre presse-papier : gardez-la précieusement, car Pennylane ne vous donnera plus accès à cette information passée cette étape (vous devrez supprimer puis recréer un token, le cas échéant).
Confirmez avoir sauvegardé votre token API puis cliquez sur Continuer. Vous avez terminé !
⚠️ Le module Connectivité, dispose d'un accès restreint. Assurez-vous d'avoir tous les droits nécessaires ou rapprochez-vous de l'utilisateur disposant du statut Administrateur de votre compte Pennylane modifier vos accès ou générer le token pour vous.
✍️ Dans le module Connectivité de Pennylane, vous pouvez à tout moment visualiser et révoquer les tokens actifs.
Tester l'API sans risque
Avant de vous lancer en production, nous vous recommandons de tester l'API dans un environnement de test (sandbox). Vous pourrez ainsi vous familiariser avec son fonctionnement, affiner vos développements et vérifier les résultats sans impacter vos données réelles.
Consultez notre article Créer un compte environnement de test pour en savoir plus.
💡 Votre environnement sandbox aura besoin d’avoir un plan d’abonnement Essentiel ou Premium pour pouvoir avoir accès à l’onglet Token API.
Si vous n’avez pas ce niveau d’abonnement actuellement, contactez notre équipe support pour qu’elle vous aide à configurer votre sandbox comme il faut. Cela n’impacte pas votre abonnement hors de la sandbox.
Utiliser l’API à grande échelle et devenir partenaire de Pennylane
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, vous souhaitez également devenir partenaire ou intégrateur de Pennylane ? Avant toute chose, adressez votre demande pour devenir partenaire technologique de Pennylane ici. Une fois votre demande validée, vous pourrez demander l’authentification Oauth 2.0.
Besoin d'aide ?
Vous souhaitez savoir ce qu’il est possible de faire avec l’API ?
📎 L'intégralité de nos endpoints ventes et achats est décrite dans cette documentation.📎 Les endpoints comptabilité sont décrits dans cette documentation.
Si la fonctionnalité que vous souhaitez intégrer n'est pas décrite dans la documentation de l'API, c’est qu’elle n’est pas encore développée et disponible. Vous pouvez nous suggérer cette fonctionnalité ci-dessous 👇
En cas d'erreur d'authentification, vérifiez la validité de votre token et son périmètre d'accès (son scope).
Si vous dépassez les limites de requêtes par seconde, étalez vos appels dans le temps : vous pouvez faire 2 appels / seconde pour l’API Ventes et Achats; et 4 appels / seconde dans l’API comptable.
Proposer des améliorations
Vous souhaitez proposer des améliorations ? Nous sommes à votre écoute. Rendez-vous sur notre forum communautaire pour partager vos retours et idées d’amélioration. Vous vous y connectez avec vos identifiants habituels Pennylane.
💡 Commencez par faire une recherche et voir si votre idée n’a pas déjà été soumise. Dans ce cas, votez pour elle pour lui donner plus de poids. Votre proposition d’amélioration n’y figure pas encore ? Soumettez-la aux votes des autres membres de la communauté.
En résumé, l'API Pennylane offre de nombreuses possibilités pour automatiser vos processus de gestion et connecter vos outils, que ce soit pour le suivi des ventes, des achats ou l'alimentation de votre comptabilité. La documentation exhaustive vous permettra d'explorer toutes les fonctionnalités disponibles.
Donner son avis
Grâce à vos votes, nous savons que cet article nécessite notre attention. Pouvez-vous nous dire ce qui manque ou ce qui n'a pas été clair ?
(Merci beaucoup ! Cela ne prendra qu'1 minute, promis)
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. Si vous n'avez pas trouvé votre réponse, n'hésitez pas à utiliser le formulaire pour nous le signaler.