Tres herramientas cubren toda la lectura. Se conceden por defecto en una clave nueva y no pueden modificar nada: su vínculo con Odoo está bloqueado en el servidor.

aidoo_query

La herramienta de búsqueda. Combina un filtro y una lectura en una sola llamada a Odoo (search_read).

Parámetro	Función	Por defecto
`model`	El modelo de Odoo afectado, por ejemplo `sale.order`	obligatorio
`domain`	El filtro, en formato de dominio de Odoo	obligatorio
`fields`	Los campos a devolver	conjunto por defecto
`limit`	Número máximo de registros	80
`offset`	Número de registros a saltar	0
`order`	La ordenación, por ejemplo `date_order desc`	orden del modelo

El dominio, en claro

Un dominio de Odoo es una lista de condiciones. El asistente las construye por ti, pero saber leerlas ayuda a comprobar que ha entendido.

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

Se lee: estado igual a «pedido confirmado» y importe superior a 10 000. Las condiciones se suman con Y por defecto.

Los operadores habituales: =, !=, >, >=, <, <=, ilike (contiene, sin distinguir mayúsculas), in, not in, child_of. Para combinar de otro modo: "&" (Y), "|" (O), "!" (NO), colocados antes de las condiciones afectadas.

Pide ver el filtro

Si un resultado te extraña, pregunta «¿qué filtro has usado?». El asistente te muestra el dominio exacto. Es la forma más rápida de detectar una mala interpretación: un estado olvidado, una fecha desplazada un día.

Paginación: por qué el asistente sabe que faltan datos

Cada respuesta contiene total_count y has_more. El asistente ve así de inmediato que su página de 80 líneas forma parte de un conjunto de 1 240, y te lo indica en vez de concluir a partir de una muestra.

Si quieres todo, dilo explícitamente («recorre todas las páginas»). Si quieres un total, no pidas la lista: pide el total, y el asistente usará aidoo_report, mucho más eficiente.

Ordenación

Mis 10 pedidos más grandes del año, de mayor a menor.

El asistente lo traduce en order: "amount_total desc" y limit: 10. Sin ordenación explícita, Odoo aplica el orden por defecto del modelo, que rara vez es el que esperas.

aidoo_read

Lee registros cuyos identificadores ya se conocen. Parámetros: model, ids, fields.

Nunca lo pedirás directamente: el asistente lo usa en un segundo momento, tras encontrar los registros con aidoo_query. Su presencia en el registro indica simplemente una lectura dirigida.

aidoo_schema

Descubre la estructura de tu base, sin leer ningún dato de negocio.

Sin argumentos: la lista de modelos accesibles
Con model: los campos de ese modelo, su tipo, sus relaciones y el hint asociado

¿Qué campos personalizados tenemos en la ficha de cliente?

Es lo que permite al asistente trabajar sobre tu Odoo, no sobre un Odoo estándar: tus campos x_*, tus modelos añadidos por un módulo sectorial, tus selecciones personalizadas.

El esquema se introspecciona, no se adivina

Aidoo lee la estructura real al conectarse y luego la refresca. Un campo añadido en Odoo se hace visible tras una nueva introspección desde Conexión Odoo → Modelos.

Formular bien una petición de lectura

Nombra el ámbito. «Los pedidos» es ambiguo; «los pedidos de venta confirmados» no lo es.

Acota el periodo. «Este mes» basta en una conversación con contexto claro, pero «entre el 1 y el 30 de junio de 2026» no deja lugar a dudas.

Di lo que quieres ver. Pedir los campos útiles («con el cliente, la fecha y el importe») evita una respuesta demasiado amplia y acelera la llamada.

Distingue lista de total. «Lístame» dispara aidoo_query; «cuántos» o «qué total» dispara aidoo_report. En una base grande, no cuestan lo mismo.

Los errores más frecuentes

Un resultado vacío aunque los datos existen

Tres causas, por orden:

Un estado no considerado: los presupuestos no son pedidos, las facturas en borrador no son facturas validadas
Los permisos de la cuenta de Odoo: puede que el usuario cuya clave API sirve para la conexión no vea esos registros
Una regla multiempresa: el registro pertenece a una empresa que esa cuenta no ve

«Model not allowed»

El modelo está bloqueado en tus ajustes de Aidoo. No es un error de Odoo, sino una regla que has puesto tú, consulta Seguridad y permisos.

Cifras que no cuadran con Odoo

Compara primero los ámbitos: Aidoo devuelve exactamente lo que pide el dominio. Una diferencia casi siempre viene de un filtro distinto al de tu vista de Odoo: divisa, empresa, estado o líneas canceladas incluidas.

Pide el dominio utilizado y compáralo con los filtros de tu pantalla de Odoo.

Siguiente paso

Informes y PDF: agregar y producir documentos
Escribir en Odoo: pasar de la consulta a la acción