Cómo migrar Odoo a una nueva versión sin perder datos

Cada año Odoo lanza una versión nueva y las antiguas dejan de recibir soporte y parches de seguridad. Actualizar a tiempo es clave, pero una migración mal planeada puede dejar datos inconsistentes o módulos que no funcionan. Esta guía resume cómo hacerlo bien.

¿Por qué migrar?

• Seguridad: las versiones sin soporte dejan de recibir correcciones.
• Funciones nuevas: cada versión mejora la contabilidad, el inventario, la web y el rendimiento.
• Compatibilidad: los módulos nuevos y las integraciones se publican para las versiones recientes.

Si usas Odoo Enterprise

Con una suscripción activa tienes acceso al servicio oficial de actualización de Odoo, que migra los módulos estándar y las personalizaciones hechas con Studio. El proceso típico es:

1. Solicitar una base de datos de prueba ya actualizada.
2. Adaptar tus módulos personalizados a la nueva versión.
3. Probar a fondo con procesos reales y reportar a Odoo cualquier problema del servicio.
4. Repetir con una base de prueba nueva hasta que todo funcione.
5. Actualizar producción en un momento de baja actividad.

Ten en cuenta que las bases de prueba vienen "neutralizadas": no envían correos ni ejecutan acciones programadas, pagos o sincronizaciones bancarias, para no afectar la operación real.

Si usas Odoo Community

Odoo no ofrece un servicio oficial de actualización para Community. La alternativa más usada es OpenUpgrade, un proyecto de la OCA que incluye scripts para migrar la estructura y los datos. Su principal limitación es que avanza una versión a la vez: para pasar de la 16 a la 19 hay que encadenar varios pasos. Además, la ruta hacia la versión más reciente suele estar lista varios meses después del lanzamiento.

En bases de datos pequeñas, a veces conviene una migración manual: instalar la versión nueva desde cero e importar los datos maestros y los saldos.

Los módulos personalizados: el punto crítico

Ningún servicio automático migra el código hecho a la medida. Hay que portarlo a la nueva versión, y algunos cambios recientes de Odoo afectan a casi todos los módulos:

• Desde Odoo 17 desapareció el atributo attrs de las vistas; ahora las condiciones se escriben directo en invisible, readonly y required.
• Desde Odoo 18 la vista <tree> pasó a llamarse <list>, y las herencias que buscaban //tree deben ajustarse.
• El código JavaScript del cliente web se escribe con el framework OWL, que también cambia entre versiones.

<!-- Antes -->
<field name="fecha_entrega" attrs="{'invisible': [('estado', '=', 'idea')]}"/>

<!-- Después -->
<field name="fecha_entrega" invisible="estado == 'idea'"/>

Lista de verificación antes de salir en vivo

Si tu Odoo además está en un servidor propio, revisa nuestra guía sobre dónde alojar tu Odoo.

Preguntas frecuentes

¿Puedo saltar varias versiones de una vez?

En Enterprise, el servicio oficial permite ir directo a una versión con soporte. En Community, con OpenUpgrade se avanza versión por versión.

¿Cuánto tarda una migración?

Depende del tamaño de la base de datos y de cuántos módulos personalizados tengas. Las bases pequeñas sin desarrollos pueden migrarse en días; con muchos módulos propios, en semanas.

¿Pierdo mis datos al migrar?

No, si se hace con respaldo, pruebas y verificación de saldos. Por eso nunca se migra directamente sobre producción.

Los precios, versiones y estados de proyectos mencionados corresponden a la fecha de publicación y pueden cambiar. Verifica siempre la información vigente en las fuentes oficiales de Odoo.