Odoo

Odoo est un ERP open source qui propose un module Documents pour la gestion de fichiers. Connecter Odoo à Ordalie permet d'accéder aux documents et dossiers stockés dans votre instance Odoo directement depuis l'assistant IA, les workflows et le système de mentions @.

Contrairement à la plupart des intégrations, l'intégration Odoo supporte aussi l'écriture : envoi de fichiers et création de dossiers dans Odoo, si le mount est configuré en lecture-écriture.

Qui peut configurer

Administrateurs de l'organisation uniquement, depuis Paramètres > Organisation > Intégrations. C'est une intégration au niveau organisation partagée avec tous les membres autorisés.

Guide de configuration

Étape 1 : Obtenir une clé API Odoo

L'intégration utilise une clé API Odoo pour s'authentifier. Pour en générer une :

  1. Connectez-vous à votre instance Odoo en tant qu'utilisateur avec accès au module Documents.
  2. Allez dans Paramètres > Utilisateurs > [votre utilisateur] > Préférences.
  3. Dans la section Clés API (ou Account Security), cliquez sur Nouvelle clé API.
  4. Donnez-lui un libellé (ex : "Ordalie") et copiez la clé générée.

La clé API doit appartenir à un utilisateur ayant les droits de lecture (et d'écriture si nécessaire) sur le module Documents d'Odoo.

Étape 2 : Configurer dans Ordalie

  1. Allez dans Paramètres > Organisation > Intégrations.
  2. Cliquez sur Ajouter à côté d'Odoo.
  3. Remplissez la configuration :
    • Nom : Un libellé pour cette connexion (ex : "Odoo Documents").
    • URL de base : L'URL de votre instance Odoo (ex : https://votreentreprise.odoo.com).
    • Base de données : Le nom de la base de données Odoo (optionnel — nécessaire si l'instance héberge plusieurs bases).
    • Clé API : La clé API générée à l'étape 1.
    • Niveau d'accès : Lecture seule ou Lecture-écriture.
  4. Cliquez sur Créer le mount.
  5. Ordalie valide la connexion en listant les documents disponibles.

Étape 3 : Commencer à utiliser vos documents

Une fois connecté :

  • Parcourez vos dossiers Odoo via le panneau workspace ou le système @.
  • Recherchez des documents par nom.
  • Analysez les fichiers avec l'assistant IA.
  • Envoyez des fichiers vers Odoo et créez des dossiers (si configuré en lecture-écriture).

Fonctionnement

Ordalie se connecte à l'API JSON v2 d'Odoo (/json/2/) pour interagir avec le modèle documents.document :

  • Authentification : Clé API transmise en bearer token. Un en-tête X-Odoo-Database est ajouté si le nom de base est renseigné.
  • Listing : Requêtes search_read paginées sur documents.document, triées par date de modification décroissante.
  • Navigation par dossiers : Les dossiers Odoo (type folder) sont navigables. Cliquer sur un dossier filtre les documents par folder_id.
  • Lecture de fichiers : Les fichiers sont récupérés par ordre de priorité : payload base64 inline, lecture de l'attachment ir.attachment, ou téléchargement HTTP via /web/content/.
  • Écriture : Création de documents via create ou mise à jour via write sur documents.document. Les fichiers sont envoyés en base64.
  • Compatibilité : L'intégration utilise des jeux de champs dégradés (fallback) pour fonctionner avec différentes versions du module Documents d'Odoo.

Référence de configuration

Champ Obligatoire Description
Nom Oui Nom d'affichage de la connexion
URL de base Oui URL de l'instance Odoo
Base de données Non Nom de la base de données (requis si multi-bases)
Clé API Oui Clé API d'un utilisateur avec accès au module Documents
Niveau d'accès Oui Lecture seule ou Lecture-écriture

Opérations supportées

Opération Disponible Notes
Parcourir les dossiers Oui Listing paginé, tri par date de modification
Recherche par nom Oui Recherche insensible à la casse (ilike)
Lire/télécharger des fichiers Oui Jusqu'à 64 Mo par fichier
Envoyer des fichiers Configurable Requiert le mode lecture-écriture
Créer des dossiers Configurable Requiert le mode lecture-écriture
Supprimer Non Non supporté

Questions fréquentes

Q : Quelles versions d'Odoo sont supportées ? R : L'intégration utilise l'API JSON v2 (/json/2/) et des jeux de champs dégradés pour s'adapter à différentes versions du module Documents. Elle est testée avec Odoo 16+ mais peut fonctionner avec des versions antérieures disposant du module Documents.

Q : Ai-je besoin du module Documents d'Odoo ? R : Oui. L'intégration interroge le modèle documents.document, qui fait partie du module Documents (et non le module standard de gestion de fichiers). Si votre instance n'a pas ce module installé, l'intégration ne fonctionnera pas.

Q : Puis-je restreindre l'accès à certains dossiers Odoo ? R : Les droits d'accès sont déterminés par l'utilisateur Odoo dont la clé API est utilisée. Si cet utilisateur n'a accès qu'à certains dossiers dans Odoo, seuls ces dossiers seront visibles dans Ordalie.

Q : Les fichiers envoyés depuis Ordalie apparaissent-ils dans Odoo ? R : Oui. Lorsque le mount est en lecture-écriture, les fichiers créés ou modifiés depuis Ordalie apparaissent dans le module Documents d'Odoo avec leur dossier parent, leur nom et leur type MIME préservés.

Dernière mise à jour le 22 février 2026