Trois outils couvrent toute la lecture. Ils sont accordés par défaut sur une clé neuve et ne peuvent rien modifier : leur liaison à Odoo est verrouillée côté serveur.

aidoo_query

L'outil de recherche. Il combine un filtre et une lecture en un seul appel Odoo (search_read).

Paramètre	Rôle	Défaut
`model`	Le modèle Odoo visé, `sale.order` par exemple	requis
`domain`	Le filtre, au format domaine Odoo	requis
`fields`	Les champs à retourner	jeu par défaut
`limit`	Nombre maximum d'enregistrements	80
`offset`	Nombre d'enregistrements à sauter	0
`order`	Le tri, `date_order desc` par exemple	ordre du modèle

Le domaine, en clair

Un domaine Odoo est une liste de conditions. L'assistant les construit pour vous, mais savoir les lire aide à vérifier qu'il a compris.

[["state", "=", "sale"], ["amount_total", ">", 10000]]

Se lit : état égal à « commande confirmée » et montant supérieur à 10 000. Les conditions s'additionnent en ET par défaut.

Les opérateurs courants : =, !=, >, >=, <, <=, ilike (contient, insensible à la casse), in, not in, child_of. Pour combiner autrement : "&" (ET), "|" (OU), "!" (NON), placés avant les conditions concernées.

Demandez à voir le filtre

En cas de doute sur un résultat, demandez « quel filtre as-tu utilisé ? ». L'assistant vous montre le domaine exact. C'est le moyen le plus rapide de repérer une mauvaise interprétation : un statut oublié, une date décalée d'un jour.

Pagination : pourquoi l'assistant sait qu'il en manque

Chaque réponse contient total_count et has_more. L'assistant voit donc immédiatement que sa page de 80 lignes fait partie d'un ensemble de 1 240, et vous le signale au lieu de conclure sur un échantillon.

Si vous voulez tout : demandez-le explicitement (« parcours toutes les pages »). Si vous voulez un total, ne demandez pas la liste, demandez le total, et l'assistant utilisera aidoo_report, bien plus efficace.

Tri

Mes 10 plus grosses commandes de l'année, de la plus élevée à la plus faible.

L'assistant traduit en order: "amount_total desc" et limit: 10. Sans tri explicite, Odoo applique l'ordre par défaut du modèle, qui est rarement celui que vous attendez.

aidoo_read

Lit des enregistrements dont les identifiants sont déjà connus. Paramètres : model, ids, fields.

Vous ne le demanderez jamais directement : l'assistant l'utilise en second temps, après avoir trouvé les enregistrements avec aidoo_query. Sa présence dans le journal signale simplement une lecture ciblée.

aidoo_schema

Découvre la structure de votre base, sans lire aucune donnée métier.

Sans argument : la liste des modèles accessibles
Avec model : les champs de ce modèle, leur type, leurs relations, et le hint associé

Quels champs personnalisés avons-nous sur la fiche client ?

C'est ce qui permet à l'assistant de travailler sur votre Odoo, pas sur un Odoo standard : vos champs x_*, vos modèles ajoutés par un module métier, vos sélections personnalisées.

Le schéma est introspecté, pas deviné

Aidoo lit la structure réelle à la connexion, puis la rafraîchit. Un champ ajouté dans Odoo devient visible après une réintrospection depuis Connexion Odoo → Modèles.

Bien formuler une demande de lecture

Nommez le périmètre. « Les commandes » est ambigu ; « les commandes de vente confirmées » ne l'est pas.

Bornez la période. « Ce mois-ci » suffit dans une conversation où le contexte est clair, mais « entre le 1er et le 30 juin 2026 » ne laisse aucune place au doute.

Dites ce que vous voulez voir. Demander les champs utiles (« avec le client, la date et le montant ») évite une réponse trop large et accélère l'appel.

Distinguez liste et total. « Liste-moi » déclenche aidoo_query ; « combien » ou « quel total » déclenche aidoo_report. Les deux ne coûtent pas la même chose sur une grosse base.

Les erreurs les plus fréquentes

Un résultat vide alors que les données existent

Trois causes, dans l'ordre :

Un statut non pris en compte : les devis ne sont pas des commandes, les factures brouillon ne sont pas des factures validées
Les droits du compte Odoo : l'utilisateur dont la clé API sert à la connexion ne voit peut-être pas ces enregistrements
Une règle multi-société : l'enregistrement appartient à une société que ce compte ne voit pas

« Model not allowed »

Le modèle est bloqué dans vos réglages Aidoo. Ce n'est pas une erreur Odoo mais une règle que vous avez posée, voir Sécurité et permissions.

Des chiffres qui ne collent pas avec Odoo

Comparez d'abord les périmètres : Aidoo restitue exactement ce que le domaine demande. Un écart vient presque toujours d'un filtre différent de celui de votre vue Odoo, devise, société, statut, ou lignes annulées incluses.

Demandez le domaine utilisé, et comparez-le aux filtres de votre écran Odoo.

Étape suivante

Rapports et PDF : agréger et produire des documents
Écrire dans Odoo : passer de la consultation à l'action