Connecter Magento

Avec la connexion Magento, Stockhub récupère les commandes de votre boutique Magento 2. Stockhub renvoie le stock et le suivi (track & trace) à Magento. Dans cet article, vous créez d'abord une intégration dans Magento, puis la connexion dans Stockhub.

Ce dont vous avez besoin

• Un accès au Magento Admin avec un compte autorisé à créer des intégrations.
• L'adresse de base de votre boutique, par exemple https://www.votreboutique.fr.

Créer une intégration dans Magento

1. Connectez-vous au Magento Admin.
2. Allez dans System > Extensions > Integrations.
3. Cliquez sur Add New Integration.
4. Sous Name, saisissez un nom reconnaissable, par exemple Stockhub. Sous Your Password, saisissez le mot de passe de votre propre compte administrateur.
5. Cliquez à gauche sur API et réglez Resource Access sur All.
6. Cliquez sur Save.
7. Dans l'aperçu, cliquez sur Activate à côté de la nouvelle intégration, puis sur Allow.
8. Copiez l'Access Token et cliquez sur Done.

Si vous préférez Custom sous Resource Access, cochez au minimum ces ressources :

• Sales > Operations > Orders, avec en dessous Actions > View, Ship, Comment et Credit Memos.
• Catalog > Inventory > Products.
• Customers > Customer Groups.
• Stores > Attributes > Product, si vous utilisez le champ Fournisseur.
• Stores > Inventory > Sources, si vous utilisez Synchroniser le stock en masse.

Autoriser l'Access Token comme jeton bearer

Depuis Magento 2.4.4, Magento n'accepte plus par défaut l'Access Token d'une intégration de la manière dont Stockhub l'utilise. Activez donc ce réglage :

1. Allez dans Stores > Settings > Configuration > Services > OAuth.
2. Ouvrez Consumer Settings.
3. Réglez Allow OAuth Access Tokens to be used as standalone Bearer tokens sur Yes.
4. Cliquez sur Save Config.

Si ce réglage est désactivé, Tester la connexion affiche Échec de la connexion dans Stockhub.

Vous trouverez plus d'informations dans la documentation d'Adobe Commerce : https://experienceleague.adobe.com/en/docs/commerce-admin/systems/integrations

Créer la connexion dans Stockhub

1. Dans le menu, allez dans Intégrations > Canaux de vente.
2. Sur l'onglet Canaux de vente, cliquez sur Nouveau canal de vente. La fenêtre Ajouter un canal de vente s'ouvre.
3. Choisissez Magento.
4. Renseignez les champs :
   • Description : un nom reconnaissable pour la connexion, par exemple le nom de votre boutique.
   • Nom de l'expéditeur : le nom sur l'étiquette d'expédition. Si vous le laissez vide, Stockhub utilise le nom de votre entreprise.
   • Boutique en ligne : l'adresse de base de votre boutique avec https://, par exemple https://www.votreboutique.fr. N'ajoutez pas /rest, Stockhub l'ajoute lui-même.
   • Access token : l'Access Token de Magento.

5. Cliquez sur Tester la connexion. Si vous voyez Connecté, Stockhub peut joindre votre boutique. Si vous voyez Échec de la connexion, vérifiez l'adresse, le jeton et le réglage des jetons bearer.
6. Cliquez sur Suivant.
7. Choisissez les données que Stockhub échange. Réglez chaque paramètre sur Actif ou Inactif :
   • Importer les commandes : récupérer les commandes de Magento.
   • Mettre à jour les informations produit existantes et Importer les nouveaux produits : vous ne les voyez que si l'entreprise de fulfilment les a activés.
   • Mettre à jour le stock vers le canal : envoyer le stock de Stockhub vers Magento.
   • Synchroniser une quantité de stock virtuelle : Stockhub ajoute cette quantité au stock envoyé à Magento.
   • Envoyer l'e-mail de suivi (track & trace) : vous ne le voyez que si l'entreprise de fulfilment l'a activé.
8. Cliquez sur Enregistrer.

Vous voyez ensuite le message Activation du canal de vente en attente. Le canal reste en statut brouillon jusqu'à ce que l'entreprise de fulfilment l'active. Ce n'est qu'alors que les synchronisations démarrent.

Fonctionnement de la connexion avec Magento

• Stockhub récupère les commandes avec le statut Processing.
• Stockhub reconnaît les produits à leur SKU.
• Si Clôturer les commandes (avec suivi) est activé, Stockhub crée dans Magento une expédition avec le suivi. La commande passe alors au statut Complete. Avec Envoyer les e-mails de suivi depuis la boutique en ligne, Magento envoie lui-même l'e-mail d'expédition à votre client.
• Si votre boutique utilise Multi-Source Inventory (MSI), activez Synchroniser le stock en masse.

Paramètres propres à Magento

Ouvrez le canal via Intégrations > Canaux de vente. En plus des paramètres généraux, vous y trouvez :

• Sur l'onglet Détails : Boutique en ligne et Access token. Saisissez-y un nouveau jeton si vous avez créé une nouvelle intégration dans Magento.
• Sur l'onglet Synchroniser : Attribut date planifiée, Synchroniser le stock en masse et Envoyer les e-mails de suivi depuis la boutique en ligne.
• Sous Champs produit personnalisés : pour Code SH, Pays d'origine, Code-barres, Refuser au retour, Prix de revient et Fournisseur, indiquez l'attribut de vos produits dans lequel Stockhub prend cette valeur.
• Sous Commandes : Ignorer les commandes avec préfixe, Importer les commandes avec préfixe, Préfixe B2B, Champs pour la remarque et Champs pour la référence client. Séparez plusieurs textes par une virgule.
• Sur l'onglet Options d'expédition : des options d'expédition dans le checkout de votre boutique. Vous ne voyez cet onglet que si l'entreprise de fulfilment a activé les options d'expédition.

Voir aussi Verkoopkanalen beheren pour tous les paramètres, les commandes du canal et la suppression d'un canal.