Aller au contenu
Ouvrir Ruit

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.

Difficulté: Moyenne 7min de lecture

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.

1. Ouvrez le Dev Dashboard

Rendez-vous sur 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.

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.

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.

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.

AutorisationObligatoire ?À quoi elle sert
read_products et write_productsOuiImporter, publier et modifier des produits
read_inventory et write_inventoryOuiGarder le stock synchronisé
read_locationsOuiSavoir dans quel entrepôt écrire ce stock
read_ordersOuiÊtre informé des ventes sur le moment. Sans elle, la connexion échoue
read_publications et write_publicationsTrès recommandéQue le produit se voie dans votre boutique et pas seulement dans le panneau

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.

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.

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.

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.

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.

7. Connectez la boutique dans RUIT

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

ChampQuoi coller
URL de la boutiqueLe domaine qui se termine par .myshopify.com
Client IDCelui de l’étape 6
Client SecretCelui 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 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.
Voir en Markdown

Cet article vous a-t-il aidé ?