Guía para migrar de Holded a FacturaScripts paso a paso

Esta guía recorre una migración real de Holded a FacturaScripts con MigraHoldedFS: qué preparar, en qué orden hacerlo y qué mirar al terminar.

Antes de empezar: dos avisos honestos

1. Haz copia de seguridad. Vas a crear clientes, productos y (si lo marcas) facturas. Lo ideal es probar primero en una instalación de pruebas, comprobar el resultado y luego repetirlo en la buena.

2. La API de Holded tiene cuota mensual. No es una limitación del plugin, es de Holded: según tu plan tienes desde 500 llamadas al mes (plan Plus) hasta 100.000 (Premium), más un límite por minuto. Cada página de 25 registros que leemos es una llamada. Por eso el plugin cuenta las llamadas, te enseña lo que Holded responde en sus cabeceras y te deja poner un tope por ejecución.

1. Sacar la clave de API en Holded

En tu cuenta de Holded: Configuración > Desarrolladores > Credenciales > Añadir token de API. Marca los permisos de lectura de contactos, productos y documentos, crea el token y cópialo (empieza por una cadena alfanumérica larga).

Ojo: la API no está disponible en el plan gratuito, solo en los de pago.

2. Configurar el plugin

Instala MigraHoldedFS y entra en Admin > Migrar desde Holded:

• Clave de API: la que acabas de copiar.
• Modo de API: deja Automático. Holded tiene dos generaciones de API (la clásica con cabecera key y la v2 con token Bearer) y el plugin prueba cuál admite tu cuenta.
• Pulsa Probar conexión: te dirá cuál ha funcionado.

3. Analizar antes de migrar

Pulsa Analizar mi cuenta de Holded. Sin crear nada, te dice cuántos clientes, proveedores, productos y facturas hay, y cuántas llamadas ha consumido ese análisis. Es el momento de decidir si migras todo de una vez o por partes.

4. El orden importa

Migra en este orden, revisando entre paso y paso:

1. Contactos (clientes y proveedores). Revisa unos cuantos en FacturaScripts: nombre, NIF, email, dirección.
2. Productos. Se identifican por SKU = referencia. Los productos sin SKU en Holded reciben una referencia derivada de su id (HLD-...) para no perderlos.
3. Facturas, solo cuando lo anterior esté bien. Van enlazadas a los contactos ya migrados, así que este orden evita duplicados.

5. Las facturas: lee esto antes

Las facturas son documentos contables y FacturaScripts es estricto con ellas, con razón:

• Usa una serie exclusiva para la migración (campo Serie, por ejemplo MIG). FacturaScripts exige que dentro de una serie las fechas sean correlativas; si mezclas facturas históricas de Holded con tu numeración en curso, el core las rechazará. Con una serie propia no hay conflicto.
• El plugin crea las facturas de más antigua a más reciente precisamente por eso.
• El número original de Holded se conserva: en las de venta va en el campo Número 2 y en las de compra en Número proveedor. La numeración de FacturaScripts sigue siendo la suya, correlativa.
• Usa Facturas desde / hasta para migrar por ejercicios. Además de ser más ordenado, reparte el consumo de cuota.

Si una factura falla, el registro te dice exactamente qué ha respondido FacturaScripts. El caso más habitual es justo el de las fechas y se arregla con la serie exclusiva.

6. Si se corta a mitad

No pasa nada, y esto es lo importante: la migración es reanudable. Cada registro migrado queda anotado en una tabla de correspondencias, así que si se agota la cuota, salta un error de red o cierras el navegador, vuelves a pulsar Migrar ahora y continúa donde lo dejó, sin duplicar nada.

Verás el aviso "Se alcanzó el tope de llamadas: vuelve a lanzarlo para continuar donde se quedó".

7. Al terminar

Revisa la pestaña Migrado (qué se ha traído y con qué código en FacturaScripts) y la de Registro (avisos e incidencias). Después, las comprobaciones de siempre: número de clientes, algún NIF suelto, los totales de un par de facturas contra Holded.

Preguntas frecuentes

¿Se puede repetir la migración? Sí. Por defecto lo ya migrado se omite. Si marcas Actualizar los ya migrados, se refrescan con lo que haya ahora en Holded.

¿Y si ya tenía clientes en FacturaScripts? El plugin los busca por NIF y por email antes de crear nada, así que los enlaza en vez de duplicarlos.

¿Migra presupuestos, albaranes o remesas? En la 1.0 no: contactos, productos y facturas de venta y compra. Si necesitas otro tipo de documento, dínoslo y lo valoramos para la siguiente versión.

¿Y si mi plan de Holded no tiene API? Entonces esta vía no te sirve: exporta desde el panel de Holded a CSV o Excel e impórtalo con nuestro plugin ImportIA, que reconoce las columnas solo.

¿Te atascas en algún punto? Escríbenos contando en qué paso estás y te echamos una mano.