API VTEX : possibilités et usage avec des agents IA
VTEX expose des API REST pour presque tous les modules de la plateforme e-commerce : catalogue, commandes, logistique, prix et clients. Distributeurs et industriels de taille moyenne ou grande, ainsi que leurs intégrateurs, l'utilisent. L'accès se fait par une clé et un jeton d'application générés dans le compte.
Ce que propose l’API VTEX
Catalogue
Produits, SKU, catégories, marques et spécifications.
Commandes (OMS)
Consultation, suivi et changement de statut des commandes, y compris l'annulation.
Logistique et stocks
Soldes par entrepôt, quais et paramètres de livraison.
Prix
Grilles et règles de prix par SKU et par politique commerciale.
Promotions
Création et consultation des promotions et des coupons.
Master Data
Données clients et entités personnalisées de la boutique.
Comment accéder à l’API VTEX
- Avec les identifiants de votre entrepriseL'API utilise une paire App Key et App Token créée dans l'administration VTEX, associée à des profils d'accès qui définissent ce que la clé peut faire.
- Certaines API ont des limites de requêtes : les intégrations en lot doivent les respecter.
- Un profil d'accès trop large donne trop de pouvoir à la clé : créez un profil propre à l'agent.
- Les données clients du Master Data sont soumises à la réglementation sur les données personnelles, comme le RGPD.
Documentation officielle: developers.vtex.com
Ce qu’un agent iTeam fait avec l’API VTEX
Service client avec la commande en main
L'agent consulte la commande dans l'OMS et son suivi, répond au client et ouvre un dossier auprès de l'équipe en cas de perte ou de retard.
Rupture de stock
L'agent croise les ventes et le solde par entrepôt, et prévient les achats des SKU qui seront à zéro dans les prochains jours.
Commandes bloquées
Les commandes restées trop longtemps dans un même statut sont listées, avec la cause probable, pour l'équipe opérations.
Revue des promotions
Avant une campagne, l'agent vérifie les promotions actives et signale les conflits de remise ou les SKU sans prix.
De l’identifiant à l’agent au travail, avec validation
Créez la clé d'application
Dans l'administration VTEX, générez une App Key et un App Token, et associez-les à un profil d'accès aux permissions minimales.
Enregistrez-les dans le coffre d'iTeam
Les identifiants restent dans le coffre, et chaque agent ne reçoit que les actions dont il a besoin, comme la lecture des commandes ou l'ajustement des stocks.
Validez en recette
Testez dans un environnement de développement ou un workspace VTEX, et conservez l'approbation pour les annulations et les prix.
Équipes IA prêtes à l’emploi qui utilisent VTEX
Questions sur l’API VTEX
L'API VTEX est-elle gratuite ?
L'usage des API fait partie du contrat de la plateforme VTEX. En général, il n'y a pas de facturation séparée par appel pour votre propre boutique.
Faut-il savoir programmer pour utiliser l'API VTEX avec iTeam ?
Pas nécessairement. L'outil HTTP d'iTeam apprend les endpoints à partir de la documentation de VTEX, et l'équipe de déploiement configure les flux.
L'agent peut-il annuler des commandes ?
Oui, si le profil d'accès le permet, mais nous recommandons que les annulations passent par une approbation humaine.
