Passer au contenu principal

Connecter PrestaShop à Pennylane (via Pennylane Connect)

GESTION - Connectez PrestaShop à Pennylane avec Pennylane Connect pour automatiser la facturation de votre boutique.

Mis à jour aujourd’hui

L’intégration avec PrestaShop (1.6 au moins) via Pennylane Connect est disponible à partir de l’abonnement Pennylane Essentiel.

PrestaShop est une plateforme de commerce entièrement personnalisable.

Fonctionnalités de l’intégration

Conversion des commandes PrestaShop en factures Pennylane

Les commandes passées par vos clients sur votre boutique Prestashop sont automatiquement transformées en factures de vente dans Pennylane.

Création ou association des clients PrestaShop dans Pennylane

Si le client qui vient de passer commande sur votre boutique ne fait pas encore partie de vos clients sur Pennylane, ce dernier est automatiquement ajouté à votre liste Pennylane, en distinguant les entreprises des particuliers. Et s’il fait déjà partie de votre liste, nous lions la facture Pennylane à la fiche Pennylane du client.

Génération automatique des écritures comptables

Les commandes PrestaShop transformées en factures dans Pennylane génèrent automatiquement des écritures dans Pennylane.

Permissions

La liste des autorisations demandées par les applications vous permet de voir les données auxquelles chaque outil aura accès dans le cadre de l’intégration.

Permissions requises par Pennylane (dans PrestaShop)

L’intégration permet à Pennylane d’accéder à toutes les données PrestaShop.

  • addresses

  • carriers

  • categories

  • combinations

  • configurations

  • countries currencies

  • customers languages

  • order_details

  • order_slip

  • order_states

  • orders

  • product_option_values

  • product_options

  • products

  • shops

  • stock_availables

  • taxes

  • tax_rules

  • warehouses

  • deliveries

  • order_invoices

  • shops

  • suppliers

Données échangées entre PrestaShop et Pennylane

L’intégration permet à PrestaShop d’accéder aux données Pennylane suivantes avec les droits de modification.

  • Clients

  • Commandes

Installation

L’intégration entre PrestaShop et Pennylane se fait via Pennylane Connect.

Pré-requis

Pour connecter PrestaShop à Pennylane via Pennylane Connect, vous devez :

  1. Avoir un compte Pennylane et opter pour l’abonnement Essentiel (ou supérieur).

  2. Créer et copier votre clé d’API PrestaShop (voir comment faire).

Créer votre clé d’API PrestaShop

  1. Connectez-vous à votre boutique PrestaShop.

  2. Dans le menu latéral gauche, cliquez sur Paramètres (en bas).

  3. Faites défilez votre écran et cliquez sur l’encadré Paramètres avancés puis sur Webservice.

  4. Dans l’encadré Statut du webservice, vérifiez qu’un message indique bien que le webservice est activé. Puis copiez l’adresse web de votre point d’entrée principale — elle commence par https://. Collez cette adresse en lieu sûr.

  5. Cliquez sur +Ajouter une clé de webservice en haut à droite.

  6. Cliquez sur le bouton Générer lié au champ Clé. Votre clé apparaît. Vous pouvez la copier et la coller en lieu sûr. Ajoutez-y une éventuelle description pour l’identifier plus tard.

  7. Vérifiez que la ligne Activer la clé webservice indique bien Oui.

  8. Pour les Permissions, cochez au moins les cases suivantes dans la colonne Voir (GET) : addresses, carriers, categories, combinations, configurations, countries, currencies, customers, languages, deliveries, order_details, order_invoices, order_slip, order_states, orders, product_option_values, product_options, products, shops, shops, stock_availables, suppliers, tax_rules, taxes, warehouses. Cliquez sur Enregistrer pour valider et créer votre clé.

Configuration

Pour connecter Pennylane à PrestaShop :

  1. Si ce n’est pas déjà fait, cliquez sur Connecter dans l’encart correspondant à Pennylane, sélectionnez ensuite l’entreprise Pennylane à connecter à PrestaShop et cliquez sur Autoriser. Vous ne voyez pas cette étape ? C’est le signe que votre compte Pennylane est déjà connecté. Passez à la suite.

  2. Collez votre clé d’API et l’adresse du point d’entrée principal de votre webservice PrestaShop (voir comment les récupérer), puis cliquez sur Connecter.

  3. [FACULTATIF]. Si vous êtes comptable et que vous ajoutez cette intégration pour le compte d’un client ayant activé l’option multiboutique, vous pouvez rechercher et sélectionner la boutique que vous souhaitez connecter à votre compte Pennylane. Validez votre choix en cliquant sur Confirmer.

L’initialisation de votre intégration commence alors en arrière-plan.

À propos des paramètres (étape 3)

L’initialisation est considérée comme terminée quand la collecte de vos données (en arrière-plan) est achevée, ce qui peut prendre jusqu’à 48 heures. Pendant ce temps, vous pouvez compléter l’étape 3 (Configuration) pour définir les paramètres de l’intégration. Une fois vos paramètres définis, vous pouvez fermer l’onglet actif sans risque. Les réglages effectués à l’étape 3 sont enregistrés.

💡 Vous recevrez un e-mail à l’adresse liée à votre compte Pennylane une fois l’intégration activée.

Convertir les commandes PrestaShop en factures

Pour que les commandes que vous recevez dans PrestaShop soient transformées en factures Pennylane, cochez la case qui se trouve à la ligne Convertir les commandes en factures.

L’étape 3 de la configuration de l’intégration vous permet de définir comment les factures créées à partir de PrestaShop doivent être créées dans Pennylane. Vous pouvez jouer sur les paramètres suivants :

  • Début de conversion. Sélectionnez la date du jour pour convertir vos prochaines commandes en factures, ou sélectionnez une date passée pour transformer rétroactivement vos commandes passées en factures Pennylane. Par défaut, les factures de vente émises plus de 30 jours avant la mise en place de la connexion entre Pennylane et PrestaShop ne seront pas récupérées. Pour remonter plus loin dans le passé, demandez à notre équipe support de migrer votre historique de vente de PrestaShop vers Pennylane (opération payante). Si une commande est déjà payée, alors la date d’échéance de la facture correspondra à la date de commande. Si la commande n’a pas encore été payée, alors la date d’échéance correspondra à la date de commande + 30 jours.

  • Statut des factures générées. Définissez si les factures créées dans Pennylane à partir des commandes PrestaShop doivent être finalisées dès leur création dans Pennylane, ou simplement enregistrées à l’état de brouillon. Notez qu’une facture finalisée n’est plus modifiable dans Pennylane.

  • Date d’émission des factures. Indiquez si vous souhaitez que la date d’émission des factures créées dans Pennylane corresponde à la date de création de la facture dans Pennylane (date de conversion) ou à la date de la commande (date de traitement).

  • Facturer selon le statut de la commande. Sélectionnez le changement de statut PrestaShop qui déclenche la création d’une facture dans Pennylane. Vous pouvez créer vos factures au moment où la commande est créée (autorisation), payée (paiement acceptée ou équivalent) ou traitée (livrée).

  • Centraliser les clients professionnels (facultatif). Sélectionnez le client Pennylane auquel seront attribuées toutes les factures importées depuis PrestaShop et destinées à des entreprises. Les coordonnées du client ayant donné lieu à une facture seront ajoutées dans la description de la facture. De cette manière, même si vous associez toutes les factures au même client, vous garderez une trace du client initial.

  • Centraliser les clients particuliers (facultatif). Sélectionnez le client Pennylane auquel seront attribuées toutes les factures importées depuis PrestaShop et destinées à des particuliers. Les coordonnées du client ayant donné lieu à une facture seront ajoutées dans la description de la facture. De cette manière, même si vous associez toutes les factures au même client, vous garderez une trace du client initial.

Données prises en charge lors de la conversion

Voici la liste des données récupérées dans PrestaShop avec le détail de ce qu’elles deviennent une fois importées dans Pennylane.

  • Les numéros de commande PrestaShop sont indiqués sur la facture Pennylane.

  • Les livraisons (et leurs coûts) ainsi que les retraits (et leurs coûts) s’affichent dans les factures Pennylane, sous forme d’une ligne avec l’adresse postale de livraison ou de retrait.

  • Les notes apposées sur les commandes PrestaShop sont récupérées par Pennylane, où elles sont répercutés dans la partie Mentions légales des factures.

  • Le multi-boutiques est compatibles avec Pennylane. Si vous avez plusieurs boutiques PrestaShop, vous pouvez les connecter au même compte Pennylane.

  • L’association ou la création de clients PrestaShop dans Pennylane repose sur l’adresse e-mail.

Désactiver la facturation du côté de PrestaShop

Si vous configurez cette intégration pour que Pennylane génère des factures à partir de vos commandes PrestaShop, alors vous devez désactiver la fonctionnalité de facturation propre à PrestaShop — pour éviter de créer des doublons.

Pour couper la facturation dans PrestaShop :

  1. Connectez-vous à votre boutique.

  2. Dans le menu latéral gauche, accédez à Commandes > Factures.

  3. Dans la section Options des factures, accédez à la ligne Activer les factures et basculez le bouton sur Non (si ce n’est pas déjà fait).

  4. Faites défiler votre écran et cliquez sur Enregistrer en bas de page.

Conseils en cas de problème

Avez-vous trouvé la réponse à votre question ?