Store Platforms

Migrer un site e-commerce sur mesure vers Odoo

Découvrez comment migrer un site e-commerce vers Odoo : choisir l’édition, importer les produits, préserver le SEO et réussir la mise en ligne.

Photo de profil de Long Nguyen

Long Nguyen

Développeur fullstack · Ingénieur IA · Chercheur

• • 5 min de lecture •

En bref : l’ordre qui fonctionne

Pour migrer un site e-commerce sur mesure vers Odoo sans compromettre les ventes ni le trafic naturel, suivez un ordre précis : déterminez d’abord si Odoo doit réellement devenir votre boutique en ligne, choisissez l’édition et la version, inventoriez vos données, importez-les avec des External IDs stables, préparez la table de redirections, recréez ce qui ne peut pas être importé, puis répétez la migration et effectuez la bascule. L’import est la partie la plus courte. Ce sont les décisions qui l’entourent qui déterminent la réussite ou l’échec du projet.

  1. Décidez ce qu’Odoo doit remplacer : toute la boutique ou uniquement le back-office.
  2. Choisissez l’édition, l’hébergement et la version.
  3. Inventoriez chaque type de données et classez-le en import, reconstruction ou archivage.
  4. Importez les données avec des External IDs préfixés afin de pouvoir répéter chaque opération.
  5. Générez une table de redirections basée sur le SKU ou un autre identifiant stable.
  6. Recréez le tunnel de commande, la livraison, les taxes et les fonctionnalités personnalisées.
  7. Répétez la migration sur un environnement de préproduction, gelez les données, importez le delta, modifiez le DNS et surveillez le résultat.

Migrer une boutique sur mesure vers Odoo : est-ce rentable ?

La vraie valeur d’Odoo se trouve dans le back-office : stocks, comptabilité, CRM et livraison réunis dans un même système, avec le site web par-dessus. Si c’est ce qui vous fait défaut, la migration peut être très avantageuse. En revanche, si votre boutique développée sur mesure constitue votre véritable produit, parce que son tunnel de commande ou son catalogue sont optimisés et différenciants, passer au Website Builder d’Odoo représente un retour en arrière et un mauvais compromis.

  • La migration vaut le coup lorsque des personnes qui ne développent pas doivent gérer le catalogue et les commandes, que les stocks et la comptabilité sont dispersés dans des tableurs ou plusieurs outils, ou que la maintenance d’un back-office personnalisé est devenue un coût à part entière.
  • Elle ne vaut généralement pas le coup lorsque la boutique actuelle convertit bien, que vous avez uniquement besoin d’un catalogue et d’un tunnel de commande, ou que personne ne prendra en charge les mises à niveau d’Odoo après le lancement.
  • Une solution intermédiaire : conserver le front-end sur mesure et utiliser Odoo comme back-office via son API. Vous évitez ainsi de recréer la vitrine et le problème des redirections.

Nous transférons actuellement l’une de nos boutiques Django développées sur mesure vers Odoo Community. La décision ne repose pas sur une simple liste de fonctionnalités. Le propriétaire de la boutique n’est pas développeur, et un back-office personnalisé n’est pas adapté à la gestion d’un catalogue par une personne dans cette situation. De plus, chaque boutique développée sur mesure finit par avoir sa propre structure, que seul son auteur connaît vraiment. Odoo apporte une structure standard, une administration standard et Python pour les éléments qui nécessitent réellement du code.

Choisissez l’édition, l’hébergement et la version avant tout import

Ces trois choix déterminent la quantité de code personnalisé que vous pourrez écrire et la personne qui prendra en charge les mises à niveau par la suite. Réglez-les donc en premier. Les deux éditions incluent les applications Website et eCommerce ; la différence concerne l’hébergement, le support et les mises à niveau.

Option Responsable de l’exploitation À choisir lorsque
Community, auto-hébergée Vous ou votre développeur assurez l’hébergement et les mises à niveau. Elle est gratuite et open source (LGPL), sans support officiel d’Odoo S.A. Vous disposez d’un développeur ou d’un partenaire responsable du serveur et des mises à niveau.
Enterprise, auto-hébergée Vous assurez l’hébergement ; Odoo S.A. fournit le support et les outils de mise à niveau via un abonnement par utilisateur. Vous souhaitez bénéficier d’un support officiel tout en gardant la maîtrise du serveur.
Enterprise sur Odoo.sh La plateforme gérée d’Odoo pour le code personnalisé, avec environnements de préproduction et sauvegardes. Vous développez des modules personnalisés et souhaitez une infrastructure gérée.
Enterprise sur Odoo Online Odoo gère l’ensemble de l’infrastructure en mode SaaS. Les fonctionnalités standard suffisent pour la boutique. Les modules Python personnalisés ne sont pas possibles ici : écartez donc cette option dès le départ si votre boutique comporte une logique spécifique.

Notre règle : choisissez en fonction de la personne qui sera responsable des mises à niveau la deuxième année, et non en fonction de la liste des fonctionnalités. Une boutique lancée sur une version que personne ne met à jour devient le prochain site legacy.

Concernant la version : Odoo publie une nouvelle version majeure chaque automne, et Odoo 20 a été présenté le lors d’Odoo Experience. Odoo prend en charge les trois versions majeures les plus récentes. Avant de faire votre choix, vérifiez que chaque module tiers dont vous dépendez possède une branche compatible. Les nouvelles versions majeures accusent généralement un retard en matière de compatibilité des modules ; une version prise en charge avec tous vos modules est préférable à la toute dernière version présentant des lacunes.

Quelles données migrer ? Établissez un inventaire

Listez chaque type de données présent dans l’ancienne boutique et attribuez-lui une décision : importer, recréer ou archiver. Considérer que tout peut être importé est l’erreur de planification la plus fréquente.

Données de l’ancienne boutique Équivalent dans Odoo Approche par défaut
Produits et SKU Fiches produit (product.template) Importer avec des External IDs
Options et variantes Attributs, valeurs et variantes de produits Normaliser avant l’import
Catégories Catégories de la boutique (product.public.category) et catégories internes (product.category) Importer avant les produits
Images des produits Images de la fiche produit Importer depuis des URL tant que l’ancien site est encore en ligne
Clients et adresses Contacts (res.partner) avec adresses de livraison enfants Importer, sans transférer les mots de passe
Historique des commandes Commandes clients (sale.order) Archiver par défaut ; importer uniquement si la comptabilité ou le portail client en a besoin
Anciennes URL Enregistrements de redirection du site web Générer à partir de la liste des anciennes URL
Blog et pages statiques Pages du site et articles de blog Recréer en conservant le contenu
Coupons, règles de livraison et de taxation, e-mails Configuration Reconstituer manuellement

Les variantes sont les données les plus difficiles à importer. Si votre ancien catalogue stocke les options sous forme de texte libre (« Grand / Bleu »), transformez-les en attributs et valeurs propres dans les données sources avant de les envoyer dans Odoo.

Importer les produits et les clients avec des External IDs

L’assistant d’import d’Odoo accepte les fichiers .xlsx et .csv pour n’importe quel objet métier. La colonne External ID est essentielle : elle permet à un enregistrement de pointer vers un autre et de réimporter les données ultérieurement pour mettre à jour les fiches plutôt que de créer des doublons. Selon la documentation d’import d’Odoo 19, les données existantes peuvent être mises à jour en masse tant que l’External ID reste cohérent. Les External IDs doivent être uniques pour l’ensemble des enregistrements de tous les objets. Préfixez-les donc par type : legacy_product_123, legacy_category_7, legacy_customer_550.

Importez les données dans l’ordre des dépendances : les catégories, puis les attributs, les produits et enfin les clients. Les images des produits peuvent être chargées depuis des URL placées dans une colonne d’image ; le serveur les récupère pendant l’import. Conservez donc l’ancien site accessible jusqu’à la fin de l’opération.

Ne devinez pas les noms de colonnes. Exportez un produit fictif depuis votre instance Odoo cible en cochant Je veux mettre à jour des données (export compatible avec l’import) et en sélectionnant tous les champs que vous comptez renseigner, puis utilisez les en-têtes de ce fichier. Le script ci-dessous refuse d’écrire un fichier contenant des colonnes absentes de ce modèle : une faute de frappe est ainsi détectée sur votre ordinateur, et non à mi-parcours de l’import.

import csv

# Import-compatible export of one dummy product from your target Odoo
TEMPLATE = "odoo_product_template.csv"
with open(TEMPLATE, newline="", encoding="utf-8") as f:
    valid_headers = set(next(csv.reader(f)))

def to_odoo_row(p):
    return {
        "External ID": f"legacy_product_{p['id']}",
        "Name": p["title"],
        "Internal Reference": p["sku"],
        "Sales Price": p["price"],
        "Product Category/External ID": f"legacy_category_{p['category_id']}",
    }

def write_csv(products, path="products_for_odoo.csv"):
    rows = [to_odoo_row(p) for p in products]
    unknown = set(rows[0]) - valid_headers
    if unknown:
        raise SystemExit(f"Not in your Odoo export template: {sorted(unknown)}")
    with open(path, "w", newline="", encoding="utf-8") as f:
        w = csv.DictWriter(f, fieldnames=list(rows[0]))
        w.writeheader()
        w.writerows(rows)

Le même principe s’applique aux clients. Ne prévoyez pas de transférer les hachages de mots de passe d’un système à l’autre. Importez le contact, puis envoyez au lancement un e-mail de réinitialisation du mot de passe ou d’invitation, en prévenant les clients qu’ils doivent s’y attendre.

Assistant CSV ou API JSON-2 : quelle méthode d’import choisir ?

Méthode Adaptée à Points de vigilance
Assistant d’import (CSV ou XLSX) Imports ponctuels de catalogues, répétitions de migration et opérations qu’une personne non développeuse peut relancer. Découpez les fichiers très volumineux en lots et testez chaque fichier avant l’import réel.
API JSON-2 Synchronisations delta le jour de la bascule, rapprochements automatisés et synchronisation continue si la vitrine reste sur mesure. Elle nécessite une clé API et un client scripté. Sur Odoo Online, l’accès à l’API dépend de votre forfait.

JSON-2 est apparue avec Odoo 19 : vous envoyez une requête POST à /json/2/<model>/<method> avec une clé API comme bearer token. Les anciens points de terminaison XML-RPC et JSON-RPC sont obsolètes, et la documentation d’Odoo 19 prévoit leur suppression dans une version majeure ultérieure. Les nouveaux scripts de migration devraient donc cibler JSON-2 sur Odoo 19 et les versions suivantes. Utilisez-la pour le contrôle le plus important après chaque import : comparer les volumes avec ceux de l’ancienne boutique.

import requests

BASE = "https://shop.example.com/json/2"
HEADERS = {
    "Authorization": "bearer YOUR_API_KEY",
    "X-Odoo-Database": "mydb",
    "Content-Type": "application/json; charset=utf-8",
}

def count(model, domain):
    r = requests.post(f"{BASE}/{model}/search_count",
                      headers=HEADERS, json={"domain": domain}, timeout=30)
    r.raise_for_status()
    return r.json()

print("products with SKU:", count("product.template", [["default_code", "!=", False]]))
print("storefront categories:", count("product.public.category", []))

Les volumes ne suffisent pas à prouver qu’aucune donnée n’a été perdue. Après chaque répétition de migration, vérifiez également un échantillon de SKU : prix, variantes, images et classement dans les catégories.

Préserver votre SEO lors d’une migration vers Odoo

Selon les recommandations d’Odoo dans sa documentation SEO d’Odoo 19, une migration ne nuit généralement pas au référencement, même si aucune plateforme ne peut garantir le maintien des positions. Odoo recommande trois pratiques : conserver le contenu existant, rediriger les anciennes URL vers leurs équivalents et surveiller le trafic ainsi que l’indexation dans Google Search Console. La documentation précise également qu’une baisse de trafic durant les premiers jours est normale et que la réindexation peut prendre de quelques jours à plusieurs semaines. Voici comment appliquer ces principes à une boutique sur mesure.

  • Construisez la table de redirections à partir de trois listes : votre ancien sitemap, les pages qui génèrent du trafic dans vos outils d’analyse et les pages qui génèrent des impressions dans Search Console. Les URL qui ne figurent dans aucune de ces listes peuvent généralement être abandonnées.
  • Basez la table sur un identifiant stable, pas sur le texte du slug. Les URL des produits Odoo se terminent par l’identifiant du produit dans la base de données ; vous ne connaissez donc chaque nouvelle URL qu’après l’import. Lisez le champ website_url de chaque produit via l’API, associez-le à l’ancienne URL grâce au SKU, puis générez les redirections à partir de cette correspondance.
  • Créez les redirections dans Odoo. Il s’agit d’enregistrements accessibles dans Site web, Configuration, Redirections, une section qui nécessite le mode développeur. Odoo propose les codes 301 et 308 pour les changements permanents. Faites pointer chaque ancienne URL directement vers son URL finale : les chaînes de redirections consomment inutilement le budget d’exploration et affaiblissent le signal.
  • Conservez la référence si les acheteurs recherchent par référence. Dans la boutique de pièces automobiles que nous exploitons, la majorité du trafic naturel provient de recherches par référence. Pour une boutique de ce type, le SKU reste présent dans le nom du produit, la balise title et l’URL, et sert de clé de rapprochement pour la table de redirections.
  • Ne modifiez qu’une variable à la fois. Ne réécrivez pas toutes les descriptions pendant le changement de plateforme. Si les positions évoluent, vous devez pouvoir déterminer si la cause vient de la plateforme ou du contenu.
  • Utilisez ce qu’Odoo génère. Odoo crée /sitemap.xml (mis en cache et actualisé toutes les 12 heures, avec un index séparé tous les 45 000 URL par fichier), permet de modifier le fichier robots.txt dans les réglages du site, ajoute des balises hreflang aux pages multilingues et produit des données structurées de produits au format schema.org. Si vous transférez d’anciens scripts de données structurées, vérifiez qu’ils ne génèrent pas désormais un balisage produit en double.

Ce qu’il faut reconstruire plutôt que migrer

L’import couvre les données. Les comportements doivent être reconstruits, et c’est à ce niveau que se concentre le budget.

Fonctionnalité de l’ancienne boutique Équivalent dans Odoo Facteur d’effort
Thème et mise en page Website Builder et thème Degré de fidélité nécessaire par rapport à l’ancien site
Tunnel de commande et paiements Prestataires de paiement, configurés et testés en mode sandbox Nombre de prestataires et de devises
Livraison et taxes Modes de livraison et positions fiscales Zones, transporteurs et règles fiscales par pays
Règles de prix personnalisées ou B2B Listes de prix ou module personnalisé Possibilité d’exprimer la règle avec une liste de prix standard
Écrans d’administration Vues standard d’Odoo Effort généralement réduit, car vous cessez de les maintenir
E-mails transactionnels Modèles d’e-mails Nombre de modèles et de langues

Lorsqu’une fonctionnalité nécessite du code, elle devient un module Odoo : Python pour les modèles, XML pour les vues et OWL pour les composants front-end personnalisés. Si vous préférez ne pas les développer vous-même, le service de développement Odoo de Netalith couvre les modules personnalisés, l’e-commerce Odoo et les intégrations. Évaluez chaque fonctionnalité personnalisée séparément : configurez-la, remplacez-la par un comportement standard ou développez un module. Transformer systématiquement chaque besoin en module est la meilleure façon de ralentir un projet Odoo.

Que faire de l’historique des commandes et des comptes clients ?

Pour les clients, importez les contacts et les adresses de livraison avec des External IDs et gérez les mots de passe au moyen d’un e-mail de réinitialisation, comme indiqué plus haut. Les achats invités ne correspondent à aucun compte à migrer : seule une adresse e-mail est disponible.

Pour les commandes, notre approche par défaut consiste à les archiver. Exportez les anciennes commandes dans une archive en lecture seule (un instantané de la base accompagné d’exports CSV ou PDF) que les équipes support et finance peuvent toujours consulter, puis vérifiez les règles locales de conservation des documents avant de décider de la durée d’archivage. Importez les commandes dans Odoo uniquement si les clients doivent retrouver leur historique dans le portail ou si la comptabilité a besoin de ces données dans Odoo.

Si vous les importez, soyez prudent. Dans une configuration standard, la confirmation d’une commande client peut créer des livraisons et des factures. Importer un historique sous forme de commandes confirmées peut donc produire des mouvements de stock et des écritures comptables dont vous n’avez pas besoin. Répétez la procédure sur un environnement de préproduction, puis contrôlez les stocks et la comptabilité.

Un plan de bascule pour éviter les commandes perdues et la double indexation

  1. Empêchez la préproduction d’apparaître dans les moteurs de recherche. La documentation SEO d’Odoo décrit une méthode pour ajouter une balise noindex à l’ensemble d’un site : saisissez une valeur aléatoire dans le champ Domaine, sous Informations du site web dans les réglages. Faites-le sur chaque base de préproduction et de test.
  2. Répétez l’import complet plusieurs fois sur une base neuve et chronométrez chaque opération. Les External IDs rendent chaque exécution répétable : corrigez la correspondance, puis relancez-la.
  3. Effectuez un rapprochement. Comparez les volumes avec le script ci-dessus, puis vérifiez un échantillon de SKU, de prix, de variantes, d’images et de catégories.
  4. Réduisez le TTL du DNS environ un jour avant la bascule afin que la modification se propage rapidement.
  5. Gelez l’ancienne boutique. Activez son mode maintenance ou désactivez au minimum le tunnel de commande pendant votre période de plus faible activité.
  6. Importez le delta. Chargez uniquement les enregistrements créés ou modifiés depuis votre instantané, en vous appuyant sur la colonne de date de mise à jour de l’ancienne boutique. Les External IDs mettent à jour les enregistrements existants sans en créer de nouveaux.
  7. Modifiez le DNS et activez les redirections. Passez une petite commande réelle, remboursez-la et vérifiez le HTTPS, le paiement, les e-mails de confirmation et le comportement des stocks.
  8. Envoyez le nouveau sitemap dans Search Console et consultez chaque jour, pendant les premières semaines, le rapport d’indexation et les erreurs 404. Conservez l’instantané de l’ancienne base ainsi qu’une copie privée de l’ancien site pour les recherches du support.

Demandez un second avis avant le gel des données

Les étapes les plus risquées — la correspondance des identifiants, la table de redirections et l’import du delta — sont aussi les plus faciles à faire contrôler en amont. Si vous souhaitez être accompagné dans un projet de changement de plateforme, le service de migration de données e-commerce de Netalith couvre le transfert d’une boutique vers une nouvelle plateforme en préservant le SEO, avec un tarif défini selon le périmètre.

FAQ

Questions fréquentes

Une migration vers Odoo nuira-t-elle à mon SEO ?

La documentation d’Odoo indique que ce ne sera généralement pas le cas, mais aucune plateforme ne peut garantir le maintien des positions. Conservez votre contenu existant, redirigez chaque ancienne URL vers son équivalent et surveillez l’indexation dans Google Search Console. Une baisse de trafic durant les premiers jours est normale.

Puis-je importer des produits et des clients dans Odoo depuis un fichier CSV ?

Oui. L’assistant d’import accepte les fichiers .xlsx et .csv pour n’importe quel objet métier. Attribuez à chaque enregistrement un External ID unique afin de préserver les relations entre les données et de permettre à un import ultérieur de mettre à jour les fiches plutôt que de créer des doublons.

Faut-il choisir Odoo Community ou Enterprise pour une boutique migrée ?

Les deux éditions incluent les applications Website et eCommerce. Community est gratuite et auto-hébergée, sans support officiel d’Odoo S.A. : vous ou un partenaire devez donc prendre en charge les mises à niveau. Enterprise ajoute le support officiel et des outils de mise à niveau via un abonnement par utilisateur. Choisissez en fonction de la personne qui assurera la maintenance et les mises à niveau de la boutique la deuxième année.

Quelle API Odoo utiliser pour les scripts de migration ?

Sur Odoo 19 et les versions suivantes, utilisez l’API JSON-2. XML-RPC et JSON-RPC sont obsolètes, et la documentation d’Odoo 19 prévoit leur suppression dans une version majeure ultérieure. JSON-2 utilise une clé API comme bearer token.

Faut-il importer les anciennes commandes dans Odoo ?

En général, archivez-les plutôt. Importer un historique sous forme de commandes clients confirmées peut déclencher des livraisons, des factures et des écritures comptables dont vous n’avez pas besoin. Importez les commandes uniquement si les clients doivent les consulter dans le portail ou si la comptabilité en a besoin, et répétez d’abord la procédure sur un environnement de préproduction.

Combien de temps faut-il pour migrer un site e-commerce sur mesure vers Odoo ?

Cela dépend du périmètre, et non de la taille du catalogue. Le chargement de données propres sur les produits et les clients est la partie rapide. La reconstruction du tunnel de commande, de la livraison, des taxes et des fonctionnalités personnalisées, ainsi que le nettoyage de variantes désordonnées, prennent davantage de temps. Établissez donc la liste des comportements spécifiques avant d’estimer le projet.

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.