Le connecteur PrestaShop 1.6 de DoliPlus relie votre ancienne boutique PrestaShop à votre logiciel de gestion. Ainsi, vos produits, vos commandes et vos clients se synchronisent automatiquement, sans double saisie.

Ce chapitre détaille donc la configuration du webservice, étape par étape, pour les versions PrestaShop 1.5 et 1.6.

 

Ce chapitre concerne uniquement le connecteur pour les versions Prestashop 1.5.x à 1.6.x. Si vous utilisez une version plus récente, reportez-vous plutôt au connecteur Prestashop 1.7.

Connecteur PrestaShop 1.6 : à quoi il sert

Le connecteur PrestaShop 1.6 fait dialoguer DoliPlus et votre boutique en continu. Par exemple, une commande passée en ligne descend dans DoliPlus, puis le stock mis à jour dans DoliPlus remonte vers la boutique.

Pour une vue d’ensemble, reportez-vous d’abord au chapitre Connecteur PrestaShop DoliPlus pour sites de vente.

Installation du module sur Prestashop

Rappel : ce module fait l’objet d’une tarification spéciale. Contactez donc le service commercial.

Par ailleurs, cette configuration revient au client ou à son webmaster. En effet, nous n’intervenons pas sur votre Prestashop.

Installation sur DoliPlus

Activez d’abord le module webservice. Générez ensuite la clé dans le tableau supérieur, puis cliquez sur « Enregistrer ».

Dans le tableau inférieur, cliquez ensuite sur « nouveau ». Prenez le modèle proposé, puis remplacez les valeurs par les vôtres. Vous compléterez la clé du service Prestashop plus tard, comme l’explique le chapitre « Activer et configurer le web service de Prestashop » ci-dessous.

Installation sur Prestashop (PS)

1. Téléchargez le module fourni dans la configuration du module PRESTADOLI de DoliPlus.
2. Récupérez ensuite la clé webservice dans la configuration de DoliPlus.
3. Créez enfin un utilisateur avec les droits de création et de lecture sur les tiers, les commandes, les factures, les produits et les catégories.
4. Testez l’accès.

Récupérez ensuite la référence du stock dans DoliPlus, cochez toutes les lignes, puis validez.

Exportez aussi les produits déjà créés, le cas échéant.

Note : réalisez cet import uniquement à l’installation, afin de récupérer les données existantes. Ensuite, ne le relancez plus en production, car vous risqueriez de compromettre l’unicité des références déjà importées dans DoliPlus.

Activer et configurer le web service de Prestashop

Vous disposez d’une clé API et de l’adresse URL du site. Reportez ensuite ces deux éléments dans la configuration du module DoliPlus.

Avant de tester, vérifiez d’abord trois points côté Prestashop :

• Votre clé API est la bonne et ses autorisations sont correctement réglées.
• L’URL Rewrite est bien activée.
• Sous Nginx ou sur un mutualisé OVH, les règles de réécriture d’URL sont en place. Sous Apache, vous devrez parfois ajouter un fichier .htaccess dans le dossier /webservice de votre Prestashop.

Testez ensuite l’API, par exemple à l’adresse https://demo.doliplus.com/prestashop/api/. Saisissez la clé API en login et laissez le mot de passe vide.

Une page de ce type doit alors apparaître, avec la mention droits validés :

<products xlink:href="http://demo.doliplus.com/prestashop/api/products"
  get="true" put="true" post="true" delete="true" head="true">
  <description xlink:href="http://demo.doliplus.com/prestashop/api/products">The products</description>
  <schema xlink:href="http://demo.doliplus.com/prestashop/api/products?schema=blank" type="blank"/>
  <schema xlink:href="http://demo.doliplus.com/prestashop/api/products?schema=synopsis" type="synopsis"/>
</products>

Choix de la langue par défaut

Rendez-vous dans Configuration / Affichage. Validez ensuite la langue française, afin que vos documents se génèrent bien en français.

Produits et déclinaisons

Prestashop ne contrôle pas la présence d’une référence. C’est pourquoi vous devez d’abord saisir une référence sur le produit de base, avant déclinaison (par exemple « monproduit »).

En revanche, la référence sur la déclinaison reste facultative. En effet, DoliPlus décline lui-même les références à partir du préfixe du produit principal :

1. monproduit_d1
2. monproduit-d2

Si vous changez les références des produits déclinés sur Prestashop, DoliPlus crée alors de nouvelles références de son côté. Mettez donc les anciennes « hors vente » lorsqu’un historique de ventes existe, voire supprimez-les si elles ne servent plus.

Par ailleurs, les caractères interdits ( espace, ‘ , / , \ , : , * , ? ,  » , < , > , | , [ , ] , , , ; , = ) sont remplacés par « _ ». Ensuite, les références des produits déclinés sont mises à jour dans Prestashop.

À noter :

• À la création d’une déclinaison, un double enregistrement reste nécessaire pour assurer la synchronisation.
• Avec le générateur de déclinaisons de Prestashop, il suffit ensuite de confirmer par un enregistrement sur l’une d’elles.

Retour de produits. Si vous l’avez activé dans Prestashop, le retour de produit se gère depuis Prestashop. Faute de remboursement, émettez plutôt un bon de réduction, utilisable au prochain achat du client.

Gestion des photos de produits

Les photos remontent automatiquement vers DoliPlus. Surveillez toutefois leur poids, car il influe sur l’affichage et sur la qualité du transfert.

Mode de paiement

DoliPlus crée automatiquement les moyens de paiement.

Par ailleurs, si vous utilisez le module gratuit Paybox sur Prestashop, vous pouvez réutiliser le même abonnement pour d’autres besoins dans DoliPlus. Consultez à ce sujet « Paiement en ligne Paybox par cartes bancaires avec DoliPlus ».

Factures clients et avoirs

DoliPlus ne gère pas les factures et les avoirs sur Prestashop. Ainsi, vous conservez un chrono unique de numérotation pour tous vos canaux de vente.

Pour éviter la génération de factures sur Prestashop, suivez d’abord les instructions de l’image ci-dessous, puis supprimez aussi leur envoi par mail.

DoliPlus crée ensuite les factures automatiquement, avec leur règlement associé. Vous les envoyez donc au client final depuis DoliPlus.

Enfin, l’interface liste à la demande les dernières factures, ou toutes les factures issues d’une boutique précise.

Achats et fournisseurs

N’activez pas ces options sur Prestashop. En effet, le principe consiste à gérer les achats et les fournisseurs dans DoliPlus.

Prix de vente

Vous gérez les prix de vente uniquement dans la boutique.

De plus, en cas de multi-prix de vente, une option de configuration désigne la classe de prix à synchroniser.

Gestion des stocks

Choix de l’entrepôt

Définissez la référence de l’entrepôt (par exemple « stock A ») de façon identique des deux côtés : dans la configuration du module DoliPlus et dans la boutique Prestashop. Le connecteur assure ensuite une synchronisation bidirectionnelle.

Par ailleurs, le menu de gauche propose une liste dédiée aux produits synchronisés avec Prestashop, selon l’entrepôt défini en configuration (voir l’inventaire ci-dessous).

Inventaire

Après un inventaire réalisé dans DoliPlus, vous pouvez forcer une mise à jour globale du stock vers Prestashop, pour les produits en statut « vente ».

Pour aller plus loin, reportez-vous au chapitre Gestion de stock. En configuration multi-boutique, sélectionnez d’abord la boutique concernée.

Un onglet « Presta » compare ensuite les stocks de la boutique et de DoliPlus. Un export CSV reste également disponible.

Note : désactivez la gestion avancée des stocks sur Prestashop.

Multi-boutiques

Déclarez d’abord vos boutiques dans la configuration DOLIPRESTA de DoliPlus. Le trigramme vous permet ensuite de différencier vos sites.

Dès lors, une liste déroulante apparaît dans l’interface de gestion pour basculer d’une boutique à l’autre.

Multi-société

Cette gestion n’est pas encore disponible pour le moment, mais elle est prévue.

Mise à jour du connecteur PrestaShop 1.6

Le module est fourni pour une compatibilité avec PrestaShop. Avant toute évolution de version PrestaShop, vérifiez donc dans la documentation que votre version reste compatible.

Pour mettre à jour le module : téléchargez-le comme à la première installation. Il est par ailleurs inutile de le désactiver.

En rapport Mémos

• Déclinaisons de produits Dolibarr & DoliPlus
• Module de transport Chronopost – Dolibarr & DoliPlus
• Connecteur Prestashop 1.7 pour DoliPlus
• PrestaShop version de démo en ligne
• Connecteur PrestaShop Dolibarr pour sites de vente