L’un des principaux atouts de Pennylane est de proposer une API REST documentée permettant d’automatiser une grande partie des opérations de gestion commerciale et comptable.
Pour un développeur ou une agence web, cela ouvre la possibilité de créer un connecteur personnalisé entre une boutique WooCommerce, Shopify, PrestaShop ou une application métier et Pennylane.
L’objectif est simple : éviter toute ressaisie manuelle en synchronisant automatiquement les données entre votre site e-commerce et votre logiciel de facturation.
Dans cette partie, nous allons découvrir le fonctionnement de l’API Pennylane et les principales possibilités offertes aux développeurs.
Pourquoi utiliser l’API Pennylane ?
Il est tout à fait possible d’utiliser Pennylane de manière classique, en créant manuellement les devis et les factures depuis l’interface.
Cependant, cette méthode devient rapidement chronophage lorsqu’une boutique traite plusieurs dizaines ou centaines de commandes par jour.
Grâce à l’API, chaque commande validée peut automatiquement déclencher la création des documents nécessaires sans intervention humaine.
Par exemple, un client passe commande sur votre boutique WooCommerce.
Une fois le paiement confirmé, votre connecteur peut :
- vérifier si le client existe déjà dans Pennylane ;
- créer la fiche client si nécessaire ;
- créer la facture correspondante ;
- ajouter les lignes de produits ;
- associer le règlement ;
- récupérer le numéro officiel de facture ;
- enregistrer ce numéro dans WooCommerce.
L’ensemble de ces opérations peut être réalisé en quelques secondes.
Une API REST moderne
Pennylane met à disposition une API REST reposant sur des échanges au format JSON.
Cette architecture facilite l’intégration avec la majorité des langages de programmation modernes :
- PHP
- JavaScript
- Node.js
- Python
- Java
- C#
- Go
L’API peut également être utilisée depuis des plateformes d’automatisation comme Make ou n8n.
Cela permet aussi bien de développer un connecteur personnalisé que de créer rapidement des automatisations sans écrire de code.
Les principales ressources disponibles
L’API Pennylane permet d’interagir avec de nombreuses ressources de la plateforme.
Parmi les plus utilisées, on retrouve :
Les clients
Vous pouvez :
- créer un client ;
- modifier ses informations ;
- récupérer sa fiche ;
- rechercher un client existant.
Cela évite la création de doublons lors des nouvelles commandes.
Les devis
L’API permet de générer automatiquement un devis à partir d’une demande effectuée sur votre site.
Cette fonctionnalité peut être intéressante pour les entreprises proposant des prestations sur mesure.
Les factures
C’est généralement la fonctionnalité la plus utilisée.
Depuis votre application, il est possible de :
- créer une facture ;
- ajouter les lignes de produits ;
- définir les montants ;
- renseigner la TVA ;
- associer un client.
Une fois la facture créée, Pennylane attribue son numéro officiel.
Les paiements
Selon votre workflow, vous pouvez également synchroniser les règlements provenant de :
- Stripe ;
- PayPal ;
- virements bancaires ;
- cartes bancaires.
Cette synchronisation évite les écarts entre votre boutique et votre logiciel comptable.
Les avoirs
Les remboursements sont souvent oubliés lors du développement d’un connecteur.
Pourtant, ils font partie intégrante du cycle de facturation.
Une bonne intégration doit être capable de générer automatiquement un avoir lorsqu’une commande est remboursée.
Exemple de workflow WooCommerce
Prenons un exemple concret.
Un client commande une formation sur votre boutique WooCommerce.
Le scénario peut être le suivant :
- Création de la commande.
- Paiement Stripe validé.
- WooCommerce déclenche un événement.
- Le connecteur appelle l’API Pennylane.
- Le client est créé ou mis à jour.
- La facture est générée.
- Le numéro de facture est renvoyé à WooCommerce.
- Le PDF est archivé.
- La commande est marquée comme synchronisée.
L’utilisateur n’a aucune manipulation supplémentaire à effectuer.
Les webhooks
Une intégration moderne ne fonctionne pas uniquement grâce aux appels API.
Les webhooks permettent à Pennylane de prévenir automatiquement votre application lorsqu’un événement se produit.
Par exemple :
- une facture est validée ;
- un paiement est enregistré ;
- une facture est annulée ;
- un document est modifié.
Votre connecteur peut alors mettre à jour automatiquement WooCommerce sans avoir à interroger l’API en permanence.
Cette approche améliore les performances tout en réduisant le nombre de requêtes.
Sécuriser son intégration
Lorsqu’une API manipule des données financières, la sécurité est essentielle.
Quelques bonnes pratiques :
- ne jamais stocker les clés API dans le code source ;
- utiliser des variables d’environnement ;
- sécuriser les échanges via HTTPS ;
- journaliser les erreurs ;
- mettre en place un système de reprise en cas d’échec ;
- limiter les droits des clés API.
Une intégration robuste doit également gérer les indisponibilités temporaires de l’API afin d’éviter toute perte de données.
Développer un connecteur WooCommerce
Grâce à son architecture ouverte, WooCommerce constitue une excellente base pour développer un connecteur vers Pennylane.
Le principe consiste à créer un plugin chargé d’écouter les événements importants :
- commande créée ;
- paiement confirmé ;
- remboursement ;
- annulation.
À chaque événement, le plugin échange les informations avec l’API Pennylane afin de maintenir les deux systèmes synchronisés.
Cette approche permet d’obtenir une automatisation complète du processus de facturation.
Pourquoi développer son propre connecteur ?
Les plateformes d’automatisation comme Make sont rapides à mettre en place, mais elles atteignent parfois leurs limites lorsque les règles métier deviennent complexes.
Un connecteur développé sur mesure offre davantage de flexibilité.
Il devient possible de :
- appliquer des règles spécifiques selon les produits ;
- gérer plusieurs sociétés ;
- synchroniser plusieurs boutiques ;
- personnaliser les libellés des factures ;
- créer automatiquement des avoirs ;
- gérer les abonnements récurrents ;
- intégrer un ERP ou un CRM.
Pour les entreprises ayant un volume de commandes important, cette approche est généralement la plus pérenne.
Ce qu’il faut retenir
L’API Pennylane permet d’automatiser la majorité des opérations de facturation d’un site e-commerce.
Associée à WooCommerce, elle facilite la création des clients, des factures, des paiements et des avoirs, tout en limitant les interventions manuelles.
Dans la prochaine partie de ce guide, nous verrons comment connecter concrètement WooCommerce à Pennylane, quelles architectures privilégier et quelles bonnes pratiques adopter pour développer un connecteur fiable, évolutif et compatible avec la réforme de la facturation électronique.
Le saviez-vous ?
Une intégration WooCommerce ↔ Pennylane ne se limite pas à la création des factures. Un connecteur bien conçu peut également synchroniser les remboursements, les avoirs, les paiements Stripe, les clients, les produits et, à terme, les échanges liés à la facturation électronique. C’est cette approche globale qui garantit une comptabilité cohérente et réduit les tâches administratives.