PrestaShop et Odoo
Connecter PrestaShop à Odoo : flux, méthode et points de vigilance
Relier PrestaShop à Odoo évite de ressaisir commandes, stocks et clients entre la boutique et la gestion. Ce guide détaille les flux à synchroniser, les options d’architecture, les pièges de mapping propres à Odoo et la méthode pour fiabiliser les échanges.
Odoo est modulaire. Votre connecteur aussi.
Chaque entreprise active ses propres applications Odoo et ses propres règles. Le connecteur doit suivre cette configuration, pas l’inverse.
En bref
Connecter PrestaShop à Odoo consiste à synchroniser automatiquement les données entre la boutique et les applications Odoo (Ventes, Inventaire, Comptabilité, CRM, Achats). Le plus souvent, produits, listes de prix et stocks partent d’Odoo vers PrestaShop, tandis que clients et commandes remontent de PrestaShop vers Odoo, puis livraisons et factures redescendent. Techniquement, l’échange s’appuie sur l’API externe d’Odoo (XML-RPC ou JSON-RPC) et sur le webservice et les hooks de PrestaShop, via un connecteur existant, un module sur mesure ou un middleware. La réussite dépend d’une source de vérité par donnée, d’un mapping précis des taxes, variantes et statuts, et d’une supervision avec reprise des erreurs.
Contexte
Pourquoi relier PrestaShop et Odoo, et sur quelles bases techniques ?
Relier PrestaShop et Odoo sert à faire travailler la vitrine et la gestion sur les mêmes données, sans ressaisie. Odoo est une suite de gestion open source organisée en applications que l’on active selon ses besoins : Ventes, Inventaire, Comptabilité, CRM, Achats, entre autres. Il existe une édition Community et une édition Enterprise, hébergées sur Odoo Online, sur Odoo.sh ou sur vos propres serveurs.
Côté Odoo, une API externe en XML-RPC ou JSON-RPC permet de lire et d’écrire les modèles de données : modèles de produits et variantes (product.template et product.product), contacts (res.partner), bons de commande (sale.order), factures, entrepôts et emplacements de stock, listes de prix. Odoo gère aussi plusieurs sociétés dans une même base.
Côté PrestaShop, le webservice expose produits, déclinaisons, stocks, clients et commandes, et les hooks déclenchent un traitement lors d’un événement, comme la validation d’une commande. Un connecteur combine les deux : il écoute les événements de la boutique et interroge ou alimente Odoo.
Pour la démarche générale, valable quel que soit l’ERP, consultez notre guide connecter PrestaShop à un ERP. Cette page se concentre sur ce qui change avec Odoo.
Les flux
Quels flux synchroniser entre PrestaShop et Odoo ?
Huit flux reviennent dans presque tous les projets. Pour chacun, fixez un sens et une source de vérité unique ; le tableau donne le schéma habituel et le point qui pose le plus souvent problème avec Odoo.
| Flux | Sens | Source de vérité habituelle | Point de vigilance |
|---|---|---|---|
| Produits et variantes | Odoo vers PrestaShop | Odoo pour les données de gestion ; PrestaShop ou un PIM pour les textes et images | Faire correspondre les attributs et valeurs d’Odoo aux déclinaisons PrestaShop, avec une référence par variante |
| Prix et listes de prix | Odoo vers PrestaShop | Odoo, surtout en B2B | Traduire les règles des listes de prix en prix spécifiques ou groupes de clients PrestaShop |
| Stocks par entrepôt | Odoo vers PrestaShop | Odoo (application Inventaire) | Choisir les entrepôts et emplacements qui alimentent le stock vendable, et la quantité retenue : disponible ou prévisionnelle |
| Clients et adresses | PrestaShop vers Odoo, parfois dans les deux sens | PrestaShop pour les particuliers ; Odoo pour les comptes professionnels | Éviter les doublons de contacts et rattacher les adresses de livraison et de facturation au bon contact parent |
| Commandes | PrestaShop vers Odoo | PrestaShop jusqu’à l’envoi, Odoo ensuite | Créer un bon de commande avec les bonnes lignes, taxes, remises et frais de port, une seule fois |
| Factures et avoirs | Odoo vers PrestaShop, ou l’inverse | Un seul outil numérote : en général Odoo | Ne jamais laisser les deux outils émettre une facture pour la même commande |
| Livraisons et suivi | Odoo vers PrestaShop | Odoo (bons de livraison) | Remonter le numéro de suivi et passer la commande PrestaShop au bon statut |
| Paiements | PrestaShop vers Odoo | Le prestataire de paiement, relayé par PrestaShop | Associer le paiement à la facture et au journal comptable attendu, remboursements compris |
Schéma le plus répandu, à adapter : certaines entreprises créent leurs produits dans PrestaShop ou gèrent leurs clients dans le CRM d’Odoo. L’important est d’écrire la règle avant de développer.
Architecture
Quelle architecture choisir pour un connecteur PrestaShop Odoo ?
Il n’y a pas d’architecture unique : le choix dépend de vos règles, de votre hébergement Odoo et de qui maintiendra le connecteur. Ces options se combinent souvent.
Connecteur existant à configurer
Des connecteurs existent, notamment sur la boutique d’applications d’Odoo. Avantage : un démarrage plus rapide si vos règles restent standard. Limite : vérifier sur une base de test les variantes, les listes de prix, les taxes et le multiboutique avant de s’engager.
Module sur mesure côté PrestaShop
Un module PrestaShop écoute les hooks et appelle l’API externe d’Odoo. Avantage : il fonctionne quel que soit l’hébergement Odoo. Limite : la logique de traitement et la file d’attente doivent tenir dans la boutique.
Module côté Odoo
Un module Odoo interroge le webservice PrestaShop et crée les commandes dans Odoo. Avantage : la logique de gestion reste au même endroit. Limite : votre hébergement Odoo doit autoriser l’installation de modules personnalisés.
Middleware
Une application intermédiaire, par exemple écrite en Symfony, lit et écrit des deux côtés et transforme les données. Avantage : découplage et place pour d’autres systèmes. Limite : un composant de plus à héberger et à superviser.
Planifié ou temps réel
Les tâches planifiées conviennent au catalogue et aux prix ; l’envoi sur événement convient aux commandes et aux stocks sensibles. La plupart des projets mélangent les deux, flux par flux.
File de messages
Chaque échange devient un message stocké, traité puis acquitté. Avantage : rien ne se perd si Odoo ou la boutique est indisponible, et les pics de commandes sont absorbés. Limite : plus de conception au départ.
Agillia ne vend pas de connecteur Odoo prêt à l’emploi. Nous développons un connecteur à la demande ou adaptons une solution existante choisie avec vous, dans le cadre d’un besoin spécifique PrestaShop.
Mapping
Les pièges de mapping entre PrestaShop et Odoo
La plupart des écarts entre la boutique et Odoo viennent du mapping, pas de l’API. Ces dix points sont à trancher champ par champ avant le développement.
- Taxes et positions fiscales : les règles de taxe de PrestaShop et les taxes d’Odoo, ajustées par les positions fiscales (client étranger, professionnel), doivent produire le même montant sur chaque ligne.
- Références internes : la clé commune doit être la référence article, pas un identifiant de base de données qui change d’un environnement à l’autre.
- Déclinaisons et variantes : une déclinaison PrestaShop correspond à une variante Odoo ; attributs, valeurs et références de chaque variante doivent se répondre exactement.
- Unités de mesure : un article vendu au carton dans Odoo et à l’unité sur le site fausse stocks et quantités commandées si la conversion n’est pas prévue.
- Multiboutique et multi-sociétés : décidez quelle boutique alimente quelle société Odoo, avec quels entrepôts, journaux et listes de prix.
- Clients invités : une commande sans compte crée-t-elle un contact Odoo, ou est-elle rattachée à un contact générique ?
- Arrondis : arrondi à la ligne ou au total, prix saisis hors taxe ou toutes taxes comprises ; une différence de méthode crée des écarts de quelques centimes entre commande et facture.
- Remises et règles de prix : règles de panier, bons de réduction et prix spécifiques PrestaShop doivent devenir des lignes ou des remises lisibles dans Odoo.
- Devises : la devise de la commande, son taux et la devise de la société Odoo doivent être cohérents.
- Statuts de commande : chaque statut PrestaShop (payé, annulé, remboursé, expédié) doit avoir un effet défini dans Odoo
Édition et hébergement
Ce que changent l’édition et l’hébergement d’Odoo
L’hébergement d’Odoo détermine surtout où le code du connecteur peut vivre. Sur Odoo Online, l’offre en ligne de l’éditeur, les possibilités d’installer des modules personnalisés sont restreintes : un connecteur passe alors le plus souvent par l’API externe, depuis PrestaShop ou un middleware. Vérifiez les conditions de votre abonnement avant de choisir.
Sur Odoo.sh, la plateforme d’hébergement de l’éditeur, et sur une installation auto-hébergée, il est possible de déployer des modules Odoo personnalisés. Un module côté Odoo devient envisageable, avec en contrepartie la responsabilité de le maintenir lors des montées de version.
L’édition compte aussi : certaines applications ne sont disponibles qu’en édition Enterprise. Listez les applications réellement utilisées (Ventes, Inventaire, Comptabilité, Achats) et vérifiez qu’elles exposent les données dont le connecteur a besoin.
Méthode
Comment mener un projet de connexion PrestaShop Odoo ?
01
1. Cadrage et cartographie
Listez les applications Odoo utilisées, les flux, leur sens, leur fréquence et leur source de vérité. Établissez le mapping des taxes, variantes, unités, listes de prix et statuts, puis faites-le valider par les équipes métier et comptables.
02
2. Maquette sur base de test
Branchez une copie de la boutique sur une base de test Odoo. Vérifiez sur quelques produits et commandes réels que les montants, les taxes et les variantes tombent juste, avant d’écrire l’essentiel du code ou de retenir un connecteur existant.
03
3. Développement et tests de bout en bout
Développez ou configurez le connecteur par flux, par petites livraisons. Testez chaque parcours complet : commande payée, annulée, remboursée partiellement, client invité, client professionnel, produit à variantes, rupture de stock.
04
4. Mise en production progressive et supervision
Ouvrez les flux un par un, en commençant par les moins risqués, hors période de forte activité. Gardez un plan de retour et surveillez les journaux et les alertes de près pendant les premières semaines.
Supervision
Superviser les échanges et traiter les erreurs
Un connecteur PrestaShop Odoo fiable est un connecteur qui sait échouer proprement : il trace, rejoue, alerte et ne crée jamais de doublon.
- Journaux : chaque échange enregistre la donnée concernée, le contenu envoyé, la réponse d’Odoo ou de PrestaShop et l’heure.
- Reprise : un message en échec reste en file et est rejoué automatiquement, avec un délai croissant entre deux tentatives, puis isolé s’il échoue encore.
- Alertes : au-delà d’un seuil, une personne nommée est prévenue avec un lien vers le message en cause.
- Idempotence : renvoyer deux fois la même commande ne crée qu’un seul bon de commande dans Odoo, grâce à une clé unique comme la référence de commande PrestaShop.
- Resynchronisation : une remise à niveau complète des stocks et des prix, à la demande ou chaque nuit, corrige les écarts accumulés.
- Contrôles d’écarts : comparer régulièrement commandes, stocks et montants facturés des deux côtés.
Une fois en production, le connecteur se maintient comme le reste de la boutique : suivi des montées de version de PrestaShop et d’Odoo, corrections et évolutions, dans le cadre d’une TMA PrestaShop ou d’une maintenance de site PrestaShop.
Agillia
Ce qu’Agillia apporte à un projet PrestaShop Odoo
Agillia conçoit et maintient des connexions entre PrestaShop et les logiciels de gestion de ses clients, sans connecteur Odoo imposé. 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 développons des modules et des connecteurs PrestaShop, comme Pennylane Connect, qui envoie les factures PrestaShop vers le logiciel comptable Pennylane (un outil comptable, pas un ERP). Notre expertise Symfony sert quand un middleware est la bonne réponse.
Si une intégration existe déjà et pose problème, un audit de votre boutique PrestaShop permet d’identifier les flux en cause avant de décider entre correction, adaptation ou nouveau développement.
Pour aller plus loin
Pour aller plus loin
- Connecter PrestaShop à un ERP : la méthode générale, les modes d’intégration et la check-list, quel que soit l’ERP.
- Connecter PrestaShop à Business Central : les flux et points de vigilance avec l’ERP de Microsoft.
- ERP, PIM, CRM : quel rôle dans un e-commerce connecté ? : la répartition des données entre les logiciels de l’entreprise.
- Portail e-commerce B2B : cahier des charges complet : les besoins B2B à prévoir : tarifs par client, encours, commandes rapides.
- Besoin spécifique PrestaShop : un connecteur Odoo développé ou adapté pour vos règles de gestion.
- Demande de devis : décrire votre projet de connexion et recevoir une proposition.
Questions fréquentes
Vos questions sur la connexion entre PrestaShop et Odoo
Comment connecter PrestaShop à Odoo ?
Vous reliez le webservice et les hooks de PrestaShop à l’API externe d’Odoo, via un connecteur existant, un module sur mesure ou un middleware. Commencez par fixer, pour chaque flux, le sens, la fréquence et la source de vérité. Validez ensuite le mapping sur une base de test Odoo avant toute mise en production.
Quelles données synchroniser entre PrestaShop et Odoo ?
Les flux habituels sont les produits et variantes, les prix et listes de prix, les stocks, les clients, les commandes, les factures, les livraisons et les paiements. Produits, prix et stocks partent en général d’Odoo, commandes et clients remontent de PrestaShop.
Faut-il un connecteur existant ou sur mesure pour relier PrestaShop et Odoo ?
Un connecteur existant convient si vos règles restent standard et qu’il passe vos tests sur variantes, taxes et listes de prix. Le sur mesure se justifie avec des règles B2B, du multiboutique ou plusieurs sociétés Odoo. Une voie intermédiaire consiste à adapter une solution existante choisie ensemble.
L’hébergement Odoo Online limite-t-il la connexion avec PrestaShop ?
Il limite surtout l’installation de modules personnalisés dans Odoo, pas l’accès à l’API externe. Le connecteur se place alors côté PrestaShop ou dans un middleware. Vérifiez les conditions de votre abonnement avant de choisir l’architecture.
Comment gérer les variantes Odoo et les déclinaisons PrestaShop ?
Chaque variante Odoo doit correspondre à une déclinaison PrestaShop, avec une référence propre des deux côtés. Les attributs et leurs valeurs doivent porter les mêmes libellés ou être mappés explicitement. Sans référence par variante, stocks et commandes se rattachent au mauvais article.
Les stocks Odoo doivent-ils être envoyés en temps réel à PrestaShop ?
Pas forcément : cela dépend de la rotation de vos produits et des quantités disponibles. Pour des articles qui se vendent vite, un envoi à chaque mouvement de stock limite les ventes de produits épuisés. Sinon, une synchronisation fréquente complétée d’une resynchronisation nocturne suffit souvent.
Qui doit émettre les factures entre PrestaShop et Odoo ?
Un seul outil doit numéroter les factures, en général Odoo quand la comptabilité y est tenue. PrestaShop affiche alors au client la facture produite par Odoo. Deux numérotations parallèles créent des doublons.
Agillia propose-t-elle un connecteur Odoo prêt à l’emploi ?
Non, Agillia ne vend pas de connecteur Odoo standard. Nous développons un connecteur à la demande ou adaptons une solution existante choisie avec vous, puis nous pouvons le maintenir dans la durée. Le point de départ est un cadrage de vos flux et de votre configuration Odoo.
Un projet pour relier votre boutique PrestaShop à Odoo ?
Décrivez-nous votre configuration Odoo, vos flux et vos contraintes : nous vous proposons une architecture et une démarche adaptées.
