La clave de Shopify que mueve tu tienda

Qué es esa clave y por qué la creas tú

Shopify no reparte contraseñas que permitan a otro servicio leer tu tienda. En su lugar, creas una pequeña app en tu propia tienda, marcas exactamente qué puede leer y Shopify le entrega un token. Pegas ese token en Omniterra y leemos tu catálogo a través de él.

De ahí salen dos cosas, las dos a tu favor:

• Tú decides qué vemos. Solo obtenemos los permisos que marcas. Pedimos acceso de lectura, nada que escriba en tu tienda de Shopify.
• Puedes cortarlo en cualquier momento. Borra la app en Shopify y el token deja de funcionar al instante, sin avisar a nadie.

Tu tienda de Shopify sigue funcionando todo el tiempo. Nada de lo que hacemos la cambia.

Paso 1 — abrir los ajustes de aplicaciones

En tu panel de Shopify, ve a Configuración → Aplicaciones y canales de venta → Desarrollar aplicaciones.

Si ves un botón que dice Permitir el desarrollo de aplicaciones personalizadas, púlsalo. Shopify lo pregunta una vez por tienda, y solo puede hacerlo la persona propietaria.

Paso 2 — crear la app

Pulsa Crear una aplicación, ponle un nombre que reconozcas después —«migración Omniterra» sirve— y confirma.

La app está vacía en este punto. Todavía no puede leer nada.

Paso 3 — marcar los permisos

Abre la pestaña Configuración y luego Integración de Admin API → Editar.

Marca el acceso de lectura para todo lo que quieras traer:

Pulsa Guardar.

Omniterra te muestra esta misma lista en la pantalla de importación, lista para copiar, y te dice cuáles faltan todavía si la conexión vuelve incompleta.

Paso 4 — instalar la app y copiar el token

Ve a la pestaña Credenciales de API y pulsa Instalar aplicación.

Shopify muestra ahora el token de acceso de la Admin API, una cadena que empieza por `shpat_`. Cópialo.

Lee bien esta parte: Shopify enseña ese token una sola vez. Si cierras la página sin copiarlo, no vuelves a verlo: tendrás que desinstalar y reinstalar la app para conseguir uno nuevo. No se pierde trabajo, pero son cinco minutos molestos.

Paso 5 — pegarlo en Omniterra

En tu panel de Omniterra, ve a Productos → Importar / Exportar, elige Shopify, escribe la dirección de tu tienda (`mi-tienda.myshopify.com`) y pega el token.

Pulsa Conectar. Leemos tu catálogo y te enseñamos lo que encontramos antes de escribir nada: cuántos productos, clientes, pedidos, páginas. No se mueve nada hasta que lo digas.

Si dice que faltan permisos

Esto sorprende a mucha gente, así que conviene saberlo de antemano: Shopify informa de los permisos que se concedieron al instalar la app, no de lo que dice la configuración ahora. Si marcas más casillas después de instalar, la app conserva el acceso antiguo, más estrecho.

La solución es reinstalar: Configuración → Integración de Admin API → Editar, marca lo que falta, Guardar, y luego Credenciales de API → Reinstalar aplicación. El token sigue siendo el mismo.

Si creaste la app en el Dev Dashboard

Algunas tiendas tienen una app hecha en `dev.shopify.com` en vez de dentro del panel de la tienda. La idea es la misma, con dos detalles más:

1. Edita `access_scopes` en la configuración de la app y pulsa Guardar.
2. Pulsa Publicar. Sin publicación, tu cambio se queda en una versión sin publicar y la tienda nunca la ve.
3. Reinstala la app en la tienda, para que los permisos nuevos se concedan de verdad.

Qué se mueve y qué no puede

Los productos con sus variantes, las imágenes, las colecciones, los clientes, los pedidos, los descuentos, las páginas, las entradas de blog, los menús, las redirecciones y los archivos pasan todos.

Algunas cosas no pueden pasar, y te lo decimos antes de empezar en vez de después: los códigos de tarjetas regalo (Shopify no los expone nunca), los datos de tarjetas guardados (pertenecen a tu proveedor de pagos, no a tu tienda) y las apps de terceros instaladas, con los datos que guardan dentro de sí mismas.

Si llegan menos productos de los que esperabas

Tres cosas explican casi todos los casos, y ninguna significa que la importación haya fallado.

Los borradores y los productos archivados se quedan atrás por defecto. Shopify los mantiene fuera del catálogo activo, y nosotros también. Si los quieres, publícalos en Shopify antes de lanzar la importación, o tráelos y ponlos en borrador aquí después.

Los productos sin precio o sin variante se omiten, porque tal como están no se pueden vender. Aparecen en el informe final, por nombre, para que veas exactamente cuáles y por qué.

Un permiso marcado después de instalar no se aplica hasta que reinstales la app; es la misma trampa de más arriba. Reinstala y pulsa Volver a comprobar en la pantalla de importación: leemos tu catálogo otra vez sin tocar nada de lo que ya llegó.

Puedes lanzar la importación dos veces si hace falta. Los productos se emparejan por su identificador de Shopify, así que una segunda pasada actualiza lo que ya está aquí en vez de crear duplicados.

Cuánto tarda

Un catálogo de unos cientos de productos suele estar listo en un par de minutos. Las tiendas grandes van por lotes y puedes salir de la página: la importación sigue y ves su avance cuando vuelvas.