Store Platforms

Intégration Odoo WooCommerce : connecteur ou migration ?

Découvrez les options d’intégration Odoo WooCommerce : plans compatibles, connecteur, API personnalisée, synchronisation des données et problèmes à éviter.

Photo de profil de Long Nguyen

Long Nguyen

Développeur fullstack · Ingénieur IA · Chercheur

• • 5 min de lecture •

Odoo dispose-t-il d’un connecteur WooCommerce natif ?

Non. Une intégration Odoo WooCommerce repose toujours sur une solution qu’Odoo ne fournit pas directement : un module tiers, un module personnalisé ou un service de synchronisation externe. La documentation officielle d’Odoo consacrée aux ventes pour la version 19 présente des connecteurs intégrés pour Amazon, Shopee, Lazada et TikTok Shop. WooCommerce n’y figure pas.

La solution native d’Odoo pour la vente en ligne est son application eCommerce, qui partage une même base de données avec les stocks et la comptabilité. Cette option est abordée à la fin de ce guide, car elle peut être plus adaptée à certaines boutiques.

Si vous conservez WooCommerce, trois questions déterminent le projet, dans cet ordre :

  1. Votre formule Odoo et votre hébergement permettent-ils réellement une intégration ?
  2. Quelle approche convient le mieux : un connecteur prêt à l’emploi, une synchronisation personnalisée ou un outil no-code ?
  3. Quel système est responsable de quelles données ?

Quelles formules et quels hébergements Odoo sont compatibles avec WooCommerce ?

C’est l’étape que la plupart des guides négligent, alors qu’elle élimine certaines options avant même de comparer les connecteurs. Deux limites s’appliquent : l’endroit où du code personnalisé peut être exécuté et les personnes ou services autorisés à appeler l’API Odoo depuis l’extérieur.

Votre configuration Odoo Modules tiers ou personnalisés API externe Ce que vous pouvez réellement faire
Odoo Online, formule One App Free ou Standard Non Non Import et export CSV manuels uniquement. L’automatisation nécessite d’abord de changer de formule ou d’hébergement.
Odoo Online, formule Custom Non Oui Utiliser un service de synchronisation externe qui appelle les deux API.
Odoo.sh ou installation sur site, formule Custom Oui Oui Utiliser un module connecteur, un module personnalisé ou un service de synchronisation externe.
Odoo Community, auto-hébergé Oui Oui Mêmes possibilités. Vérifiez que le module prend en charge Community.

Deux précisions importantes derrière ce tableau :

  • L’accès à l’API dépend de la formule. La documentation de l’API External JSON-2 d’Odoo indique que l’accès aux données via l’API externe est disponible uniquement avec les formules tarifaires Custom, et non avec One App Free ou Standard.
  • Odoo Online n’héberge pas les modules personnalisés. La page tarifaire d’Odoo décrit Odoo Online comme un hébergement pour les bases de données sans modules personnalisés. Un module connecteur nécessite donc Odoo.sh ou votre propre serveur, quelle que soit la formule payée.

L’échéance XML-RPC à vérifier auprès de chaque éditeur

Odoo 19 a introduit l’API JSON-2 et déconseillé les anciens points de terminaison XML-RPC et JSON-RPC. La documentation prévoit leur suppression dans une prochaine version majeure d’Odoo et pour Odoo Online dans une prochaine version intermédiaire.

En pratique, cela signifie que toute intégration qui appelle Odoo depuis l’extérieur via XML-RPC, par exemple un plugin installé côté WordPress, a une durée de vie limitée. Les modules qui s’exécutent dans Odoo utilisent directement son ORM et ne sont pas concernés. Demandez précisément quelle technologie utilise le produit que vous achetez.

Trois façons de connecter WooCommerce à Odoo

  Module connecteur de l’Apps Store Module personnalisé ou service de synchronisation Plateforme d’automatisation no-code
Lieu d’exécution Dans Odoo Dans Odoo ou comme service séparé appelant les deux API Un cloud tiers
Compatible avec Odoo Online Non Service de synchronisation uniquement, avec la formule Custom Formule Custom uniquement, car la solution utilise l’API externe
Adapté lorsque Le catalogue et le parcours de commande sont standards Vous avez des champs personnalisés, des tarifs B2B, plusieurs entrepôts ou des parcours de commande atypiques Le volume de commandes est faible et vous avez un ou deux flux, par exemple d’une nouvelle commande vers un devis
Risque principal La qualité du code varie et chaque mise à niveau d’Odoo dépend de l’éditeur Coût initial plus élevé et maintenance à votre charge La réconciliation des stocks, les nouvelles tentatives et la prévention des doublons deviennent limitées quand le volume augmente
Coût initial Le plus faible Le plus élevé Faible

L’Odoo Apps Store répertorie de nombreux modules tiers pour ce besoin, dont la plupart portent simplement le nom WooCommerce Connector. Commencez par là si vos processus sont standards. Un connecteur qui couvre 90 % de votre flux et nécessite seulement une petite personnalisation coûte généralement moins cher qu’un développement entièrement nouveau.

Optez pour une solution personnalisée lorsque le connecteur devrait de toute façon être largement réécrit : règles tarifaires par groupe de clients, stocks répartis entre plusieurs entrepôts, packs ou étape de validation avant confirmation des commandes. Netalith intervient dans ces deux cas, en évaluant ou en étendant un connecteur existant et en développant une synchronisation personnalisée, dans le cadre de son service de développement et d’intégration Odoo.

Comment évaluer un connecteur Odoo WooCommerce avant de l’acheter ?

Des dizaines d’annonces portent le même nom. Comparez-les donc selon des critères précis plutôt que selon leurs listes de fonctionnalités. Voici ceux qui permettent le mieux d’anticiper les problèmes :

  • Version et édition. Les modules sont publiés pour chaque version majeure d’Odoo. Vérifiez qu’une version est disponible pour votre version exacte et pour Community si c’est l’édition que vous utilisez.
  • Licence. Les modules payants sont souvent commercialisés sous la Odoo Proprietary License. Vérifiez si vous pouvez modifier le code et combien de bases de données un achat couvre.
  • Risque lié à la chaîne d’approvisionnement. Le module s’exécute dans votre ERP avec un accès à la base de données et conserve les clés de lecture et d’écriture de votre boutique. Faites examiner le code par un développeur et installez-le d’abord sur une copie de préproduction.
  • Mécanisme de synchronisation. La conception la plus robuste combine des webhooks et une réconciliation planifiée. Les tâches planifiées seules entraînent des délais ; les webhooks seuls peuvent créer des interruptions silencieuses.
  • Couverture des données. Vérifiez la prise en charge des produits variables, des remboursements, de la correspondance des taxes, des lignes de livraison, des coupons et de plusieurs boutiques par rapport à votre usage réel.
  • Dépendances serveur. Certains connecteurs nécessitent l’installation de paquets Python supplémentaires sur le serveur Odoo. Cela confirme qu’ils ne peuvent pas fonctionner sur Odoo Online.
  • Politique de mise à niveau. Demandez si la prochaine version d’Odoo est incluse dans le prix et dans quel délai elle est généralement publiée après la sortie d’Odoo.
  • Journaux et nouvelles tentatives. Il vous faut un journal d’erreurs par enregistrement et la possibilité de relancer une seule commande échouée sans tout réimporter.

Quelles données synchroniser entre Odoo et WooCommerce, et dans quel sens ?

La règle qui évite la plupart des erreurs de synchronisation est simple : chaque champ doit avoir un seul responsable. Une synchronisation bidirectionnelle du même champ crée des boucles et des écrasements. Une synchronisation bidirectionnelle de champs différents ne pose pas de problème.

Donnée Responsable habituel Sens Déclencheur
Niveaux de stock Odoo Odoo vers WooCommerce Lors d’un mouvement de stock, plus une transmission complète planifiée
Commandes WooCommerce WooCommerce vers Odoo Webhook à la création de la commande, plus interrogation de réconciliation
Clients WooCommerce WooCommerce vers Odoo Créés avec la commande et rapprochés par adresse e-mail
Statut d’exécution et suivi Odoo Odoo vers WooCommerce Lorsque la livraison est validée
Contenu produit, images et catégories À choisir Dans un seul sens depuis le responsable Lors d’une modification
Prix À choisir Dans un seul sens depuis le responsable Lors d’une modification
Remboursements WooCommerce WooCommerce vers Odoo, sous forme d’avoir Lors du remboursement

Le contenu produit est le véritable point de décision. Faites d’Odoo le responsable si vous vendez également via un point de vente ou des marketplaces. Gardez WooCommerce comme responsable si votre équipe marketing rédige les pages produits dans WordPress. Les numéros de suivi nécessitent un choix supplémentaire, car le cœur de WooCommerce ne prévoit pas de champ de suivi sur les commandes : enregistrez-les dans une note de commande, dans les métadonnées de commande ou via un plugin de suivi des expéditions.

Correspondance des statuts de commande

L’API REST de WooCommerce utilise sept statuts de commande. Déterminez l’action à effectuer dans Odoo pour chacun avant d’écrire la moindre ligne de code.

Statut WooCommerce Action Odoo suggérée
pending Ne pas importer. Le paiement n’est pas arrivé.
on-hold Importer comme devis ou attendre. Cas courant pour un virement bancaire.
processing Importer et confirmer la commande client. C’est le principal point d’entrée.
completed Défini par Odoo après la livraison, et non importé comme une nouvelle commande.
cancelled Annuler la commande client si elle n’a pas encore été expédiée.
refunded Créer un avoir et un retour si les articles sont renvoyés.
failed Ignorer.

Comment fonctionne une synchronisation API entre Odoo et WooCommerce ?

Architecture d’une intégration Odoo WooCommerce : les commandes et les clients passent de la boutique WooCommerce par une couche de synchronisation vers Odoo via webhook, tandis que les stocks et le suivi repartent dans l’autre sens ; une interrogation de réconciliation planifiée couvre les événements manqués

Le côté WooCommerce

WooCommerce expose ses données sous /wp-json/wc/v3/. Voici les éléments qui structurent une intégration, tous décrits dans la documentation de l’API REST WooCommerce :

  • Clés. Une clé et un secret client sont créés dans WooCommerce > Réglages > Avancé > API REST, avec une autorisation de lecture, d’écriture ou de lecture/écriture. En HTTPS, ils sont transmis via HTTP Basic Auth.
  • Pagination. Les listes renvoient 10 éléments par défaut et 100 au maximum par page. Les totaux sont transmis dans les en-têtes X-WP-Total et X-WP-TotalPages.
  • Récupérations incrémentielles. Les listes de commandes et de produits acceptent modified_after, ce qui permet à une interrogation de ne récupérer que les éléments modifiés.
  • Écritures par lots. Les points de terminaison par lots acceptent par défaut jusqu’à 100 objets par requête. C’est la méthode à utiliser pour transmettre le stock d’un catalogue important.
  • Webhooks. Des sujets comme order.created et order.updated envoient du JSON à votre URL. La requête est signée dans l’en-tête X-WC-Webhook-Signature avec un HMAC-SHA256 du contenu encodé en base64.

Le côté Odoo

Depuis Odoo 19, un service externe appelle POST /json/2/<model>/<method> avec une clé API comme jeton bearer. Un comportement compte davantage que la syntaxe : chaque appel JSON-2 s’exécute dans sa propre transaction de base de données, et les appels ne peuvent pas être enchaînés au sein d’une même transaction. Si vous créez l’en-tête d’une commande lors d’un appel, puis ses lignes lors d’un second, une erreur entre les deux laisse une commande incomplète dans votre ERP.

La solution consiste à envoyer la commande et ses lignes dans un seul appel create, ou à exposer une méthode personnalisée qui effectue toute l’opération. L’exemple ci-dessous montre le principe. Les recherches de partenaires et de produits sont volontairement omises.

import base64, hashlib, hmac, requests

def woo_signature_ok(raw_body, header_sig, secret):
    digest = hmac.new(secret.encode(), raw_body, hashlib.sha256).digest()
    expected = base64.b64encode(digest).decode()
    return hmac.compare_digest(expected, header_sig)

def odoo(model, method, **params):
    r = requests.post(
        f'{ODOO_URL}/json/2/{model}/{method}',
        headers={'Authorization': f'bearer {ODOO_API_KEY}',
                 'X-Odoo-Database': ODOO_DB},
        json=params, timeout=30)
    r.raise_for_status()
    return r.json()

def import_order(woo):               # woo = parsed order.created payload
    ref = 'WC-' + str(woo['id'])
    domain = [['client_order_ref', '=', ref]]
    if odoo('sale.order', 'search_count', domain=domain):
        return                       # already imported, deliveries can repeat
    odoo('sale.order', 'create', vals_list=[{
        'partner_id': find_or_create_partner(woo['billing']),
        'client_order_ref': ref,
        'order_line': [[0, 0, {
            'product_id': product_id_for_sku(line['sku']),
            'product_uom_qty': line['quantity'],
            'price_unit': float(line['price']),
        }] for line in woo['line_items']],
    }])

Autour de ce noyau, une synchronisation de production ajoute quatre éléments : vérifier la signature avant toute opération, accuser rapidement réception du webhook et traiter l’événement depuis une file d’attente, conserver la correspondance entre les identifiants WooCommerce et Odoo, puis exécuter une interrogation planifiée avec modified_after pour récupérer ce que les webhooks auraient manqué.

Ce qui casse en production et comment le corriger

Symptôme Cause Correction
Produits en double ou impossibles à rapprocher Le SKU est facultatif dans WooCommerce et Odoo n’impose pas l’unicité de la référence interne. Nettoyez et rendez les SKU obligatoires et uniques dans les deux systèmes avant la première synchronisation, puis rapprochez les enregistrements à partir des identifiants stockés, et non du seul SKU.
Les variantes ne correspondent pas Un produit variable WooCommerce est un parent avec des variations stockées séparément. Odoo génère les variantes à partir des lignes d’attributs et peut créer des combinaisons qui n’existent pas dans la boutique. Associez chaque variation à une variante Odoo au moyen de son SKU et contrôlez les combinaisons créées par Odoo.
Les totaux de commande diffèrent de quelques centimes WooCommerce envoie ses propres résultats de taxe sous forme de chaînes à deux décimales. Odoo recalcule la taxe à partir de ses propres règles fiscales. Associez chaque taux de taxe WooCommerce à une taxe Odoo, harmonisez le paramétrage des prix TTC et définissez une règle pour les écarts d’arrondi.
Surventes La synchronisation transmet la quantité disponible, qui inclut encore le stock réservé à d’autres commandes. Transmettez la quantité libre des entrepôts qui expédient les commandes en ligne. Ajoutez une marge de sécurité pour les produits à forte rotation.
Les commandes cessent d’arriver sans alerte WooCommerce désactive un webhook après cinq livraisons consécutives échouées, par exemple pendant une mise à niveau d’Odoo. Surveillez le statut des webhooks, conservez l’interrogation de réconciliation et déclenchez une alerte lorsqu’aucune commande n’est arrivée pendant une période inhabituelle.
Commandes clients en double La même commande arrive deux fois, à cause d’une nouvelle livraison ou de l’arrivée simultanée du webhook et de l’interrogation. Utilisez l’identifiant de commande WooCommerce comme clé d’idempotence et vérifiez son unicité dans Odoo.
L’intégration cesse de fonctionner après un changement d’équipe Une clé API WooCommerce appartient à un utilisateur WordPress et cesse de fonctionner lorsque cet utilisateur est supprimé. Créez un utilisateur dédié à l’intégration dans les deux systèmes, avec uniquement les droits nécessaires à la synchronisation.
Commandes manquantes autour de minuit Les dates WooCommerce suivent le fuseau horaire du site, sauf si vous utilisez les champs GMT. Odoo stocke les dates en UTC. Lisez les champs de date _gmt et définissez dates_are_gmt dans les requêtes filtrées.

Aucun de ces problèmes n’apparaît dans une démonstration avec dix produits. Ils se manifestent dès les premières semaines, raison pour laquelle un test en préproduction avec une copie de votre véritable catalogue et un mois de commandes réelles vaut mieux que n’importe quelle liste de fonctionnalités.

Quel est le coût d’une intégration Odoo WooCommerce ?

La licence du connecteur est généralement le plus petit poste de dépense. Prévoyez les cinq éléments suivants :

Poste de coût Module connecteur Développement personnalisé
Logiciel Achat d’un module pour chaque version d’Odoo Temps de développement
Formule Odoo Formule Custom si vous utilisez Odoo Enterprise, car Standard n’autorise ni les modules personnalisés ni l’API externe
Hébergement Odoo.sh ou votre propre serveur pour toute solution qui s’exécute dans Odoo
Configuration Nettoyage des SKU, correspondance des taxes et des statuts, test sur des données réelles. Nécessaire quelle que soit l’approche.
Maintenance Mises à jour de l’éditeur pour chaque version d’Odoo, plus les corrections lorsque WooCommerce ou un plugin change de comportement Votre développeur prend en charge les deux aspects

C’est la configuration qui fausse le plus souvent les estimations. Un catalogue avec des SKU propres et uniques et un seul taux de taxe se connecte rapidement. Un catalogue avec des SKU manquants, des produits variables et plusieurs classes de taxe nécessite un travail sur les données avant même que le moindre outil puisse aider, et aucun connecteur ne s’en charge à votre place.

Intégrer WooCommerce à Odoo ou migrer la boutique vers Odoo eCommerce ?

Odoo eCommerce utilise la même base de données que les stocks, les ventes et la comptabilité : il n’y a donc rien à synchroniser. Cela supprime toute cette catégorie de problèmes. En contrepartie, il faut recréer la boutique en ligne.

Conservez WooCommerce et intégrez-le si Passez à Odoo eCommerce si
Votre trafic organique dépend de vos contenus et de vos URL WordPress La boutique est un catalogue simple avec un tunnel de commande
Vous utilisez des extensions WooCommerce comme les abonnements ou les réservations Les règles de prix, de stock et de produits résident déjà dans Odoo
Votre équipe travaille chaque jour dans WordPress Vous préférez gérer un seul système plutôt qu’une couche de synchronisation

Une migration entraîne ses propres coûts : redirections pour chaque URL indexée, recréation du thème et vérification de la compatibilité de votre prestataire de paiement. Comparez ce coût ponctuel à celui de l’achat et de la maintenance d’une intégration pendant plusieurs années.

Si vous ne savez pas de quel côté du tableau vous vous situez, envoyez à Netalith votre version d’Odoo, votre type d’hébergement et une estimation du nombre de produits et de commandes via le formulaire de devis gratuit. Vous recevrez une recommandation cadrée : connecteur, synchronisation personnalisée ou migration, avec un prix établi selon le périmètre.

FAQ

Questions fréquentes

Odoo dispose-t-il d’un connecteur WooCommerce intégré&nbsp;?

Non. Odoo 19 documente des connecteurs intégrés pour Amazon, Shopee, Lazada et TikTok Shop, mais pas pour WooCommerce. Une intégration Odoo WooCommerce utilise un module tiers de l’Odoo Apps Store, un module personnalisé ou un service de synchronisation externe.

Puis-je connecter WooCommerce à Odoo Online&nbsp;?

Uniquement avec la formule Custom et via un service de synchronisation externe qui appelle l’API Odoo. Odoo Online n’héberge pas les modules tiers ou personnalisés, et la documentation d’Odoo limite l’accès à l’API externe aux formules tarifaires Custom. Avec One App Free ou Standard, l’intégration automatisée n’est pas disponible.

Odoo Community fonctionne-t-il avec WooCommerce&nbsp;?

Oui. Un serveur Odoo Community auto-hébergé peut exécuter des modules connecteurs et des modules personnalisés, et son API fait partie intégrante d’Odoo. Vérifiez que le connecteur choisi est publié pour Community et pour votre version exacte d’Odoo.

La synchronisation Odoo WooCommerce est-elle en temps réel&nbsp;?

Elle peut être presque en temps réel pour les commandes lorsque des webhooks WooCommerce sont utilisés, car chaque nouvelle commande est transmise à la synchronisation dès sa création. Les connecteurs qui reposent uniquement sur des tâches planifiées se synchronisent selon l’intervalle défini. Une configuration fiable combine les webhooks et une réconciliation planifiée, car WooCommerce désactive un webhook après cinq livraisons consécutives échouées.

Quel système doit être la source de vérité pour les stocks&nbsp;?

Odoo. Il enregistre les réceptions, les réservations, les livraisons et les retours, et connaît donc la quantité réellement disponible à la vente. WooCommerce doit recevoir les stocks depuis Odoo et lui transmettre les commandes, plutôt que de conserver son propre stock séparé.

Les connecteurs qui utilisent XML-RPC continueront-ils à fonctionner&nbsp;?

Pour le moment. Odoo a déconseillé les points de terminaison XML-RPC et JSON-RPC dans la version 19 au profit de l’API JSON-2, et sa documentation prévoit leur suppression dans une prochaine version d’Odoo ainsi que pour Odoo Online dans une prochaine version intermédiaire. Les intégrations qui appellent Odoo depuis l’extérieur doivent passer à JSON-2 avant cette échéance. Les modules qui s’exécutent dans Odoo ne sont pas concernés.

Restez informé avec Netalith

Recevez des ressources de développement, des mises à jour produit et des offres spéciales directement dans votre boîte mail.