Explorador de modelos de Odoo: campos, relaciones, API

La herramienta responde a una pregunta que desarrolladores, implantadores y usuarios avanzados se hacen cada semana: ¿cómo se llama este campo en la base de datos y de dónde viene? Bastan tres pasos.

Un modelo es una clase Python que describe un tipo de registro: un contacto, una factura, una línea de pedido. El ORM (Object Relational Mapping, la capa que traduce los objetos Python en consultas SQL) crea una tabla PostgreSQL para cada modelo persistente. El modelo res.partner se guarda así en la tabla res_partner.

El nombre técnico sigue una convención sencilla: un prefijo de aplicación (sale, account, stock, hr) y una o varias palabras separadas por puntos. Los prefijos res (recursos compartidos) e ir (Information Repository, el núcleo técnico) señalan los modelos del módulo base.

Cada campo tiene un nombre técnico (partner_id), una etiqueta visible para el usuario (Cliente) y un tipo. El tipo determina lo que puede leer o escribir por la API y cómo filtrar por él.

Odoo es modular: cada aplicación añade lo que necesita a los modelos existentes, sin duplicarlos. El módulo sale, por ejemplo, añade los pedidos de un contacto a res.partner. La ficha indica, para cada campo, el módulo que lo declara. Conviven tres mecanismos.

El explorador describe Odoo estándar. Para comprobar un campo en su base, active el modo de desarrollador: Ajustes y luego «Activar el modo de desarrollador», o añada ?debug=1 a la dirección. Pase el ratón sobre una etiqueta de formulario: una ayuda emergente muestra el nombre técnico del campo y su modelo.

El menú Ajustes > Técnico > Estructura de la base de datos > Modelos lista además todos los modelos instalados, incluidos sus módulos propios y los campos creados con Studio (prefijo x_studio_).

Odoo 19 introduce la API JSON-2: una petición POST a /json/2/<modelo>/<método>, autenticada con una clave API enviada en la cabecera Authorization. Cada ficha del explorador ofrece un ejemplo listo para copiar en curl y en Python con campos reales del modelo. El método fields_get devuelve la definición de los campos de su base, personalizaciones incluidas.

Las claves API se crean en Preferencias > Seguridad de la cuenta, con una validez máxima de tres meses. Según la documentación de Odoo, el acceso a la API externa está reservado al plan Custom: no está disponible en los planes One App Free y Standard.

Las fichas se generan a partir del código fuente de Odoo 19 Community (build pública del 28 de agosto de 2026, licencia LGPL v3): 395 módulos instalables analizados sin ejecutar Odoo. Se excluyen las localizaciones extranjeras y los módulos de prueba; se conservan las localizaciones francesas. Las etiquetas y ayudas en español y francés proceden de los archivos de traducción oficiales de Odoo.

No figuran aquí: los módulos Enterprise, sus módulos propios, los campos de Studio y las listas de selección calculadas dinámicamente. Para consultar el esquema real de SU base, Aidoo lee la estructura de sus modelos y responde en lenguaje natural. ¿Prepara un cambio de versión? Consulte nuestra página de migración a Odoo 19.