La clé Shopify qui déplace votre boutique

Ce qu’est cette clé, et pourquoi c’est vous qui la créez

Shopify ne distribue pas de mot de passe permettant à un service tiers de lire votre boutique. Vous créez à la place une petite application sur votre boutique, vous cochez exactement ce qu’elle peut lire, et Shopify lui remet un jeton. Vous collez ce jeton dans Omniterra, qui lit votre catalogue à travers lui.

Deux conséquences, toutes deux à votre avantage :

• C’est vous qui décidez de ce que nous voyons. Nous n’obtenons que les autorisations que vous cochez. Nous demandons un accès en lecture, rien qui écrive dans votre boutique Shopify.
• Vous pouvez couper à tout moment. Supprimez l’application dans Shopify et le jeton cesse immédiatement de fonctionner, sans prévenir personne.

Votre boutique Shopify continue de tourner pendant toute l’opération. Rien de ce que nous faisons ne la modifie.

Étape 1 — ouvrir les paramètres des applications

Dans votre admin Shopify, allez dans Paramètres → Applications et canaux de vente → Développer des applications.

Si un bouton Autoriser le développement d’applications personnalisées s’affiche, appuyez dessus. Shopify ne le demande qu’une fois par boutique, et seul le propriétaire peut le faire.

Étape 2 — créer l’application

Appuyez sur Créer une application, donnez-lui un nom que vous reconnaîtrez plus tard — « migration Omniterra » fera l’affaire — et confirmez.

À ce stade l’application est vide. Elle ne peut encore rien lire.

Étape 3 — cocher les autorisations

Ouvrez l’onglet Configuration, puis Intégration Admin API → Modifier.

Cochez l’accès en lecture pour tout ce que vous voulez reprendre :

Appuyez sur Enregistrer.

Omniterra affiche aussi cette liste exacte sur l’écran d’import, prête à copier, et vous indique celles qui manquent encore si la connexion revient incomplète.

Étape 4 — installer l’application et copier le jeton

Allez dans l’onglet Identifiants API et appuyez sur Installer l’application.

Shopify affiche alors le jeton d’accès Admin API, une chaîne commençant par `shpat_`. Copiez-le.

Lisez bien ce passage : Shopify n’affiche ce jeton qu’une seule fois. Si vous fermez la page sans l’avoir copié, vous ne pourrez plus le revoir — il faudra désinstaller puis réinstaller l’application pour en obtenir un nouveau. Rien n’est perdu, mais ce sont cinq minutes agaçantes.

Étape 5 — le coller dans Omniterra

Dans votre admin Omniterra, allez dans Produits → Import / Export, choisissez Shopify, saisissez l’adresse de votre boutique (`ma-boutique.myshopify.com`) et collez le jeton.

Appuyez sur Connecter. Nous lisons votre catalogue et vous montrons ce que nous avons trouvé avant la moindre écriture : combien de produits, de clients, de commandes, de pages. Rien ne bouge tant que vous ne le dites pas.

S’il indique que des autorisations manquent

Celle-ci surprend, autant la connaître d’avance : Shopify signale les autorisations accordées au moment de l’installation, pas celles que décrit la configuration actuelle. Si vous cochez d’autres cases après l’installation, l’application conserve son accès initial, plus étroit.

La solution est de réinstaller : Configuration → Intégration Admin API → Modifier, cochez ce qui manque, Enregistrer, puis Identifiants API → Réinstaller l’application. Le jeton reste le même.

Si vous avez créé l’application dans le Dev Dashboard

Certaines boutiques ont une application créée sur `dev.shopify.com` plutôt que dans l’admin de la boutique. Le principe est identique, avec deux détails en plus :

1. Modifiez `access_scopes` dans la configuration de l’application et appuyez sur Enregistrer.
2. Appuyez sur Publier. Sans publication, votre changement reste une version non publiée et la boutique ne la voit jamais.
3. Réinstallez l’application sur la boutique, pour que les nouvelles autorisations soient réellement accordées.

Ce qui se déplace, et ce qui ne peut pas

Les produits avec leurs variantes, les images, les collections, les clients, les commandes, les réductions, les pages, les articles de blog, les menus, les redirections et les fichiers passent tous.

Certaines choses ne peuvent pas suivre, et nous vous le disons avant de commencer plutôt qu’après : les codes de cartes-cadeaux (Shopify ne les expose jamais), les coordonnées bancaires enregistrées (elles appartiennent à votre prestataire de paiement, pas à votre boutique) et les applications tierces installées, avec les données qu’elles gardent en interne.

Si moins de produits arrivent que prévu

Trois choses expliquent presque tous les cas, et aucune ne signifie que l’import a échoué.

Les brouillons et les produits archivés restent en arrière par défaut. Shopify les garde hors du catalogue actif, nous aussi. Si vous les voulez, publiez-les dans Shopify avant de lancer l’import, ou faites-les venir et repassez-les en brouillon ici ensuite.

Les produits sans prix ou sans variante sont ignorés, car ils ne peuvent pas être vendus en l’état. Ils figurent dans le rapport final, nommément, pour que vous voyiez exactement lesquels et pourquoi.

Une autorisation cochée après l’installation ne s’applique qu’après avoir réinstallé l’application ; c’est le même piège que plus haut. Réinstallez, puis appuyez sur Vérifier à nouveau dans l’écran d’import — nous relisons votre catalogue sans toucher à ce qui est déjà arrivé.

Vous pouvez lancer l’import deux fois si besoin. Les produits sont appariés par leur identifiant Shopify, donc un second passage met à jour ce qui est déjà là au lieu de créer des doublons.

Combien de temps cela prend

Un catalogue de quelques centaines de produits est généralement traité en deux minutes. Les grandes boutiques passent par lots et vous pouvez quitter la page : l’import continue et vous en suivez l’avancement à votre retour.