Es habitual que una implantación de Odoo bien montada se tuerza precisamente por la migración de datos. El sistema está configurado, los flujos están claros, pero el día de arrancar aparecen clientes duplicados, productos sin precio, stock descuadrado y facturas que apuntan a la nada. Todo porque la importación desde Excel se hizo deprisa y mal.
Si vienes de trabajar con hojas de cálculo y vas a dar el salto a Odoo, este es el momento más delicado de todo el proyecto. No es difícil, pero hay que hacerlo con cuidado. Te cuento cómo.
Por qué la migración de datos es donde más se tuercen las cosas
Cuando planificas una implantación, piensas en módulos, en flujos, en formación. La migración de datos parece lo fácil: exportar de Excel, importar en Odoo, listo. Pero la realidad es que tus datos están sucios. Llevan años acumulando errores, duplicados, campos vacíos, formatos inconsistentes. Y Odoo no perdona.
Un ERP necesita datos estructurados. Si un producto no tiene unidad de medida, Odoo no sabe qué hacer con él. Si un cliente tiene dos fichas con nombres distintos, vas a tener facturas repartidas entre las dos. Si el stock inicial está mal, el inventario nunca va a cuadrar.
Lo que más veo es gente que subestima esta fase. Suele llevar bastante más de lo previsto. Y si no se hace bien, los errores se arrastran durante meses. Si quieres entender cómo encaja esto en el proyecto completo, en la guía de implantación de Odoo tienes el contexto de todas las fases.
Qué datos llevar y cuáles no
No todo lo que tienes en Excel tiene que ir a Odoo. Antes de exportar nada, decide qué necesitas realmente:
- Contactos: clientes y proveedores activos. Los que no tienen actividad desde hace tiempo, déjalos fuera o márcalos como inactivos.
- Productos: los que vendes o compras hoy. Si solo mueves una parte del catálogo, empieza por esa.
- Stock inicial: el inventario real a fecha de arranque. Esto es crítico si vas a usar Odoo para gestionar almacenes y logística.
- Documentos abiertos: pedidos pendientes, facturas sin cobrar, albaranes sin facturar. Lo que está en curso tiene que estar en Odoo para poder seguirlo.
El histórico es otra historia. Facturas antiguas, pedidos cerrados, movimientos de stock de años anteriores. La tentación es llevarlo todo, pero pregúntate: ¿lo vas a consultar? ¿Lo necesitas para informes? Si la respuesta es no, déjalo en un archivo y no lo importes. Menos datos, menos problemas.
Limpiar antes de importar
Esta es la parte que nadie quiere hacer pero que más dolores de cabeza ahorra. Antes de tocar Odoo, limpia tus datos en origen:
- Duplicados: busca clientes o productos repetidos y unifícalos. En Excel puedes usar formato condicional o tablas dinámicas para detectarlos.
- Formatos: teléfonos con y sin prefijo, direcciones escritas de diez formas distintas, nombres en mayúsculas y minúsculas. Unifica.
- Códigos: si tus productos tienen referencia, asegúrate de que sea única y consistente. Odoo usa la referencia interna para identificar productos.
- Unidades de medida: si vendes por unidades, kilos, metros o cajas, asegúrate de que cada producto tenga la suya clara. Y que coincida con las que vas a configurar en Odoo.
- Categorías: tanto de productos como de contactos. Las categorías que no existan en Odoo normalmente darán error al importar.
Esta limpieza la puedes hacer en el propio Excel. Lleva tiempo, pero es tiempo bien invertido.
El orden importa
No puedes importar todo de golpe. Hay un orden lógico que tienes que respetar porque unos registros dependen de otros:
- Configuración base: categorías de producto, unidades de medida, etiquetas de contacto, almacenes. Todo lo que otros registros van a referenciar.
- Contactos: clientes y proveedores. Si tienes direcciones de envío o facturación separadas, van después del contacto principal.
- Productos: con sus precios, categorías y unidades ya configuradas.
- Stock inicial: mediante un inventario inicial en Odoo, no importando movimientos.
- Documentos abiertos: pedidos de venta, pedidos de compra, facturas pendientes. Cada uno referencia contactos y productos que ya tienen que existir.
Si intentas importar un pedido de venta antes de tener el cliente y los productos, Odoo no va a saber qué hacer. Te dará error.
La importación de Odoo: cómo funciona
Odoo tiene una herramienta de importación integrada que funciona con ficheros CSV o Excel. En la mayoría de vistas de lista, puedes acceder desde el menú de acciones a la opción Importar registros. Ahí subes tu fichero y mapeas las columnas a los campos de Odoo.
Lo más útil es usar las plantillas que ofrece el propio Odoo. En el asistente de importación puedes descargar plantillas para los datos más habituales, como contactos o productos. Esas plantillas tienen las columnas correctas con los nombres que Odoo espera. Si rellenas tus datos siguiendo esa estructura, el mapeo es automático.
El concepto clave aquí es el identificador externo. Es un código único que tú asignas a cada registro y que Odoo guarda. Si mañana vuelves a importar el mismo fichero con cambios, Odoo usa ese identificador para actualizar el registro en lugar de crear uno nuevo. Sin identificador externo, es fácil acabar creando duplicados al reimportar.
Mi recomendación: usa siempre identificadores externos. Y prueba siempre en una base de datos de prueba antes de tocar la de producción. Odoo te permite duplicar la base de datos para hacer pruebas. Úsalo.
Errores típicos que veo con más frecuencia
Después de muchas importaciones, estos son los errores que más se repiten:
- Separador decimal y formato de fechas: en CSV, el asistente detecta el formato y te deja cambiarlo en las opciones. Lo más seguro para las fechas es usar el formato AAAA-MM-DD. Revisa esas opciones antes de confirmar.
- Codificación de caracteres: si exportas a CSV y tu fichero tiene acentos, eñes o símbolos, asegúrate de guardarlo en UTF-8. Si no, Odoo te va a mostrar caracteres raros o directamente rechazar el fichero. Con ficheros .xlsx no tienes este problema.
- Categorías que no existen: si en tu fichero un producto tiene una categoría que en Odoo no has creado, la importación normalmente fallará. Crea primero todo lo que vas a referenciar.
- Unidades de medida que no coinciden: si escribes la unidad con un nombre distinto al que tiene en Odoo, no va a casar. Usa exactamente el nombre que tiene configurado o el identificador externo de la unidad.
- Campos obligatorios vacíos: si un producto necesita unidad de medida y no la tiene, error. Revisa qué campos son obligatorios en cada modelo.
La mayoría de estos errores se detectan en la importación de prueba. Por eso insisto: nunca importes directamente en producción.
Cuándo compensa un script en lugar de la importación manual
La importación de Odoo está bien para volúmenes moderados y datos relativamente limpios. Pero hay casos en los que compensa escribir un script:
- Mucho volumen: si tienes decenas de miles de registros, la importación manual se vuelve lenta y propensa a errores.
- Datos de otro programa: si vienes de un ERP anterior, un CRM o un sistema de facturación, los datos suelen estar en formatos que no encajan directamente. Un script puede transformarlos.
- Relaciones complejas: si necesitas importar pedidos con sus líneas, facturas con sus vencimientos o productos con sus variantes, la importación manual se complica. Un script puede crear todo en el orden correcto.
- Validaciones especiales: si quieres verificar datos contra reglas de negocio antes de importar, un script te da ese control.
Escribir un script requiere conocimientos de Python y de la API de Odoo. Si no los tienes, es donde entra un desarrollador. En el artículo sobre costes de implantación verás por qué la migración de datos es precisamente la partida que más se olvida al presupuestar.
Esto no es lo mismo que migrar de versión
Un apunte importante: pasar datos de Excel a Odoo no es lo mismo que migrar de una versión de Odoo a otra. Si ya tienes Odoo en una versión antigua y quieres pasar a la actual, eso es otro proceso completamente distinto, con sus propias complicaciones. Lo explico en detalle en el artículo sobre migración de versión de Odoo.
Aquí estamos hablando de una implantación nueva, donde partes de cero en Odoo y traes datos de sistemas anteriores. Es más sencillo en algunos aspectos porque no arrastras personalizaciones ni módulos, pero tiene sus propios retos.
Lo que marca la diferencia
La diferencia entre una migración de datos que fluye y una que se complica está en la preparación. Si limpias antes de importar, si respetas el orden, si pruebas en un entorno de prueba, si usas identificadores externos, la importación va bien.
Si te lanzas a importar lo primero que exportas sin revisarlo, vas a pasarte días arreglando errores. Y lo peor es que algunos de esos errores no los ves hasta que llevas semanas trabajando con Odoo y te das cuenta de que el stock no cuadra o de que hay clientes duplicados por todas partes.
Si estás planificando tu paso a Odoo y quieres que alguien con experiencia te ayude con la migración de datos, echa un vistazo a cómo trabajo como consultor Odoo o escríbeme directamente. Hablamos de tu caso concreto y vemos qué necesitas.

