Afin de faciliter au maximum la connexion de votre boutique en ligne, Douano met à votre disposition un assistant d'installation interactif. Cet écran vous guide pas à pas tout au long du processus de configuration.

Nous vous expliquons ci-dessous en détail chaque étape de cet assistant, afin que vous sachiez exactement quelles informations vous devez avoir à portée de main pour activer correctement le plugin Shopify.

Shopify - Phase 1 : la configuration dans Shopify

☝️ Bien que l'assistant de configuration de Douano vous guide à travers la plupart des paramètres, la toute première étape de l'installation se déroule entièrement dans votre environnement Shopify.

Comme l'assistant n'a pas d'accès direct à l'interface d'administration sécurisée de votre boutique Shopify, vous devrez d'abord effectuer manuellement les étapes ci-dessous. Une fois ces informations recueillies, vous pourrez lancer l'assistant d'installation dans Douano pour finaliser la connexion.

💡 Pour permettre à Douano de communiquer en toute sécurité avec votre boutique Shopify, nous utilisons une application sur mesure au sein de votre propre environnement Shopify. Suivez les étapes ci-dessous pour configurer correctement la connexion.

Étape 1 : Créer l'application dans Shopify

Connectez-vous à l'espace d'administration (Admin) de votre boutique en ligne Shopify.
Dans le menu de gauche, accédez à Paramètres → Applications.
Cliquez en haut sur Développer des applications (Develop apps), puis sélectionnez Créer une application (Create an app).
Saisissez un nom clair, par exemple : Intégration Douano.
Cliquez sur Créer une application pour confirmer.

Étape 2 : Configurer les autorisations API (scopes)

Maintenant que l'application existe, nous devons attribuer à Douano les droits de lecture et d'écriture appropriés.

Dans l'application que vous venez de créer, cliquez sur Configurer les autorisations API Admin (Configure Admin API scopes).
Cochez les scopes ci-dessous. Ils sont classés par catégorie ci-dessous :
- Produits & Stock : write_products, read_products, write_inventory, read_inventory
- Commandes : read_orders, write_orders(Facultatif : cochez également read_all_orders si vous souhaitez récupérer les commandes historiques datant de plus de 60 jours)
- Clients : write_customers, read_customers
- Emplacements et marchés : read_locations, read_locales, read_markets, read_translations
- Remises et fichiers : read_discounts, read_files
- Expédition et traitement (Fulfillment) : write_assigned_fulfillment_orders, read_assigned_fulfillment_orders, write_merchant_managed_fulfillment_orders, read_merchant_managed_fulfillment_orders, write_custom_fulfillment_services, read_custom_fulfillment_services, write_shipping, read_shipping

Enfin, cliquez sur Enregistrer en haut à droite ou en bas à droite.

Étape 3 : Installer l'application et copier le jeton d'accès

Cliquez sur le bouton vert Installer l'application en haut de la page et confirmez l'installation.
Vous serez alors automatiquement redirigé vers l'onglet Références API (API credentials).
Dans la section Jeton d'accès API Admin , vous verrez un jeton commençant par shpat_.

☝️ Ce jeton d'accès n'est affiché qu'une seule fois ! Copiez-le immédiatement et conservez-le en lieu sûr (par exemple dans un gestionnaire de mots de passe). Si vous quittez ou actualisez la page, vous ne pourrez plus jamais consulter ce jeton. Vous devrez alors supprimer l'application et la recréer.

Étape 4 : Copier la clé secrète du webhook

Restez sur le même onglet (Références API).
Faites défiler vers le bas jusqu'à la section Abonnements aux webhooks (Webhook subscriptions).
Recherchez le texte : « Vos webhooks seront signés avec » (Your webhooks will be signed with).
Copiez le code (la clé de signature) qui se trouve juste après.

☝️ Si vous utilisez un compte partenaire dans Shopify, vous trouverez la clé secrète du webhook dans la section Notifications du menu de gauche. Elle apparaîtra ici sous "Vos webhooks seront signés avec".

Récapitulatif : de quelles données avez-vous besoin pour démarrer la configuration dans Douano ?

Données	Où les trouver ?	Exemple
URL de la boutique	Dans la barre d'adresse de votre navigateur lorsque vous êtes connecté à l'interface d'administration Shopify.	`votreboutique.myshopify.com`
Jeton d'accès à l'API d'administration	Dans l'onglet Références API (voir Étape 3). Commence toujours par shpat_	`shpat_abcdef123456...`
Clé secrète du webhook	Dans l'onglet Références API, sous la rubrique Abonnements aux webhooks (voir Étape 4).	`1a2b3c4d5e6f...`

Shopify - Phase 2 : Assistant de configuration dans Douano

Une fois le plugin Shopify activé, la connexion peut être activée et testée dans le portail Douano. Pour ce faire, suivez les étapes ci-dessous.

Dans Douano, accédez à : Paramètres ➔ Shopify ➔ Assistant de configuration

Étape 1 : La connexion

💡 Au cours de cette étape de l'assistant, vous établissez la connexion effective entre votre environnement Douano et votre boutique en ligne Shopify. Vous ouvrez ainsi l'autoroute numérique qui permet aux deux systèmes d'échanger et de synchroniser des informations en toute sécurité.

Saisir les informations : Saisissez les informations que vous avez recueillies lors des étapes précédentes (comme décrit dans l'aperçu ci-dessus).
Tester la connexion : Cliquez sur le bouton Tester la connexion.
Enregistrer les webhooks : dès que le test est réussi, un nouveau bouton apparaît juste à côté du bouton de test : Enregistrer les webhooks. Cliquez dessus.
Message de confirmation : après l'enregistrement, un encadré vert contenant un message de confirmation s'affiche en bas de l'écran. Votre connexion est désormais active.

Étape 2 : Généralités

💡 Au cours de cette étape, vous définissez les règles de la synchronisation : que faut-il faire, que faut-il éviter, et comment ? En configurant ces paramètres avec précision, vous adaptez l'intégration à votre mode de fonctionnement.

Nous vous expliquons ci-dessous les différentes options en détail, afin que vous puissiez configurer l'intégration de manière optimale.

Gamme de prix : vous indiquez ici la gamme de prix dont les prix seront importés dans Shopify pour les produits associés. Vous pouvez également choisir de créer une gamme de prix distincte dans Douano pour les produits de votre boutique Shopify.
Relation pour le client Shopify : vous sélectionnez ici une relation générale pré-créée (par exemple, une relation que vous avez nommée Consommateurs Shopify ou Ventes boutique en ligne). Toutes les commandes anonymes ou B2C dont l'adresse e-mail n'est pas connue dans Douano seront alors comptabilisées administrativement sur ce client fictif.
Produit pour l'expédition : il s'agit de l'article sur lequel les frais d'expédition sont comptabilisés. Vous sélectionnez ici un service créé dans Douano, par exemple frais d'expédition. L'argent que le client paie pour l'expédition via Shopify est alors associé à ce produit.
Confirmer automatiquement les commandes : laissez cette option cochée, sauf si vous souhaitez d'abord vérifier et confirmer manuellement chaque commande reçue de la boutique en ligne.
Synchronisation des stocks vers Shopify : cette option garantit que les variations de stock sont prises en compte dans les deux systèmes. Il est recommandé de la laisser activée en permanence.
Expéditions gérées en interne (synchronisation vers Shopify) : cette option garantit que lorsqu'une expédition est finalisée dans Douano, elle est automatiquement envoyée à la boutique en ligne en tant que Shopify fulfillment (= terminée) et s'affiche dans votre aperçu des commandes sur Shopify.
Synchroniser les produits vers Shopify : les produits sélectionnés qui sont également utilisés dans Shopify y seront mis à jour lorsque vous effectuez une modification dans Douano.
Synchroniser les commandes à partir d’une date : si votre boutique en ligne est en ligne depuis deux ans, Shopify contient des centaines, voire des milliers d’anciennes commandes. Si vous activez le plug-in sans date, Douano tenterait d'importer toutes ces commandes historiques. Cela fausserait complètement votre stock actuel et perturberait vos déclarations d'accises passées. En saisissant la date d'aujourd'hui, Douano ignore tout ce qui concerne le passé et ne commence la synchronisation qu'à partir de ce moment précis.

Étape 3 : Produits

💡 Dans cette section, vous associez définitivement vos produits Douano aux produits de Shopify. Cela garantit une synchronisation parfaite entre les deux systèmes lorsqu'une commande est passée ou lorsque le stock change.

De Douano vers Shopify : vous avez déjà sélectionné les produits que vous souhaitez transférer de Douano vers votre boutique en ligne en leur attribuant la bonne catégorie de produit.
Correspondance des produits existants : si Shopify contient déjà des produits (presque) identiques à ceux de Douano, le système vous demande ici une confirmation. Vous indiquez ici explicitement quel produit Shopify doit être associé à quel produit Douano. Cela vous permet d'éviter la création accidentelle de doublons dans votre boutique en ligne.

Comment fonctionne le mappage des produits ?

Filtrage par catégorie : les produits auxquels vous avez attribué une catégorie telle que Boutique en ligne Shopify dans Douano apparaissent automatiquement dans la liste ici.
Établir la connexion exacte : pour indiquer au plug-in quel produit Shopify correspond à quel produit Douano, vous devez les associer une seule fois ici.
Identifier les produits non liés : vous pouvez facilement reconnaître les produits qui doivent encore être liés grâce à l'icône de lien bleue à la fin de la ligne. Cliquez dessus pour établir le lien correct.

Une fois que vous avez terminé, cliquez sur Terminer en bas à droite.

Étape 4 : Terminé

💡 La configuration étant terminée, il est temps d'échanger les données existantes entre les deux systèmes. Cela vous permet de mettre immédiatement en ligne les données de base.

Envoyer les produits et les stocks vers Shopify

Cette action vous permet de finaliser la configuration et de vous assurer que les deux portails sont synchronisés :

Transfert des produits : les produits sélectionnés dans Douano sont immédiatement créés dans votre boutique en ligne Shopify.
État des stocks : les quantités de stock actuelles provenant de Douano sont immédiatement transférées et correctement affichées sur votre tableau de bord Shopify.

Shopify - Assistant de configuration