Saltar al contenido
Cuéntanos tu proyecto

Migración · · 10 min de lectura

Cómo migrar de VTEX a Shopify: datos, catálogo y URL

Para migrar de VTEX a Shopify hay que saber qué datos salen de VTEX y por dónde, cómo encajan en Shopify su modelo de producto y SKU, sus políticas comerciales y el Master Data, y cómo proteger las URL de producto que terminan en /p. Esta guía lo explica con la documentación oficial de cada plataforma, para que puedas preparar la extracción y pedir propuestas comparables.

Antes de migrar: qué hace VTEX que Shopify resuelve de otra forma

Una tienda VTEX suele tener más piezas de las que se ven en el frontal. Antes de exportar nada, haz inventario de lo que usa hoy y de quién depende cada pieza dentro de la empresa.

Para cada elemento de la lista, decide su destino en Shopify: función nativa, app, desarrollo a medida o no llevarlo. Esa lista es la que hace comparables las propuestas. Si quien te presupuesta no pregunta por las políticas comerciales ni por el Master Data, está pensando en una migración más sencilla que la tuya.

Si hay un ERP o un OMS, fija también qué sistema manda en cada dato: catálogo, precios, stock, pedidos y clientes. Cambiar de plataforma es buen momento para revisarlo; la guía de integrar Shopify con un ERP explica cómo repartir esos flujos.

  • Políticas comerciales y para qué canal sirve cada una
  • Vendedores externos o funcionamiento como marketplace
  • Promociones activas y tablas de precios
  • Entidades propias del Master Data, además de clientes y direcciones
  • Apps y desarrollos sobre el frontal, sea Store Framework o FastStore
  • Integraciones con ERP, OMS, logística y marketplaces externos

Qué se puede exportar de VTEX y cómo

VTEX anunció que a finales de febrero de 2026 todas sus tiendas tendrían la nueva experiencia de importación y exportación por hoja de cálculo, que reúne las operaciones en Catálogo > Productos y SKUs. Desde ahí, con el botón Exportar, salen por separado los productos y SKU, las especificaciones de producto, las de SKU y las imágenes. Cada exportación es un archivo .xlsx cuyo enlace de descarga llega por email y caduca a las 24 horas.

La hoja de productos y SKU admite hasta 300.000 productos por exportación. Trae, entre otros campos, nombre, descripción, marca, departamento, categoría, la parte final de la URL del producto, el título de página, la meta descripción y las políticas comerciales en las que está; por SKU, la referencia, el EAN, las medidas y el peso. Precios y stock no están entre sus campos, y las imágenes y las especificaciones tienen su propia hoja.

Los precios se exportan desde la lista de precios del módulo de Precios, eligiendo la tabla de precios base, la de precios fijos o la de precios calculados, que es el precio final sin promociones. Solo aparecen los SKU que tienen precio. El stock se exporta desde la pestaña de almacenes de la estrategia de envío, con la opción de exportar ítems: el archivo llega por email, con una fila por SKU y almacén.

Los clientes y sus direcciones están en el Master Data, en dos entidades de datos: CL para los perfiles y AD para las direcciones, enlazadas por el campo userId. Se extraen con la API de Master Data, que tiene un endpoint de scroll para recorrer muchos documentos en varias peticiones. Si la tienda guarda datos propios en otras entidades, localízalas y decide qué pasa con cada una.

Los pedidos se sacan con la API de pedidos de VTEX, que permite listarlos y pedir el detalle de cada uno, o con una app de migración que haga esa extracción.

  • Hoja de productos y SKU, con todos los campos
  • Hojas de especificaciones de producto y de SKU
  • Hoja de imágenes por SKU
  • Tablas de precios base y fijos
  • Stock por almacén
  • Clientes (CL) y direcciones (AD) del Master Data
  • Pedidos, si se van a importar o a archivar
  • Lista de URL con tráfico sacada de Search Console

Del modelo producto-SKU de VTEX a productos y variantes

En VTEX el producto reúne los datos comunes y cada SKU es una variación concreta, con su referencia, EAN, medidas y peso. Shopify se organiza de forma parecida: el producto tiene opciones, como talla o color, y cada combinación de valores es una variante con su SKU, su precio y su artículo de inventario. La traducción directa es un producto VTEX por producto Shopify y un SKU por variante.

El límite de 100 variantes por producto que todavía aparece en muchas comparativas está desactualizado. Desde el 15 de octubre de 2025 todos los comerciantes de Shopify pueden crear productos con hasta 2.048 variantes. La letra pequeña está en las apps: las que no usan las API de producto GraphQL vigentes pueden fallar con productos de más de 100 variantes, así que revisa las de catálogo, feeds y ERP antes de cargar productos grandes.

Las especificaciones de VTEX piden una decisión campo a campo. Las de SKU que distinguen una variante de otra pasan a ser opciones. El resto, como composición, medidas o datos técnicos, va a metacampos de producto o de variante; y si un dato tiene ficha propia y se repite en muchos productos, como un material, a metaobjetos. La guía de metaobjetos en Shopify explica cuándo compensa cada uno.

Departamentos y categorías se convierten en colecciones, manuales o automáticas por condiciones, y la jerarquía se rehace en el menú de navegación. La marca puede ir a un metacampo o a una colección por marca si necesita página propia.

Con un catálogo pequeño basta el CSV de productos de Shopify. Con miles de SKU, especificaciones e imágenes por variante, compensa un script sobre la Admin API o una app de importación que se pueda repetir hasta que el resultado esté limpio; la guía de importar productos a Shopify explica cómo revisar la carga. En Weblineo hacemos este mapeo de catálogo, junto con el de URL, dentro del servicio de migración a Shopify.

Políticas comerciales, precios y B2B

En VTEX una política comercial agrupa la configuración de catálogo, precios, promociones, logística, segmentación de clientes y pagos de una estrategia de venta. Sirve para separar las condiciones de marketplaces, vendedores, la tienda propia, las tiendas físicas o el canal B2B. En la ayuda en inglés de VTEX ya aparecen como sales channels, canales de venta; en la versión en español siguen llamándose políticas comerciales.

Shopify reparte esas funciones entre varias piezas, así que conviene revisar cada política comercial por separado y decidir a cuál va.

La parte que más análisis pide es el marketplace. Si en VTEX hay vendedores externos que publican su catálogo y reciben pedidos, decide antes de empezar si ese modelo sigue, cómo les llegan los pedidos y quién cobra. En Shopify hay que elegir y probar una solución concreta, sea una app o un desarrollo, y tenerla validada antes de cerrar el alcance de la migración.

  • Países, monedas e idiomas: Markets. Cada mercado agrupa países o regiones y admite precios en moneda local, ajustes por porcentaje o precios fijados por país o región. La guía de Shopify Markets lo detalla.
  • Empresas con su propio surtido y precios: Shopify B2B, con empresas y catálogos. Está en los planes Basic, Grow, Advanced y Plus; fuera de Plus hay un máximo de 3 asignaciones de catálogo activas entre los mercados B2B. La guía de Shopify B2B explica cómo se monta.
  • Marcas o países que necesitan una tienda separada, con su configuración y su frontal: tiendas de expansión de Shopify Plus, hasta diez tiendas por organización sin coste adicional, contando la principal.
  • Promociones: se rehacen como descuentos de Shopify; las que dependen de condiciones muy específicas pueden pedir una app o un desarrollo.

Clientes, cuentas y pedidos históricos

Según el centro de ayuda de Shopify, los clientes se migran con el CSV de clientes, con una app de migración o con la API de clientes. Desde el Master Data hay que unir cada perfil de CL con sus direcciones de AD por el userId y trasladar el consentimiento de marketing de cada canal tal como estaba: quien se dio de baja en VTEX tiene que llegar a Shopify sin consentimiento.

Las contraseñas no se pueden migrar por CSV. Con las cuentas de cliente actuales de Shopify tampoco hacen falta: el cliente escribe su email y recibe un código de verificación de 6 dígitos de un solo uso. Avisa por email antes y después del cambio para que nadie crea que ha perdido su cuenta.

Para los pedidos históricos, el centro de ayuda de Shopify indica como vías las apps de migración y las API de pedidos y de transacciones, no el CSV. Antes de importarlos, desactiva las notificaciones de pedido nuevo del equipo: cada pedido importado genera un email.

La decisión previa es para qué los quieres. Si el cliente tiene que ver sus compras anteriores en su cuenta, hay que importarlos. Si solo hacen falta para contabilidad, devoluciones o atención al cliente, basta con archivar la exportación de VTEX y dejarla accesible para el equipo.

URL /p, redirecciones 301 y SEO

En VTEX la URL de una ficha de producto se forma con el dominio, el campo textLink del producto y el sufijo /p: un producto con textLink camiseta-polo queda en tienda.com/camiseta-polo/p. En Shopify la ficha vive en /products/ seguido del handle, y las colecciones en /collections/. Ninguna URL de producto de VTEX coincide con su equivalente en Shopify, así que todas las que tengan tráfico o enlaces necesitan una redirección 301.

La regla base del mapa es tienda.com/{textLink}/p hacia tienda.com/products/{handle}. Si usas el textLink como handle, el mapa sale casi directo de la hoja de productos, que trae esa parte de la URL en su propia columna. Ojo con los productos cuyo textLink se haya cambiado en el Admin o por la API de catálogo, donde el campo se llama LinkId: la URL que Google tiene indexada puede no ser la actual. Saca la lista real de Search Console y de un rastreo de la tienda, no solo de la hoja.

Las páginas de departamento y de categoría tienen sus propias rutas: asígnalas una a una a su colección. No mandes en bloque a la portada las búsquedas internas ni las URL con filtros; si alguna tiene tráfico propio, llévala a la colección más cercana.

En Shopify las redirecciones se crean desde el apartado de redirecciones de URL o importando un CSV, con un máximo de 100.000 por tienda y de 20 millones en Plus. Solo funcionan desde direcciones que dan error: si la URL antigua todavía carga una página, la redirección no salta. Tampoco se pueden redirigir rutas que empiezan por /apps, /cart, /orders o /shop. El procedimiento de carga y comprobación está en la guía de redirecciones 301 al migrar a Shopify.

Traslada también el título de página y la meta descripción de cada producto, que la hoja de VTEX trae en columnas propias. Shopify genera el sitemap.xml automáticamente; envíalo a Search Console el día del cambio.

Tema, pagos, dominio y día del cambio

El frontal de VTEX, sea Store Framework o FastStore, no se puede llevar a Shopify. El tema se construye de nuevo sobre Online Store 2.0, partiendo de la Theme Store o a medida; la guía sobre tema a medida o plantilla de Shopify ayuda a elegir. Es el momento de rehacer la ficha de producto con las especificaciones ya convertidas en metacampos.

Pagos, envíos e impuestos se configuran desde cero. Si vendes en España, apóyate en las guías de métodos de pago y de envíos en Shopify, y haz pedidos de prueba completos con cada método de pago y cada tipo de envío antes de abrir.

La tienda nueva se monta en paralelo en su dominio .myshopify.com mientras VTEX sigue vendiendo. El día del cambio, haz una última exportación de clientes y pedidos, apunta el DNS del dominio a Shopify, envía el sitemap y vigila los errores 404 en Search Console las semanas siguientes para añadir las redirecciones que falten.

En Weblineo trabajamos solo con Shopify desde 2016 y somos Shopify Plus Partner. Si estás valorando salir de VTEX, el servicio de migración a Shopify cubre la extracción, el mapeo del catálogo y las redirecciones; si los canales o el volumen piden Plus, lo planteamos con el servicio de Shopify Plus.

Preguntas frecuentes

¿La exportación de productos de VTEX incluye imágenes y precios?

No. La hoja de productos y SKU no trae precios ni stock, y las imágenes tienen su propia exportación en el mismo apartado de Catálogo. Los precios salen de la lista de precios y el stock de los almacenes, cada uno en su archivo.

¿Qué pasa con las URL de producto que terminan en /p?

Dejan de existir. En VTEX la ficha es dominio, textLink y /p; en Shopify, /products/ y el handle. Cada URL con tráfico necesita una redirección 301 a su producto, y usar el textLink como handle hace el mapa casi directo.

¿Cuántas variantes admite Shopify por producto?

Hasta 2.048 para todos los comerciantes desde octubre de 2025; el límite de 100 que circula está desactualizado. Comprueba que tus apps de catálogo usan las API de producto GraphQL vigentes, porque las que no lo hacen pueden fallar por encima de 100 variantes.

¿Hace falta Shopify Plus para salir de VTEX?

Depende de lo que resuelvan hoy tus políticas comerciales. B2B está disponible desde el plan Basic, con un máximo de 3 asignaciones de catálogo activas fuera de Plus. Plus hace falta para las tiendas de expansión, para superar las 100.000 redirecciones o para quitar ese límite de catálogos.

¿Mis clientes tendrán que registrarse otra vez?

No. Sus datos se importan, aunque las contraseñas no se pueden migrar. Con las cuentas de cliente actuales de Shopify entran con su email y un código de un solo uso, sin contraseña.

Cuéntanos qué necesita tu tienda

Cuéntanos tu proyecto en unos minutos. Si encaja, reservas una llamada de 30 minutos con un desarrollador y te enviamos una propuesta con precio cerrado.

Cuéntanos tu proyectoTe respondemos en menos de 24 horas