De forma predeterminada, al importar datos (como la importación de CSV) con el módulo base_import, Odoo sigue esta regla:
- Si importas el XMLID de un registro, realiza una actualización.
- Si no lo haces, crea un nuevo registro.
Este módulo te permite establecer reglas adicionales para determinar si una importación dada es una actualización o un nuevo registro.
Esto es útil cuando necesitas sincronizar bases de datos heterogéneas, y el campo que utilizas para emparejar registros en esas bases de datos con los de Odoo no es el XMLID sino el nombre, el VAT, el correo electrónico, etc.
Después de instalar este módulo, la lógica de importación cambiará a:
- Si importas el XMLID de un registro, realiza una actualización.
- Si no lo haces:
- Si hay reglas de coincidencia de importación para el modelo que estás importando:
- Descarta las reglas que requieren campos que no estás importando.
- Recorre las reglas restantes una por una en orden para encontrar una coincidencia en la base de datos.
- Omite la regla si requiere una condición especial que no se cumple.
- Si se encuentra una coincidencia:
- Detén el recorrido del resto de reglas válidas.
- Actualiza ese registro.
- Si se encuentran cero o múltiples coincidencias:
- Continúa con la siguiente regla.
- Si se agotan todas las reglas y no se encuentra una única coincidencia:
- Crea un nuevo registro.
- Si no hay reglas de coincidencia para tu modelo:
- Crea un nuevo registro.
De forma predeterminada se instalan 2 reglas para instancias de producción:
- Una regla que te permitirá actualizar empresas basándose en su VAT, cuando is_company es True.
- Una regla que te permitirá actualizar usuarios basándose en su login.
En instancias de demostración hay más ejemplos.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 18.0Te permite definir reglas de coincidencia para que las importaciones CSV actualicen registros existentes en lugar de crear duplicados, basándose en campos como VAT, email o name en lugar del ID externo.
Cuando importas datos con la herramienta de importación estándar de Odoo, Odoo normalmente crea un nuevo registro a menos que el archivo contenga un ID externo. Este módulo cambia ese comportamiento: puedes configurar reglas de coincidencia que le indican a Odoo qué combinación de campos identifica un registro existente.
- Un nuevo menú "Import Match" (dentro del área Técnico/Configuración) permite a los administradores crear reglas por modelo. Cada regla enumera uno o más campos que en conjunto forman una clave única, y las reglas se prueban en orden.
- Un campo dentro de una regla se puede marcar como condicional: la regla solo se usa cuando el valor importado para ese campo es exactamente igual al valor que estableciste (por ejemplo, coincidir solo con empresas cuando el valor importado de is_company es exactamente "True").
- Durante la importación, las reglas cuyos campos no están presentes en el archivo importado se ignoran. Las reglas restantes se comprueban una por una; si coincide exactamente un registro existente, ese registro se actualiza. Si no coincide ninguno o coinciden varios registros, Odoo recurre a crear un nuevo registro.
- El módulo incluye reglas ya preparadas: los partners coinciden por VAT (para empresas), los usuarios por login, y las reglas de demostración hacen coincidir partners por nombre más empresa matriz, por email o por nombre.
- Afecta el comportamiento de importación de cualquier modelo a través del método compartido
load, y añade los modelosbase_import.matchybase_import.match.field. Solo los administradores del sistema pueden crear o cambiar reglas; los demás usuarios pueden leerlas.
Depende de
Menús que añade
Modelos y campos (3)
- base · amplía un modelo existente
- base_import.match · modelo nuevoname, model_id, sequence, field_ids (Fields), model_name (Model name)
- base_import.match.field · modelo nuevoname, field_id (Field), match_id (Match), model_id, conditional, imported_value
Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 7 confirmadas, 2 sin información de 9 versiones.
Fuentes · Odoo 15.0
Confirmado el 2026-11-03 en la rama 15.0 de OCA/server-backend.
terminal Instalación y uso
Documentación de OCA · Odoo 18.0Configuración
Fuente · Odoo 18.0Para configurar este módulo, necesita:
- Ir a Settings \> Technical \> Database Structure \> Import Match.
- Crear.
- Elegir un Model.
- Elegir los Fields que conforman una clave única en ese modelo.
- Si la regla debe usarse solo para ciertos valores importados, marque Conditional e introduzca la cadena exacta que se va a importar en Imported value.
- Tenga en cuenta que la coincidencia aquí se evalúa siempre como una cadena de texto sensible a mayúsculas y minúsculas. Si introduce, por ejemplo,
True, coincidirá con esa cadena, pero no coincidirá con1otrue. - Guardar.
En esa vista de lista, puede ordenar las reglas arrastrando y soltando.
Para usar este módulo, necesita:
- Seguir los pasos de la sección Configuración anterior.
- Ir a cualquier vista de lista.
- Pulsar Importar y seguir el procedimiento de importación como de costumbre.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.