# Conectar Shopify con RUIT

Tutorial para conectar Shopify: crear la app en el Dev Dashboard, pegar los ocho permisos, instalarla y copiar sus dos claves en RUIT.

_Updated: 2026-09-28 · Source: https://ruit.es/docs/conectar-shopify/_

En este tutorial conectas tu tienda de Shopify con RUIT. Son dos partes: primero creas una app
dentro de tu propia tienda, y después pegas sus dos claves en RUIT. Tarda **cinco minutos** y se
hace **una sola vez**.

**Necesitas** ser el propietario de la tienda, o tener el permiso de desarrollo de apps si eres
miembro del equipo. Vale cualquier tienda, incluidas las de desarrollo. RUIT no te pide en ningún
momento tu contraseña de Shopify: los permisos los defines tú y los puedes retirar cuando quieras.

> **Aviso:** Desde 2026 las apps nuevas **solo se crean en el Dev Dashboard**. Si entras en Ajustes, Apps y
> canales de venta, ya no hay formulario: solo una tarjeta que te manda allí. Las apps que creaste
> antes en el panel siguen funcionando, y sus claves están en su pestaña de credenciales.

## 1. Abre el Dev Dashboard

Abre la [guía del Dev Dashboard de Shopify](https://shopify.dev/docs/apps/build/dev-dashboard) e inicia sesión en `dev.shopify.com/dashboard` con la misma cuenta con la que administras tu
tienda. Verás la lista de apps de tu organización y, arriba a la derecha, `Create app`.

_Captura: La lista de apps del Dev Dashboard de Shopify, con el buscador por nombre y el botón de crear app arriba a la derecha_

La lista de apps. Si es tu primera vez estará vacía y verás un comando de terminal: ignóralo, es
para quien programa apps. El botón que buscas es `Create app`.

## 2. Crea la app y ponle nombre

Pulsa `Create app`, escribe un nombre que reconozcas y confirma. El nombre es solo para ti.

_Captura: La pantalla de crear una app en el Dev Dashboard, con el campo del nombre y el botón de crear_

Cualquier nombre sirve. En las figuras de esta guía se llama RUIT.

## 3. Pega los ocho permisos

Shopify te deja en la pantalla de la versión. Busca el apartado `API access` y, en el campo
`Scopes`, pega esta lista tal cual:

```
read_products,write_products,read_inventory,write_inventory,read_locations,read_orders,read_publications,write_publications
```

Hay también un botón para marcarlos uno a uno en una lista larguísima, pero pegar la lista es más
rápido y no te dejas ninguno. El resto de los campos se quedan como vienen.

_Captura: El campo `Scopes` del Dev Dashboard con los ocho permisos pegados como una lista separada por comas_

Los ocho permisos pegados de una vez. Debajo del campo hay un selector con casillas que hace lo
mismo, uno a uno.

| Permiso                                   | ¿Obligatorio? | Para qué                                                       |
| ----------------------------------------- | ------------- | -------------------------------------------------------------- |
| `read_products` y `write_products`        | Sí            | Importar, publicar y editar productos                           |
| `read_inventory` y `write_inventory`      | Sí            | Mantener el stock sincronizado                                  |
| `read_locations`                          | Sí            | Saber en qué almacén escribir ese stock                         |
| `read_orders`                             | Sí            | Enterarse de las ventas al momento. Sin él la conexión se rechaza |
| `read_publications` y `write_publications`| Muy recomendado | Que el producto se vea en tu tienda y no solo en el panel     |

> **Aviso:** Los seis primeros se comprueban al conectar, así que si falta alguno te enteras en el acto. **Los
> dos de publicaciones no se comprueban**, y esa es la trampa: la conexión sale bien, el producto se
> crea, y no aparece en tu tienda porque nadie lo publicó en el canal de venta. Ponlos ahora y te
> ahorras el viaje.

## 4. Publica la versión

Pulsa `Release`, arriba a la derecha, y confirma en la ventana que se abre. El nombre y el mensaje
que te pide son opcionales.

_Captura: La ventana que confirma la publicación de una versión nueva de la app, con los campos opcionales de nombre y mensaje_

Este paso es el que más se olvida. **Sin publicar la versión, las claves del paso 6 todavía no
existen.**

## 5. Instala la app en tu tienda

Vuelve a la vista general de la app y pulsa `Install app`. Elige tu tienda y confirma en la
pantalla de permisos.

_Captura: La vista general de la app en el Dev Dashboard, con la versión activa y el botón de instalar la app_

La vista general, con la versión ya publicada y el botón de instalar.

_Captura: La pantalla de instalación dentro del panel de la tienda, con los permisos que pide la app y los botones de cancelar e instalar_

Shopify avisa de que la app no ha pasado su revisión. Es lo normal en una app privada creada en tu
propia organización: nadie más que tú puede instalarla, y los permisos son los que acabas de
definir.

> **Nota:** Sin este paso las claves existen pero no autorizan nada, y RUIT rechaza la conexión diciendo que la
> app no está instalada en la tienda.

## 6. Copia el `Client ID` y el `Client Secret`

En los ajustes de la app, en el apartado de credenciales, tienes los dos valores. El secreto está
oculto hasta que pulsas el icono del ojo.

> **Aviso:** RUIT quiere el par **`Client ID` más `Client Secret`**, y nada más. No copies la clave de automatización
> del Dev Dashboard ni, en una app antigua, la clave de acceso que empieza por `shpat_`. Con esas dos
> claves RUIT emite sus propios accesos, que caducan cada día y se renuevan solos, así que nunca
> guardamos una clave permanente de tu tienda.

## 7. Conecta la tienda en RUIT

Entra en **Configuración → Cuentas**, pulsa **Conectar Cuenta** y elige **Shopify**. Te pide tres
cosas:

| Campo             | Qué pegar                                        |
| ----------------- | ------------------------------------------------ |
| URL de la tienda  | El dominio que acaba en `.myshopify.com`          |
| `Client ID`         | El del paso 6                                     |
| `Client Secret`     | El del paso 6                                     |

La dirección es el dominio terminado en `.myshopify.com`, no el dominio con el que vendes de cara al
público. RUIT es tolerante al copiar y pegar: también acepta la dirección del panel de administración.

_Captura: El diálogo de conectar Shopify en RUIT: el enlace a esta guía, los campos de la URL de la tienda, el identificador y el secreto de la app, y los botones de cancelar y conectar_

El diálogo de Shopify. Los números señalan **URL de la tienda**, `Client ID` y `Client Secret`.

_Vídeo pendiente: Conectar una tienda de Shopify_

## Qué has conseguido

Tu tienda de Shopify está conectada a RUIT con unas claves que son tuyas y que puedes revocar
cuando quieras. A partir de aquí puedes importar los productos que ya tienes, publicar los de tu
inventario, y RUIT se entera de cada venta en cuanto ocurre.

_Captura: La pantalla de Cuentas conectadas de RUIT con una tarjeta por marketplace, entre ellas la de Shopify con la tienda conectada, y el botón de conectar cuenta arriba a la derecha_

La tienda de Shopify entre las cuentas conectadas, con el nombre de la tienda en Shopify y sin
botón de reconectar.

**Siguiente paso:** [importar desde un marketplace](https://ruit.es/docs/importar-desde-un-marketplace/) para traer
lo que ya vendes en esa tienda.

## Si algo no cuadra

- **La conexión falla diciendo que faltan permisos.** El error nombra cuáles. Vuelve al paso 3,
  pega la lista entera en una **versión nueva** de la app y publícala; los permisos viajan con la
  versión, así que editarlos sin publicar no cambia nada.
- **El producto se crea pero no se ve en la tienda.** Te faltan los dos permisos de publicaciones.
  Son los que no se comprueban al conectar.
- **La conexión falla diciendo que la app no está instalada.** Te saltaste el paso 5, o instalaste
  la app en otra tienda.
- **Tenías una app de antes de 2026.** Sigue valiendo. Sus claves están en su pestaña de
  credenciales dentro del panel de la tienda, no en el Dev Dashboard.

- [Vender en Shopify con RUIT](https://ruit.es/docs/vender-en-shopify/)
- [Conectar WooCommerce con RUIT](https://ruit.es/docs/conectar-woocommerce/)
- [Cómo funciona conectar una cuenta](https://ruit.es/docs/como-funciona-conectar-una-cuenta/)
