Actualizar la versión de Odoo es uno de los proyectos técnicos más delicados que afronta una empresa que usa este ERP. A diferencia de actualizar una app de móvil, una migración de versión de Odoo implica transformar la estructura de la base de datos, revisar la compatibilidad de todos los módulos instalados y asegurar que los flujos de trabajo críticos siguen funcionando después del cambio.
Esta guía es para empresas que llevan tiempo con su versión actual y se plantean dar el salto. Si estás empezando con Odoo, también puede ser útil la guía para principiantes de Odoo que cubre la configuración inicial desde cero.
Antes de empezar: preguntas que debes responder
Una migración de versión exitosa empieza con una buena auditoría previa. Antes de planificar la fecha de migración, necesitas responder a estas preguntas:
¿Cuántos módulos OCA tienes instalados y cuáles tienen versión compatible con la versión objetivo? Este es el punto más crítico. Si tienes 10 módulos OCA y solo 7 están portados a la nueva versión, necesitas decidir si sustituir los 3 faltantes por alternativas, desarrollar la portación tú mismo o esperar a que la comunidad los porte.
¿Tienes módulos desarrollados a medida? Cada módulo personalizado requiere revisión y posiblemente reescritura parcial para ser compatible con la nueva versión. Este trabajo es el que más tiempo consume en proyectos de migración.
¿Cuántos datos tiene tu base de datos? Una base de datos con millones de registros puede tardar horas en migrar. Planificar esto es clave para minimizar el tiempo de parada del sistema.
¿Cuándo es el mejor momento del año para hacer el go-live? Nunca durante el cierre fiscal, en campaña de ventas o en períodos de alta actividad. El mejor momento suele ser entre enero y marzo (después del cierre del ejercicio anterior) o en verano si el negocio tiene temporada baja.
Las 6 etapas de una migración de Odoo profesional
| Etapa | Actividades | Duración típica | Responsable |
|---|---|---|---|
| 1. Auditoría | Inventario de módulos, verificación de compatibilidad, análisis de personalizaciones, estimación de riesgos | 1–3 días | Partner técnico |
| 2. Preparación | Portación/actualización de módulos OCA, reescritura de módulos a medida incompatibles, creación del entorno de staging | 1–4 semanas | Partner técnico |
| 3. Migración de datos | Ejecución del proceso de migración de base de datos con upgrade.odoo.com en entorno de staging | 4–24 horas | Partner técnico |
| 4. Pruebas | Pruebas funcionales de los flujos críticos con datos reales migrados: ventas, compras, contabilidad, RRHH | 3–10 días | Equipo cliente + partner |
| 5. Formación | Sesiones de formación en las novedades de la nueva versión para usuarios clave | 1–3 días | Partner funcional |
| 6. Go-live | Migración final de producción en ventana de mantenimiento + soporte intensivo primeras 48 horas | 4–12 horas | Partner técnico |
Paso 1: Auditoría de módulos — el paso más importante
Antes de tocar ningún entorno, necesitas un inventario completo de los módulos instalados en tu Odoo actual. Ve a Ajustes → Módulos → Módulos instalados y exporta la lista completa. Para cada módulo necesitas saber: si es un módulo oficial de Odoo (siempre compatibles entre versiones oficiales), si es un módulo OCA (verificar en github.com/OCA si hay rama para tu versión objetivo) o si es un módulo desarrollado a medida (requiere revisión del código).
La herramienta de precheck de upgrade.odoo.com analiza tu base de datos y genera un informe automático de compatibilidad. Es gratuita y es el primer paso que debes dar — te dirá exactamente qué módulos tienen problemas conocidos antes de que empiece el trabajo de desarrollo.
Paso 2: Migración de base de datos con upgrade.odoo.com
Odoo SA proporciona una plataforma oficial de migración en upgrade.odoo.com. El proceso consiste en subir un dump de tu base de datos actual, especificar la versión origen y destino, y esperar a que el sistema genere una base de datos migrada. Este proceso está disponible para usuarios Enterprise y maneja la transformación de estructuras de datos entre versiones.
Importante: la plataforma de migración migra los datos de los módulos oficiales de Odoo. Los módulos de terceros (OCA o a medida) necesitan que sus propios scripts de migración estén preparados y ejecutados después. Por eso la preparación técnica del paso 1 es crítica: si un módulo a medida no tiene script de migración, los datos de ese módulo no se migrarán correctamente.
Paso 3: Pruebas funcionales con datos reales
Una vez tienes el entorno de staging con la base de datos migrada y todos los módulos actualizados, empieza la fase de pruebas. Esta fase la realizan conjuntamente el equipo técnico y los usuarios clave de cada departamento. Los flujos que siempre debes probar:
Contabilidad: crear una factura de venta, registrar un pago, conciliar con extracto bancario, generar los modelos fiscales de IVA. Si usas el SII, verificar que los envíos automáticos a la AEAT siguen funcionando.
Ventas: crear un presupuesto, convertirlo en pedido de venta, generar albarán, facturar. Verificar que los precios, descuentos y condiciones de pago se migran correctamente.
Compras: crear solicitud de compra, confirmar pedido, registrar recepción, validar factura de proveedor.
Correo electrónico: verificar que los envíos de facturas, presupuestos y notificaciones siguen funcionando. El servidor de correo saliente y la configuración SPF/DKIM pueden verse afectados por la migración si hubo cambios en la URL del dominio.
Los 3 riesgos más frecuentes en migraciones de Odoo
No todas las migraciones salen perfectas a la primera. Estos son los problemas más comunes y cómo prevenirlos:
Módulo OCA sin versión compatible. Es el problema número uno. Muchos proyectos de migración se retrasan semanas porque un módulo OCA crítico no tiene versión para la versión objetivo. La solución preventiva es auditar los módulos OCA antes de comprometerse con una fecha de go-live. Si un módulo no tiene versión, hay tres opciones: esperar a que la comunidad lo porte (puede tardar meses), contratar la portación a un partner técnico (semanas, coste controlado) o buscar una alternativa funcional que sí tenga versión compatible.
Pérdida de personalizaciones de informes. Las plantillas de PDF (facturas, albaranes, presupuestos) personalizadas a menudo necesitan revisión después de la migración porque el motor de renderizado de reportes puede cambiar entre versiones. Incluye la revisión de todas las plantillas de informe en el checklist de pruebas.
Configuraciones de correo que dejan de funcionar. Después de la migración, es habitual que los servidores de correo saliente necesiten reconfigurarse, especialmente si el servidor SMTP tenía configuraciones específicas de la versión anterior. Esto puede hacer que las facturas y notificaciones dejen de enviarse sin que nadie lo note hasta que un cliente llame preguntando por qué no recibe sus documentos. Probar el correo explícitamente es parte obligatoria del checklist de go-live.
Cómo comunicar la migración al equipo
Un aspecto que muchas empresas subestiman es la gestión del cambio interno. Una migración técnica perfecta puede fracasar si el equipo no está preparado para el cambio. Estas son las comunicaciones que no puedes olvidar:
2 semanas antes del go-live: informa al equipo de la fecha de mantenimiento y el tiempo de parada esperado. Explica qué va a cambiar visualmente en la interfaz y qué flujos de trabajo se ven afectados. Designa un superusuario en cada departamento que haya participado en las pruebas y pueda apoyar a sus compañeros las primeras horas después del go-live.
El día del go-live: activa un modo de mantenimiento visible para todos los usuarios que muestre un mensaje claro ("Sistema en mantenimiento hasta las XX:00h") en lugar de un error técnico. Cuando el sistema vuelva a estar disponible, envía una comunicación interna confirmándolo y recordando el canal de soporte para dudas.
Las primeras 48–72 horas: son el período crítico de soporte post-migración. El partner debe estar disponible con tiempo de respuesta rápido (idealmente menos de 2 horas) para resolver los problemas que surjan en el uso real. Los problemas detectados en producción siempre son distintos a los detectados en las pruebas de staging — no porque las pruebas hayan sido malas, sino porque el uso real tiene infinitas variaciones que ningún checklist puede anticipar completamente.
Cuándo hacer el go-live: la ventana de mantenimiento
El go-live es el momento en que actualizas el sistema de producción. El tiempo de parada (downtime) va desde unas pocas horas para instalaciones pequeñas hasta 12–24 horas para bases de datos muy grandes. Planifica esta ventana en un momento de baja actividad: un viernes a última hora de la tarde o un fin de semana, nunca en período de cierre fiscal o durante una campaña de ventas.
El proceso en el go-live es: poner el sistema en modo mantenimiento → hacer backup final de producción → ejecutar el proceso de migración de producción → verificar que arranca correctamente → ejecutar un checklist rápido de los flujos críticos → comunicar al equipo que el sistema está disponible.
Si tu instancia está en Odoo en la nube con Odoo.sh, el proceso de go-live es más controlado: Odoo.sh permite hacer el go-live de una rama de staging a producción con un clic, y en caso de problema crítico puedes revertir al backup anterior en minutos.
¿Planificando la migración de tu versión de Odoo?
En OsPrime llevamos a cabo migraciones de versión de Odoo con un proceso estructurado que minimiza el riesgo y el tiempo de parada. Empezamos con una auditoría técnica gratuita para darte un presupuesto ajustado a la complejidad real de tu instalación.
Solicita auditoría previa de migración →Preguntas frecuentes: migración de versión de Odoo
¿Cuánto cuesta migrar de versión en Odoo?
El coste depende de la complejidad de la instalación. Para una pyme con Odoo estándar sin personalizaciones importantes, la migración puede costar entre 1.500€ y 3.000€. Con módulos a medida o muchos módulos OCA, el coste puede subir a 5.000–15.000€. La plataforma upgrade.odoo.com cobra por el procesamiento de bases de datos grandes, pero las bases pequeñas son gratuitas.
¿Se puede migrar de Odoo 16 a Odoo 20 directamente?
Sí, la plataforma upgrade.odoo.com permite migraciones que saltan varias versiones. Sin embargo, cada versión saltada acumula cambios técnicos que hay que resolver, por lo que la complejidad es mayor que migrar versión a versión. Para saltos de más de 2 versiones, es recomendable contar con un partner técnico experimentado.
¿Qué pasa si la migración falla en producción?
Un proceso de migración profesional siempre incluye un backup completo del sistema de producción antes de empezar. Si la migración falla, se restaura el backup y el sistema vuelve a funcionar con la versión anterior. El tiempo de restauración suele ser similar al de la migración. Por eso es crítico tener el backup verificado antes del go-live.
¿Los datos históricos se mantienen después de la migración?
Sí. Todos los datos históricos (facturas, pedidos, contactos, movimientos contables) se migran a la nueva versión. El proceso de migración de Odoo SA está diseñado para preservar la integridad de todos los datos. Los únicos datos que pueden no migrarse son los de módulos sin script de migración compatible, que es por lo que la auditoría previa es imprescindible.
¿Cuánto tiempo estará el sistema parado durante la migración?
El tiempo de parada en el go-live depende del tamaño de la base de datos. Para una base de datos de menos de 5 GB, normalmente entre 2 y 4 horas. Para bases de datos grandes (20 GB o más), puede llegar a 12–24 horas. En instalaciones de Odoo.sh, la migración puede prepararse en una rama independiente y el switchover a producción lleva minutos.
Actualizar la versión de Odoo es uno de los proyectos técnicos más delicados que afronta una empresa que usa este ERP. A diferencia de actualizar una app de móvil, una migración de versión de Odoo implica transformar la estructura de la base de datos, revisar la compatibilidad de todos los módulos instalados y asegurar que los flujos de trabajo críticos siguen funcionando después del cambio.
Esta guía es para empresas que llevan tiempo con su versión actual y se plantean dar el salto. Si estás empezando con Odoo, también puede ser útil la guía para principiantes de Odoo que cubre la configuración inicial desde cero.
Antes de empezar: preguntas que debes responder
Una migración de versión exitosa empieza con una buena auditoría previa. Antes de planificar la fecha de migración, necesitas responder a estas preguntas:
¿Cuántos módulos OCA tienes instalados y cuáles tienen versión compatible con la versión objetivo? Este es el punto más crítico. Si tienes 10 módulos OCA y solo 7 están portados a la nueva versión, necesitas decidir si sustituir los 3 faltantes por alternativas, desarrollar la portación tú mismo o esperar a que la comunidad los porte.
¿Tienes módulos desarrollados a medida? Cada módulo personalizado requiere revisión y posiblemente reescritura parcial para ser compatible con la nueva versión. Este trabajo es el que más tiempo consume en proyectos de migración.
¿Cuántos datos tiene tu base de datos? Una base de datos con millones de registros puede tardar horas en migrar. Planificar esto es clave para minimizar el tiempo de parada del sistema.
¿Cuándo es el mejor momento del año para hacer el go-live? Nunca durante el cierre fiscal, en campaña de ventas o en períodos de alta actividad. El mejor momento suele ser entre enero y marzo (después del cierre del ejercicio anterior) o en verano si el negocio tiene temporada baja.
Las 6 etapas de una migración de Odoo profesional
| Etapa | Actividades | Duración típica | Responsable |
|---|---|---|---|
| 1. Auditoría | Inventario de módulos, verificación de compatibilidad, análisis de personalizaciones, estimación de riesgos | 1–3 días | Partner técnico |
| 2. Preparación | Portación/actualización de módulos OCA, reescritura de módulos a medida incompatibles, creación del entorno de staging | 1–4 semanas | Partner técnico |
| 3. Migración de datos | Ejecución del proceso de migración de base de datos con upgrade.odoo.com en entorno de staging | 4–24 horas | Partner técnico |
| 4. Pruebas | Pruebas funcionales de los flujos críticos con datos reales migrados: ventas, compras, contabilidad, RRHH | 3–10 días | Equipo cliente + partner |
| 5. Formación | Sesiones de formación en las novedades de la nueva versión para usuarios clave | 1–3 días | Partner funcional |
| 6. Go-live | Migración final de producción en ventana de mantenimiento + soporte intensivo primeras 48 horas | 4–12 horas | Partner técnico |
Paso 1: Auditoría de módulos — el paso más importante
Antes de tocar ningún entorno, necesitas un inventario completo de los módulos instalados en tu Odoo actual. Ve a Ajustes → Módulos → Módulos instalados y exporta la lista completa. Para cada módulo necesitas saber: si es un módulo oficial de Odoo (siempre compatibles entre versiones oficiales), si es un módulo OCA (verificar en github.com/OCA si hay rama para tu versión objetivo) o si es un módulo desarrollado a medida (requiere revisión del código).
La herramienta de precheck de upgrade.odoo.com analiza tu base de datos y genera un informe automático de compatibilidad. Es gratuita y es el primer paso que debes dar — te dirá exactamente qué módulos tienen problemas conocidos antes de que empiece el trabajo de desarrollo.
Paso 2: Migración de base de datos con upgrade.odoo.com
Odoo SA proporciona una plataforma oficial de migración en upgrade.odoo.com. El proceso consiste en subir un dump de tu base de datos actual, especificar la versión origen y destino, y esperar a que el sistema genere una base de datos migrada. Este proceso está disponible para usuarios Enterprise y maneja la transformación de estructuras de datos entre versiones.
Importante: la plataforma de migración migra los datos de los módulos oficiales de Odoo. Los módulos de terceros (OCA o a medida) necesitan que sus propios scripts de migración estén preparados y ejecutados después. Por eso la preparación técnica del paso 1 es crítica: si un módulo a medida no tiene script de migración, los datos de ese módulo no se migrarán correctamente.
Paso 3: Pruebas funcionales con datos reales
Una vez tienes el entorno de staging con la base de datos migrada y todos los módulos actualizados, empieza la fase de pruebas. Esta fase la realizan conjuntamente el equipo técnico y los usuarios clave de cada departamento. Los flujos que siempre debes probar:
Contabilidad: crear una factura de venta, registrar un pago, conciliar con extracto bancario, generar los modelos fiscales de IVA. Si usas el SII, verificar que los envíos automáticos a la AEAT siguen funcionando.
Ventas: crear un presupuesto, convertirlo en pedido de venta, generar albarán, facturar. Verificar que los precios, descuentos y condiciones de pago se migran correctamente.
Compras: crear solicitud de compra, confirmar pedido, registrar recepción, validar factura de proveedor.
Correo electrónico: verificar que los envíos de facturas, presupuestos y notificaciones siguen funcionando. El servidor de correo saliente y la configuración SPF/DKIM pueden verse afectados por la migración si hubo cambios en la URL del dominio.
Los 3 riesgos más frecuentes en migraciones de Odoo
No todas las migraciones salen perfectas a la primera. Estos son los problemas más comunes y cómo prevenirlos:
Módulo OCA sin versión compatible. Es el problema número uno. Muchos proyectos de migración se retrasan semanas porque un módulo OCA crítico no tiene versión para la versión objetivo. La solución preventiva es auditar los módulos OCA antes de comprometerse con una fecha de go-live. Si un módulo no tiene versión, hay tres opciones: esperar a que la comunidad lo porte (puede tardar meses), contratar la portación a un partner técnico (semanas, coste controlado) o buscar una alternativa funcional que sí tenga versión compatible.
Pérdida de personalizaciones de informes. Las plantillas de PDF (facturas, albaranes, presupuestos) personalizadas a menudo necesitan revisión después de la migración porque el motor de renderizado de reportes puede cambiar entre versiones. Incluye la revisión de todas las plantillas de informe en el checklist de pruebas.
Configuraciones de correo que dejan de funcionar. Después de la migración, es habitual que los servidores de correo saliente necesiten reconfigurarse, especialmente si el servidor SMTP tenía configuraciones específicas de la versión anterior. Esto puede hacer que las facturas y notificaciones dejen de enviarse sin que nadie lo note hasta que un cliente llame preguntando por qué no recibe sus documentos. Probar el correo explícitamente es parte obligatoria del checklist de go-live.
Cómo comunicar la migración al equipo
Un aspecto que muchas empresas subestiman es la gestión del cambio interno. Una migración técnica perfecta puede fracasar si el equipo no está preparado para el cambio. Estas son las comunicaciones que no puedes olvidar:
2 semanas antes del go-live: informa al equipo de la fecha de mantenimiento y el tiempo de parada esperado. Explica qué va a cambiar visualmente en la interfaz y qué flujos de trabajo se ven afectados. Designa un superusuario en cada departamento que haya participado en las pruebas y pueda apoyar a sus compañeros las primeras horas después del go-live.
El día del go-live: activa un modo de mantenimiento visible para todos los usuarios que muestre un mensaje claro ("Sistema en mantenimiento hasta las XX:00h") en lugar de un error técnico. Cuando el sistema vuelva a estar disponible, envía una comunicación interna confirmándolo y recordando el canal de soporte para dudas.
Las primeras 48–72 horas: son el período crítico de soporte post-migración. El partner debe estar disponible con tiempo de respuesta rápido (idealmente menos de 2 horas) para resolver los problemas que surjan en el uso real. Los problemas detectados en producción siempre son distintos a los detectados en las pruebas de staging — no porque las pruebas hayan sido malas, sino porque el uso real tiene infinitas variaciones que ningún checklist puede anticipar completamente.
Cuándo hacer el go-live: la ventana de mantenimiento
El go-live es el momento en que actualizas el sistema de producción. El tiempo de parada (downtime) va desde unas pocas horas para instalaciones pequeñas hasta 12–24 horas para bases de datos muy grandes. Planifica esta ventana en un momento de baja actividad: un viernes a última hora de la tarde o un fin de semana, nunca en período de cierre fiscal o durante una campaña de ventas.
El proceso en el go-live es: poner el sistema en modo mantenimiento → hacer backup final de producción → ejecutar el proceso de migración de producción → verificar que arranca correctamente → ejecutar un checklist rápido de los flujos críticos → comunicar al equipo que el sistema está disponible.
Si tu instancia está en Odoo en la nube con Odoo.sh, el proceso de go-live es más controlado: Odoo.sh permite hacer el go-live de una rama de staging a producción con un clic, y en caso de problema crítico puedes revertir al backup anterior en minutos.
¿Planificando la migración de tu versión de Odoo?
En OsPrime llevamos a cabo migraciones de versión de Odoo con un proceso estructurado que minimiza el riesgo y el tiempo de parada. Empezamos con una auditoría técnica gratuita para darte un presupuesto ajustado a la complejidad real de tu instalación.
Solicita auditoría previa de migración →Preguntas frecuentes: migración de versión de Odoo
¿Cuánto cuesta migrar de versión en Odoo?
El coste depende de la complejidad de la instalación. Para una pyme con Odoo estándar sin personalizaciones importantes, la migración puede costar entre 1.500€ y 3.000€. Con módulos a medida o muchos módulos OCA, el coste puede subir a 5.000–15.000€. La plataforma upgrade.odoo.com cobra por el procesamiento de bases de datos grandes, pero las bases pequeñas son gratuitas.
¿Se puede migrar de Odoo 16 a Odoo 20 directamente?
Sí, la plataforma upgrade.odoo.com permite migraciones que saltan varias versiones. Sin embargo, cada versión saltada acumula cambios técnicos que hay que resolver, por lo que la complejidad es mayor que migrar versión a versión. Para saltos de más de 2 versiones, es recomendable contar con un partner técnico experimentado.
¿Qué pasa si la migración falla en producción?
Un proceso de migración profesional siempre incluye un backup completo del sistema de producción antes de empezar. Si la migración falla, se restaura el backup y el sistema vuelve a funcionar con la versión anterior. El tiempo de restauración suele ser similar al de la migración. Por eso es crítico tener el backup verificado antes del go-live.
¿Los datos históricos se mantienen después de la migración?
Sí. Todos los datos históricos (facturas, pedidos, contactos, movimientos contables) se migran a la nueva versión. El proceso de migración de Odoo SA está diseñado para preservar la integridad de todos los datos. Los únicos datos que pueden no migrarse son los de módulos sin script de migración compatible, que es por lo que la auditoría previa es imprescindible.
¿Cuánto tiempo estará el sistema parado durante la migración?
El tiempo de parada en el go-live depende del tamaño de la base de datos. Para una base de datos de menos de 5 GB, normalmente entre 2 y 4 horas. Para bases de datos grandes (20 GB o más), puede llegar a 12–24 horas. En instalaciones de Odoo.sh, la migración puede prepararse en una rama independiente y el switchover a producción lleva minutos.