Migración

Tenemos scripts de migración probados para los tres grandes. Mapeamos productos, variantes, clientes, órdenes históricas, reviews, suscripciones y tags. Pro+ incluye asistencia humana gratis: te ayudamos con el mapping, validamos los datos y hacemos un staging dry-run antes del cutover.

Tres formas de migrar
(1) CLI propio con wp wafle migrate dentro del core. (2) npm script con npx @wafle/migrate (más cómodo desde fuera). (3) Asistencia gratis donde lo hacemos con vos en una llamada de 30 min.

Shopify

El script usa la Admin API de Shopify (necesita un token con scopes read_products,read_orders,read_customers,read_inventory) y crea todo en Wafle preservando IDs externos (vas a poder cross-reference después).

bashbash
# Opción A: CLI dentro del container Wafle
wp wafle migrate shopify ./shopify-export.json \
  --tenant gamerland \
  --dry-run

# Opción B: npm desde tu máquina
npx @wafle/migrate shopify \
  --shopify-store mystore.myshopify.com \
  --shopify-token shpat_•••• \
  --wafle-key wpk_•••• \
  --tenant gamerland \
  --dry-run

Lo que migramos:

  • Productos + variantes + imágenes + collections + tags + metafields.
  • Inventory por location (mapeado a warehouses de Wafle).
  • Customers con todos sus addresses + tags + notes.
  • Órdenes (todas o desde una fecha) con items, transactions, fulfillments, refunds.
  • Reviews (vía Yotpo / Judge.me / Loox si están conectados).
  • Discount codes activos.

Lo que NO migramos (tenés que setup manual):

  • Themes (Wafle es headless / managed con themes propios).
  • Apps de Shopify (cada una tiene su data; algunas tienen plugin Wafle equivalente).
  • Configuración de pagos (lo conectás de cero con MP/Stripe).

WooCommerce

bashbash
npx @wafle/migrate woocommerce \
  --woo-url https://oldstore.com \
  --woo-key ck_•••• \
  --woo-secret cs_•••• \
  --wafle-key wpk_•••• \
  --tenant gamerland \
  --include orders,customers,products,coupons \
  --since 2023-01-01

Para sitios Woo grandes (>50k productos o >500k órdenes) recomendamos importar por chunks con --chunk-size 5000 --resume-from. El script soporta resume si se cae.

Tiendanube

bashbash
npx @wafle/migrate tiendanube \
  --tn-store-id 123456 \
  --tn-token bearer_•••• \
  --wafle-key wpk_•••• \
  --tenant gamerland

Tiendanube exige autorizar la app Wafle Migrator (one-click OAuth) o pedir al soporte de TN un token de export — ambos caminos están documentados en la UI del wizard.

Otros (Mercado Shops, Magento, custom)

Si venís de Mercado Shops, Magento, BigCommerce o algo custom, podés:

  • Exportar a CSV con el formato Wafle (template en /admin/stores/<slug>/catalog/add/upload) y subir.
  • Pedir asistencia humana — escribí a [email protected] con el origen y nos ponemos a armar el mapping con vos.

Dry-run y staging

Siempre corré --dry-run primero. El script imprime un report con:

  • Cuántos productos, variantes, customers, órdenes va a crear.
  • Qué SKUs duplicados o inválidos encontró.
  • Qué categorías no mapearon (te muestra suggested mapping).
  • Conflictos de email (mismo customer en distintos sources).

Si tenés plan Starter+, podés pedir un tenant staging efímero (gratis, 7 días) donde corremos la migración real para que valides UI y data antes del cutover.

Cutover real

Recomendamos esta secuencia:

  1. Dry-run en staging, fix de mappings.
  2. Migración full a tenant productivo (sin dominio).
  3. Validación a ojo de samples (10 productos, 10 órdenes, 10 customers).
  4. Cambio de DNS (ver Conectar dominio).
  5. Ventana de freeze: 30 min sin órdenes nuevas en el origen.
  6. Migración incremental final (solo lo que entró durante el freeze).
Reviews y SEO
Si tu tienda tiene tráfico orgánico, mantené las URLs viejas con redirect 301 al equivalente Wafle. El script genera un CSV de redirects que podés cargar en /admin/stores/<slug>/seo/redirects.

Asistencia gratis para Pro+

Pro y Scale incluyen migración asistida sin costo. Te bookeás una call de 30 min, miramos juntos el catálogo y las cosas raras, hacemos el dry-run, corregimos el mapping y dejamos agendado el cutover. Pedila desde /admin/account → Soporte o por email.

Siguientes