Mise en place d’un webhook entre Shopify et Atomic Seller

Objectif

Cette procédure permet de configurer un système de notifications automatiques entre votre boutique Shopify et Atomic Seller via un webhook.

Grâce à cette configuration, les données de vos commandes sont transmises automatiquement et en temps réel à Atomic Seller pour traitement.

Prérequis

Pour mettre en place cette intégration, vous devez :

• Créer un accès API Shopify et récupérer :
  • l’URL de l’API
  • le jeton d’accès (token)
• Renseigner les informations requises dans votre espace Atomic Seller
• Définir un suffixe de référence de commande
• Configurer deux webhooks dans Shopify

1. Créer un accès API Shopify

Étapes

1. Accédez aux Paramètres de votre boutique Shopify (en bas à gauche du tableau de bord)
2. Cliquez sur Applications et canaux de vente
3. Sélectionnez Développer des applications
4. Cliquez sur Créer une application
5. Donnez un nom à votre application (ex. : Atomic Seller) puis validez

Configuration des accès API

1. Ouvrez l’onglet Configuration
2. Dans la section Intégration de l’API Admin, cliquez sur Configurer
3. Dans le champ de recherche, saisissez order
4. Cochez toutes les permissions associées
5. Cliquez sur Enregistrer

Récupération du jeton d’accès

1. Accédez à l’onglet Identifiants API
2. Cliquez sur Installer l’application
3. Cliquez sur Révéler le jeton
4. Copiez le jeton et conservez-le en lieu sûr
   ⚠️ Ce jeton ne sera plus affiché ultérieurement

2. Récupérer l’URL de l’API

L’URL de l’API Shopify suit le format suivant :

https://votredomaine/admin/api/2025-01/orders.json

Pour trouver votre domaine :

1. Dans les paramètres Shopify, cliquez sur Domaines
2. Sélectionnez votre domaine au format xxxxx.myshopify.com
3. Copiez ce domaine
4. Remplacez votredomaine dans l’URL par votre domaine

Exemple :

https://25et7c-0c.myshopify.com/admin/api/2025-01/orders.json

3. Configurer votre boutique dans Atomic Seller

Dans votre espace client Atomic Seller, renseignez les champs suivants :

• URL de l’API de la boutique : URL récupérée précédemment
• Token : jeton d’accès API
• Remplacer l’adresse : mettre NO

4. Définir un suffixe de référence de commande

Principe

Une référence de commande se compose de :

• un préfixe (ex. : #)
• un numéro de commande (ex. : 1002)
• un suffixe (ex. : MABOUTIQUE)

Exemple : #1002MABOUTIQUE

Le suffixe permet à Atomic Seller d’identifier votre boutique de manière unique.

Configuration

1. Accédez aux Paramètres Shopify
2. Ouvrez la section Général
3. Dans le bloc Référence de commande, repérez le champ Suffixe
4. Saisissez un identifiant court et explicite
5. Transmettez ce suffixe à Atomic Seller

5. Créer les webhooks

Deux webhooks doivent être configurés :

• Création d’une commande
• Mise à jour d’une commande

Fonctionnement

• Lorsqu’une commande est validée, une notification est envoyée automatiquement à Atomic Seller
• Si la commande est modifiée (par vous ou le client), une mise à jour est également envoyée

Étapes de configuration

1. Accédez aux Paramètres Shopify
2. Cliquez sur Notifications
3. Descendez jusqu’à la section Webhooks
4. Cliquez sur Créer un webhook

Configuration du premier webhook

• Événement : Création d’une commande
• Format : JSON
• URL :https://ws2.atomicseller.com/Api/WebHook/ShopifyOrder
• Version de l’API : dernière version disponible
• Cliquez sur Enregistrer

Configuration du second webhook

Répétez les mêmes étapes en sélectionnant :

• Événement : Mise à jour d’une commande

Finalisation

Votre intégration est maintenant prête à tester. N’oubliez pas de valider que tout fonctionne par un test avec votre logisticien avant de considérer que c’est opérationnel.

Dès qu’une commande est passée sur votre boutique Shopify :

• elle est automatiquement envoyée à Atomic Seller
• toutes les informations nécessaires à son traitement sont transmises en temps réel