Nouvelle fonctionnalité ! WooCommerce Marketplace API dans WC Vendors

Gérer une boutique multi-vendeurs implique beaucoup de copier-coller. Les totaux de commissions vont dans une feuille de calcul, les nouvelles candidatures de vendeurs sont transmises à un chat d'équipe, et les vendeurs demandent des exportations pour pouvoir mettre à jour leurs propres outils d'inventaire ou d'expédition. Chacune de ces tâches est une personne qui déplace des données à la main. WC Vendors 2.7.3 change cela. Il ajoute une API de marketplace WooCommerce qui permet à d'autres applications de lire et de mettre à jour votre marketplace en toute sécurité : vendeurs, commandes des vendeurs, commissions, taux de commission et résumés des ventes. Il ajoute également des webhooks de marketplace et un ensemble de capacités que les assistants IA peuvent découvrir et exécuter sur votre site.

Dans cet article, nous expliquerons ce que la nouvelle API inclut, qui peut l'utiliser et ce que vous pouvez construire avec. Ensuite, nous vous guiderons étape par étape dans la configuration, depuis le premier identifiant jusqu'à votre premier webhook.

Qu'est-ce que l'API de marketplace WooCommerce ?

C'est un ensemble d'adresses web sur votre site que d'autres logiciels peuvent appeler pour lire ou modifier les données de la marketplace. Les développeurs appellent ces adresses des points de terminaison. Chacune d'elles commence par /wp-json/wcvendors/v1, et elles sont livrées dans le plugin gratuit WC Vendors à partir de la version 2.7.3.

La version comporte trois parties qui fonctionnent ensemble.

Points de terminaison REST pour les vendeurs, les commandes et les commissions

Les points de terminaison couvrent les enregistrements sur lesquels repose une place de marché. Les applications peuvent lister et lire les vendeurs, mettre à jour le profil du magasin et les détails de paiement d'un vendeur, et approuver, refuser, activer ou désactiver les vendeurs. Elles peuvent également lire les enregistrements de commissions, lire les commandes des vendeurs, lire et modifier les taux de commission, et extraire un résumé des ventes pour toute période donnée.

Webhooks pour les événements de la place de marché

Les webhooks fonctionnent dans l'autre sens. Au lieu qu'une application demande des nouvelles à votre site, votre site informe l'application au moment où quelque chose se produit. WC Vendors ajoute 11 événements de place de marché aux webhooks de WooCommerce, tels qu'une nouvelle candidature de vendeur, une approbation de vendeur, une nouvelle commission et une nouvelle commande de vendeur.

Capacités pour les agents IA

WC Vendors enregistre également 10 capacités de place de marché auprès de l'API des capacités de WordPress. Une capacité est une action nommée avec une entrée et une sortie claires que les outils d'IA peuvent trouver et exécuter. Cinq capacités ne font que lire des données, comme un résumé de la place de marché. Les cinq autres apportent des modifications, comme l'approbation d'un vendeur ou d'un produit en attente, de sorte qu'un outil d'IA bien construit demande à une personne de confirmer d'abord.

C'est ce qui permet à un assistant connecté via le Protocole de Contexte de Modèle de répondre à des questions telles que « Quels vendeurs attendent l'approbation ? » en utilisant les données de votre place de marché en direct.

Pourquoi une boutique multi-vendeurs a besoin de sa propre API

WooCommerce dispose déjà d'une API REST pour les produits, les commandes et les clients. Cependant, elle ne sait pas que les vendeurs existent. Elle ne peut pas dire à une application quel vendeur possède une commande, combien de commission est due, ou si un vendeur attend toujours l'approbation.

Une API de place de marché WooCommerce comble cette lacune. Elle s'exprime en termes de place de marché, de sorte qu'une application demande « les commissions dues au vendeur 42 » au lieu de reconstituer la réponse à partir des données brutes des commandes.

Elle est également conçue pour une boutique avec de nombreux vendeurs. Les identifiants d'un vendeur n'atteignent que les enregistrements de ce vendeur. Cela signifie que vous pouvez laisser les vendeurs connecter leurs propres outils sans exposer les commandes, les clients ou les gains de quiconque.

Qui peut l'utiliser et ce que chaque utilisateur peut voir

Chaque requête se connecte avec un identifiant, et ce qui revient dépend de qui appartient cet identifiant.

• Propriétaire de la boutique : Tout utilisateur qui peut gérer WooCommerce, tel qu'un administrateur ou un responsable de boutique, voit tous les vendeurs, commandes, commissions et rapports. Seul le propriétaire de la boutique peut approuver, refuser, activer ou désactiver les vendeurs et modifier les taux de commission.
• Vendeur actif : Ne voit que ses propres enregistrements. Demander les données d'un autre vendeur renvoie une erreur.
• Vendeur en attente ou inactif : N'a aucun accès, même avec un identifiant valide.
• Toute autre personne : N'a aucun accès.

Les détails privés restent privés

Les champs bancaires et de paiement n'apparaissent que lorsqu'une application lit ou met à jour un seul vendeur. Les listes de vendeurs et les messages webhook ne les incluent jamais, de sorte qu'une seule requête ne peut pas extraire tous les détails bancaires de tous les vendeurs en même temps.

Les détails du client sur les commandes des fournisseurs suivent les paramètres que vous utilisez déjà pour le tableau de bord du fournisseur. Vous les trouverez sous WC Vendors > Paramètres > Capacités > Commandes, comme expliqué dans notre guide des paramètres de capacités. Si vous y masquez l’e-mail ou le numéro de téléphone d’un client aux fournisseurs, l’API le masque également, même lorsque le propriétaire de la boutique l’appelle.

Limites de débit intégrées

Chaque utilisateur peut effectuer 100 requêtes par minute vers chaque point de terminaison. Dépasser la limite renvoie une erreur « trop de requêtes » jusqu’à la fin de la minute. Les limites de débit sont désactivées sur les sites configurés dans un environnement local ou de développement, vous ne les verrez donc pas sur la plupart des sites de test.

Ce que vous pouvez construire avec

Voici quelques idées qui utilisent uniquement ce qui est inclus dans WC Vendors 2.7.3.

• Rapports de commissions pour votre comptable : Extrayez toutes les commissions avec le statut « dues » pour un fournisseur avant le jour du paiement. Si vous êtes encore en train de configurer vos tarifs, notre guide sur comment facturer une commission aux fournisseurs couvre les options.
• Alertes d’application instantanées : Envoyez le webhook « Demande de fournisseur soumise » à votre chat d’équipe ou à votre CRM. Votre équipe peut examiner le candidat et l’approuver via l’API, en utilisant le même processus d’approbation des fournisseurs que l’écran d’administration.
• Intégrations appartenant aux fournisseurs : Un fournisseur crée ses propres identifiants et connecte un outil d’inventaire ou une application d’expédition. Cette application voit les commandes du fournisseur, et celles de personne d’autre.
• Rapports hebdomadaires du marché : Demandez un résumé des ventes de la semaine dernière et obtenez le total des commandes, le chiffre d’affaires brut, la commission due, les revenus du marché et vos 10 meilleurs fournisseurs en une seule réponse.
• Un assistant IA pour l’administration du marché : Demandez à un assistant le résumé du mois dernier ou la liste des produits en attente d’approbation. Notre marque sœur StoreAgent montre comment connecter Claude et ChatGPT à votre boutique.

Avant cette version, chacun de ces éléments nécessitait un plugin personnalisé ou une exportation manuelle. Avec l’API du marché WooCommerce, il s’agit d’une poignée de requêtes que tout outil d’automatisation ou développeur peut configurer.

Comment configurer l’API du marché WooCommerce

Il n’y a pas de paramètre à activer. Une fois WC Vendors 2.7.3 actif, les points de terminaison sont en ligne et chaque requête nécessite un identifiant. Suivez ces étapes pour connecter votre première application.

Étape 1 : Mettre à jour WC Vendors et vérifier les mots de passe d’application

1. Mettez à jour WC Vendors vers la version 2.7.3 ou ultérieure. Si WordPress affiche ensuite un avis « Mise à jour WC Vendors requise », cliquez sur Exécuter la mise à jour.
2. Accédez à Utilisateurs > Profil dans votre administration WordPress et faites défiler jusqu’à Mots de passe d’application.
3. Si vous voyez un formulaire pour ajouter un nouveau mot de passe, vous êtes prêt. Si la section indique qu’elle nécessite HTTPS, activez d’abord HTTPS pour votre site.
4. Si la section est manquante, un plugin de sécurité ou votre hébergeur a désactivé les Mots de passe d'application. Vous pouvez les réactiver, ou utiliser une clé d'API REST WooCommerce à la place.

Étape 2 : Créer une identification pour le propriétaire de la boutique

L'API accepte deux types d'identifications, et les deux se connectent via HTTPS.

• Mot de passe d'application : Dans Utilisateurs > Profil > Mots de passe d'application, entrez un nom pour l'application, créez le mot de passe, et copiez-le immédiatement. WordPress ne l'affiche qu'une seule fois. Le guide officiel des Mots de passe d'application explique leur fonctionnement.
• Clé d'API REST WooCommerce : Allez dans WooCommerce > Réglages > Avancé > API REST et ajoutez une clé pour votre utilisateur. Une clé Lecture ne peut que lire les données. Choisissez Lecture/Écriture si l'application doit modifier quoi que ce soit.

Si vous prévoyez d'utiliser les fonctionnalités d'IA, créez un Mot de passe d'application. Les clés d'API REST WooCommerce ne fonctionnent pas pour les fonctionnalités.

Étape 3 : Laisser les vendeurs créer leurs propres identifications

Les vendeurs n'ont pas besoin que vous créiez des identifications pour eux. Ils peuvent le faire depuis leur propre tableau de bord.

1. Le vendeur ouvre son tableau de bord vendeur et va dans Réglages, puis l'onglet API.
2. Il clique sur Générer une identification API.
3. La nouvelle identification apparaît une fois avec un bouton Copier et l'avertissement « Enregistrez ceci maintenant. Pour des raisons de sécurité, il ne sera plus affiché. »
4. Après cela, l'onglet affiche le nom de l'identification, la date de création, la date de dernière utilisation, et un bouton Régénérer.

Chaque vendeur peut détenir une identification à la fois. La régénération demande une confirmation, puis désactive immédiatement l'ancienne, donc toute application l'utilisant doit être mise à jour. L'onglet API n'apparaît que lorsque les Mots de passe d'application sont disponibles sur votre site.

Étape 4 : Faire votre première requête

Connectez-vous avec le nom d'utilisateur WordPress et le Mot de passe d'application. Cette requête liste les cinq premiers vendeurs :

curl -u "USERNAME:APPLICATION_PASSWORD" \
  "https://your-site.com/wp-json/wcvendors/v1/vendors?per_page=5"

La réponse est une liste de vendeurs au format JSON. Deux en-têtes de réponse, X-WP-Total et X-WP-TotalPages, vous indiquent combien d'enregistrements et de pages existent, et vous pouvez demander jusqu'à 100 enregistrements par page.

Voici une requête qu'une application d'un vendeur pourrait faire pour voir les commissions qui n'ont pas encore été payées :

curl -u "VENDOR_USERNAME:APPLICATION_PASSWORD" \
  "https://your-site.com/wp-json/wcvendors/v1/commissions?status=due"

Étape 5 : Ajouter un webhook de marketplace

1. Allez dans WooCommerce > Réglages > Avancé > Webhooks et cliquez sur Ajouter un webhook.
2. Entrez un nom et l'URL de livraison où votre application doit recevoir le message.
3. Ouvrez la liste déroulante Topic et choisissez un sujet de marketplace, par exemple, Vendor approved ou Commission created.
4. Définissez le Status sur Active et enregistrez.

WooCommerce gère la livraison, la signature et les journaux de livraison. Sa documentation sur les webhooks explique comment vérifier qu'un message provient bien de votre boutique.

Étape 6 : Connecter un agent IA avec des capacités

Les capacités nécessitent WordPress 6.9 ou une version ultérieure et un mot de passe d'application du propriétaire de la boutique. Pour voir ce qui est disponible, demandez la liste des capacités dans la catégorie wcvendors :

curl -u "OWNER_USERNAME:APPLICATION_PASSWORD" \
  "https://your-site.com/wp-json/wp-abilities/v1/abilities?category=wcvendors"

La plupart des gens n'appelleront pas cela manuellement. Un outil IA compatible MCP lit la même liste et décide quelle capacité exécuter. Pour un exemple concret de nos marques sœurs, voyez comment Advanced Coupons vous permet de gérer les coupons avec l'API WordPress Abilities, ou comment Wholesale Suite exécute des tâches de vente en gros depuis Claude ou ChatGPT.

Vous souhaitez connecter un assistant IA ? Notre guide étape par étape, Comment utiliser les capacités IA dans WC Vendors, vous montre comment connecter Claude ou ChatGPT à votre marketplace via StoreAgent. Il explique également ce que chacune des 10 capacités peut faire, qui peut les exécuter et comment résoudre les problèmes de configuration courants.

Chaque point de terminaison, webhook et capacité en un coup d'œil

Points de terminaison

Toutes les routes commencent par /wp-json/wcvendors/v1.

Méthode	Route	Ce que cela fait	Qui peut l'utiliser
GET	/vendors	Lister les vendeurs	Propriétaire de la boutique, vendeur (son propre enregistrement)
GET, PUT	/vendors/{id}	Lire ou mettre à jour le profil de la boutique et les détails de paiement d'un vendeur	Propriétaire de la boutique, vendeur (son propre enregistrement)
POST	/vendors/{id}/approve, /deny	Décider d'une candidature en attente	Propriétaire de la boutique
POST	/vendors/{id}/activate, /deactivate	Suspendre ou rétablir un vendeur	Propriétaire de la boutique
GET, PUT	/vendors/{id}/commission	Lire ou définir le taux de commission d'un vendeur	Propriétaire de la boutique (les vendeurs peuvent lire les leurs)
GET, PUT	/settings/commission	Lire ou modifier le taux de commission global	Propriétaire de la boutique
GET	/commissions, /commissions/{id}	Lire les enregistrements de commission	Propriétaire de la boutique, vendeur (enregistrements propres)
GET	/orders, /orders/{id}	Lire les commandes des vendeurs	Propriétaire de la boutique, vendeur (commandes propres)
GET	/reports/sales	Résumé des ventes pour une période donnée	Propriétaire de la boutique, vendeur (ventes propres)

Sujets des webhooks

• Vendeurs : Candidature de vendeur soumise, Vendeur approuvé, Vendeur refusé, Vendeur activé, Vendeur désactivé, Vendeur mis à jour et Vendeur supprimé.
• Commissions : Commission créée.
• Commandes des vendeurs : Commande vendeur créée, Commande vendeur mise à jour et Commande vendeur supprimée.

Capacités

• Lire : lister les vendeurs, obtenir un vendeur, lister les produits en attente, obtenir les paramètres de commission et obtenir un résumé du marché.
• Écrire : approuver un vendeur, rejeter un vendeur, mettre à jour le profil de la boutique d'un vendeur, approuver un produit et rejeter un produit.

Aucune capacité ne déplace d'argent, ne modifie un taux de commission, ne change le mode de paiement d'un vendeur ou ne supprime un enregistrement. Les capacités d'écriture envoient les mêmes e-mails que les boutons correspondants dans votre administration WordPress, et un produit rejeté retourne au vendeur en tant que brouillon avec votre raison jointe.

Meilleures pratiques pour une intégration de marché sécurisée

Traitez l'API du marché WooCommerce comme toute autre porte d'entrée de votre boutique. Ces habitudes la maintiennent sécurisée et fiable.

• Donnez à chaque application le moins d'accès dont elle a besoin. Si une application lit uniquement les rapports, donnez-lui une clé de lecture plutôt qu'une clé de lecture/écriture.
• Prévoyez les changements d'identifiants des vendeurs. Un vendeur détient un identifiant, et sa régénération coupe l'accès à toutes les applications qui utilisaient l'ancien immédiatement.
• Vérifiez les paramètres client avant de connecter un outil d'expédition ou de comptabilité. Si les détails du client reviennent vides, examinez Capacités > Commandes et cliquez sur Enregistrer.
• Conservez votre propre copie de tout ce dont vous pourriez avoir besoin plus tard. Les webhooks « Vendeur supprimé » et « Commande vendeur supprimée » n'envoient que l'ID, car l'enregistrement n'existe plus.
• Surveillez la santé des webhooks. WooCommerce ne renvoie pas une livraison échouée, et il désactive un webhook après plus de cinq livraisons échouées.
• Sachez quels types de commissions nécessitent Pro. Sans WC Vendors Pro, l'API n'accepte que les commissions en pourcentage. Les nouveaux taux s'appliquent aux nouvelles commissions, et les enregistrements existants ne changent pas.
• Désactivez ce que vous n'utilisez pas. L'ajout de define( 'WCV_DISABLE_ABILITIES', true ); à wp-config.php supprime les capacités, et define( 'WCV_DISABLE_REST_API', true ); supprime toute l'API.

Pour une liste de contrôle plus complète, lisez notre guide sur la sécurité des places de marché WooCommerce.

Conclusion

WC Vendors 2.7.3 donne à votre boutique quelque chose qu'elle n'a jamais eu auparavant : un moyen public et documenté pour que d'autres logiciels interagissent avec les vendeurs, les commandes et les commissions. L'API de place de marché WooCommerce prend en charge les tâches quotidiennes qui nécessitaient auparavant des exportations et des copier-coller, de la réconciliation des commissions à l'approbation de nouveaux vendeurs.

Il a été conçu en tenant compte des risques d'une boutique multi-vendeurs. Les vendeurs ne voient que leurs propres données, les détails de paiement restent hors des listes et des webhooks, et les informations client suivent les mêmes règles que votre tableau de bord vendeur. Les webhooks maintiennent vos autres outils à jour sans interroger, et les capacités permettent à un assistant IA de gérer l'administration de routine pendant que vous gardez le contrôle de chaque changement.

Commencez petit. Créez une seule identification, connectez un seul webhook et voyez combien de travail manuel disparaît. Ensuite, développez à partir de là à mesure que votre place de marché grandit.

Voici ce que nous avons couvert dans cet article :

• Qu'est-ce que l'API de place de marché WooCommerce
• Pourquoi une boutique multi-vendeurs a besoin de sa propre API
• Qui peut l'utiliser et ce que chaque utilisateur peut voir
• Ce que vous pouvez construire avec
• Comment configurer l'API de place de marché WooCommerce
• Chaque point d'accès, webhook et capacité en un coup d'œil
• Meilleures pratiques pour une intégration de place de marché sécurisée

Questions fréquemment posées