Herencia en Odoo: _inherit vs _inherits explicado con ejemplos

Conceptos

Dos palabras, dos mecanismos

Regla mnemotécnica: _inherit = «quiero más del mismo»; _inherits = «quiero un modelo nuevo que reutilice otro por dentro».

_inherit

Extensión clásica con _inherit

Es el patrón más usado en módulos custom. No creas un modelo nuevo: modificas uno existente. Todos los módulos que heredan el mismo modelo encadenan sus cambios gracias a super().

# contact_extension/models/res_partner.py
from odoo import api, fields, models

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

    birth_date = fields.Date(string='Birth Date')
    age = fields.Integer(compute='_compute_age', store=True)

    @api.depends('birth_date')
    def _compute_age(self):
        today = fields.Date.today()
        for partner in self:
            partner.age = (
                today.year - partner.birth_date.year
                if partner.birth_date else 0
            )

El registro sigue siendo un res.partner. La tabla es res_partner. Las vistas del contacto muestran los nuevos campos si añades un XML con xpath.

_inherits

Delegación con _inherits

Creas un modelo nuevo cuyos campos del padre delegado aparecen como si fueran propios. En base de datos hay dos registros vinculados: uno en tu tabla y otro en la del padre.

# Ejemplo simplificado al estilo product.product / product.template
class ProductVariant(models.Model):
    _name = 'product.variant.custom'
    _description = 'Product Variant'
    _inherits = {{'product.template': 'template_id'}}

    template_id = fields.Many2one(
        'product.template', string='Template',
        required=True, ondelete='cascade',
    )
    sku_suffix = fields.Char(string='SKU Suffix')

    # Accedes a template_id.name como si fuera self.name
    # El ORM delega lectura/escritura al registro padre

Al crear un product.variant.custom, Odoo crea también el product.template asociado. Al borrar el hijo con ondelete='cascade', se elimina el padre.

Decisión

¿Cuándo usar cada uno?

Ejemplo de dominio: un diagnostic.test.subject (perfil del menor) no debería ser un res.partner vía _inherits si buscas privacidad RGPD — mejor modelo separado con relación Many2one. La herencia por delegación une demasiado el ciclo de vida.

Errores

Errores habituales

Práctica

Checklist antes de elegir

1. ¿El modelo ya existe en el core o en otro módulo? → probablemente _inherit
2. ¿Necesito una entidad nueva con identidad propia en menús/informes? → valora _inherits o modelo + Many2one
3. ¿Los datos del padre deben vivir/v morir con el hijo? → _inherits con ondelete='cascade'
4. ¿Solo añado campos y lógica? → _inherit sin dudar
5. ¿Privacidad o separación de dominio? → modelo independiente + relación, no delegación