Mettre en place PrestaDoliSync

• Configuration des WebServices
• Configuration des mises à jour de masse des prix et des stocks
• Configuration de l'importation automatique des commandes dans Dolibarr
• Page de configurations
• Créez votre première boutique PrestaShop dans Dolibarr
• Comment importer des commandes PrestaShop dans Dolibarr ?
• Configuration des factures avec PrestaDoliSync
• Incompatibilités connues

Configuration des WebServices

L'activation des WebServices PrestaShop est nécessaire pour que Dolibarr puisse communiquer avec votre boutique en ligne. Elle assure la synchronisation des données, telles que les commandes et les clients, en évitant les mises à jour manuelles. Avec des clés API sécurisées, il garantit un échange fiable et efficace, optimisant la gestion de l'entreprise.

1. Activation du Webservice PrestaShop

1. Connectez-vous au panneau d'administration de PrestaShop.
2. Accédez à Paramètres avancés > Webservice.
3. Activez l'option Activer le Webservice.
4. Cliquez sur Enregistrer.

Note importante sur l'activation des webServices de PrestaShop

Attention l'activation des webServices ne fonctionnent pas toujours lors de l'activation de ces derniers. Il est possible qu'il soit nécessaire d'ajouter la lignes suivantes à votre fichier .htaccess de votre site PrestaShop juste apres RewriteEngine on.

RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule . - [E=HTTP_AUTHORIZATION:%1]

Ou Le serveur Web peut nécessiter l'activation de la directive CGIPassAuth pour permettre à PrestaShop de recevoir l'en-tête HTTP_AUTHORIZATION.

CGIPassAuth On

ou

SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

Attention au mode maintenance !

Si vous n'arrivez pas à vous connecter depuis Dolibarr il est possible que le mode maintenance du site vous en empêche, pensez à ajouter toutes les ip du serveur de votre Dolbarr.

2. Créer une clé API Mode automatique

1. Dans le panneau de configuration du module coté PrestaShop
2. Cliquez sur Créer une nouvelle clé !

2. bis Créer une clé API Manuellement

1. Dans Paramètres avancés > Webservice, cliquez sur Ajouter une nouvelle clé Webservice.
2. Cliquez sur Générer ! pour créer une clé unique.
3. Ajoutez une description (par exemple, "Connexion Dolibarr").
4. Définissez l'option Statut sur "Oui".

3. Configure Permissions

1. Cochez les cases GET et/ou PUT pour les ressources correspondantes.
2. Cliquez sur Enregistrer.

Assurez-vous que la clé dispose des autorisations suivantes :

GET & Head pour:

shops,languages,order_histories, attachments, addresses, carriers, combinations, countries, customers, orders, order_carriers, order_details, products, product_options, product_option_values, product_suppliers, suppliers, taxes, tax_rules, tax_rule_groups, customizations, product_customization_fields, order_payments

PUT pour:

combinations, order_histories, products

Configuration des mises à jour de masse des prix et des stocks

Le module peut utiliser deux méthodes différentes pour récupérer le fichier CSV contenant les informations sur le prix et le stock des produits. La première méthode (recommandée) consiste à utiliser l'option « Télécharger le fichier à partir de l'URL », qui ne nécessite que le lien URL vers le fichier disponible dans Dolibarr (le lien contient un jeton de sécurité). La seconde méthode est la méthode FTP, qui nécessite la configuration d'une connexion FTP vers le dossier documents de Dolibarr pour la récupération des fichiers.

Configuration de la méthode « Télécharger un fichier à partir d'une URL

Pour activer la mise à jour en masse des prix et stocks dans PrestaShop, suivez ces étapes :

1. Activez la tâche planifiée pour l'exportation des prix et stocks dans Dolibarr (Exportation des prix et stocks des produits) (voir image Dolibarr point 1).
   
   Cette tâche génère un fichier stocké dans le répertoire des documents de Dolibarr :
   /prestasync/export-stock.csv
   
   
2. Copiez dans la page de configuration de Dolibarr le lien permettant de télécharger le fichier CSV des prix et stocks (voir image Dolibarr point 2).
   
   
3. Retournez à la configuration de PrestaDoliSync dans PrestaShop et sélectionnez "Télécharger le fichier depuis l'URL" dans le champ mode d'importation du fichier des prix (voir image PrestaShop point 1).
   
   
4. Collez votre lien dans le champ "URL du fichier d'importation des prix" (voir image PrestaShop point 2).
   
   
5. Enregistrez

Configuration de la méthode FTP

Pour activer la mise à jour en masse des prix et stocks dans PrestaShop, suivez ces étapes :

1. Activez la tâche planifiée pour l'exportation des prix et stocks dans Dolibarr (Exportation des prix et stocks des produits).
   
   Cette tâche génère un fichier stocké dans le répertoire des documents de Dolibarr :
   /prestasync/export-stock.csv
   
   
2. Configurez l'accès FTP au dossier des documents de votre installation Dolibarr.
   
   
3. Retournez à PrestaShop et sélectionnez "Obtenir le fichier depuis FTP" dans le champ mode d'importation du fichier des prix (voir image PrestaShop point 1).
   
   
4. Entrez les identifiants d'accès FTP dans la configuration du module sur PrestaShop (voir point 2 dans l'image).
   Astuce : Bien que Dolibarr génère le fichier sous le nom export-stock.csv, vous pouvez utiliser un fichier différent. Cela vous permet de créer un fichier personnalisé avec vos propres modifications de stock ou de prix.
   
   
5. Activez la mise à jour en masse des prix. (Voir point 1 dans l'image).
   
   
6. Ajoutez une tâche planifiée pour appeler l'URL fournie sous le bouton d'activation de la mise à jour en masse des prix. (Voir point 2 dans l'image).
   
   
7. Enregistrez

Note: your dolibarrimport price url need to be accessible by your PrestaShop apache server.

Effectuer des mises à jour massives des prix et des stocks

Une fois le module configuré, il suffit de lancer l'URL de mise à jour disponible sur la page de configuration du module PrestaDoliSync dans PrestaShop (voir point 3 dans l'image).

Pour automatiser les mises à jour régulières, il est recommandé d'utiliser une tâche planifiée (cron) afin d'effectuer des appels périodiques à cette URL. Il est conseillé de mettre à jour ces informations au moins une fois par jour, et il est déconseillé d'effectuer des mises à jour trop fréquentes, une fréquence d'une fois par heure étant déjà considérée comme élevée.

Note : Les erreurs sont enregistrées dans la section des journaux de Dolibarr.

Astuce : Vous pouvez appeler l'URL avec le paramètre &displaylog=1 pour afficher toutes les informations lors de l'appel de l'URL. De plus, vous pouvez filtrer les journaux pour une référence produit spécifique en utilisant &ref=YOURREFERENCE.

Configuration de l'importation automatique des commandes dans Dolibarr avec les WebHooks

Les webhooks de PrestaShop permettent d'envoyer des mises à jour de statut à Dolibarr, ce qui lui permet de récupérer automatiquement les commandes en fonction des changements de statut, à condition que la configuration le permette. Cette intégration rationalise le processus en déclenchant une synchronisation automatique des données chaque fois qu'un statut de commande est mis à jour, réduisant ainsi le besoin d'intervention manuelle et améliorant l'efficacité.

Configuration du WebHook

1. Pour configurer le webhook saisir simplement l'url fournie par le module PrestaDoliSync coté de Dolibarr. (Voir points 1 et 2 sur l'image)

2. Ajouter une tâche planifiée (cron) qui appel l'URL (Point 3) toutes les minutes (ou au minimum toutes les 5 mins).

À noter : les webhooks permettent de stocker et d’envoyer des événements entre PrestaShop et Dolibarr. Ces événements sont conservés pour envoi pendant 10 minutes ; passé ce délai, ils sont ignorés ou supprimés. Il est donc important de déclencher l’appel à l’URL durant ce laps de temps, d’où l’intérêt de la tâche planifiée (cron).

Page de configurations

Configurer les paramètres dans la page de configuration de Dolibarr

La dernière étape d'une installation réussie du module dans Dolibarr consiste à configurer les paramètres de base dans la page de configuration. Ces paramètres vous permettent d'adapter le système aux besoins de votre entreprise. Dans cette section, vous définirez des paramètres tels que le type de contact client pour la facturation et l'expédition, les produits/services utilisés pour gérer les remises et l'emballage, et les paramètres de synchronisation avec PrestaShop.

Il est important de compléter cette étape avec soin, car ces paramètres affecteront directement la façon dont les commandes, les factures et les livraisons seront gérées dans Dolibarr. Ces paramètres doivent être configurés en fonction des workflow de votre entreprise et de la façon dont vous travaillez au quotidien. Une fois les configurations de base définies, vous pouvez poursuivre la personnalisation du système et l'intégration avec d'autres outils si nécessaire.

N'oubliez pas que cette page de configuration vous permet également de définir des options importantes pour la gestion des stocks, des prix d'achat et de vente, ainsi que pour la sécurité et l'automatisation des actions dans le système.

Créez votre première boutique PrestaShop dans Dolibarr

Comment importer des commandes PrestaShop dans Dolibarr ?

Si vous n'avez pas configuré la synchronisation automatique des commandes via Webhooks, vous pouvez importer manuellement les commandes de PrestaShop vers Dolibarr de deux manières :

1. Importation en masse

• Accédez à la liste des commandes dans le module PrestaDoliSync.
• Sélectionnez les commandes que vous souhaitez importer.
• Cliquez sur l'option pour importer les commandes sélectionnées.

2. Importation individuelle

• Ouvrez la fiche d'une commande spécifique.
• Utilisez l'option d'importation pour récupérer les informations depuis PrestaShop.

L'importation manuelle vous permet de contrôler quelles commandes sont intégrées dans Dolibarr, en particulier si vous souhaitez filtrer ou vérifier certaines commandes avant la synchronisation.

Configuration des factures avec PrestaDoliSync

Si vous souhaitez que toutes les factures soient générées par Dolibarr (et non par PrestaShop), il faut déléguer la gestion des factures à Dolibarr.

Cela permet d’avoir des factures identiques et centralisées entre vos deux systèmes.

Étape 1 : Désactiver la génération des factures dans PrestaShop

1. Désactiver les factures dans les paramètres générauxAllez dans Commandes > Factures.Dans la section Options des factures, mettez Activer les factures → NON.
   
   
2. Désactiver la génération automatique par statutAllez dans Paramètres de commandes > États de commandes.Assurez-vous que l’option Générer une facture est désactivée pour tous les statuts de commande.

De cette façon, PrestaShop n’émettra plus de factures, et celles de Dolibarr seront les seules valides.

Étape 2 : Récupérer la clé API Dolibarr

1. Connectez-vous à Dolibarr en administrateur.
2. Allez dans Accueil > Configuration > Modules/Applications > Web services.
3. Activez le module API REST (si ce n’est pas déjà fait).
4. Pour créer un utilisateur dédié : allez dans Utilisateurs & Groupes > Utilisateurs, créez un nouvel utilisateur, attribuez-lui les droits minimaux requis pour accéder aux factures (accès aux factures / tiers...) et enregistrez.
5. Pour récupérer la clé API d’un utilisateur (nouveau ou existant) : ouvrez la fiche utilisateur et copiez la clé API associée à ce compte.
6. Dans le module PrestaDoliSync (côté PrestaShop), ouvrez la section : Configuration de l’API Dolibarr : utilisé pour afficher les factures Dolibarr sur le compte client.
7. Renseignez les informations suivantes :URL Dolibarr (exemple : https://votresite.com/dolibarr/)Clé API DolibarrRéférence du shop dans Dolibarr (référence de votre boutique dans Dolibarr)

Incompatibilités connues

Le module Dolibarr Presta Sync s'appuie sur les WebServices natifs de PrestaShop pour assurer la synchronisation des données entre votre boutique en ligne et Dolibarr. Cependant, certaines versions de PrestaShop présentent des bugs ou des limitations dans leur implémentation des WebServices, susceptibles de perturber le bon fonctionnement du module.

Ces incompatibilités peuvent entraîner des erreurs lors de l'import ou de l'export de données (produits, clients, commandes, etc.), ou bloquer complètement la synchronisation. Il est donc essentiel de s'assurer que votre instance PrestaShop est à jour et que les correctifs nécessaires sont appliqués.

À noter : THERSANE contribue activement au projet PrestaShop en identifiant les anomalies liées aux WebServices utilisés par le module PrestDoliSync et en proposant des correctifs directement dans le code source via la plateforme collaborative GitHub. Ces contributions visent à améliorer la stabilité et la compatibilité du cœur de PrestaShop avec les solutions de gestion comme Dolibarr.

Vous trouverez ci-dessous une liste de correctifs recommandés à appliquer manuellement sur certaines versions de PrestaShop afin de garantir une compatibilité optimale avec le module.

WebService : Correctifs pour images de type "customizations"

Voir correction #38417 sur le repos GitHub de PrestaShop

La foire aux question (F.A.Q)

Lors de la mise à jour des stocks, certains produits restent à zéro dans le fichier CSV d'export, alors qu'il y a du stock dans Dolibarr.

Vérifiez que les produits en question ne sont pas désactivés à la vente côté Dolibarr.

En effet, lorsqu'on utilise la gestion des stocks sur PrestaShop, le moyen le plus simple de désactiver un produit à la vente est de définir son stock à zéro. Cela est d'autant plus vrai pour les déclinaisons, qui ne peuvent pas être désactivées individuellement dans PrestaShop

J'ai une erreur : PrestaShop webService error : XBF: This call to PrestaShop Web Services failed and returned an HTTP status of 401. That means: Unauthorized

Cette erreur indique que la clé API utilisée pour accéder au Webservice de PrestaShop ne dispose pas des droits nécessaires pour effectuer certaines opérations (comme la lecture ou l’écriture sur certaines ressources : Clients, Paniers, Commandes, Produits, etc.).

1. Accédez au back-office PrestaShop

• Allez dans Paramètres avancés > Webservice.

2. Vérifiez les permissions de la clé API utilisée

• Recherchez la clé concernée.
• Cliquez sur modifier (icône crayon).
• Assurez-vous que les autorisations nécessaires sont activées pour les ressources concernées

Astuce : durant la phase de test, vous pouvez attribuer temporairement tous les droits à la clé API afin de confirmer qu’il s’agit bien d’un problème de permissions. Pensez ensuite à restreindre les accès selon les besoins réels, pour des raisons de sécurité."

3. Sauvegardez les modifications.

4. Videz le cache de PrestaSync et de PrestaShop si nécessaire.