{"id":2051,"date":"2026-05-04T00:24:54","date_gmt":"2026-05-04T00:24:54","guid":{"rendered":"https:\/\/exdoo.mx\/blogs\/dominios-en-odoo-19-filtros-basicos-reglas-avanzadas\/"},"modified":"2026-05-04T00:24:54","modified_gmt":"2026-05-04T00:24:54","slug":"dominios-en-odoo-19-filtros-basicos-reglas-avanzadas","status":"publish","type":"post","link":"https:\/\/exdoo.mx\/blogs\/dominios-en-odoo-19-filtros-basicos-reglas-avanzadas\/","title":{"rendered":"Dominios en Odoo 19: de filtros b\u00e1sicos a reglas avanzadas"},"content":{"rendered":"

En Odoo, un dominio<\/strong> es una expresi\u00f3n que filtra registros: el equivalente a la cl\u00e1usula WHERE<\/code> de SQL pero declarada en Python. Los usas para filtrar listas, restringir relaciones Many2one\/Many2many<\/em>, definir reglas de seguridad y mucho m\u00e1s. En esta gu\u00eda vemos desde lo b\u00e1sico hasta los patrones que m\u00e1s se usan en producci\u00f3n con Odoo 19.<\/p>\n

1. Sintaxis b\u00e1sica<\/h2>\n

Un dominio es una lista de tuplas<\/strong>, cada tupla con tres elementos: (campo, operador, valor)<\/code>.<\/p>\n

# Facturas de cliente confirmadas\n[('move_type', '=', 'out_invoice'), ('state', '=', 'posted')]\n<\/code><\/pre>\n
Cuando hay varias tuplas y no especificas nada, Odoo las une con AND<\/code> impl\u00edcito. Operadores m\u00e1s usados:<\/p>\n
    \n
  • =<\/code>, !=<\/code>, ><\/code>, <<\/code>, >=<\/code>, <=<\/code><\/li>\n
  • like<\/code>, ilike<\/code> (sensible\/insensible a may\u00fasculas)<\/li>\n
  • in<\/code>, not in<\/code> con una lista de valores<\/li>\n
  • child_of<\/code>, parent_of<\/code> para jerarqu\u00edas (cuentas, categor\u00edas, locations)<\/li>\n<\/ul>\n
    2. Operadores l\u00f3gicos: prefix notation<\/h2>\n
    Para combinar condiciones con OR o NOT, Odoo usa notaci\u00f3n prefija<\/strong>. Cada operador (&<\/code>, |<\/code>, !<\/code>) afecta a las siguientes<\/em> condiciones.<\/p>\n
    # Facturas borrador OR confirmadas (de cliente)\n['&',\n    ('move_type', '=', 'out_invoice'),\n    '|',\n        ('state', '=', 'draft'),\n        ('state', '=', 'posted')]\n<\/code><\/pre>\n
    El truco: &<\/code> y |<\/code> son operadores binarios (toman las dos siguientes), !<\/code> es unario (toma la siguiente). Si lo escribes a mano, cuenta los argumentos para que cuadren.<\/p>\n
    3. Dominios con contexto<\/h2>\n
    El context<\/code> es un diccionario que viaja con cada acci\u00f3n y vista. Te sirve para que un mismo bot\u00f3n abra una vista filtrada distinto seg\u00fan desde d\u00f3nde se haya invocado.<\/p>\n
    3.1 Pasar default desde la acci\u00f3n<\/h3>\n
    <record id=\"action_facturas_pendientes\" model=\"ir.actions.act_window\">\n    <field name=\"name\">Facturas pendientes<\/field>\n    <field name=\"res_model\">account.move<\/field>\n    <field name=\"view_mode\">list,form<\/field>\n    <field name=\"domain\">[('payment_state', 'in', ['not_paid', 'partial'])]<\/field>\n    <field name=\"context\">{'default_move_type': 'out_invoice'}<\/field>\n<\/record>\n<\/code><\/pre>\n
    Cuando el usuario crea un registro desde esa acci\u00f3n, el campo move_type<\/code> ya viene rellenado.<\/p>\n
    3.2 Filtrar por usuario actual<\/h3>\n
    # Solo mis \u00f3rdenes de venta\n[('user_id', '=', uid)]\n<\/code><\/pre>\n
    La variable uid<\/code> est\u00e1 disponible autom\u00e1ticamente en los dominios evaluados en vistas y reglas. Si necesitas la compa\u00f1\u00eda actual, usa company_id<\/code> con allowed_company_ids<\/code>:<\/p>\n
    [('company_id', 'in', allowed_company_ids)]\n<\/code><\/pre>\n
    4. Dominios din\u00e1micos en vistas<\/h2>\n
    Los m\u00e1s \u00fatiles son los que dependen de otro campo del mismo formulario. Se escriben directo en el atributo domain<\/code> del XML:<\/p>\n
    <field name=\"product_id\"\n    domain=\"[('type', '=', 'product'),\n            ('categ_id', '=', categ_filter_id)]\"\/>\n<\/code><\/pre>\n
    Aqu\u00ed categ_filter_id<\/code> es otro campo del mismo formulario. Cada vez que cambia su valor, Odoo re-eval\u00faa el dominio y limita las opciones.<\/p>\n
    4.1 Cambiar el dominio con @api.onchange<\/h3>\n
    Cuando el dominio depende de c\u00e1lculos m\u00e1s complejos, usa un onchange<\/code> que devuelve {'domain': {...}}<\/code>:<\/p>\n
    from odoo import api, fields, models\n\nclass SaleOrder(models.Model):\n    _inherit = 'sale.order'\n\n    warehouse_id = fields.Many2one('stock.warehouse')\n\n    @api.onchange('warehouse_id')\n    def _onchange_warehouse_filter_products(self):\n        if not self.warehouse_id:\n            return {'domain': {'order_line.product_id': []}}\n        # Solo productos con stock en ese almac\u00e9n\n        product_ids = self.env['stock.quant'].search([\n            ('location_id.warehouse_id', '=', self.warehouse_id.id),\n            ('quantity', '>', 0),\n        ]).product_id.ids\n        return {'domain': {\n            'order_line.product_id': [('id', 'in', product_ids)]\n        }}\n<\/code><\/pre>\n
    5. Reglas de registro (seguridad por dominio)<\/h2>\n
    Las record rules<\/strong> son dominios que Odoo aplica autom\u00e1ticamente a cada query, seg\u00fan el grupo del usuario. Es la forma est\u00e1ndar de implementar visibilidad por sucursal, vendedor o cualquier criterio de negocio.<\/p>\n
    <record id=\"rule_factura_solo_propia_sucursal\" model=\"ir.rule\">\n    <field name=\"name\">Factura: solo de mi sucursal<\/field>\n    <field name=\"model_id\" ref=\"account.model_account_move\"\/>\n    <field name=\"domain_force\">\n        [('branch_id', 'in', user.branch_ids.ids)]\n    <\/field>\n    <field name=\"groups\" eval=\"[(4, ref('account.group_account_invoice'))]\"\/>\n    <field name=\"perm_read\" eval=\"True\"\/>\n    <field name=\"perm_write\" eval=\"True\"\/>\n    <field name=\"perm_create\" eval=\"True\"\/>\n    <field name=\"perm_unlink\" eval=\"False\"\/>\n<\/record>\n<\/code><\/pre>\n
    Tres cosas a recordar con record rules:<\/p>\n
      \n
    1. Se eval\u00faa con permisos elevados.<\/strong> Dentro del domain_force<\/code> tienes acceso a user<\/code> (recordset del usuario actual) sin restricciones.<\/li>\n
    2. Las reglas del mismo grupo se unen con OR<\/strong>; las de grupos distintos con AND. Esto importa cuando hay varias reglas que tocan el mismo modelo.<\/li>\n
    3. Si un usuario es superuser<\/strong> o el contexto trae bypass_rules<\/code>, la regla no aplica.<\/li>\n<\/ol>\n
      6. Dominios multi-compa\u00f1\u00eda<\/h2>\n
      En multi-compa\u00f1\u00eda, Odoo trae allowed_company_ids<\/code> en el contexto: la lista de IDs de las compa\u00f1\u00edas que el usuario tiene activas en el selector superior derecho. \u00dasala en lugar de hardcodear.<\/p>\n
      # Mal: solo ve la compa\u00f1\u00eda \"principal\"\n[('company_id', '=', user.company_id.id)]\n\n# Bien: respeta el selector multi-compa\u00f1\u00eda\n[('company_id', 'in', allowed_company_ids)]\n<\/code><\/pre>\n
      En las record rules es exactamente igual:<\/p>\n
      <field name=\"domain_force\">\n    ['|', ('company_id', '=', False),\n          ('company_id', 'in', allowed_company_ids)]\n<\/field>\n<\/code><\/pre>\n
      El '|'<\/code> con company_id = False<\/code> es para los registros compartidos (sin compa\u00f1\u00eda asignada).<\/p>\n
      7. Tips de producci\u00f3n<\/h2>\n
        \n
      • Debug f\u00e1cil:<\/strong> en el modo desarrollador, abre Filtros > A\u00f1adir filtro personalizado<\/em> y arma el dominio visualmente. Despu\u00e9s copia el resultado del developer tooltip.<\/li>\n
      • No mezcles tipos:<\/strong> ('field', '=', False)<\/code> es muy distinto a ('field', '=', 0)<\/code>. Para campos relacionales vac\u00edos, siempre = False<\/code>.<\/li>\n
      • Performance:<\/strong> dominios con muchos like<\/code> sobre tablas grandes son lentos. Si vas a filtrar millones de registros, aseg\u00farate de tener el campo indexado (index=True<\/code> en la definici\u00f3n).<\/li>\n
      • Evita search().ids<\/code> innecesario:<\/strong> en lugar de [('id', 'in', self.env['x'].search([...]).ids)]<\/code>, casi siempre puedes hacer un dominio relacional con .<\/code> (ej: ('partner_id.country_id', '=', mx_id)<\/code>).<\/li>\n<\/ul>\n
        Cierre<\/h2>\n
        Los dominios son la base de c\u00f3mo Odoo expresa filtros en todos los rincones: vistas, acciones, record rules, m\u00e9todos de b\u00fasqueda. Dominarlos te ahorra much\u00edsimo c\u00f3digo Python repetitivo y te permite implementar reglas de negocio (visibilidad por sucursal, restricciones por rol, vistas contextuales) usando configuraci\u00f3n en lugar de overrides.<\/p>\n
        Si en tu implementaci\u00f3n tienes casos de visibilidad complejos (varias sucursales, m\u00faltiples compa\u00f1\u00edas, vendedores con territorios), antes de meterte a sobrescribir _search<\/code>, revisa si una record rule bien dise\u00f1ada no resuelve el problema con menos riesgo.<\/p>\n","protected":false},"excerpt":{"rendered":"
        Gu\u00eda t\u00e9cnica de dominios en Odoo 19: sintaxis, operadores l\u00f3gicos, contexto, dominios din\u00e1micos en vistas, record rules y multi-compa\u00f1\u00eda.<\/p>\n","protected":false},"author":1,"featured_media":2052,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-2051","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-base"],"_links":{"self":[{"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/posts\/2051","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/comments?post=2051"}],"version-history":[{"count":0,"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/posts\/2051\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/media\/2052"}],"wp:attachment":[{"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/media?parent=2051"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/categories?post=2051"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/tags?post=2051"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}