Cette documentation explique pas à pas comment créer et installer une application Shopify personnalisée via l’Espace Développeur (Shopify Dev Dashboard), afin de connecter votre boutique à Atoo-Sync.

1. Prérequis

Avant de commencer, vous devez disposer :

• D’un accès à l’Espace Développeur Shopify (Dev Dashboard)
• Du compte propriétaire de la boutique

Important
Il est obligatoire d’utiliser le compte propriétaire.
Sans ce compte, l’accès au Dev Dashboard et la gestion des applications ne seront pas possibles.

2. Accéder au Shopify Dev Dashboard

Depuis votre interface Shopify :

• Cliquez en haut à droite sur votre avatar
• Sélectionnez Dev Dashboard

Vous accédez à l’espace de gestion des applications.

3. Créer une application

Dans le Dev Dashboard :

• Cliquez sur Create app (Créer une application)

• Renseignez les informations suivantes :

Nom de l’application
Exemple : Atoo-Sync GesCom

URL de l’application
https://www.atoo-next.net/

4. Configurer les permissions (Scopes)

Dans l’application :

• Descendez jusqu’à la section Access
• Cliquez sur Select scopes (Sélectionner des champs daccès)
  
  

Dans la fenêtre qui s’ouvre :

• Cochez toutes les permissions nécessaires (tout autoriser)
  
  

• Cliquez sur Terminé
• Décochez :
  • Use Legacy install flow
    

Cliquez sur Done en bas de page (Publier)

5. Créer et publier une version de l’application

Dans le Dev Dashboard :

• Renseignez :

  • Version name : ex. 1.0
  • Version message : date ou commentaire

• Cliquez sur Publier

Votre version apparaît alors comme :

• Actif

Important
Tant que la version n’est pas Active, l’application ne peut pas être installée.

6. Configurer la distribution de l’application

Dans la page de l’application :

• Repérez le bloc Distribution

• Cliquez sur Distribution personnalisée

Dans cette section :

• Choisissez Distribution personnalisée puis Sélectionner

• Générez le lien d’installation

Important
Cette étape est obligatoire :
sans distribution configurée, l’installation de l’application est impossible.

7. Installer l’application sur la boutique

1 méthode possible :

• Utilisez le lien d’installation généré
• Sélectionnez la boutique concernée

Collez et exécutez le lien.

Exemple : 

-------

Une page Shopify s’ouvre :

• Vérifiez les permissions demandées
• Cliquez sur Installer

La page Atoo-Next apparait après l'installation

8. Vérifier l’installation

Après installation :

• Retournez dans le Dev Dashboard

• Vérifiez que :

• Le compteur Installations = 1

L’application est maintenant connectée à votre boutique.

9. Récupérer les identifiants API

Dans le Dev Dashboard :

• Ouvrez l’application
• Accédez à Paramètres (Settings)

Vous trouverez :

• Client ID
• Client Secret

Ces informations sont nécessaires pour Atoo-Sync.

10. Configurer la connexion dans Atoo-Sync

Dans Atoo-Sync :

• Ouvrez la configuration du site Web

Renseignez :

URL de la boutique
https://xxxx.myshopify.com/
(Remplacer xxxx par le nom de votre boutique)

Client ID
Client Secret

• Cliquez sur Enregistrer
• Cliquez sur Tester la connexion

Points d’attention importants

 Vérifiez toujours :

• Une version est bien Active
• La distribution personnalisée est configurée
• Le lien d’installation est utilisé

> En cas d’erreur, ces trois éléments sont les causes les plus fréquentes.

Résultat attendu

Une fois la configuration terminée :

• L’application est installée sur Shopify
• Les identifiants API sont récupérés
• La connexion Atoo-Sync est opérationnelle