Migration Odoo : la checklist en 10 étapes pour réussir

Migrer Odoo d'une ancienne version vers une version récente n'est pas une formalité, mais ce n'est pas non plus un saut dans le vide. Avec une préparation sérieuse, la plupart des problèmes se règlent avant la mise en production. Voici la checklist que nous suivons pour préparer une migration.

Pourquoi migrer ?

• Rester sur une version supportée : Odoo ne maintient en général que les trois dernières versions, au-delà il n'y a plus de correctifs officiels.
• Corriger les failles de sécurité : une version abandonnée ne reçoit plus de correctifs, alors que l'ERP contient vos données les plus sensibles.
• Profiter des nouveautés : interface, modules, intégrations et performances s'améliorent à chaque version.
• Maîtriser la dette technique : migrer tôt vos modules personnalisés coûte moins cher que tout migrer d'un coup des années plus tard.

Les erreurs les plus fréquentes

• Migrer sans inventaire des modules personnalisés et des modules tiers.
• Travailler directement sur la base de production au lieu d'une copie.
• Découvrir trop tard qu'un module tiers n'existe pas dans la version cible.
• Ne pas comparer les chiffres comptables avant et après la migration.
• Sauter la recette par les utilisateurs et la découvrir le jour de la bascule.
• Ne pas prévoir de plan de retour arrière.

La checklist en 10 étapes

1. Inventorier votre installation

La base de tout : savoir exactement ce que vous migrez.

• Version et édition actuelles (Community ou Enterprise)
• Liste des modules installés : standard, communautaires (OCA), tiers payants, personnalisés
• Intégrations externes : e-commerce, paiement, transporteurs, comptabilité, API
• Rapports, formulaires imprimés et actions automatisées personnalisés

2. Choisir la version cible et le chemin

La migration des données se fait généralement de version majeure en version majeure. Fixez la cible et le nombre d'étapes avant de commencer.

• Version cible choisie (récente et supportée)
• Chemin de migration défini (version par version)
• Nouveautés de la version cible qui remplacent vos personnalisations repérées

3. Trier les modules personnalisés

Chaque module coûte du temps à migrer. Le meilleur module à migrer est celui que vous n'avez plus besoin de maintenir.

• Modules à conserver et à migrer
• Modules à remplacer par une fonction standard ou un module OCA
• Modules devenus inutiles à supprimer

4. Vérifier les modules tiers

Un module tiers qui n'existe pas dans la version cible bloque la migration.

• Disponibilité de chaque module tiers dans la version cible
• Alternative identifiée pour chaque module abandonné
• Licences et abonnements à jour

5. Sauvegarder et créer une copie de travail

Ne migrez jamais directement votre production.

• Sauvegarde complète de la base et des fichiers joints
• Copie de travail restaurée sur un environnement de test
• Procédure de restauration testée

6. Migrer le code spécifique

Vues, modèles, méthodes, scripts JavaScript : chaque version change des API et des conventions.

• Analyse des points de rupture dans chaque module
• Adaptation du code Python, des vues XML, du JavaScript et des styles
• Installation de chaque module sur la version cible sans erreur

7. Migrer les données

Toujours sur la copie de travail, jamais sur la production.

• Migration de la base de la version source à la version cible
• Reprise des champs et modèles personnalisés
• Enregistrements orphelins et doublons repérés

8. Contrôler les chiffres

« Le module s'installe » ne veut pas dire « les chiffres sont justes ». C'est l'étape qui protège votre comptabilité.

• Balance comptable avant et après identique
• Soldes clients et fournisseurs identiques
• Valorisation du stock et nombre d'enregistrements clés comparés
• Rapports principaux comparés sur une même période

9. Tester et faire valider par les utilisateurs

• Scénarios métier essentiels testés : vente, achat, stock, facturation, paie
• Droits d'accès et groupes de sécurité vérifiés
• Impressions, courriels et intégrations testés
• Recette signée par les utilisateurs clés

10. Préparer la bascule et le suivi

• Fenêtre d'arrêt planifiée et utilisateurs prévenus
• Plan de retour arrière prêt
• Utilisateurs formés aux changements
• Suivi après mise en ligne : corrections rapides pendant les premières semaines

Questions fréquentes

Combien de temps dure une migration ?

Cela dépend du nombre de modules personnalisés, du volume de données et de l'écart entre les versions. Une analyse préalable permet de donner un délai réaliste.

Peut-on migrer sans arrêter l'activité ?

Oui pour les essais : ils se font sur une copie. Seule la bascule finale demande une courte interruption, qu'on planifie avec les équipes.

Et si un module personnalisé ne peut pas être migré ?

Cela arrive quand il dépend d'un code qui a disparu d'Odoo. L'analyse préalable le signale et on choisit entre réécrire, remplacer par le standard ou abandonner la fonction.

Faut-il se faire accompagner ?

Pas obligatoirement, mais c'est utile dès que vous avez des modules personnalisés ou une comptabilité à contrôler. Un partenaire expérimenté évite les erreurs listées plus haut.

Et maintenant ?

Si vous voulez savoir où en est votre installation et ce qu'une migration demanderait, vous pouvez demander un devis de migration Odoo. Nous analysons d'abord votre code puis vous remettons un devis écrit. Pour toute autre question, contactez-nous. Vous êtes en Algérie ? Découvrez notre accompagnement d'intégrateur Odoo en Algérie.