CARONNA OdooL'intégrateur Odoo par IA

CARONNA Odoo / Blog / Modules et technique

Modules et technique

Comprendre une erreur Odoo et la corriger : le guide pour non-développeurs

Publié le 22 novembre 2026 · 7 min de lecture

Un message rouge en plein milieu d'une facture ou d'une commande suffit à bloquer une équipe, même quand la cause est simple. Voici comment lire ces messages, repérer les causes les plus courantes et savoir quand passer la main.

Une erreur Odoo qui surgit au moment de valider une facture ou une commande donne l'impression que tout est cassé. En réalité, la plupart de ces messages disent assez clairement ce qui ne va pas, à condition de savoir où regarder. Cet article vous donne une méthode simple, sans notion de programmation, pour comprendre le message et choisir la bonne correction.

Que faire dès qu'une erreur Odoo apparaît à l'écran

Le premier réflexe est de ne pas fermer la fenêtre trop vite. Le message contient souvent l'information utile. Avant de cliquer ailleurs :

  1. Faites une capture d'écran du message complet, avec le menu et la page visibles derrière.
  2. Notez ce que vous faisiez : quel document, quel bouton, quel utilisateur, à quelle heure.
  3. Cherchez un bouton de détails (souvent nommé « Détails » ou « Copier l'erreur complète », selon la version). Il affiche le texte technique, que vous pourrez coller dans un message.
  4. Essayez avec un autre enregistrement (une autre facture, un autre client). Si l'erreur disparaît, le problème vient des données de la fiche, pas du système.
  5. Vérifiez si un collègue obtient la même erreur. Si oui, la cause est probablement commune. Si non, pensez aux droits d'accès.

Ces cinq gestes prennent quelques minutes et rendent le diagnostic bien plus rapide, que vous le fassiez vous-même ou que quelqu'un d'autre s'en charge.

Les grandes familles de messages et ce qu'elles signifient

Les intitulés exacts changent selon la version d'Odoo et la langue, mais on retrouve quelques familles récurrentes.

  • Erreur d'accès (« Access Error ») : votre utilisateur n'a pas le droit de lire, modifier, créer ou supprimer ce type de document. Le message cite en général le nom du document concerné et parfois les groupes autorisés.
  • Erreur de validation (« Validation Error ») : une règle métier n'est pas respectée. Par exemple, une donnée obligatoire manque ou deux valeurs sont incompatibles.
  • Erreur utilisateur (« User Error ») : Odoo vous explique volontairement ce qu'il faut faire, par exemple « configurez d'abord un compte comptable ». C'est la plus facile à traiter : lisez et suivez la consigne.
  • Enregistrement manquant (« Missing Record ») : vous essayez d'ouvrir ou de modifier une fiche qui a été supprimée entre-temps, souvent par un autre utilisateur ou par une automatisation.
  • Erreur serveur (« Odoo Server Error ») : une fenêtre avec un bloc de texte technique. C'est la plus intimidante, mais elle se lit plus facilement qu'on ne le croit (voir la section suivante).

Une erreur qui contient des phrases comme « null value in column » ou « duplicate key » vient de la base de données, c'est-à-dire l'endroit où Odoo range toutes ses informations. La première signale qu'un champ obligatoire est resté vide. La seconde indique qu'on essaie d'enregistrer une valeur qui doit être unique alors qu'elle existe déjà (une référence, un code, un identifiant).

Lire un message technique sans être développeur

Le bloc de texte d'une erreur serveur s'appelle une « trace » : c'est la liste des étapes que le programme a traversées avant de s'arrêter. Vous n'avez pas besoin de tout comprendre. Deux endroits suffisent.

La dernière ligne est la plus utile. Elle donne le type de problème et souvent une phrase lisible. Quelques exemples de ce que vous pouvez y trouver :

  • Un nom de champ introuvable (le message contient souvent « field » ou « does not exist ») : un champ a été supprimé ou renommé, mais une vue, un rapport ou une action automatique le réclame encore.
  • Un message sur plusieurs enregistrements alors qu'un seul était attendu (« Expected singleton ») : un traitement a été prévu pour une seule fiche et a reçu une sélection multiple.
  • Une clé introuvable ou un élément vide : une donnée attendue n'est pas renseignée.

Les noms qui reviennent sont le deuxième indice. Un nom de module, de modèle (le type de document, par exemple une commande ou une facture) ou de champ vous indique où chercher. S'il s'agit d'un module que vous avez installé ou personnalisé, c'est un très bon point de départ.

Pour afficher plus d'informations dans l'interface, vous pouvez activer le mode développeur. Il s'active dans les paramètres ou en ajoutant `?debug=1` à l'adresse de la page, selon la version. Il révèle les noms techniques des champs au survol et donne accès à des menus supplémentaires. Il ne modifie rien par lui-même, mais vérifiez la procédure exacte pour votre version.

Les causes fréquentes et comment les corriger

Voici les situations les plus courantes, avec la piste de correction à essayer en premier. Les noms de menus varient selon la version : vérifiez-les sur votre instance.

1. Un droit d'accès manquant. Ouvrez la fiche de l'utilisateur concerné dans les paramètres, section utilisateurs, et regardez ses droits d'accès pour l'application en cause. Ajoutez-lui le niveau nécessaire, ou demandez à un collègue qui a les droits d'effectuer l'opération. Évitez de donner des droits d'administrateur « pour que ça passe » : c'est rapide, mais cela ouvre beaucoup trop largement l'accès.

2. Un champ obligatoire vide. Repérez le champ cité dans le message, renseignez-le, puis recommencez. Si l'erreur se produit lors d'un import de fichier, vérifiez que la colonne correspondante est bien remplie sur toutes les lignes.

3. Un doublon. Cherchez dans la liste le document ou la fiche qui porte déjà la même valeur. Selon le cas, modifiez la valeur ou fusionnez les doublons si votre version propose cette fonction.

4. Une erreur apparue juste après une mise à jour ou l'ajout d'un module. C'est un cas classique : une personnalisation faite sur mesure ne correspond plus à la nouvelle structure. Notez la date du changement, car elle oriente tout le diagnostic. Si possible, reproduisez le problème sur une copie de la base (un environnement de test) avant de toucher à la production.

5. Une incohérence entre sociétés. Si vous gérez plusieurs sociétés dans la même base, un document peut mélanger des éléments appartenant à des sociétés différentes (un client, un compte, un entrepôt). Le message le mentionne en général. Vérifiez la société active en haut de l'écran et celle des éléments utilisés.

6. Un champ ou une règle ajoutée à la main. Les règles automatiques, les vues modifiées et les champs personnalisés sont des sources fréquentes d'erreurs. Désactivez temporairement la règle suspecte sur une copie de test, vérifiez que l'erreur disparaît, puis corrigez-la proprement.

Une précaution vaut pour toutes ces corrections : ne supprimez jamais un champ, une vue ou une donnée pour « voir si ça marche ». Ce type d'action est difficile à défaire. Préférez désactiver, tester sur une copie et garder une trace de ce que vous avez changé.

Quand l'IA de CARONNA peut vous faire gagner du temps

Si la cause est dans un paramétrage, un champ, une vue, une action automatisée ou un droit, vous pouvez la faire examiner par l'IA de CARONNA. Vous branchez votre Odoo, vous décrivez le problème en français (« les commerciaux n'arrivent plus à confirmer un devis depuis jeudi ») et l'IA propose une correction de paramétrage. Si vous le souhaitez, l'extension Chrome lui permet de voir l'écran où le message s'affiche, ce qui évite de tout recopier.

Les garde-fous sont ceux qui comptent dans ce genre de situation :

  • vous choisissez entre mode test et mode production ;
  • toute action irréversible demande votre accord explicite ;
  • un journal complet garde chaque modification, avec possibilité de l'annuler.

Cela ne dispense pas de relire ce qui est proposé : vous restez décisionnaire. Et certaines erreurs, notamment celles liées à l'hébergement ou à du code que vous ne maîtrisez pas, peuvent exiger l'intervention de la personne qui administre votre serveur. L'IA est incluse dans l'abonnement ; pour estimer ce que cela peut représenter pour votre équipe, consultez la section gain de temps. Pour voir le fonctionnement sur un cas concret, la démonstration est le plus simple. Et si vous souhaitez directement essayer avec votre base, rendez-vous sur l'application.

Votre checklist à appliquer dès aujourd'hui

Sans rien installer, vous pouvez dès maintenant :

  1. Créer un document partagé où l'équipe colle la capture, l'heure, l'utilisateur et l'action en cours à chaque erreur.
  2. Repérer les trois erreurs qui reviennent le plus souvent et les classer dans les familles ci-dessus.
  3. Vérifier qui possède quels droits sur les applications sensibles (ventes, achats, comptabilité).
  4. Demander à votre administrateur si une copie de test de votre base existe, ou en créer une.
  5. Noter la date de chaque mise à jour ou ajout de module, pour relier plus vite une erreur à son origine.

Une erreur n'est pas toujours un incident grave : c'est souvent Odoo qui vous signale qu'une règle, un droit ou une donnée n'est pas en place. Plus vous prenez l'habitude de lire le message calmement, plus ces blocages deviennent des corrections de quelques minutes.

Votre intégrateur Odoo, disponible tout de suite

Branchez votre Odoo et décrivez votre besoin en français : l'IA paramètre, connecte et vérifie, avec votre accord pour chaque action sensible. IA incluse, dès 149 € par mois.

À lire ensuite