Odoo 18: extender modelos y vistas sin modificar el core

Punto de venta real en una tienda con terminal de pagos
Fotografía de SumUp · Unsplash (licencia gratuita). Contexto empresarial de ERP y POS; no interfaz de Odoo. · Ver imagen original

Añadir un campo al formulario de contactos parece una tarea de interfaz: buscar el elemento en XML e insertar otro después. En Odoo esa modificación atraviesa varias capas. El campo debe existir en el modelo; el addon debe declarar sus dependencias; la vista heredada debe localizar el nodo correcto; la operación ha de respetar los permisos del usuario; y una actualización del módulo tiene que poder aplicar la extensión sin alterar el código del producto.

Por eso la regla «no edites el core» es necesaria, pero insuficiente. Una personalización mantenible depende de contratos entre módulos, modelos, vistas, seguridad y assets. Este análisis se limita a Odoo 18.0; no presupone que los mismos selectores XML ni las APIs internas permanezcan iguales en 17, 19 o una futura versión.

Capas de extensión de Odoo 18: manifiesto, modelo Python, vista XML y seguridad.
Diagrama editorial original. Las personalizaciones del módulo se separan de los archivos originales del núcleo.

Qué significa realmente heredar en Odoo

Odoo dispone de varios mecanismos que comparten la palabra herencia, pero cumplen funciones diferentes:

MecanismoQué modificaCuándo conviene
_inherit = 'res.partner' sin _nameAmplía el modelo existenteAñadir campos o comportamiento a contactos
_name junto con _inheritCrea un modelo nuevo basado en otroSe necesita una entidad distinta con comportamiento heredado
_inherits = {'otro.modelo': 'campo_id'}Delega campos mediante relacionesComposición entre modelos, con limitaciones documentadas
inherit_id en ir.ui.viewAplica instrucciones a una vista base o heredadaExtender formularios, listas y otras vistas

No son alternativas intercambiables. _inherits realiza delegación, y la documentación del ORM de Odoo 18 advierte que los métodos no se heredan como los campos y que la herencia delegada encadenada tiene limitaciones. Para añadir una propiedad a res.partner, la extensión in place mediante _inherit suele ser la vía directa.

Ilustración conceptual de extensión de modelos y vistas en Odoo 18: herencia Python, XML y control de acceso.
Ilustración conceptual original: síntesis visual del tema del artículo, no captura ni prueba ejecutada.

Un addon mínimo y una dependencia explícita

Tomemos una personalización deliberadamente pequeña: añadir una nota logística opcional a un contacto. No introduce un modelo independiente ni requiere exponer información confidencial. El directorio del addon puede organizarse así:

partner_operations/
├── __init__.py
├── __manifest__.py
├── models/
│   ├── __init__.py
│   └── res_partner.py
└── views/
    └── res_partner_views.xml

El manifiesto declara qué módulo necesita para funcionar y qué XML carga:

# partner_operations/__manifest__.py
{
    'name': 'Partner Operations Notes',
    'version': '18.0.1.0.0',
    'depends': ['base'],
    'data': [
        'views/res_partner_views.xml',
    ],
    'installable': True,
    'application': False,
}

En este ejemplo la dependencia base es suficiente porque se extiende res.partner y su formulario base. Un addon que herede una vista de sale, stock o point_of_sale debe incluir el módulo dueño de esa vista entre sus dependencias. El orden de carga no se resuelve adivinando una prioridad XML; depende del grafo de módulos declarado en depends. Véase Module Manifests, Odoo 18.

Los __init__.py importan el paquete de modelos y su archivo:

# partner_operations/__init__.py
from . import models

# partner_operations/models/__init__.py
from . import res_partner

El campo existe antes de referenciarlo en la vista:

# partner_operations/models/res_partner.py
from odoo import fields, models


class ResPartner(models.Model):
    _inherit = 'res.partner'

    logistics_note = fields.Char(string='Nota logística')

Esto añade un atributo al modelo existente. No se debe confundir con crear una tabla nueva mediante _name. Tampoco significa que todos los usuarios puedan leer o modificar el campo: sus permisos siguen dependiendo de los mecanismos de seguridad del modelo y, si se configura, de los grupos permitidos para el campo.

Herencia de vistas: localizar y aplicar cambios

La vista original del formulario de contactos se declara con el identificador base.view_partner_form en el código de Odoo 18. El siguiente ejemplo introduce logistics_note después del primer nodo email encontrado por el localizador XPath:

<!-- partner_operations/views/res_partner_views.xml -->
<odoo>
  <record id="view_partner_form_operations_note" model="ir.ui.view">
    <field name="name">res.partner.form.operations.note</field>
    <field name="model">res.partner</field>
    <field name="inherit_id" ref="base.view_partner_form"/>
    <field name="arch" type="xml">
      <xpath expr="//field[@name='email']" position="after">
        <field name="logistics_note"/>
      </xpath>
    </field>
  </record>
</odoo>

Qué se verificó: el repositorio oficial odoo/odoo, rama 18.0, contiene el registro view_partner_form y un campo email en esa vista. Qué no se verificó: la instalación de este addon, el resultado de la vista combinada en una base real y su interacción con otros módulos que heredan el mismo formulario. En una instancia con addons adicionales, el resultado final depende de la secuencia de herencia y de las modificaciones ya aplicadas.

inherit_id no copia la vista entera. El sistema parte de la vista padre resuelta y aplica las especificaciones de las vistas extendidas, también de forma recursiva; las prioridades influyen en el orden entre extensiones. El manual de View Records, Odoo 18 explica esa resolución.

Un XPath estable no es necesariamente el más largo

Una expresión global como //field[@name='email'] puede ser suficiente si hay una única coincidencia en la arquitectura combinada prevista, pero es frágil si otra extensión introduce un campo con el mismo nombre. La documentación precisa que el localizador XPath de herencia aplica la primera coincidencia. Más precisión es útil cuando responde a una estructura comprobada, no cuando añade rutas posicionales como group[3]/group[2] que cambian con pequeñas modificaciones de UI.

La estrategia práctica es inspeccionar la vista combinada de la base objetivo, elegir un ancla semántica que realmente exista y registrar por qué se eligió. El ejemplo anterior es un punto de partida pedagógico, no una promesa de compatibilidad universal.

after, attributes, replace y move

Los cambios más comunes no tienen el mismo impacto:

  • before, after e inside insertan contenido respecto del nodo localizado.
  • attributes modifica atributos sin sustituir el elemento entero.
  • replace reemplaza el nodo localizado y puede eliminar comportamiento añadido por otras extensiones.
  • move permite reubicar elementos según la sintaxis de herencia documentada en Odoo 18.

Por ejemplo, cambiar solo la etiqueta visible de un campo puede expresarse con attributes:

<xpath expr="//field[@name='email']" position="attributes">
  <attribute name="string">Correo principal</attribute>
</xpath>

Esto modifica el aspecto de la vista; no renombra el campo ORM y no establece permisos. Un required, invisible o readonly en XML puede condicionar el comportamiento de esa interfaz, pero no debe convertirse en la única garantía de una regla de negocio o seguridad. Si la restricción importa fuera del formulario, hay que diseñarla también en la capa que procesa las operaciones.

Reemplazar un nodo grande con position="replace" puede funcionar hoy y bloquear una modificación posterior de Odoo o de otro addon. Conviene reservarlo para casos en que el cambio sea estructural y esté cubierto por pruebas de actualización.

Seguridad: ACL, reglas de registro y campos

Un error habitual consiste en añadir un campo invisible="1" y considerar protegida la información. Ocultar un control no es controlar el acceso a los datos. Odoo aplica seguridad en varias capas:

ACL (ir.model.access). Determinan qué grupos pueden efectuar operaciones de creación, lectura, escritura y eliminación sobre un modelo. Son permisos de modelo y se conceden de forma aditiva según los grupos del usuario; no filtran filas individuales.

Record rules (ir.rule). Filtran qué registros puede usar una operación determinada. Las reglas globales y las asociadas a grupos se combinan con semánticas distintas; una regla ausente no equivale a un permiso adicional de modelo. Su diseño debe probarse con usuarios reales de cada rol.

Acceso de campos. Un campo ORM puede restringirse por groups. El sistema controla su exposición en operaciones y metadata; no basta con esconderlo visualmente.

Métodos de negocio. Un método público que recibe IDs y argumentos por RPC no debe tratar esos datos como confiables. sudo() puede alterar de forma importante el contexto de permisos; un flujo que lo utiliza tiene que justificar por qué eleva privilegios y limitar estrictamente los registros y acciones afectados. El capítulo oficial de seguridad de Odoo 18 documenta estos riesgos.

En el addon de la nota logística no creamos un modelo nuevo; por ello no necesitamos declarar una nueva ACL únicamente por añadir un campo a res.partner. La política existente del modelo sigue siendo relevante. Si el negocio exige que la nota sea confidencial, eso ya requiere una decisión de grupos y pruebas de acceso, no solo un atributo de vista.

Assets y Owl: otra forma de extensión, otra frontera

Cuando la personalización requiere JavaScript, CSS, templates o componentes Owl, ya no basta con heredar un formulario. En Odoo 18 los archivos se agregan a bundles mediante la clave assets del manifiesto. Las operaciones append, prepend, before, after, replace, remove e include tienen reglas de orden; por ejemplo, apuntar con before a un asset aún no declarado puede fallar. Consulta Assets, Odoo 18.

Un ejemplo independiente del campo del apartado anterior sería declarar un módulo JavaScript existente dentro del bundle backend:

# Fragmento conceptual del diccionario __manifest__.py.
# Solo incluirlo cuando el archivo exista realmente.
{
    'assets': {
        'web.assets_backend': [
            'partner_operations/static/src/js/backend_extension.js',
        ],
    },
}

Ese archivo no forma parte del addon mínimo descrito arriba y no debe agregarse al manifiesto hasta existir realmente. Tampoco todo cambio de UI necesita un patch Owl: la herencia de vista declarativa suele tener menor superficie de mantenimiento cuando el requisito es insertar o reordenar campos.

Un componente Owl, un patch de comportamiento y una extensión de vista XML afectan capas distintas. Antes de escribir JavaScript, hay que identificar si el objetivo es datos ORM, composición XML, interacción cliente o servicio transversal. El costo de un patch no se mide solo por su longitud: también cuenta cuánto depende de APIs internas que pueden cambiar al actualizar la versión.

Actualizaciones y pruebas: verificar la vista combinada

Una personalización se considera mantenible cuando resiste una actualización compatible y permite detectar fallos antes de que el usuario abra el formulario. La estrategia recomendada para este ejemplo es:

  1. Instalar el módulo en una base de pruebas, nunca en producción como primer intento.
  2. Inspeccionar la vista resultante de res.partner y confirmar que logistics_note aparece donde se espera.
  3. Probar creación y escritura del campo desde el ORM con los roles pertinentes.
  4. Actualizar el addon en una copia de la base y comprobar si las expresiones XPath siguen resolviendo.
  5. Ejecutar pruebas de regresión de los flujos que otros módulos hayan añadido al mismo formulario.

Una prueba ORM aislada puede comprobar que el campo existe y almacena el valor:

# tests/test_partner_note.py — requiere package tests/__init__.py
from odoo.tests.common import TransactionCase


class TestPartnerOperations(TransactionCase):
    def test_logistics_note_is_stored(self):
        partner = self.env['res.partner'].create({
            'name': 'Contacto de pruebas',
            'logistics_note': 'Entregar en recepción',
        })
        self.assertEqual(partner.logistics_note, 'Entregar en recepción')

Esto no prueba que el XPath se haya aplicado ni que los grupos tengan los permisos correctos: esas condiciones necesitan pruebas específicas o inspección de la vista combinada con un usuario de prueba. El snippet no fue ejecutado aquí y, para cargar el test, también habría que añadir los imports adecuados en el paquete tests y en el __init__.py del módulo.

Antes de actualizar conviene hacer backup y conocer el mecanismo de recuperación de la base. Desactivar un addon o restaurar una revisión de Git no revierte automáticamente los cambios de esquema y datos que haya realizado el módulo. La recuperación y compatibilidad de migraciones forman parte del plan de operación, no de inherit_id.

Una frontera diferente a las islas de Astro

Astro compone componentes y puede elegir qué se hidrata en el navegador; Odoo resuelve vistas heredadas, modelos persistentes, reglas de seguridad y bundles dentro de un sistema integrado. No son el mismo mecanismo. El principio de diseño compartido es más abstracto: la extensión debe declarar qué contrato modifica y qué queda fuera de su responsabilidad. Una mala frontera en un blog puede producir JavaScript innecesario; una mala frontera en ERP puede exponer datos, romper una actualización o cambiar una operación de negocio.

Si interesa contrastar ambas decisiones, los artículos sobre arquitectura Astro e islas Svelte desarrollan el lado de renderizado web. Aquí la unidad fundamental sigue siendo el módulo de Odoo y su relación con otros módulos.

Conclusión

Heredar una vista con XPath es solo la parte visible de una personalización. Lo difícil es preservar el contrato entre un campo real del ORM, un addon con dependencias, una vista combinada que cambia con otros módulos y un sistema de seguridad que no puede delegarse a atributos visuales. En Odoo 18, un addon pequeño, explícito y verificable suele ser más fácil de mantener que un reemplazo masivo de la vista base.

Referencias de Odoo 18.0: Module Manifests, ORM API — Inheritance and extension, View Records — Inheritance, Security, Assets y vista original de contactos de la rama 18.0.