PrestaShop et Dolibarr

Connecter PrestaShop à Dolibarr : flux, méthode et points de vigilance

Relier une boutique PrestaShop à Dolibarr évite de ressaisir commandes, clients et stocks dans deux outils. Ce guide détaille les flux à synchroniser, les architectures possibles, les pièges de correspondance des données et la méthode pour mettre en place une connexion fiable.

Une connexion Dolibarr se décide d’abord sur papier.

Avant de choisir un module ou d’écrire du code, fixez qui crée les produits, qui tient le stock et qui émet les factures. Le reste en découle.

En bref

Connecter PrestaShop à Dolibarr consiste à faire circuler automatiquement les données entre la boutique et l’ERP/CRM open source : produits, prix et stocks par entrepôt partent en général de Dolibarr vers PrestaShop, tandis que les commandes et les clients remontent de PrestaShop vers Dolibarr, sous forme de tiers et de commandes clients. La connexion s’appuie sur le module API REST de Dolibarr, à activer avec une clé d’API par utilisateur, et sur le webservice et les hooks de PrestaShop. Elle passe par un module existant à évaluer, un développement sur mesure ou un middleware. Le point décisif est de fixer une source de vérité par donnée, et surtout un seul outil émetteur des factures.

Contexte

Pourquoi relier PrestaShop à Dolibarr ?

On relie PrestaShop à Dolibarr pour que la boutique et la gestion partagent les mêmes produits, stocks, clients et commandes sans double saisie. PrestaShop reste la vitrine et le tunnel de commande ; Dolibarr devient l’outil de gestion commerciale, de stock et de facturation.

Dolibarr est un ERP/CRM open source écrit en PHP. Il est modulaire : on active seulement les modules utiles, comme Produits et services, Stocks et entrepôts, Tiers (clients et fournisseurs), Commandes, Factures ou Expéditions. Il s’installe sur votre serveur ou chez un hébergeur. Sa modularité en fait un choix fréquent pour des petites et moyennes entreprises, mais chaque installation est différente : les modules actifs et leur paramétrage changent ce que la connexion doit gérer.

Ce guide se concentre sur ce qui est propre à Dolibarr. Les principes généraux, comme les modes d’intégration ou la gestion des files d’attente, sont détaillés dans notre guide connecter PrestaShop à un ERP. Pour situer Dolibarr parmi les autres logiciels d’un e-commerce connecté, lisez ERP, PIM, CRM : quel rôle dans un e-commerce connecté ?

Les flux

Quels flux synchroniser entre PrestaShop et Dolibarr ?

Huit flux reviennent dans presque tous les projets. Le sens indiqué est le plus courant, pas une obligation : l’essentiel est qu’une seule application fasse foi pour chaque donnée.

FluxSensSource de vérité habituellePoint de vigilance
Produits et variantesDolibarr vers PrestaShopDolibarr pour la référence, le libellé et les données de gestion ; PrestaShop pour les textes marketing et les imagesUne variante Dolibarr est un produit enfant, une déclinaison PrestaShop ne l’est pas : la correspondance doit être explicite
Prix et niveaux de prixDolibarr vers PrestaShopDolibarr, surtout si les niveaux de prix ou les prix par client sont activésPrix HT ou TTC, groupes de clients PrestaShop face aux niveaux de prix Dolibarr
Stocks par entrepôtDolibarr vers PrestaShopDolibarr, entrepôt par entrepôtChoisir quels entrepôts alimentent le stock vendable du site et quand Dolibarr décrémente
Tiers et adressesPrestaShop vers DolibarrPrestaShop pour les particuliers ; Dolibarr pour les comptes professionnelsDoublons de tiers, clients invités, adresses de livraison multiples
CommandesPrestaShop vers DolibarrPrestaShop jusqu’à la création dans Dolibarr, Dolibarr ensuiteNe jamais créer deux fois la même commande : clé unique obligatoire
Factures et avoirsSelon la règle choisieUn seul outil, PrestaShop ou DolibarrNumérotation unique et continue ; avoirs liés à la bonne facture
Expéditions et suiviDolibarr vers PrestaShopDolibarr si l’équipe y prépare les envoisStatut de commande et numéro de suivi à renvoyer au client
PaiementsPrestaShop vers DolibarrLe prestataire de paiement, via PrestaShopRapprocher le paiement de la bonne facture et du bon compte bancaire

Schéma de départ à adapter : certaines entreprises créent leurs fiches produits dans PrestaShop, d’autres gèrent tout dans Dolibarr. Les fonctions disponibles dépendent des modules Dolibarr activés.

Architecture

Quelle architecture choisir pour la connexion ?

Il n’existe pas une seule bonne architecture : le choix dépend de vos règles de gestion, de vos volumes et de qui maintiendra la connexion. Ces options se combinent souvent.

Module existant

La place de marché DoliStore et celle de PrestaShop proposent des modules tiers de synchronisation. Évaluez-les sur vos cas réels : déclinaisons, niveaux de prix, entrepôts, avoirs. Un module existant peut aussi servir de base à adapter.

Sur mesure côté PrestaShop

Un module PrestaShop appelle l’API REST de Dolibarr pour lire le catalogue et les stocks et pour créer tiers et commandes. Les traitements restent visibles dans le back-office de la boutique.

Module côté Dolibarr

Un module Dolibarr interroge le webservice de PrestaShop. Utile quand l’équipe pilote tout depuis Dolibarr.

Échanges planifiés

Une tâche planifiée synchronise par lots le catalogue, les prix et les stocks. Simple à superviser, mais en différé.

Temps réel par hooks

Les hooks de PrestaShop déclenchent un envoi dès qu’une commande est validée ou change de statut. À réserver aux flux sensibles, avec une file d’attente si Dolibarr ne répond pas.

Middleware

Une plateforme intermédiaire transforme et route les données. Pertinente quand d’autres outils entrent dans la boucle : marketplaces, logiciel d’entrepôt, CRM, outil comptable.

Agillia ne vend pas de connecteur Dolibarr prêt à l’emploi. Nous développons la connexion à la demande, ou nous adaptons un module existant choisi avec vous, dans le cadre d’un besoin spécifique PrestaShop. Si votre ERP est un autre logiciel, voyez aussi nos guides connecter PrestaShop à Odoo et connecter PrestaShop à Business Central.

Mapping

Les pièges de correspondance entre PrestaShop et Dolibarr

La plupart des écarts viennent de données qui ne se modélisent pas de la même façon dans les deux outils. Chaque point ci-dessous doit faire l’objet d’une règle écrite avant le développement.

Sécurité

Hébergement et sécurité de l’API Dolibarr

L’API REST de Dolibarr donne accès à vos clients, à vos prix et à vos factures : elle se protège comme un back-office. Ces règles valent que Dolibarr soit sur votre serveur ou chez un hébergeur.

HTTPS obligatoire

Tous les échanges entre PrestaShop et Dolibarr passent en HTTPS, avec un certificat valide. Une clé d’API transmise en clair peut être interceptée.

Clé d’API dédiée

Créez un utilisateur Dolibarr réservé à la connexion et générez sa clé d’API. Ne réutilisez jamais le compte d’un collaborateur : son départ couperait les échanges.

Droits minimaux

Cet utilisateur ne reçoit que les droits nécessaires aux flux prévus : lire les produits et les stocks, créer tiers et commandes. Pas d’accès à l’administration.

Journalisation

Chaque appel est tracé côté connecteur : date, objet, réponse.

Exposition limitée

Si possible, restreignez l’accès à l’API aux adresses IP de la boutique et maintenez Dolibarr à jour, comme le cœur et les modules de PrestaShop.

Renouvellement des clés

Changez la clé d’API en cas de départ d’un prestataire ou de doute, et stockez-la hors du code source, dans la configuration du serveur.

Méthode

La méthode pour connecter PrestaShop à Dolibarr

01

1. Auditer les deux outils

Listez les modules Dolibarr actifs et leur paramétrage : variantes, niveaux de prix, entrepôts, règle de décrémentation du stock. Côté PrestaShop, repérez les modules qui touchent au stock, aux prix ou aux factures. Un audit de la boutique peut précéder le projet.

02

2. Écrire les règles et le mapping

Fixez pour chaque flux le sens, la fréquence et la source de vérité, puis faites correspondre les champs : références, taux de TVA, statuts, transporteurs, moyens de paiement. Décidez quel outil émet les factures.

03

3. Développer et recetter

Branchez une copie de la boutique sur un Dolibarr de test. Rejouez les cas réels : commande avec règle panier, client invité, déclinaison sans stock, annulation, remboursement partiel, avoir.

04

4. Reprendre, basculer et suivre

Alignez d’abord les références des deux côtés, puis lancez la reprise initiale. Basculez hors période de forte activité, gardez un plan de retour et suivez les journaux de près les premières semaines.

Supervision

Superviser la connexion et traiter les erreurs

Une connexion PrestaShop – Dolibarr fiable n’est pas celle qui n’échoue jamais, c’est celle qui signale ses échecs et sait les rejouer. Prévoyez ces mécanismes dès le développement.

Une fois en service, la connexion fait partie de la boutique : elle se maintient avec elle. Elle peut entrer dans une maintenance PrestaShop ou dans une TMA PrestaShop, qui couvre aussi ses évolutions.

Agillia

Pourquoi confier votre connexion Dolibarr à Agillia ?

Agillia est une agence et un éditeur de modules PrestaShop : nous développons des modules et des connecteurs sur mesure, en PHP, le langage de Dolibarr, et avec le framework Symfony. Notre équipe réunit des experts seniors qui maintiennent des sites e-commerce depuis plus de 16 ans, avec plus de 20 ans d’expérience du web.

Nous éditons notamment Pennylane Connect, qui envoie les factures PrestaShop vers le logiciel comptable Pennylane. Ce n’est pas un ERP, mais ce module repose sur les mêmes exigences qu’une connexion Dolibarr : correspondance des taxes, numérotation des factures, reprise des échanges en échec.

Pour Dolibarr, nous travaillons par étapes courtes selon notre méthode agile de développement sur mesure : cadrage des flux, développement, recette avec vos équipes, mise en production. Le projet prend la forme d’un besoin spécifique PrestaShop, chiffré après analyse de votre installation.

Pour aller plus loin

Pour aller plus loin

Questions fréquentes

Vos questions sur la connexion entre PrestaShop et Dolibarr

Comment connecter PrestaShop à Dolibarr ?

Vous reliez le webservice PrestaShop à l’API REST de Dolibarr par un module existant, un développement sur mesure ou un middleware. Activez d’abord le module API REST et créez un utilisateur dédié avec sa clé d’API. Avant toute technique, écrivez la source de vérité, le sens et la fréquence de chaque flux. Testez ensuite sur une copie de la boutique et un Dolibarr de recette.

Le plus souvent : produits et variantes, prix, stocks par entrepôt, tiers, commandes, factures et avoirs, expéditions et paiements. Produits, prix et stocks partent en général de Dolibarr, commandes et clients remontent de PrestaShop.

Un seul des deux, jamais les deux. Si Dolibarr gère la facturation, PrestaShop transmet la commande et Dolibarr émet et numérote la facture. Si PrestaShop émet la facture, Dolibarr la reçoit telle quelle, avec son numéro, sans en recréer une.

Des modules tiers existent sur DoliStore et sur la place de marché PrestaShop, mais leur couverture varie. Vérifiez-les sur vos cas réels : déclinaisons, niveaux de prix, entrepôts, avoirs, clients invités. Agillia n’en vend pas : nous développons la connexion à la demande ou adaptons un module choisi avec vous.

Décidez quels entrepôts Dolibarr alimentent le stock vendable du site, puis envoyez à PrestaShop leur somme ou le stock d’un entrepôt dédié au web. Vérifiez aussi le moment où Dolibarr décrémente son stock, selon le paramétrage du module Stocks. Une resynchronisation régulière corrige les écarts accumulés.

Oui, à condition de les faire correspondre explicitement, car les deux outils ne les modélisent pas de la même façon. Dolibarr crée un produit enfant par variante, PrestaShop rattache ses déclinaisons au produit parent. Une référence unique par déclinaison sert de clé entre les deux.

Non, Dolibarr peut être sur un autre serveur ou chez un hébergeur, puisque les échanges passent par API. Ce qui compte est un accès en HTTPS, une clé d’API dédiée aux droits minimaux et un accès restreint à la boutique si possible.

Une connexion bien conçue met la commande en file d’attente et la transmet dès que Dolibarr répond de nouveau. La boutique continue de vendre sur le dernier stock connu. Sans file de reprise, la commande risque de manquer dans Dolibarr jusqu’à une ressaisie manuelle.

Un projet de connexion entre PrestaShop et Dolibarr ?

Décrivez-nous votre installation Dolibarr, ses modules actifs et les flux que vous voulez automatiser : nous vous proposons une approche adaptée, connecteur sur mesure ou module existant à adapter.