Migrar de PrestaShop 1.7 a 9 paso a paso: el plan que evita sorpresas

Una migración de PrestaShop 1.7 a 9 sale bien cuando el día del cambio es aburrido. Para que lo sea, todo lo difícil tiene que haber pasado antes, en una copia, con tiempo para equivocarse. Este es el plan que seguimos, con las trampas que solemos encontrar en cada fase.

1. Inventario: qué hace tu tienda

Antes de tocar nada, haz dos listas:

• Módulos instalados, con su versión, su autor y si están activos. Saca la lista de la base de datos para que no se escape ninguno.
• Funciones de la tienda: cómo se cobra, cómo se envía, cómo se factura, con qué se conecta (ERP, marketplaces, transportistas), qué hay de SEO, qué automatizaciones de correo.

Para cada función, decide qué la resolverá en PrestaShop 9: el mismo módulo actualizado, un sustituto, algo que ya trae el núcleo o nada, porque ya no se usa. Es habitual que una tienda con años de recorrido descubra que una parte de sus módulos no hace falta.

Revisa también la carpeta override/. Cada override es código que modifica el núcleo, y en PrestaShop 9 muchas clases han cambiado. Lo que dependa de un override hay que rehacerlo, a ser posible con hooks.

2. La copia en local

Trae una copia completa de la tienda actual (ficheros y base de datos) a un entorno de pruebas que no esté en el mismo servidor que la tienda real y que no pueda enviar correos a clientes. Esto último es importante: una copia con la base de datos real y el correo configurado puede escribir a un cliente de verdad con un simple cambio de estado de pedido.

Anonimiza los datos personales si la copia la va a manejar más gente, y desactiva o pon en modo de pruebas pasarelas, conexiones con el ERP y cualquier cron que hable con el exterior.

3. Elegir el camino: actualizar o migrar datos

Hay dos formas de llegar a PrestaShop 9:

• Actualizar sobre la instalación existente con el asistente oficial. Mantiene todo, pero arrastra también los restos de años: tablas de módulos desinstalados, configuración vieja, overrides.
• Instalación limpia de PrestaShop 9 y migración de datos: catálogo, clientes, pedidos, direcciones, CMS. Más trabajo al principio, pero la tienda nueva solo tiene lo que se ha decidido llevar.

Con una 1.7 que tiene muchos módulos de terceros, overrides y un tema muy modificado, la segunda suele dar menos problemas a medio plazo. Con una 1.7.8 cuidada y pocos módulos, actualizar puede ser suficiente. Decide sobre la copia, no sobre la teoría.

4. Los datos

Al migrar datos, comprueba cada tipo con números, no a ojo:

• Productos, combinaciones, precios específicos, stock e imágenes: el mismo número en origen y destino.
• Clientes, direcciones y grupos, con sus descuentos.
• Pedidos, con sus estados, facturas y abonos. La numeración de facturas debe continuar, no reiniciarse.
• Reglas de carrito y vales vigentes.
• Páginas CMS, categorías con sus descripciones y metadatos SEO.
• Traducciones de todos los idiomas.

Conserva los identificadores de productos y categorías siempre que puedas: facilitan las redirecciones, las integraciones y los informes.

5. El tema

Un tema de 1.7 rara vez funciona tal cual en PrestaShop 9. Las opciones habituales son adaptarlo, hacer un tema hijo del tema por defecto de PrestaShop 9 con tu diseño o elegir un tema comercial compatible. Ten en cuenta que el tema no es solo diseño: también lleva plantillas de correo, textos traducidos y, a veces, módulos propios. Revisa la tienda en móvil y en escritorio, página por página.

6. URLs y redirecciones 301

Si las URLs cambian, Google tiene que saberlo. Lo ideal es mantener la misma estructura de URLs; si no es posible, cada URL antigua con tráfico o enlaces debe redirigir con un 301 a su equivalente nueva, no a la portada. Saca la lista de URLs antiguas del sitemap, de Search Console y de los registros del servidor, y comprueba las redirecciones con un rastreo antes del día del cambio.

7. Pagos en modo pruebas

Cada método de pago se prueba en modo sandbox de punta a punta: pago correcto, pago rechazado, pago cancelado, reembolso y, si lo usas, pago con autenticación reforzada. Comprueba que el pedido se crea con el estado correcto y que la notificación de la pasarela llega. En PrestaShop 9, los módulos que recibían esas notificaciones en un .php directo dentro de modules/ pueden encontrarse con un 403, porque el .htaccess de serie deniega esas peticiones. Es una de las causas más frecuentes de «el cliente pagó y no hay pedido» tras una migración.

8. El ensayo general

Con todo listo, repite la migración entera desde una copia nueva de la tienda real, cronometrando cada paso. El ensayo sirve para tres cosas: confirmar que el proceso es repetible, saber cuánto tiempo tendrás la tienda en mantenimiento y descubrir lo que ha cambiado en la tienda real desde la primera copia.

9. El día del cambio

1. Avisa con antelación si va a haber una ventana de mantenimiento.
2. Pon la tienda antigua en mantenimiento y detén sus crons e integraciones.
3. Migra los pedidos, clientes y cambios de catálogo desde la última copia.
4. Activa en la tienda nueva las pasarelas en modo real, las conexiones con el ERP y los crons.
5. Apunta el dominio a la tienda nueva y comprueba el certificado.
6. Haz un pedido real con cada método de pago y reembólsalo.
7. Envía el sitemap nuevo a Search Console y vigila los errores 404 los días siguientes.
8. Conserva la tienda antigua parada y sin acceso público durante un tiempo, por si hay que consultar algo.

Lo que suele romperse

• Overrides que ya no encajan con las clases del núcleo.
• Módulos que no se instalan o no muestran su configuración en PrestaShop 9.
• Crons que apuntaban a ficheros .php de módulos y ahora reciben 403 sin que nadie se entere.
• Plantillas de correo que vuelven a las de por defecto o pierden traducciones.
• Numeración de facturas que se reinicia.
• Imágenes que hay que regenerar con los formatos y tamaños nuevos.
• Analítica y píxeles que se quedan en la tienda antigua.

Y una ventaja que se olvida: al terminar, tienes la tienda en una versión con soporte, con PHP actual y con módulos al día. A partir de ahí, mantenerla actualizada es mucho menos trabajo que volver a saltar varias versiones de golpe.

Cómo resolverlo en PrestaShop

Las migraciones de 1.6 y 1.7 a PrestaShop 9 son una parte importante de nuestro trabajo en Rekire. Con los bonos de horas de soporte (20, 50 o 100 horas, según el tamaño de la tienda) hacemos el proyecto entero o la parte que necesites: inventario de módulos y funciones, copia en un entorno de pruebas sin correo saliente, migración de datos comprobada por números, adaptación del tema, redirecciones, pruebas de pagos, ensayo y acompañamiento el día del cambio. Las horas se consumen según el trabajo real.