Introducción
Un error de manifiesto en Odoo aparece cuando el archivo __manifest__.py de un módulo contiene algún fallo. Ese fichero es la hoja de identidad del módulo: declara su nombre, versión, dependencias, archivos que debe cargar y parámetros de instalación.
Si el manifiesto tiene problemas, Odoo puede:
- No reconocer el módulo
- Impedir su instalación
- Fallar al actualizarlo
- Provocar errores del servidor en el arranque
Los errores en el manifiesto son especialmente frecuentes en el desarrollo de módulos a medida y durante migraciones entre versiones.
Esta guía muestra por qué ocurren esos fallos y ofrece pasos claros para repararlos.
¿Qué es el archivo de manifiesto en Odoo?
Todos los módulos de Odoo incluyen un archivo __manifest__.py.
Ejemplo:
{
'name': 'Custom Sales Extension',
'version': '16.0.1.0.0',
'depends': ['base', 'sale'],
'data': [
'views/sale_order_view.xml',
'security/ir.model.access.csv',
],
'installable': True,
}
Con ese fichero Odoo sabe:
- Cómo se llama el módulo
- De qué módulos depende
- Qué archivos debe cargar
- Si el módulo está marcado como instalable
Si alguno de estos puntos falla, el módulo no podrá funcionar correctamente.
Causas habituales de errores en el manifiesto de Odoo
1. Error de sintaxis en Python
El manifiesto es un diccionario Python. Si hay:
- Una coma faltante
- Indentación incorrecta
- Paréntesis o corchetes sin cerrar
- Comillas mal formadas
Odoo no podrá cargar el módulo.
Ejemplo de error:
'depends': ['base', 'sale'] 'data': ['views/view.xml']
Falta la coma después de depends.
2. Declaración de dependencia incorrecta
Si en depends se referencia un módulo inexistente:
'depends': ['sales']
en lugar de:
'depends': ['sale']
Odoo arrojará un error relacionado con dependencias.
3. Ruta de archivo incorrecta en la sección data
Si data apunta a un archivo que no existe:
'data': ['views/missing_view.xml']
Odoo fallará en la instalación.
4. Uso de claves obsoletas o no válidas
Usar claves no soportadas por la versión de Odoo puede provocar problemas.
Las propiedades específicas de cada versión deben corresponder con la versión de Odoo usada.
5. installable establecido en False
Si aparece:
'installable': False
El módulo no aparecerá en la lista de Apps.
Es habitual que al desarrollar se olvide activarlo (poner True).
6. Formato de versión incorrecto
Un formato de versión erróneo puede causar problemas en procesos de actualización y despliegues automatizados.
Cómo solucionar un error de manifiesto en Odoo
Paso 1 – Revisar los logs del servidor
Al arrancar Odoo o al actualizar la lista de apps, mira los registros en busca de:
SyntaxError
O trazas relacionadas con el manifiesto.
El log normalmente indica la línea exacta en __manifest__.py donde ocurre el fallo.
Paso 2 – Validar la sintaxis Python
Abre el manifiesto y comprueba:
- Comas entre las claves del diccionario
- Indentación adecuada
- Corchetes y paréntesis balanceados
- Comillas correctas en las cadenas
Un pequeño error de formato puede bloquear la instalación.
Paso 3 – Verificar dependencias
Confirma que cada módulo listado en:
'depends': []
exista y esté escrito correctamente.
Paso 4 – Comprobar rutas de archivos en data
Asegúrate de que todos los caminos indicados en:
'data': []
existan realmente dentro del directorio del módulo.
Revisa errores tipográficos o archivos colocados en carpetas equivocadas.
Paso 5 – Reiniciar y actualizar la lista de Apps
Tras corregir los errores:
- Reinicia el servicio de Odoo
- Accede al apartado Apps
- Haz clic en “Actualizar lista de aplicaciones”
- Vuelve a intentar la instalación
Cómo evitar errores en el manifiesto
- Usa un formato coherente en __manifest__.py
- Valida la sintaxis antes de desplegar
- Mantén las dependencias claras y reducidas
- No copies manifiestos de versiones distintas sin adaptarlos
- Usa control de versiones para rastrear cambios
Un manifiesto bien organizado evita la mayoría de fallos al instalar módulos.
Cómo Dasolo garantiza configuraciones limpias en los módulos
Los errores en el manifiesto suelen parecer triviales, pero pueden impedir por completo la instalación o actualización de un módulo. Normalmente nacen de fallos de sintaxis, dependencias mal declaradas o referencias a archivos inexistentes.
En Dasolo evitamos fallos relacionados con el manifiesto aplicando:
- Validación estricta de sintaxis
- Definición de dependencias clara y mínima
- Referencias precisas a archivos de datos y seguridad
- Gestión de configuración consciente de la versión de Odoo
- Pruebas previas al despliegue en entornos de staging
Un flujo disciplinado de configuración reduce interrupciones en despliegues y asegura un comportamiento estable de los módulos entre entornos.
Conclusión
El “Error de manifiesto” en Odoo surge cuando el archivo de configuración del módulo presenta sintaxis inválida, dependencias erróneas o referencias de archivo incorrectas. Aunque a primera vista parezca un fallo sencillo, suele indicar carencias en las prácticas de configuración del proyecto.
Revisar concienzudamente la estructura del manifiesto, comprobar dependencias y realizar pruebas antes del despliegue evita fallos repetidos. Mantener una configuración limpia y controlada es clave para tener implementaciones Odoo fiables y escalables.