Pennylane publie son propre module sur la marketplace PrestaShop. Une fois votre boutique connectée, chaque commande marquée comme payée dans PrestaShop crée une facture client finalisée dans Pennylane. Cet article s’adresse aux e-commerçants qui gèrent une boutique PrestaShop et qui veulent automatiser leur facturation.
⚠️Cet article décrit l’intégration développée par Pennylane. Elle est différente des intégrations PrestaShop via Chift ou Pennylane Connect, qui restent disponibles. Si votre boutique est déjà connectée par l’un de ces moyens, contactez le support Pennylane avant d’activer celle-ci, pour éviter des factures en double.
Prérequis
Pour connecter PrestaShop à Pennylane, vous devez disposer :
d’un accès administrateur à votre back-office PrestaShop, avec les droits nécessaires pour créer une clé de webservice ;
d’un compte Pennylane, ou d’une adresse e-mail pour en créer un.
Installer le module Pennylane dans PrestaShop
Connectez-vous à votre back-office PrestaShop.
Ouvrez la marketplace PrestaShop Addons.
Recherchez le module Pennylane - Electronic Invoicing.
Téléchargez le module.
Créer ou connecter votre compte Pennylane
Depuis la page de configuration du module :
si vous n’avez pas encore de compte Pennylane, cliquez sur le bouton de création de compte dans la section Connexion, puis suivez les étapes ;
si vous avez déjà un compte Pennylane, connectez-vous d’abord à Pennylane depuis l’application avant de configurer la synchronisation de votre boutique.
Créer la clé de webservice PrestaShop
La clé de webservice autorise Pennylane à lire les données nécessaires à la création de vos factures.
Depuis la page de configuration du module :
Dans la section Configuration, cliquez sur Générer la clé API.
Copiez la clé de webservice.
La clé doit rester active et conserver les droits de lecture nécessaires. Une clé désactivée, une permission manquante ou un webservice désactivé empêche la connexion de s’établir.
⚠️ Ne partagez jamais votre clé de webservice dans un canal public. Elle donne accès aux données de votre boutique.
Connecter votre boutique à Pennylane
Rendez-vous dans Paramètres entreprise, puis cliquez sur Connectivité.
Dans la barre de recherche de l’onglet Intégrations, écrivez PrestaShop.
Cliquez sur l’encart PrestaShop portant le logo de Pennylane, et non celui de Chift.
Renseignez l’adresse principale de votre boutique PrestaShop et la clé de webservice que vous venez de copier.
Cliquez sur Continuer.
Pennylane vérifie automatiquement que l’adresse de la boutique est accessible et que la clé d;e webservice est valide. Si la vérification échoue, la connexion n’est pas enregistrée.
Sélectionner vos boutiques
Si Pennylane détecte plusieurs boutiques PrestaShop sur votre compte, un menu déroulant apparaît dans le volet latéral de l’intégration. Sélectionnez toutes les boutiques dont vous voulez synchroniser les données.
Enregistrer le secret de webhook
Après la validation de la clé de webservice, Pennylane génère un secret de webhook. Ce secret sécurise les échanges entre PrestaShop et Pennylane, et il ne s’affiche qu’une seule fois.
Copiez le secret affiché dans Pennylane.
Revenez sur la page de configuration du module Pennylane dans votre back-office PrestaShop.
Collez le secret dans le champ Secret webhook.
Enregistrez la configuration.
⚠️Conservez ce secret. Si vous le perdez, utilisez l’action Régénérer le secret dans Pennylane, puis remplacez l’ancien secret dans la configuration du module PrestaShop. L’ancien secret cesse de fonctionner dès qu’il est régénéré.
📖 Pour aller plus loin : pour que l’intégration crée vos factures, votre éditeur de factures et votre numérotation doivent être prêts.
Vérifier que la synchronisation fonctionne
Vérifiez que le statut de l’intégration est Active dans Pennylane.
Créez ou reprenez une commande de test dans PrestaShop.
Passez cette commande à un statut considéré comme payé.
Après quelques instants, vérifiez que la facture apparaît dans Ventes > Factures clients.
La synchronisation se fait automatiquement en arrière-plan : les commandes payées deviennent des factures clients finalisées dans Pennylane. L’intégration reprend les informations transmises par PrestaShop (client, lignes de commande, quantités, montants et TVA). Dans la version actuelle, ces informations ne sont pas rapprochées automatiquement de vos fiches clients existantes dans Pennylane
Lorsqu’un remboursement total ou partiel génère un avoir dans PrestaShop, Pennylane crée automatiquement un avoir et le rattache à la facture d’origine, si celle-ci figure déjà dans Pennylane. L’avoir reprend le même client, la même devise et les produits remboursés. Les frais de port sont inclus s’ils font partie du remboursement. Si plusieurs remboursements partiels génèrent plusieurs avoirs dans PrestaShop, Pennylane crée un avoir pour chacun d’eux.
Désactiver l’intégration
Rendez-vous dans Paramètres entreprise, puis cliquez sur Connectivité.
Dans la barre de recherche de l’onglet Intégrations, écrivez PrestaShop.
Cliquez sur l’encart PrestaShop portant le logo Pennylane et le badge Active.
En bas du volet latéral, cochez la case de confirmation.
Cliquez sur Supprimer l’intégration.
La désactivation ne supprime ni les données déjà synchronisées, ni les factures émises dans Pennylane. Elle empêche seulement la synchronisation des commandes suivantes. Si vous reconnectez l’intégration plus tard, seules les commandes marquées comme payées à partir de cette date créeront des factures dans Pennylane.
Questions fréquentes
Les commandes arrivent-elles sous forme de factures ou d’écritures comptables ?
Les commandes payées sont créées sous forme de factures clients finalisées dans Pennylane.
Les commandes payées avant la connexion sont-elles importées ?
Non, ne comptez pas sur une reprise automatique de votre historique. Contactez le support Pennylane si vous souhaitez récupérer ces commandes dans Pennylane.
Puis-je connecter une installation multiboutique ?
Oui. Au moment de la connexion, pensez à sélectionner toutes les boutiques que vous voulez synchroniser avec Pennylane.
Comprendre les données partagées avec Pennylane
Pennylane accède à votre boutique PrestaShop en lecture seule pour récupérer les données nécessaires à la création de factures et d’avoirs. Pennylane ne parcourt pas votre boutique. Elle consulte les données d’une commande payée ou d’un avoir lorsque le module PrestaShop lui transmet l’identifiant correspondant.
Données utilisées
Pour maintenir la connexion : l'adresse de votre boutique et la clé API. Si vous avez plusieurs boutiques, l'identifiant et le nom de celles que vous connectez.
Pour chaque commande payée : les informations nécessaires à la facture (référence, date, devise, montants et lignes), le client concerné et son adresse de facturation.
Pour chaque avoir généré dans PrestaShop à la suite d’un remboursement total ou partiel, Pennylane récupère l’avoir, la commande d’origine et les montants remboursés.
Pennylane ne consulte ni votre catalogue, ni votre stock, ni vos paniers, ni la liste de vos clients ou de vos commandes. Elle ne récupère pas les données de connexion du client, ni ses préférences de communication.
Utilisation des données
Ces données permettent à Pennylane de :
Créer une facture de vente pour chaque commande payée, avec son client,
Créer un avoir pour chaque avoir généré dans PrestaShop, si la facture d’origine figure déjà dans Pennylane,
Marquer ces factures comme payées dans Pennylane.
Ne pas recréer une opération déjà importée.
ℹ️ Pennylane ne crée, ne modifie ni n'annule aucune donnée sur votre boutique PrestaShop.
