ImportFactuSOL — Módulo para Dolibarr

Migra tus datos de FactuSOL a Dolibarr con un solo clic.

ImportFactuSOL es un módulo para Dolibarr dirigido a empresas españolas que quieren pasarse de FactuSOL — uno de los programas de gestión y facturación para pymes más populares de España — a Dolibarr sin tener que volver a introducir años de datos a mano.

Sube el ZIP de copia de seguridad de FactuSOL, haz clic en Iniciar y el módulo hace el resto: lee los ficheros de base de datos Access, mapea cada entidad a su equivalente en Dolibarr e importa todo dentro de una única transacción. Si algo falla, un rollback completo deja tu base de datos de Dolibarr intacta.

Qué se importa

Qué NO se importa (por diseño)

Las facturas históricas, presupuestos, albaranes y cobros se dejan intencionadamente en FactuSOL. Tu instalación de FactuSOL sigue siendo el archivo de todos los documentos anteriores. A partir del día de la migración creas nuevas facturas en Dolibarr, con todos tus clientes, proveedores, productos y stock ya cargados.

IVA español

Los códigos de tipo de IVA de FactuSOL se convierten a los porcentajes reales:

Por qué elegir este módulo

• Sin reintroducción de datos. Miles de productos, clientes y proveedores — importados en minutos, no en meses.
• Seguro por transacción. Toda la importación corre dentro de una única transacción de base de datos. Un fallo en cualquier punto revierte todo limpiamente.
• Resolución de provincias. Las provincias de clientes y proveedores se vinculan a la lista oficial española de Dolibarr, manteniendo la integridad referencial en lugar de guardar texto libre.
• Códigos de barras EAN13. Los códigos de barras de los productos se importan si el tipo EAN13 está instalado en Dolibarr.
• Vínculos con proveedor. El proveedor habitual de cada artículo queda enlazado en llx_product_fournisseur_price.
• Informe detallado. Tras la importación, una tabla muestra importados / omitidos / advertencias por entidad.
• Notificación de errores. Si la importación falla, el desarrollador recibe un aviso automático por email para una resolución más rápida.

Requisitos

Servidor

Instalar mdbtools

Verificación: mdb-tables --version

Hosting compartido: Si tu proveedor deshabilita exec(), este módulo no puede funcionar. Se requiere un VPS o servidor propio.

Instalación

1. Descarga el ZIP del módulo desde Dolistore y descomprímelo.
2. Copia la carpeta importfactusol/ a htdocs/custom/ dentro de tu instalación de Dolibarr.
3. Inicia sesión como administrador y ve a Inicio → Configuración → Módulos/Aplicaciones.
4. Busca ImportFactuSOL y haz clic en Activar.
5. Ve a Inicio → Configuración → ImportFactuSOL para abrir la página de importación.

Cómo usarlo

1. En FactuSOL, ve a Archivo → Copia de seguridad. El resultado es un ZIP con nombre como FactuSOL_0012026.ZIP.
2. En la página de configuración de ImportFactuSOL en Dolibarr, sube ese ZIP.
3. Haz clic en Iniciar importación y espera. Bases de datos grandes (miles de productos y clientes) pueden tardar varios minutos.
4. Revisa la tabla resumen. Los registros que no pudieron importarse aparecen en la columna Advertencias.

Solución de problemas

"mdbtools no está instalado" — Instala mdbtools en el servidor (ver tabla arriba) y recarga la página. El botón de subida se reactiva automáticamente.

La importación falla a mitad — Todos los cambios se revierten. No queda ningún dato parcial en Dolibarr. Revisa el mensaje de error en la pantalla y el log de Dolibarr en DOL_DATA_ROOT/dolibarr.log.

Advertencias de provincia — Un nombre de provincia de FactuSOL no coincidió con la lista de Dolibarr. El tercero se importa igualmente; el campo de provincia queda vacío. Puedes asignarlo manualmente en la ficha del cliente o proveedor.

exec() está deshabilitado — Cambia a un VPS o contacta con tu proveedor de hosting para habilitar exec().

Historial de versiones

1.0.0

• Versión inicial
• Importa: categorías de productos, almacenes, clientes, proveedores, productos (con IVA, EAN13, categorías, vínculos de proveedor) y niveles de stock
• Seguro por transacción con rollback completo en caso de error
• Resolución de provincias mediante llx_c_departements de Dolibarr
• Compatible con Dolibarr 17 – 22

Licencia

Este módulo se distribuye bajo la licencia GNU GPL v3. Cada licencia adquirida autoriza la instalación en una única instancia de Dolibarr. Para despliegues en múltiples instancias, adquiere una licencia por instancia.

El código fuente está disponible bajo los términos de la GPL v3; no obstante, la redistribución o reventa de este módulo — modificado o no — no está permitida sin autorización previa por escrito del autor.

Autor

Diego Cebrián — diego@cebrian-it.fr