Inicio / Guía de migración
Guía completa · Actualizado: agosto de 2026 · Compatible con Odoo 17 y 18Guía completa para migrar de Holded a Odoo
Requisitos, mapeo de campos entidad por entidad, tiempos reales y los errores más comunes.
Migrar de Holded a Odoo implica cuatro fases: preparar los requisitos (API key de Holded, Odoo con API externa), previsualizar y seleccionar los datos, mapear los campos de cada entidad, y ejecutar con verificación posterior. Con Holded2Odoo el proceso completo, para una cuenta de tamaño medio (unos 5.000 registros), tarda entre 8 y 20 minutos de ejecución una vez confirmados los pasos previos.
¿Qué necesito antes de empezar la migración?
Dos requisitos, ninguno negociable:
-
1. Una API key de Holded en modo lectura
Se genera desde Ajustes → Developers → Credentials dentro de tu cuenta de Holded. Solo disponible en planes de pago de Holded (no en el plan gratuito) y requiere rol de administrador o developer.
-
2. Una instancia de Odoo con API externa habilitada
Plan Custom de Odoo Online, o una instancia self-hosted (cualquier edición). Los planes One App Free y Standard de Odoo Online no incluyen acceso a la API externa — si tu Odoo está en uno de esos planes, tendrás que actualizar antes de poder conectar.
¿Cómo se mapean los campos de Holded a Odoo?
Holded2Odoo aplica un mapeo por defecto para cada entidad, editable antes de ejecutar. Esta es la correspondencia base:
| Entidad Holded | Modelo Odoo | Notas |
|---|---|---|
| Contacto | res.partner | NIF/CIF → campo vat; dirección requiere resolver país/provincia por nombre |
| Producto | product.template | El impuesto no comparte ID entre plataformas — mapeo manual habitual |
| Factura de venta | account.move (out_invoice) | Requiere que el contacto y los productos ya estén migrados |
| Factura de compra | account.move (in_invoice) | Igual que venta, con diario de tipo compra |
| Asiento contable | account.move (entry) | El plan de cuentas es el punto de mayor fricción manual |
Los dos puntos que casi siempre requieren ajuste manual: el mapeo de impuestos (los tipos de IVA no comparten identificador entre Holded y Odoo) y el plan de cuentas (la numeración contable rara vez coincide 1:1). Holded2Odoo te lo señala explícitamente en el paso de mapeo, no como sorpresa al final.
¿En qué orden se migran los datos?
Orden fijo, no configurable, porque las dependencias de datos lo exigen: contactos → productos → facturas → contabilidad. Una factura necesita que su contacto y sus productos ya existan en Odoo; un asiento contable necesita el plan de cuentas ya resuelto. Si un bloque falla, los anteriores ya migrados no se revierten.
¿Cuánto tarda una migración de Holded a Odoo?
Depende del volumen: para una cuenta con hasta 500 registros (plan Starter), la ejecución suele completarse en pocos minutos. Para una cuenta con hasta 5.000 registros (plan Business, con contabilidad), calcula entre 8 y 20 minutos de ejecución. La previsualización previa (contar los registros de Holded) puede tardar más en cuentas grandes, porque Holded no expone un endpoint de conteo total y hay que paginar hasta el final — ese tiempo se cachea y no se repite en visitas posteriores.
¿Qué pasa si un registro falla al migrar?
Se registra en el log con el motivo exacto (por ejemplo, "cliente sin NIF válido en destino" o "categoría de producto no existe en Odoo") y el resto de la migración continúa. Al finalizar puedes reintentar solo los registros fallidos, sin repetir los que ya se migraron bien.
Errores comunes al migrar de Holded a Odoo
| Error | Causa habitual |
|---|---|
| "No se pudo contactar con Odoo" | El plan de Odoo no incluye API externa (One App Free / Standard) |
| Cliente sin NIF válido en destino | El contacto en Holded no tiene NIF/CIF relleno o tiene formato inválido |
| Categoría de producto no existe en Odoo | La categoría de Holded no tiene equivalente creado en el Odoo de destino — hay que crearla antes o mapearla a una existente |
| Cuenta contable no encontrada | El plan de cuentas de Odoo no tiene el código exacto que usa el asiento en Holded |
Cuándo esta guía no es suficiente
Si tu migración implica transformar la estructura de los datos (por ejemplo, reorganizar el plan de cuentas por completo, no solo mapearlo) o mantener ambos sistemas sincronizados de forma continua, esto ya no es una migración puntual sino un proyecto de integración a medida — escríbenos y te decimos con franqueza si te podemos ayudar.
Empieza por ver tus datos
La previsualización es gratuita y no requiere tarjeta. Verás el recuento real antes de decidir nada.