Qué hay que mapear al migrar VTEX a Shopify
Para migrar VTEX a Shopify hay que mapear tres sistemas conectados: catálogo y merchandising, checkout y promociones, y operación con OMS e integraciones. Tratarlo como una importación de productos deja fuera las reglas que determinan qué se vende, a qué precio y cómo se entrega.
El trabajo empieza con ejemplos reales y APIs de origen, no con una plantilla vacía. La documentación de VTEX ayuda a extraer estructuras, pero el uso concreto de cada cuenta debe verificarse.
Consulta el servicio de migración a Shopify para el programa completo y Shopify frente a VTEX para la comparación de plataforma.
Descubrimiento del estado actual
Registra:
- cuentas, entornos y tiendas;
- categorías, marcas, productos, SKUs y especificaciones;
- sellers y reglas de disponibilidad;
- listas o políticas comerciales utilizadas;
- precios, promociones y cupones;
- checkout, pagos, impuestos y logística;
- pedidos, cancelaciones y devoluciones;
- CMS, búsqueda y merchandising;
- ERP, PIM, WMS, CRM, marketplaces y marketing;
- rutas, redirects, sitemap e internacionalización;
- jobs, aplicaciones y endpoints personalizados.
Para cada elemento, añade volumen y última utilización. Así se distingue una capacidad crítica de una configuración abandonada.
Catálogo: producto, SKU y especificaciones
VTEX y Shopify no utilizan el mismo modelo. Crea una tabla de correspondencia explícita:
| VTEX | Shopify | Pregunta de diseño |
|---|---|---|
| Producto | Product | ¿Qué contenido comparten los SKUs? |
| SKU | Variant | ¿Qué opciones generan una combinación comprable? |
| Categoría | Collection o taxonomía | ¿Es navegación, clasificación o ambas? |
| Especificación | Metafield, opción o tag | ¿Es estructurada, filtrable o editorial? |
| Marca | Vendor o metafield | ¿Cómo se usa en filtros y feeds? |
No conviertas todas las especificaciones en tags. Los metafields permiten tipos y validación; las opciones deben reservarse para variantes.
Mantén una tabla con ID de VTEX, ID de Shopify, SKU y estado. Títulos y URLs pueden cambiar; no son identificadores seguros.
Sellers, stock y fulfillment
Si VTEX utiliza sellers o logística distribuida, decide cómo se representa en Shopify: locations, apps, marketplace externo o integración propia. No existe una correspondencia automática válida para todas las operaciones.
Documenta:
- quién calcula disponibilidad;
- qué stock se muestra como vendible;
- cómo se asigna la ubicación;
- quién crea fulfillment;
- cómo vuelve el tracking;
- qué ocurre con pedidos parciales;
- cómo se procesan cancelaciones y devoluciones.
Prueba pedidos que combinen sellers, ubicaciones o plazos distintos. El camino simple puede ocultar el principal riesgo de operación.
Precio, promociones y checkout
Extrae reglas y resultados, no solo configuraciones. Para cada promoción conserva carritos de prueba con productos, cliente, canal, fecha, descuento esperado y exclusiones.
Clasifica la regla futura:
- configuración nativa de Shopify;
- descuento o función compatible;
- app;
- lógica en sistema externo;
- retirada por falta de uso.
En checkout, cubre métodos de pago, antifraude, impuestos, direcciones, envío, pickup, gift cards y consentimiento. Algunas extensiones dependen del plan y del punto de extensión disponible; valídalo antes de aprobar la arquitectura.
OMS, ERP y sistemas externos
El pedido debe seguirse extremo a extremo:
- creación en Shopify;
- validación y pago;
- envío a OMS o ERP;
- aceptación;
- asignación y preparación;
- fulfillment y tracking;
- cancelación o devolución.
Guarda los identificadores de ambos sistemas y diseña idempotencia. Un timeout puede ocurrir después de que el sistema destino haya creado el pedido; repetir a ciegas genera duplicados.
Una conciliación periódica debe localizar pedidos sin pareja, líneas distintas, estados estancados y fulfillments ausentes.
Contenido, rutas y SEO
Extrae todas las URLs conocidas y clasifica su intención. Las rutas de categorías, productos, marcas, páginas y contenidos pueden cambiar al entrar en la estructura de Shopify.
El mapping debe cubrir:
- destino final y redirect directo;
- canonical;
- contenido que se conserva;
- enlaces internos;
- hreflang si existen mercados o idiomas;
- filtros y parámetros;
- páginas de marca con demanda;
- recursos con enlaces externos.
No mantengas indexables combinaciones de filtros solo porque estaban disponibles en VTEX. Decide según utilidad y demanda. La guía de migración SEO a Shopify amplía esta parte transversal.
Migración repetible de datos
Construye scripts o procesos que puedan ejecutarse más de una vez. Separa carga inicial y delta final:
- taxonomía y definiciones;
- productos y SKUs;
- media;
- precios;
- inventario;
- clientes autorizados;
- contenido;
- redirects.
Cada lote debe informar creados, actualizados, omitidos y fallidos. Concilia conteos y una muestra estratificada, incluyendo productos con muchas especificaciones, variantes inactivas y media incompleta.
Ensayo de cutover
El ensayo mide:
- duración de exportación e importación;
- volumen de cambios durante la congelación;
- delta necesario antes de abrir;
- comprobaciones de compra e integración;
- propagación de dominio;
- activación de redirects;
- observación posterior;
- criterio para volver atrás.
El rollback debe indicar qué ocurre con pedidos recibidos en Shopify después de abrir. Volver el DNS no devuelve automáticamente esos pedidos a VTEX.
Preguntas frecuentes
¿Se pueden importar productos de VTEX directamente en Shopify?
Se pueden extraer y transformar mediante APIs o archivos, pero hay que mapear producto, SKU, especificaciones, media, precio y estado al modelo de Shopify. La importación necesita validación y correspondencias persistentes.
¿Qué ocurre con las promociones de VTEX?
Hay que evaluarlas por comportamiento. Algunas encajan en Shopify, otras necesitan una app o desarrollo y otras pueden retirarse. La equivalencia se demuestra con carritos de prueba.
¿Es necesario mantener VTEX después del lanzamiento?
Puede mantenerse en acceso controlado durante estabilización o para consultar históricos, según el plan. Su retirada debe esperar a que datos, operación, soporte y obligaciones de conservación estén resueltos.
Fuentes oficiales revisadas
Referencias usadas para contrastar recomendaciones técnicas, documentación de plataforma y criterios de búsqueda.
