psimport

📌 Versión del módulo: 1.0.0 📅 Última actualización: 13/07/2026 👤 Editor/Licencia: Philippe GRAND / Atoo-Net / GNU GPL v3+ 🌍 Idiomas de la interfaz: 📧 Soporte: por correo electrónico en contact@atoo-net.com ✅ Compatibilidad con Dolibarr: Dolibarr 24.0 o superior ✅ Compatibilidad con PrestaShop: PrestaShop 1.6 a 9.x ✅ Versión de PHP requerida: PHP 8.1 o superior 💡 Actualizaciones gratuitas durante un año para la misma versión y, posteriormente, un 50 % de descuento en la siguiente versión.

Migra los datos de tu tienda PrestaShop a Dolibarr con psimport

El módulo psimport proporciona un conjunto completo de herramientas de migración que permiten transferir los datos de una tienda PrestaShop existente a Dolibarr ERP/CRM.

Permite recuperar e importar tus categorías, clientes, direcciones, productos, imágenes de productos, archivos descargables y pedidos.

La migración utiliza la API REST Webservice estándar de PrestaShop. Normalmente no es necesario acceder directamente a la base de datos MySQL de PrestaShop.

En lugar de crear inmediatamente los registros en Dolibarr, psimport almacena primero la información recuperada en tablas intermedias de staging. Esto permite revisar los datos, detectar errores y corregir problemas antes de realizar la importación definitiva.

El mecanismo de staging también permite volver a ejecutar únicamente las importaciones que hayan fallado, sin tener que descargar de nuevo todos los datos desde PrestaShop.

🔄 Datos que pueden migrarse

🧩 Un proceso de migración seguro en dos etapas

Cada operación de migración se divide en dos etapas independientes:

1. Recuperación: los datos se recuperan desde PrestaShop mediante la API Webservice y se almacenan en las tablas de staging de psimport.

2. Importación: los registros de staging revisados y validados se convierten en objetos de Dolibarr.

Esta separación ofrece un mayor control que una migración directa, ya que permite comprobar los datos recuperados antes de que se realicen cambios en la base de datos de Dolibarr.

🗃️ Tablas intermedias de staging

psimport utiliza tablas específicas cuyos nombres comienzan por:

llx_psimport_*

Estas tablas almacenan la información recuperada desde PrestaShop antes de su importación definitiva en Dolibarr.

Para cada recurso, el módulo muestra:

📊 Interfaz de gestión de importaciones

La pestaña Gestión de la importación proporciona una visión centralizada de todas las operaciones de migración.

Desde esta interfaz puedes:

• Recuperar los datos desde PrestaShop mediante la acción Fetch

• Importar los datos de staging en Dolibarr mediante la acción Importar

• Consultar el número de registros pendientes, importados correctamente o con errores

• Restablecer los registros con errores para volver a procesar únicamente esos registros

• Vaciar una tabla de staging antes de realizar una nueva prueba de migración

• Consultar la fecha de la última recuperación de datos

🔁 Volver a ejecutar únicamente las importaciones con errores

Cada registro de staging dispone de un estado de importación:

Después de corregir la causa de un error, utiliza la acción Restablecer errores para devolver las filas afectadas al estado pendiente.

A continuación, puedes volver a ejecutar la importación correspondiente. Los registros que ya se hayan importado correctamente no se procesarán una segunda vez.

Esto evita tener que reiniciar toda la migración debido a un pequeño número de registros no válidos o incompletos.

📦 Migración de productos y servicios

psimport importa los productos de PrestaShop en Dolibarr junto con sus principales datos comerciales y fiscales.

La migración de productos incluye:

• La referencia del producto

• El nombre y la descripción del producto

• Los precios sin impuestos y con impuestos incluidos

• La determinación del tipo de IVA mediante los grupos de reglas fiscales de PrestaShop

• La asociación con las categorías importadas

• La imagen principal del producto

• La galería completa de imágenes del producto

• Los archivos descargables asociados a los productos virtuales

El tipo de objeto de destino en Dolibarr puede seleccionarse en la configuración del módulo.

Para módulos de software, licencias, documentos y otros artículos digitales, se recomienda importar los productos de PrestaShop como servicios de Dolibarr.

🧾 Determinación de los tipos de IVA

PrestaShop no siempre muestra directamente el porcentaje final de IVA en el recurso del producto.

psimport determina el tipo aplicable leyendo la configuración fiscal de PrestaShop mediante los siguientes recursos Webservice:

• tax_rule_groups

• tax_rules

• taxes

Esto permite transferir con mayor precisión los precios de los productos y los tipos de IVA a Dolibarr.

No obstante, los resultados relativos al IVA deben verificarse en los datos de staging y en una muestra de fichas de productos de Dolibarr antes de importar todo el catálogo.

🖼️ Imágenes principales y galerías completas de productos

psimport puede recuperar tanto la imagen principal como la galería completa asociada a cada producto de PrestaShop.

La galería se recupera mediante el endpoint de imágenes de productos de PrestaShop y se almacena en una tabla de staging específica antes de importarse en Dolibarr.

El módulo:

• Recupera todas las imágenes asociadas a cada producto

• Conserva, siempre que sea posible, el orden de las imágenes devuelto por PrestaShop

• Detecta e ignora los duplicados exactos entre la imagen principal y la galería

• Informa de las imágenes que no han podido descargarse o importarse

Dado que la respuesta exacta de la API puede variar según la versión de PrestaShop, se recomienda realizar primero una prueba con un número reducido de productos antes de importar todo el catálogo.

📥 Archivos descargables de productos virtuales

La API Webservice estándar de PrestaShop no expone los archivos descargables asociados a los productos virtuales.

Para solucionar esta limitación, psimport incluye el módulo opcional para PrestaShop Psimport Bridge.

Una vez instalado en la tienda de origen, el bridge permite a psimport recuperar los archivos ya registrados en la tabla de descargas de productos de PrestaShop.

El bridge:

• Utiliza la misma clave API Webservice de PrestaShop que psimport

• Funciona en modo de solo lectura

• No modifica la base de datos de PrestaShop

• No modifica los archivos almacenados en el servidor PrestaShop

• Únicamente permite acceder a archivos ya registrados como archivos descargables de productos

• Puede eliminarse una vez finalizada la migración

También es posible realizar una migración manual alternativa exportando la tabla de descargas de productos de PrestaShop y copiando el directorio de descargas de la tienda de origen.

👥 Migración de clientes y direcciones

psimport recupera los clientes y sus direcciones desde PrestaShop antes de crear los terceros correspondientes en Dolibarr.

La migración puede incluir:

• La identidad del cliente

• El nombre de la empresa, cuando esté disponible

• La dirección de correo electrónico

• Los números de teléfono

• La dirección postal

• El código postal y la ciudad

• La información del país

• Las direcciones de entrega y facturación asociadas

Los clientes y las direcciones se procesan conjuntamente para conservar la relación entre cada cliente y sus datos de dirección.

🛒 Migración de pedidos

psimport puede recuperar e importar los pedidos de clientes de PrestaShop y sus líneas correspondientes.

La migración de pedidos incluye:

• La referencia del pedido de PrestaShop

• El cliente asociado

• La fecha del pedido

• Los productos y servicios solicitados

• Las cantidades y los precios unitarios

• Los tipos de IVA

• Los totales del pedido

• La correspondencia de los métodos de pago

• El filtrado según los estados de pedido de PrestaShop seleccionados

Antes de importar los pedidos, deben revisarse los identificadores de los estados de pedido de PrestaShop aceptados y las correspondencias de los métodos de pago según la configuración de la tienda de origen.

Los productos y los clientes deben importarse antes que los pedidos, para que las líneas de pedido puedan asociarse a los objetos correctos de Dolibarr.

📋 Orden de migración recomendado

Para conservar las relaciones entre los objetos importados, se recomienda el siguiente orden de ejecución:

1. Categorías

2. Clientes y direcciones

3. Productos o servicios

4. Archivos descargables de productos

5. Galerías completas de imágenes de productos

6. Pedidos y líneas de pedido

Cada etapa debe revisarse antes de continuar con la siguiente.

🔍 Comprobaciones recomendadas después de cada etapa

• Comparar el número de registros en PrestaShop, en las tablas de staging y en Dolibarr

• Revisar los registros de staging pendientes y con errores

• Comprobar la jerarquía de categorías importada

• Verificar los nombres, direcciones de correo electrónico y direcciones postales de los clientes

• Comprobar las referencias, descripciones y asociaciones de categorías de los productos

• Verificar los precios sin impuestos, los precios con impuestos incluidos y los tipos de IVA

• Abrir una muestra de imágenes de productos y archivos descargables

• Comprobar las asociaciones de clientes y productos en los pedidos importados

• Comparar las líneas y los totales de los pedidos entre PrestaShop y Dolibarr

⚙️ Requisitos en PrestaShop

El Webservice de PrestaShop debe activarse desde:

Parámetros avanzados → Webservice → Activar el servicio web de PrestaShop

A continuación, debe crearse una clave API Webservice con permisos de lectura sobre los recursos necesarios:

categories, customers, addresses, countries, products, images, tax_rule_groups, tax_rules, taxes, orders, order_details

Únicamente son necesarios permisos GET, ya que psimport lee los datos desde PrestaShop y no escribe ningún dato en la tienda de origen.

⚙️ Requisitos en Dolibarr

Los siguientes módulos estándar de Dolibarr deben estar activados antes de iniciar la migración:

La activación de psimport crea automáticamente las tablas de staging necesarias. En una instalación estándar no se requiere ninguna importación SQL manual.

🔑 Configuración de la conexión API

La conexión se configura desde la página de configuración del módulo psimport en Dolibarr.

Hay disponible una prueba de conexión para verificar la URL de la API y la clave Webservice antes de iniciar la migración.

🛡️ Protección de la tienda de origen

psimport está diseñado para leer la información de PrestaShop sin modificar la tienda de origen.

• La clave Webservice de PrestaShop únicamente necesita permisos GET

• La migración escribe los datos únicamente en la base de datos y en los directorios de documentos de Dolibarr

• El módulo opcional Psimport Bridge funciona en modo de solo lectura

• El bridge únicamente expone los archivos descargables ya registrados en PrestaShop

• No se modifica ningún pedido, cliente ni producto en PrestaShop

No obstante, antes de cualquier operación de migración se recomienda encarecidamente realizar una copia de seguridad completa de ambas aplicaciones y de sus documentos.

☁️ Resolución de problemas con Cloudflare y errores HTTP 403

Si la conexión con la API funciona en un navegador, pero psimport recibe una respuesta HTTP 403 Forbidden con el cuerpo vacío, la solicitud puede estar siendo bloqueada por un cortafuegos o un servicio de protección contra bots antes de llegar a PrestaShop.

Esto puede ocurrir especialmente cuando la tienda de origen está protegida por Cloudflare Bot Fight Mode, ModSecurity u otro Web Application Firewall.

En Cloudflare, comprueba:

Seguridad → Análisis → Eventos

Si la solicitud aparece como un desafío administrado generado por Bot Fight Mode, desactiva temporalmente la protección durante la migración o crea una regla de exclusión adecuada cuando el plan de Cloudflare utilizado lo permita.

La protección de seguridad puede volver a activarse después de la migración.

🧪 Comenzar con una prueba sobre una muestra limitada

Antes de iniciar una migración completa, se recomienda encarecidamente probar cada recurso con un límite reducido de registros.

Esto permite:

• Validar la conexión con la API

• Comprobar la estructura de los datos recuperados

• Confirmar la determinación de los tipos de IVA

• Verificar la correspondencia de productos y clientes

• Comprobar los permisos de descarga de imágenes y archivos

• Confirmar las correspondencias de estados de pedido y métodos de pago

• Detectar diferencias de compatibilidad entre las versiones de PrestaShop

Una vez validada la muestra, el mismo proceso puede ejecutarse sin límite para migrar el conjunto completo de datos.

🧭 Casos de uso habituales

• Sustituir una tienda PrestaShop por un marketplace de Dolibarr: recuperar el catálogo existente, los clientes y el historial de pedidos antes del cambio de plataforma.

• Centralizar los datos comerciales: incorporar los clientes, productos y pedidos de PrestaShop al ERP/CRM Dolibarr de la empresa.

• Migrar una tienda de módulos de software: transferir productos virtuales, archivos de módulos, archivos de documentación e imágenes de productos a Dolibarr.

• Preparar una migración controlada: revisar y corregir los datos de staging antes de crear los registros en Dolibarr.

• Reanudar una migración interrumpida: volver a ejecutar únicamente los registros con errores sin descargar ni importar de nuevo los registros ya procesados correctamente.

• Conservar el historial de pedidos: recuperar los pedidos antiguos de los clientes y sus líneas para consultarlos y realizar su seguimiento comercial en Dolibarr.

❓ Preguntas frecuentes

• ¿Es necesario acceder directamente a la base de datos MySQL de PrestaShop?
  No. La migración estándar utiliza la API REST Webservice de PrestaShop. Una exportación manual de la base de datos únicamente constituye una alternativa opcional para recuperar archivos descargables cuando no se puede instalar Psimport Bridge.

• ¿Qué versiones de PrestaShop son compatibles?
  psimport es compatible con PrestaShop 1.6 a 9.x mediante la API Webservice estándar de PrestaShop.

• ¿Qué versión de Dolibarr se necesita?
  El módulo requiere Dolibarr 24.0 o superior.

• ¿Qué versión de PHP se necesita?
  Se requiere PHP 8.1 o superior.

• ¿psimport modifica los datos de PrestaShop?
  No. La API de PrestaShop se utiliza únicamente con permisos GET. Los datos se leen desde PrestaShop y se crean en Dolibarr.

• ¿Psimport Bridge modifica PrestaShop?
  No. El bridge funciona en modo de solo lectura y únicamente permite acceder a archivos ya registrados como productos descargables.

• ¿Se pueden volver a importar los registros con errores?
  Sí. Corrige los datos o la configuración, restablece los registros con errores y vuelve a ejecutar únicamente la importación afectada.

• ¿Se duplican los registros ya importados cuando se vuelve a ejecutar una importación?
  No. El estado de staging permite identificar los registros que ya se han importado correctamente.

• ¿Puedo comprobar la información antes de importarla?
  Sí. Todos los datos recuperados se almacenan primero en las tablas de staging para poder revisarlos antes de la importación definitiva.

• ¿Por qué la prueba de la API devuelve un error HTTP 403?
  La solicitud puede estar siendo bloqueada por Cloudflare Bot Fight Mode, ModSecurity u otro cortafuegos situado delante de la tienda PrestaShop.

• ¿Debo probar la migración antes de importarlo todo?
  Sí. Prueba siempre cada recurso con una muestra limitada y comprueba el resultado antes de iniciar la migración completa.

¿Por qué utilizar psimport?

• Migrar una tienda PrestaShop sin desarrollar scripts SQL de conversión específicos

• Utilizar la API Webservice estándar de PrestaShop sin necesidad de acceder directamente a la base de datos

• Comprobar y corregir los datos antes de crear los objetos en Dolibarr

• Importar categorías, clientes, direcciones, productos, imágenes, archivos y pedidos

• Recuperar los archivos descargables asociados a productos virtuales

• Determinar los tipos de IVA a partir de la configuración fiscal de PrestaShop

• Supervisar las importaciones pendientes, correctas o con errores desde una interfaz centralizada

• Volver a ejecutar únicamente los registros con errores en lugar de repetir toda la migración

• Mantener sin cambios la tienda PrestaShop de origen durante la migración

• Preparar una transición controlada de PrestaShop a una tienda basada en Dolibarr

⚠️ Recomendación importante

Una migración de datos debe probarse siempre en una instancia independiente de Dolibarr antes de realizarla en un entorno de producción.

Antes de comenzar, crea una copia de seguridad completa de:

• La base de datos de PrestaShop

• Los archivos de PrestaShop y el directorio de descargas

• La base de datos de Dolibarr

• El directorio de documentos de Dolibarr

Después de cada etapa de la migración, compara el número de registros de origen y destino y comprueba manualmente una muestra representativa de los datos importados.

📖 Documentación

La documentación completa del módulo está disponible en el wiki oficial de Dolibarr:

👉 Wiki de Dolibarr – Módulo psimport (ES)

Documentación en francés:

👉 Wiki de Dolibarr – Módulo psimport (FR)

Documentación en inglés:

👉 Wiki de Dolibarr – Módulo psimport (EN)

Más módulos