Qu'est-ce qu'une API ?

Une API (Interface de Programmation d'Application) permet à une application ou un service d'accéder aux fonctionnalités ou aux données d'une autre application de manière contrôlée. L’information est mise à jour en temps réel, vous dialoguez instantanément avec l’information la plus enrichie et la plus fiable possible. C’est donc un réel gain de temps et d’argent.

Chez WALOMO, nous avons développé une API puissante pour aider nos distributeurs à intégrer nos produits directement dans leurs propres systèmes :

le catalogue avec nos produits (caractéristiques, visuels, etc…)
les prix (vos prix d’achat distributeurs)
les stocks (en temps réel)
les dates de réapprovisionnement
les commandes (bientôt disponible)

Comment se connecter à l'API de WALOMO ?

Il vous suffit de vous connecter à votre espace client afin d'avoir directement accès en temps réel à la donnée WALOMO.

Aucune clé API n'est nécessaire. La procédure requiert seulement de rester connecté à votre espace client, en exploitant le fichier au format .json fourni par nos soins. Vous pouvez réaliser cette demande auprès du responsable commercial en charge de votre compte client.

Pourquoi se connecter à l'API de WALOMO ?

Se connecter à l'API de WALOMO offre de nombreux avantages pour nos distributeurs, leur permettant d'améliorer leur efficacité opérationnelle et d'enrichir l'expérience utilisateur. Voici quelques-uns des avantages clés :

1. Automatisation des Processus : L'intégration de notre API permet aux distributeurs d'automatiser une grande partie des processus manuels, tels que la gestion des commandes, la mise à jour des stocks, ou encore la synchronisation des commandes. Cela réduit non seulement le risque d'erreurs humaines, mais permet aussi de gagner un temps précieux.
2. Accès en Temps Réel aux Données : Grâce à notre API, les distributeurs peuvent accéder aux informations les plus récentes en temps réel. Cela inclut les niveaux de stock, les nouvelles collections, les promotions en cours, et bien plus encore. Cette transparence permet une meilleure prise de décision et une réactivité accrue face aux demandes des clients.
3. Personnalisation et Flexibilité : Notre API est conçue pour être flexible, permettant aux distributeurs de personnaliser l'intégration selon leurs besoins spécifiques. Que vous souhaitiez intégrer notre catalogue de produits dans votre boutique en ligne, ou utiliser nos outils d'analyse pour optimiser vos ventes, notre API offre des possibilités infinies.
4. Amélioration de l'Expérience Client : En intégrant directement nos services via l'API, les distributeurs peuvent offrir une expérience plus fluide et cohérente à leurs clients. Par exemple, les mises à jour automatiques de l'inventaire et des prix garantissent que les clients disposent toujours des informations les plus précises.
5. Sécurité et Conformité : Nous comprenons l'importance de la sécurité des données. Notre API est construite avec les normes de sécurité les plus élevées pour garantir la confidentialité et l'intégrité des informations échangées. De plus, nous veillons à ce que toutes les transactions soient conformes aux réglementations locales et internationales.

En se connectant à l'API de WALOMO, les distributeurs peuvent non seulement rationaliser leurs opérations, mais aussi créer de nouvelles opportunités pour engager et fidéliser leurs clients. Rejoignez-nous aujourd'hui et découvrez comment notre API peut transformer votre manière de faire des affaires.

Pour plus d'informations sur comment commencer avec notre API, veuillez consulter notre documentation technique ou contacter notre équipe d'assistance dédiée.

1. Introduction

Cette documentation fournit des instructions détaillées sur la manière d’utiliser les APIs spécifiques Walomo dans Magento 2. L’utilisation API est une fonctionnalité qui permet de récupérer des données depuis le serveur Magento et permettant à l’utilisateur de récupérer l’information rapidement.

2. Prérequis

Pour pouvoir utiliser les API Magento2, il faut pouvoir disposer d’un outil comme Postman.

Nous allons dans la suite du document utiliser Postman comme outils de référence dans les captures d’écrans.

Une fois l’application Postman installé, il faut suivre ces prochaines étapes pour finaliser la configuration :

Importer la collection Walomo avec le fichier walomo-collection.json

Créer un nouvel environnement Walomo avec les différentes variables :
- URL : type default -> valeur en fonction de l’environnement par exemple : https://www.walomo.com/rest/V1/
- currentAccessToken : type default -> pas mettre de valeur elle sera rempli automatiquement
- username : type default -> email de l’utilisateur front
- password : type secret -> mot de passe de l’utilisateur front

Sélectionner l’environnement créé

3. Générer un token client

Url : {{URL}}integration/customer/token

Method: POST

Body de la requête de type JSON :

{

"username": "{{username}}",

"password": "{{password}}"

}

Cette requête est à exécuter à chaque fois que l’on veut utiliser l’API. Le token généré est valide 1h.

4. Récupérer les prix produits

Url : {{URL}}walomo/prices/me

Method: GET

Authorization : Bearer token (voir la rubrique « Générer un token client »)

Cette requête permet de récupérer tous les prix produits en fonction des conditions commerciales du client.

5. Récupérer les stocks produits

URL : {{URL}}walomo/stocks

Method : GET

Authorization : Bearer token (voir la rubrique « Générer un token client »)

Cette requête permet de récupérer tous les stocks et les réassort des produits.

6. Récupérer les informations produits

URL : {{URL}}walomo/products

Method : GET

Authorization : Bearer token (voir la rubrique « Générer un token client »)

Params :

Skus : Liste des skus séparés par une vigule (pas obligatoire)
Page : numéro de la pagination

Cette requête permet de récupérer les informations produits. Elle renvoie par défaut 200 produits et le paramètre page permet de paginer dans la collection produit et le filtre permet de filtrer sur plusieurs skus.