Migrar de VTEX a Shopify: cuándo conviene y cómo hacerlo paso a paso

Cada vez más marcas en Perú y Latinoamérica evalúan dejar VTEX para pasarse a Shopify: buscan una plataforma más simple de operar, con menos dependencia técnica y un ecosistema enorme de apps. Pero una migración desde VTEX tiene sus propios retos, sobre todo cuando el catálogo es grande y hay muchas integraciones.

Un dato importante antes de empezar: el Centro de ayuda de Shopify no tiene una guía específica para VTEX, como sí la tiene para WooCommerce o Wix. Por eso en este artículo aplicamos a una migración desde VTEX la guía general de migración de Shopify y sus reglas oficiales de importación por CSV. Al final te dejamos los enlaces a las fuentes.

¿Cuándo conviene migrar de VTEX a Shopify?

• Quieres operar tu tienda sin depender de un equipo técnico para cada cambio de contenido, promociones o diseño.
• Buscas un ecosistema de apps amplio para sumar reseñas, email marketing, fidelización o facturación sin desarrollos a medida.
• Tu catálogo y tu operación ya no justifican la complejidad de tu plataforma actual.
• Quieres lanzar más rápido nuevas colecciones, campañas y tiendas para otros países.

Si tu operación depende de integraciones muy específicas con ERP o marketplaces, conviene evaluarlas antes: muchas se resuelven con apps de Shopify o con su API, pero cada caso es distinto.

¿Qué datos se pueden migrar de VTEX a Shopify?

La guía oficial de Shopify recomienda revisar qué datos quieres trasladar y aprovechar para dejar atrás contenido antiguo o con bajo rendimiento. Estos son los datos habituales y cómo se importan en Shopify:

Shopify ordena los métodos de menos a más complejo: copiar y pegar, importar por CSV, usar una app de migración, contratar a un Shopify Partner o crear una solución con la API. En catálogos grandes como los que suelen estar en VTEX, lo habitual es combinar CSV, apps y API.

Paso 1: planifica y respeta el orden de importación

Shopify es claro en esto: importa primero los productos, luego los clientes y al final los pedidos históricos. Así cada pedido queda vinculado a su producto y a su cliente. El resto de datos se puede importar en cualquier orden.

Para los pedidos, Shopify recomienda migrar los de los últimos 2 a 5 años. Y antes de importarlos, desactiva las notificaciones de personal: si no, quien recibe avisos de pedidos nuevos, incluido el dueño de la cuenta, recibirá un correo por cada pedido importado.

Paso 2: adapta tu catálogo de VTEX al CSV de productos de Shopify

Los archivos que exportas desde VTEX no siguen el formato de Shopify, así que hay que transformarlos. Estas son las reglas oficiales del CSV de productos de Shopify que más importan al migrar un catálogo grande:

• Formato: la primera fila debe tener los encabezados, las columnas van separadas por comas y el archivo se guarda en UTF-8.
• Columnas obligatorias: para productos nuevos basta con el título; si vas a cargar variantes, agrega también el identificador de URL (handle).
• Handle: puede tener letras, números y guiones, pero no espacios. Es lo que une todas las filas de un mismo producto.
• Variantes: la primera fila lleva todos los datos del producto; cada variante va en su propia fila con el mismo handle y sin repetir título, descripción, proveedor ni etiquetas.
• Hasta 3 opciones por producto (por ejemplo talla, color y material). Si en VTEX tus productos tienen más especificaciones, hay que reorganizarlas o pasarlas a metacampos.
• Imágenes: se cargan por URL, que debe ser pública, con https:// y sin contraseña. Puedes cargar hasta 250 imágenes por producto, una por fila, y agregar texto alternativo.
• Inventario: la columna de cantidad sirve solo para tiendas con una ubicación. Si manejas varios almacenes o tiendas, usa el CSV de inventario.
• Metacampos: se pueden importar metacampos de producto, pero no de variante por CSV.
• Etiquetas y códigos de barras: hasta 250 etiquetas por producto y hasta 20 códigos de barras por producto o variante.

Ojo: si un producto tiene una opción de variante incompleta, no se importa y hay que agregarlo manualmente. Y los productos que se importan ocultos no se publican hasta que los hagas disponibles en tus canales de venta.

Paso 3: migra tu base de clientes

• El archivo debe pesar 15 MB o menos; si tu base es más grande, divídela en varios archivos.
• La columna Email es obligatoria.
• Cada email y cada teléfono deben ser únicos: los clientes duplicados se omiten. Limpia duplicados antes de importar.
• Los permisos de marketing por email, SMS y WhatsApp solo aceptan yes o no. Shopify recuerda enviar correos solo a quienes aceptaron recibirlos.
• Los totales de compras de cada cliente no se importan desde el CSV: se calculan a partir de los pedidos que migres.
• Las contraseñas no se migran. Tus clientes conservan sus datos, pero tendrán que crear una contraseña nueva o ingresar con el método de acceso que configures en Shopify.
• Puedes etiquetar a los clientes importados para crear segmentos y campañas.

Paso 4: pedidos históricos y demás contenido

Los pedidos no se importan desde el admin de Shopify: se usan apps de migración de la Shopify App Store o la API. Lo mismo aplica para tarjetas de regalo, crédito de tienda y, en muchos casos, el blog. Las páginas sueltas, como políticas de envío o de cambios, se pueden copiar y pegar.

Si tu tema o tus contenidos usan imágenes y archivos alojados en tu plataforma actual, Shopify recomienda que esas URL sean accesibles durante la migración.

Paso 5: configura pagos, envíos e impuestos para Perú

• Pagos: Shopify Payments no está disponible en Perú, así que usarás un proveedor de terceros como Izipay o Mercado Pago.
• Envíos: revisa la dirección de tu tienda y tus ubicaciones, crea zonas y tarifas, y configura las dimensiones de los paquetes si usas tarifas calculadas.
• Impuestos: configúralos según las normas de tu país y usa anulaciones para casos especiales.
• Checkout: agrega tus políticas de reembolso, privacidad y términos.

Paso 6: pruebas, redirecciones y dominio

• Pedidos de prueba: una compra exitosa y una fallida, un reembolso, una cancelación y despachos totales y parciales.
• Redirecciones 301: la estructura de URL de Shopify es distinta a la de otras plataformas, así que tus enlaces antiguos dejarán de funcionar si no los rediriges. Créalas en Contenido > Menús > Redirecciones de URL o impórtalas por CSV, empezando por las páginas con más visitas.
• Dominio: desconéctalo de tu plataforma anterior antes de transferirlo para evitar errores de certificado SSL, y crea las redirecciones antes del cambio.
• Después del lanzamiento: envía tu sitemap.xml a Google Search Console y comprueba que las páginas más visitadas redirigen bien.

Para no olvidar ningún paso, revisa nuestro checklist de migración a Shopify de 30 puntos.

Errores frecuentes al migrar desde VTEX

• Querer replicar tal cual la estructura de VTEX en vez de adaptarla a las reglas de Shopify, como el límite de 3 opciones por producto.
• Importar pedidos antes que productos y clientes.
• No limpiar emails y teléfonos duplicados en la base de clientes.
• Usar URL de imágenes que dejan de estar disponibles cuando apagas la tienda anterior.
• Lanzar sin redirecciones y perder posicionamiento en Google.

Preguntas frecuentes

¿Shopify tiene una guía oficial para migrar desde VTEX?

No hay una guía específica para VTEX en el Centro de ayuda de Shopify. Se aplica la guía general de migración y las reglas de importación de productos, clientes y pedidos.

¿Se pueden migrar los pedidos de VTEX a Shopify?

Sí, pero no desde el admin de Shopify: se usan apps de migración o la API. Shopify recomienda migrar los pedidos de los últimos 2 a 5 años.

¿Qué pasa si mis productos tienen más de 3 variaciones?

Shopify permite hasta 3 opciones por producto. Las especificaciones adicionales se pueden reorganizar o guardar como metacampos.

¿Mis clientes tendrán que crear una cuenta nueva?

Sus datos se migran, pero las contraseñas no. Tendrán que crear una contraseña nueva o ingresar con el método de acceso que configures en Shopify.

¿Cuánto demora migrar de VTEX a Shopify?

Depende del tamaño del catálogo, la cantidad de datos y las integraciones. En CyberAliado migramos una tienda completa desde 2 semanas y media.

Migra de VTEX a Shopify con un Shopify Expert

En CyberAliado migramos tu tienda desde VTEX o cualquier otro CMS con productos, clientes, pedidos y redirecciones 301, y configuramos pagos locales, envíos y facturación. Revisa también cuánto cuesta migrar a Shopify en Perú.

Conoce nuestro servicio de migración o cotiza tu proyecto aquí.

Fuentes (Centro de ayuda de Shopify)

• Migrar a Shopify
• Migrar a Shopify con archivos CSV
• Usar archivos CSV para productos
• Importar y exportar clientes
• Checklist de migración a Shopify
• Países donde está disponible Shopify Payments