Migrar a WooCommerce paso a paso: guía técnica real

Migrar a WooCommerce paso a paso es uno de esos procesos que parece sencillo sobre el papel y se complica rápido en la práctica. No porque la plataforma sea difícil, sino porque una tienda online en producción tiene dependencias invisibles: tablas de base de datos personalizadas, URLs hardcodeadas en el contenido, configuraciones de pasarela de pago vinculadas al dominio original, y pedidos activos que no pueden perderse. Este artículo cubre lo que los tutoriales genéricos no explican: el orden correcto, los puntos de fallo reales y cómo tomar decisiones técnicas cuando las cosas no salen exactamente como estaba previsto.

Qué tipo de migración estás haciendo realmente

Antes de ejecutar cualquier paso, conviene precisar qué tipo de migración tienes entre manos, porque el proceso varía considerablemente según el caso:

• Migración de plataforma: vienes de Shopify, PrestaShop, Magento u otro sistema. Aquí el reto principal es el mapeo de datos: productos, clientes, pedidos, categorías y atributos tienen estructuras distintas.
• Migración de hosting: la tienda ya corre en WooCommerce pero cambias de servidor. El reto es la sincronización de datos y el tiempo de inactividad mínimo.
• Migración de dominio: cambia la URL base, lo que afecta a todas las imágenes, enlaces internos, integraciones de terceros y configuración SSL.

Confundir estos escenarios lleva a omitir pasos críticos. Una migración de plataforma requiere herramientas de importación específicas. Una migración de hosting requiere clonar correctamente el sistema de archivos y la base de datos. Una migración de dominio requiere actualizar referencias en la base de datos y reconfigurar cada integración API que usa la URL anterior.

Fase 1: Auditoría antes de tocar nada

El error más frecuente es empezar a mover archivos sin haber mapeado lo que existe. Antes de cualquier acción técnica, documenta:

• Número exacto de productos, variantes, categorías y etiquetas
• Plugins activos que modifican la base de datos de WooCommerce (suscripciones, membresías, puntos de fidelidad)
• Pasarelas de pago configuradas y si están vinculadas a webhook URLs
• Integraciones externas: CRM, ERP, plataformas de email marketing, herramientas de analítica
• Tablas de base de datos adicionales creadas por plugins

Esta auditoría determina la complejidad real del proyecto. Una tienda con 200 productos simples y una pasarela Stripe básica no tiene nada que ver con una tienda con WooCommerce Subscriptions, un sistema de puntos personalizado y sincronización con un ERP externo. El tiempo estimado y los riesgos son radicalmente distintos.

Para las migraciones de plataforma, WooCommerce dispone de un importador nativo de productos vía CSV, pero ese importador no cubre pedidos históricos ni datos de clientes. Esos datos requieren herramientas o scripts adicionales.

Fase 2: Preparar el entorno de staging

Nunca migres directamente a producción. El entorno de staging es el espacio donde ocurre toda la migración hasta que está verificada al 100%. Si tu hosting lo permite, actívalo desde el panel de control. Si no, crea un subdominio temporal con acceso restringido.

En el staging necesitas replicar exactamente el entorno de destino: misma versión de PHP, mismo motor de base de datos, misma configuración de memoria. Las diferencias de entorno son la causa número uno de bugs que «solo aparecen en producción».

Clonar correctamente la tienda origen

Si partes de una tienda WooCommerce existente (migración de hosting), el clonado implica dos elementos separados que deben sincronizarse:

1. Sistema de archivos: núcleo de WordPress, tema activo, todos los plugins, carpeta wp-content/uploads. Usa rsync o un plugin como Duplicator para garantizar integridad.
2. Base de datos: exporta un dump completo con mysqldump o phpMyAdmin. Verifica que el archivo no esté truncado antes de importarlo.

Después de importar la base de datos en el nuevo entorno, actualiza las referencias de URL con WP-CLI usando el comando wp search-replace 'url-antigua' 'url-nueva' --all-tables. Este paso reemplaza las URLs hardcodeadas en posts, meta datos y opciones de WordPress en una sola operación.

Fase 3: Verificación funcional completa

Una vez la tienda está en staging con los datos migrados, la verificación no es opcional ni rápida. Este es el checklist mínimo antes de dar el paso a producción:

Verificación de datos

• Cuenta de productos en el origen vs. en el destino (deben coincidir exactamente)
• Imágenes de producto: que se muestren correctamente, sin URLs rotas
• Precios, stock, atributos y variantes de cada familia de productos
• Pedidos históricos: estado, importe, cliente asignado
• Datos de clientes: contraseñas, direcciones, historial de compra

Verificación funcional

• Flujo completo de compra: añadir al carrito → checkout → confirmación
• Pasarelas de pago en modo test: verifica que los webhooks apuntan al nuevo dominio
• Emails transaccionales: que se envían y que los enlaces dentro del email son correctos
• Integraciones externas: CRM, herramientas de email, píxeles de analítica
• Reglas de envío y zonas geográficas

Las contraseñas de los clientes no se pierden en una migración de WooCommerce a WooCommerce porque WordPress almacena hashes de contraseña que son portables. Sin embargo, en migraciones desde otras plataformas, los hashes son incompatibles y los clientes necesitarán resetear su contraseña al primer acceso.

Fase 4: El cambio de DNS y la sincronización final

Este es el momento más delicado. Entre la última exportación de datos en origen y el momento en que el DNS propaga el nuevo dominio, pueden ocurrir pedidos nuevos en la tienda original. Tienes dos estrategias:

• Modo mantenimiento controlado: activas una página de mantenimiento en la tienda original durante la ventana de cambio. Pierdes ventas potenciales pero garantizas consistencia de datos. Recomendado para tiendas con volumen bajo o medio.
• Sincronización en caliente: mantienes ambas tiendas activas durante la propagación DNS y sincronizas manualmente los pedidos nuevos. Técnicamente más complejo pero minimiza el tiempo de inactividad comercial.

La propagación DNS puede tardar entre 15 minutos y 48 horas dependiendo del TTL configurado y del proveedor de dominio. Reduce el TTL a 300 segundos (5 minutos) al menos 24 horas antes del cambio para acelerar la propagación.

Tareas inmediatamente después del cambio de DNS

1. Verifica que el certificado SSL está activo en el nuevo servidor
2. Confirma que los redirects 301 desde URLs antiguas están configurados
3. Reactiva las pasarelas de pago en modo producción
4. Actualiza los webhooks en Stripe, PayPal u otras plataformas de pago
5. Verifica Google Search Console: añade la nueva propiedad si el dominio ha cambiado
6. Envía el sitemap actualizado

Errores que convierten una migración en un problema serio

He visto proyectos de migración bien planificados complicarse por detalles que nadie documentó en la fase de auditoría. Los más frecuentes:

URLs hardcodeadas en el contenido

Muchos editores de página (Elementor, Divi, el editor de bloques nativo) almacenan URLs absolutas dentro del JSON de sus bloques. El search-replace de WP-CLI cubre la mayoría, pero a veces hay serializaciones anidadas que requieren herramientas especializadas como Search Replace DB para manejar correctamente los datos serializados.

Tablas personalizadas de plugins

Plugins como WooCommerce Subscriptions, WPML o sistemas de puntos crean sus propias tablas en la base de datos. El importador estándar no las copia. Si no identificas estas tablas en la auditoría inicial, los datos desaparecen silenciosamente durante la migración.

Ignorar el entorno PHP

Un cambio de PHP 7.4 a PHP 8.2 puede romper plugins que no han actualizado su código. Verifica la compatibilidad de todos los plugins activos con la versión de PHP del nuevo servidor antes de migrar.

No probar en móvil

El checkout de WooCommerce en móvil tiene comportamientos diferentes al desktop. La verificación funcional debe incluir dispositivos reales, no solo el simulador del navegador.

Cuánto tiempo lleva realmente una migración

Depende del tipo de migración y la complejidad de la tienda, pero estos son rangos realistas basados en proyectos habituales:

• Migración de hosting (tienda simple): 4-8 horas incluyendo verificación
• Migración de hosting (tienda compleja con integraciones): 1-3 días
• Migración de plataforma (Shopify/PrestaShop a WooCommerce): 3-10 días según el volumen de datos y la complejidad del mapeo
• Migración de dominio: 2-6 horas más el tiempo de propagación DNS

Las estimaciones que prometen migrar una tienda en producción en 2 horas sin staging ni verificación son señales de alarma. El tiempo de verificación es proporcional a la cantidad de integraciones y al volumen de datos, no negociable.

Preguntas frecuentes sobre migración a WooCommerce

¿Puedo migrar solo una parte de la tienda?

Sí, pero con precauciones. Es posible migrar solo el catálogo de productos sin migrar pedidos históricos, por ejemplo. El problema es que las integraciones suelen requerir consistencia de IDs entre sistemas. Si un pedido histórico en tu CRM referencia el ID 1045 de WooCommerce y ese ID cambia tras la migración, la referencia queda huérfana.

¿Se pierde el SEO durante la migración?

Si los slugs de producto y categoría se mantienen iguales y los redirects 301 están configurados para cualquier URL que cambie, el impacto en SEO es mínimo. La pérdida de posicionamiento en migraciones suele deberse a cambios de estructura de URLs sin redirects adecuados, no a la migración en sí.

¿Qué pasa con las suscripciones activas?

Las suscripciones activas de WooCommerce Subscriptions dependen de datos vinculados a la pasarela de pago (tokens de tarjeta, IDs de cliente en Stripe). Al migrar de hosting, estos datos suelen conservarse si la pasarela es la misma. Al migrar de plataforma, los tokens no son portables y las suscripciones activas necesitan un proceso de re-activación por parte del cliente.

Si estás evaluando si tiene sentido asumir esta migración internamente o con apoyo técnico externo, en rayoweb.es/contacto puedes explicar tu caso concreto y obtener una valoración honesta del alcance real del proyecto.