Configurer Odoo
Obtenez vos identifiants API Odoo pour connecter Order Invoicer
Prérequis
Avant de commencer, assurez-vous que :
- Vous disposez d'un compte Odoo (Odoo Online ou Odoo.sh, version 15+)
- Vous avez un accès administrateur ou les droits suffisants pour créer des clés API
- Vous connaissez l'URL de votre instance Odoo (ex :
https://masociete.odoo.com)
Obtenir vos identifiants API
Order Invoicer nécessite trois informations pour se connecter à votre instance Odoo :
- L'URL de votre instance Odoo
- Le nom de la base de données
- Une clé API (API Key)
Identifiez votre URL Odoo
Votre URL Odoo est l'adresse que vous utilisez pour accéder à votre instance :
- Odoo Online :
https://masociete.odoo.com - Odoo.sh :
https://masociete.odoo.comou un sous-domaine personnalisé - On-premise : l'URL de votre serveur (ex :
https://erp.masociete.fr)
L'URL doit commencer par https://. Si votre instance n'est pas en HTTPS, contactez votre administrateur système.
Trouvez le nom de votre base de données
Le nom de la base de données dépend de votre type d'hébergement :
- Odoo Online : le nom de la base correspond généralement au sous-domaine de votre URL (ex : pour
https://masociete.odoo.com, la base estmasociete) - Odoo.sh : consultez votre tableau de bord Odoo.sh pour le nom exact
- On-premise : demandez à votre administrateur système
Pour vérifier le nom de votre base de données :
- Accédez à
https://votre-url-odoo.com/web/database/manager - La liste des bases de données disponibles s'affiche
- Notez le nom exact de votre base
Si votre instance Odoo Online est en multi-base, assurez-vous de sélectionner la bonne base de données. En cas de doute, il s'agit du sous-domaine dans votre URL.
Générez une clé API
Odoo utilise des clés API pour l'authentification sécurisée. Voici comment en créer une :
- Connectez-vous à votre instance Odoo
- Cliquez sur votre avatar en haut à droite, puis sur Mon profil (ou Préférences)
- Allez dans l'onglet Sécurité du compte
- Dans la section Clés API, cliquez sur Nouvelle clé API
- Saisissez une description (ex :
Order Invoicer) - Si l'authentification à deux facteurs est activée, saisissez votre code TOTP
- Copiez immédiatement la clé affichée
La clé API n'est affichée qu'une seule fois. Si vous la perdez, vous devrez en générer une nouvelle depuis les paramètres de sécurité de votre profil.
Si vous ne voyez pas la section « Clés API », vérifiez que votre version d'Odoo est 14 ou supérieure. Les clés API ne sont pas disponibles sur les versions antérieures.
Configurez les permissions
L'utilisateur associé à la clé API doit disposer des droits suivants dans Odoo :
Comptabilité / Facturation
- ✅ Lecture et création de factures
- ✅ Lecture et création d'avoirs
- ✅ Lecture et création de paiements
Contacts
- ✅ Lecture et création de contacts (partenaires)
Ventes (si vous synchronisez les bons de commande)
- ✅ Lecture et création de bons de commande
Produits
- ✅ Lecture des produits
Pour vérifier les droits de l'utilisateur :
- Allez dans Paramètres > Utilisateurs & Sociétés > Utilisateurs
- Sélectionnez l'utilisateur associé à la clé API
- Vérifiez que les droits ci-dessus sont attribués
Nous recommandons d'utiliser un compte administrateur ou de créer un utilisateur dédié avec les permissions nécessaires pour éviter les erreurs de droits.
Renseignez vos identifiants dans Order Invoicer
Depuis le formulaire de connexion Odoo dans Order Invoicer, renseignez :
- URL Odoo : l'URL complète de votre instance (ex :
https://masociete.odoo.com) - Nom de la base de données : le nom de votre base Odoo
- Clé API : la clé générée à l'étape précédente
Le connecteur validera automatiquement vos identifiants en interrogeant l'API Odoo et vérifiera les permissions de votre compte.
Dépannage
Erreur « Identifiants invalides »
- Vérifiez que l'URL est correcte et accessible
- Vérifiez que le nom de la base de données est exact (sensible à la casse)
- Assurez-vous que la clé API est complète et n'a pas été tronquée
Erreur « Permissions insuffisantes »
- Vérifiez les droits de l'utilisateur associé à la clé API (voir étape 4)
- Assurez-vous que les modules Comptabilité et Contacts sont installés sur votre instance
Erreur « Connexion impossible »
- Vérifiez que votre instance Odoo est accessible depuis Internet
- Si vous utilisez un pare-feu ou VPN, assurez-vous que les connexions API sont autorisées
- Vérifiez que votre instance n'est pas en maintenance
Support
Si vous rencontrez des difficultés :
- Vérifiez la section de dépannage ci-dessus
- Consultez la documentation officielle Odoo
- Contactez notre support :
contact@orderinvoicer.com