# Connecter votre boutique Shopify à RUIT

Tutoriel pour connecter Shopify : créer l'app dans le Dev Dashboard, coller les huit autorisations, l'installer et copier ses deux clés dans RUIT.

_Updated: 2026-09-17 · Source: https://ruit.es/fr/docs/vendre-sur-shopify/_

Dans ce tutoriel, vous connectez votre boutique Shopify à RUIT. Il y a deux parties : vous créez
d'abord une app dans votre propre boutique, puis vous collez ses deux clés dans RUIT. Cela prend
**cinq minutes** et se fait **une seule fois**.

**Il vous faut** être le propriétaire de la boutique, ou disposer de l'autorisation de développement
d'apps si vous faites partie de l'équipe. N'importe quelle boutique convient, y compris celles de
développement. RUIT ne vous demande à aucun moment votre mot de passe Shopify : les autorisations,
c'est vous qui les définissez, et vous pouvez les retirer quand vous voulez.

> **Avertissement:** Depuis 2026, les nouvelles apps **ne se créent que dans le Dev Dashboard**. Si vous allez dans
> Paramètres, Apps et canaux de vente, il n'y a plus de formulaire : seulement une carte qui vous y
> envoie. Les apps que vous aviez créées avant dans le panneau continuent de fonctionner, et leurs
> clés sont dans leur onglet d'identifiants.

## 1. Ouvrez le Dev Dashboard

Rendez-vous sur [dev.shopify.com](https://dev.shopify.com) avec le compte qui administre votre
boutique. Vous verrez la liste des apps de votre organisation et, en haut à droite, `Create app`.

_Capture: La liste des apps du Dev Dashboard de Shopify, avec la recherche par nom et le bouton de création d'app en haut à droite_

La liste des apps. Si c'est votre première fois, elle sera vide et vous verrez une commande de
terminal : ignorez-la, elle est pour qui programme des apps. Le bouton que vous cherchez est
`Create app`.

## 2. Créez l'app et donnez-lui un nom

Appuyez sur `Create app`, saisissez un nom que vous reconnaîtrez et confirmez. Le nom n'est que
pour vous.

_Capture: L'écran de création d'une app dans le Dev Dashboard, avec le champ du nom et le bouton de création_

N'importe quel nom convient. Dans les figures de ce guide, elle s'appelle RUIT.

## 3. Collez les huit autorisations

Shopify vous laisse sur l'écran de la version. Cherchez la rubrique `API access` et, dans le champ
`Scopes`, collez cette liste telle quelle :

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

Il y a aussi un bouton pour les cocher une à une dans une liste interminable, mais coller la liste
va plus vite et vous n'en oubliez aucune. Les autres champs restent tels quels.

_Capture: Le champ `Scopes` du Dev Dashboard avec les huit autorisations collées comme une liste séparée par des virgules_

Les huit autorisations collées d'un coup. Sous le champ, un sélecteur à cases fait la même chose,
une par une.

| Autorisation                               | Obligatoire ?   | À quoi elle sert                                                  |
| ------------------------------------------ | --------------- | ------------------------------------------------------------------ |
| `read_products` et `write_products`        | Oui             | Importer, publier et modifier des produits                          |
| `read_inventory` et `write_inventory`      | Oui             | Garder le stock synchronisé                                         |
| `read_locations`                           | Oui             | Savoir dans quel entrepôt écrire ce stock                           |
| `read_orders`                              | Oui             | Être informé des ventes sur le moment. Sans elle, la connexion échoue |
| `read_publications` et `write_publications`| Très recommandé | Que le produit se voie dans votre boutique et pas seulement dans le panneau |

> **Avertissement:** Les six premières sont vérifiées à la connexion, donc s'il en manque une vous le savez sur-le-champ.
> **Les deux des publications ne sont pas vérifiées**, et c'est là le piège : la connexion réussit, le
> produit se crée, et il n'apparaît pas dans votre boutique parce que personne ne l'a publié sur le
> canal de vente. Mettez-les maintenant et vous vous épargnez le voyage.

## 4. Publiez la version

Appuyez sur `Release`, en haut à droite, et confirmez dans la fenêtre qui s'ouvre. Le nom et le
message qu'elle demande sont facultatifs.

_Capture: La fenêtre qui confirme la publication d'une nouvelle version de l'app, avec les champs facultatifs du nom et du message_

C'est l'étape qu'on oublie le plus. **Tant que la version n'est pas publiée, les clés de l'étape 6
n'existent pas encore.**

## 5. Installez l'app dans votre boutique

Revenez à la vue d'ensemble de l'app et appuyez sur `Install app`. Choisissez votre boutique et
confirmez sur l'écran des autorisations.

_Capture: La vue d'ensemble de l'app dans le Dev Dashboard, avec la version active et le bouton d'installation de l'app_

La vue d'ensemble, avec la version déjà publiée et le bouton d'installation.

_Capture: L'écran d'installation dans le panneau de la boutique, avec les autorisations que demande l'app et les boutons annuler et installer_

Shopify prévient que l'app n'a pas passé sa revue. C'est normal pour une app privée créée dans votre
propre organisation : personne d'autre que vous ne peut l'installer, et les autorisations sont
celles que vous venez de définir.

> **Remarque:** Sans cette étape, les clés existent mais n'autorisent rien, et RUIT refuse la connexion en disant
> que l'app n'est pas installée dans la boutique.

## 6. Copiez le `Client ID` et le `Client Secret`

Dans les réglages de l'app, à la rubrique des identifiants, vous avez les deux valeurs. Le secret
reste caché jusqu'à ce que vous appuyiez sur l'icône de l'œil.

> **Avertissement:** RUIT veut la paire **`Client ID` plus `Client Secret`**, et rien d'autre. Ne copiez pas la clé
> d'automatisation du Dev Dashboard ni, dans une app ancienne, la clé d'accès qui commence par
> `shpat_`. Avec ces deux clés, RUIT émet ses propres accès, qui expirent chaque jour et se
> renouvellent tout seuls : nous ne gardons donc jamais de clé permanente de votre boutique.

## 7. Connectez la boutique dans RUIT

Allez dans **Paramètres → Comptes**, appuyez sur **Connecter Compte** et choisissez **Shopify**. Il
vous demande trois choses :

| Champ                | Quoi coller                                |
| -------------------- | ------------------------------------------ |
| URL de la boutique   | Le domaine qui se termine par `.myshopify.com` |
| `Client ID`            | Celui de l'étape 6                          |
| `Client Secret`        | Celui de l'étape 6                          |

L'adresse est le domaine terminé par `.myshopify.com`, pas le domaine avec lequel vous vendez au
public. RUIT est tolérant au copier-coller : il accepte aussi l'adresse du panneau d'administration.

_Vidéo à venir: Connecter une boutique Shopify_

## Ce que vous avez accompli

Votre boutique Shopify est connectée à RUIT avec des clés qui sont les vôtres et que vous pouvez
révoquer quand vous voulez. À partir d'ici, vous pouvez importer les produits que vous avez déjà,
publier ceux de votre inventaire, et RUIT est informé de chaque vente dès qu'elle se produit.

**Étape suivante :** [importer depuis une marketplace](https://ruit.es/docs/importar-desde-un-marketplace/) pour
rapatrier ce que vous vendez déjà dans cette boutique.

## Si quelque chose cloche

- **La connexion échoue en disant qu'il manque des autorisations.** L'erreur nomme lesquelles.
  Revenez à l'étape 3, collez la liste entière dans une **nouvelle version** de l'app et publiez-la ;
  les autorisations voyagent avec la version, donc les modifier sans publier ne change rien.
- **Le produit se crée mais ne se voit pas dans la boutique.** Il vous manque les deux autorisations
  des publications. Ce sont celles qui ne sont pas vérifiées à la connexion.
- **La connexion échoue en disant que l'app n'est pas installée.** Vous avez sauté l'étape 5, ou
  vous avez installé l'app dans une autre boutique.
- **Vous aviez une app d'avant 2026.** Elle reste valable. Ses clés sont dans son onglet
  d'identifiants au sein du panneau de la boutique, pas dans le Dev Dashboard.
- **Le stock d'un produit est épuisé.** RUIT archive le produit dans Shopify au lieu de le
  supprimer : l'historique et l'adresse du produit sont donc conservés.

- [Vendre sur WooCommerce avec RUIT](https://ruit.es/docs/vender-en-woocommerce/)
- [Vendre sur PrestaShop avec RUIT](https://ruit.es/docs/vender-en-prestashop/)