Ce guide vous accompagne dans la configuration du suivi de commande avec Magento 2. Vous créez une intégration en lecture seule dans votre administration Magento, récupérez ses identifiants, puis installez l’application iAdvize qui permet à votre Assistant de répondre aux questions de vos clients sur leurs commandes.

NB L’utilisation de cette application est soumise à condition et réservée aux boutiques Magento 2 en version PaaS (Adobe Commerce et Magento Open Source). Contactez votre interlocuteur habituel chez iAdvize avant de procéder à son installation.

Contexte et fonctionnement

L’application Magento 2 PaaS - order tracking permet à votre Assistant de donner aux visiteurs des informations précises sur leurs commandes et leurs expéditions, à partir des données de votre boutique.

Parcours type :

Un client demande des informations sur sa commande.
L’Assistant lui demande son numéro de commande et l’e-mail utilisé pour la passer.
L’application interroge l’API de votre boutique Magento.
L’Assistant affiche le statut et la date de la commande et, si elle est expédiée, le détail de chaque colis.

Les informations récupérées :

le statut de la commande ;
la date de la commande ;
pour chaque colis expédié, le transporteur, le numéro de suivi et les produits qu’il contient, y compris pour une commande répartie en plusieurs expéditions.

⚠ Magento ne fournit ni le lien de suivi du transporteur, ni le statut de livraison en temps réel des colis (en transit, en cours de livraison, livré). Ces informations restent gérées par le transporteur : l’Assistant ne les donne pas.

Prérequis

Pour installer l’application, iAdvize vous demande les informations suivantes :

URL de base de votre boutique Magento : l’adresse racine de votre boutique
Exemple : https://monsiteweb.com
Consumer Key (clé consommateur)
Consumer Secret (secret consommateur)
Access Token (jeton d’accès)
Access Token Secret (secret du jeton d’accès)
(Facultatif) Code de la vue de boutique (Store Code), si votre instance Magento gère plusieurs boutiques ou vues

Les quatre identifiants (Consumer Key, Consumer Secret, Access Token, Access Token Secret) sont générés ensemble, en une seule fois, quand vous créez une intégration dans votre administration Magento. Les sections suivantes expliquent comment récupérer chaque information.

Récupérer l’URL de base de votre boutique

Il s’agit de l’URL racine de votre boutique Magento, en https://, par exemple https://monsiteweb.com.

⚠ N’ajoutez aucun suffixe à cette URL (/api, /rest, /rest/V1…). L’application l’ajoute elle-même : une URL avec suffixe empêche la connexion à votre boutique.

Créer une intégration Magento

L’application se connecte à votre boutique avec le protocole OAuth 1.0a, compatible avec toutes les versions de Magento 2, y compris à partir de la version 2.4.4.

Créer l’intégration

Dans votre administration Magento, ouvrez Système > Extensions > Intégrations.
Cliquez sur Ajouter une nouvelle intégration.
Donnez-lui un nom, par exemple « iAdvize - Order tracking ».

Accorder les droits en lecture

Ouvrez l’onglet API.
Accordez l’accès aux seules ressources suivantes : Ventes > Opérations > Commandes > Actions > Voir et Ventes > Opérations > Expéditions.
Cliquez sur Enregistrer.

NB Aucun autre droit n’est nécessaire. L’application consulte vos commandes et vos expéditions, elle ne modifie jamais rien dans votre boutique.

Activer l’intégration et copier les identifiants

Dans la liste des intégrations, cliquez sur Activer sur la ligne de votre intégration.
Confirmez l’autorisation.
Magento affiche les quatre identifiants : Consumer Key, Consumer Secret, Access Token et Access Token Secret.

⚠ Copiez ces quatre valeurs dès qu’elles s’affichent et conservez-les en lieu sûr : vous les collez ensuite dans l’application iAdvize.

Récupérer le code de la vue de boutique (facultatif)

Si votre instance Magento gère plusieurs boutiques ou vues, vous pouvez indiquer la vue à laquelle l’application se connecte.

Dans votre administration Magento, ouvrez Boutiques > Paramètres > Toutes les boutiques.
Relevez la valeur de la colonne Code de la vue concernée.

Sans code renseigné, l’application utilise la vue par défaut de votre instance.

Installer l’application dans iAdvize

Vous disposez de toutes les informations nécessaires :

URL de base de votre boutique
Consumer Key, Consumer Secret, Access Token et Access Token Secret
Code de la vue de boutique, si besoin

Rendez-vous dans Paramètres > Intégration > Apps.
Recherchez Magento 2 PaaS - order tracking.
Cliquez sur Découvrir.

Cliquez sur Installer.

Dans la section Authentification, renseignez les informations récupérées.
Cliquez sur Suivant jusqu’à la fin de l’installation.

⚠ L’installation ne teste pas la connexion à votre boutique. Vérifiez chaque valeur avant de valider : une erreur dans l’URL ou dans un identifiant empêche l’Assistant de retrouver les commandes.

Une fois l’application installée, contactez votre interlocuteur habituel chez iAdvize pour finaliser la mise en place du suivi de commande dans votre Assistant.