Configuration de la connexion Odoo

Ce guide vous explique comment vérifier votre base, créer une clé API et connecter la base à LinkyFlow pour charger votre comptabilité, vos ventes, vos achats et vos contacts dans Excel ou dans l'application web.

Prérequis

Une base sous Odoo 19 ou ultérieur, car LinkyFlow utilise son API externe JSON-2. Une adresse où aucune API JSON-2 ne répond est refusée.
Une offre Odoo donnant accès à l'API externe. La grille tarifaire d'Odoo l'indique sur l'offre Custom, pas sur One App Free ni Standard. LinkyFlow n'a pas été testé sur ces deux offres, ni sur Odoo.sh : vérifiez votre offre avant de compter dessus. Là où l'API est fermée, la connexion ne peut pas fonctionner.
Une adresse servie en https://. Un serveur qui héberge plusieurs bases doit en choisir une d'après son nom d'hôte : LinkyFlow ne désigne pas de base.
Un utilisateur Odoo qui peut lire et écrire ce que LinkyFlow doit lire et écrire : la clé agit comme cet utilisateur, règles d'enregistrement comprises, dans sa société par défaut

Étape 1 — Créer une clé API

Les noms ci-dessous sont ceux d'Odoo en anglais.

Dans Odoo, cliquez sur votre avatar, puis sur Preferences → Account Security → New API Key.
Nommez-la LinkyFlow.
Pour sa durée, choisissez Persistent Key si vous êtes administrateur, sinon la plus longue proposée par Odoo. Quand une clé expire, Odoo refuse les appels de LinkyFlow jusqu'à ce que vous la remplaciez, et LinkyFlow ne peut pas la renouveler.
Confirmez votre mot de passe, puis copiez la clé. Elle n'est affichée qu'une fois. Un mot de passe ne la remplace jamais.

Étape 2 — Ajouter la connexion dans LinkyFlow

Dans Excel ou l'application web, ouvrez Connexions → Ajouter une connexion.
Choisissez Odoo dans la liste des fournisseurs.
Collez l'API Key et l'Instance URL : l'adresse affichée par votre navigateur, comme https://mycompany.odoo.com. Une page du client web d'Odoo est ramenée à son adresse ; tout autre chemin est refusé.
Enregistrez.

À l'enregistrement ou à la synchronisation de la connexion, LinkyFlow lit ce que l'utilisateur de la clé peut faire, modèle par modèle : rien n'est écrit pour le savoir. Un droit que l'utilisateur n'a pas est affiché comme non accordé, et les autres continuent de fonctionner ; un utilisateur sans aucun droit lu par LinkyFlow est refusé. Une application absente de votre base est dite de la même façon : sans l'application Inventaire, le stock n'est pas proposé et l'agent Stock Sync le dit, et tout le reste continue de fonctionner ; installez l'application, puis synchronisez. La première synchronisation nomme la connexion d'après votre société.

Si la connexion est refusée

Si LinkyFlow indique que l'adresse ne sert aucune API Odoo 19, vérifiez l'adresse et la version de votre base. Si LinkyFlow indique que la clé est refusée, elle a été révoquée, elle a expiré ou elle appartient à une autre base : créez une nouvelle clé dans Odoo et modifiez la connexion. Si une requête est indiquée comme indisponible, l'application qu'elle lit n'est pas installée dans votre base, Ventes ou Achats par exemple : installez-la dans Odoo, puis synchronisez la connexion.

Quand la clé expire

À chaque synchronisation, LinkyFlow lit la date de la clé et vous avertit à partir de 7 jours avant, dans la liste des connexions et sur la page de la connexion. Il sait quelle clé est la vôtre quand l'utilisateur n'en a qu'une, ou une seule encore valide : avec plusieurs, il indique qu'il ne le sait pas. Une clé par intégration garde l'avertissement.

Étape 3 — Charger votre première requête

Insérez une requête LinkyFlow et choisissez le fournisseur Odoo.
Choisissez Invoices, sélectionnez votre connexion dans le champ Link, puis exécutez-la — les 100 premières factures se chargent par défaut, et une page en contient jusqu'à 200.
Utilisez les flèches pour naviguer, ou choisissez Tous les résultats pour lire les pages à la suite : au plus 200 pages de 200 lignes, et LinkyFlow indique quand il s'est arrêté là.

LinkyFlow conserve la clé API côté serveur : elle n'est plus jamais affichée, ni envoyée à un assistant IA.