Der Betrieb eines Multi-Vendor-Shops beinhaltet viel Kopieren und Einfügen. Provisionssummen werden in eine Tabellenkalkulation eingegeben, neue Händlerbewerbungen werden an einen Team-Chat weitergeleitet und Händler bitten um Exporte, damit sie ihre eigenen Inventar- oder Versandtools aktualisieren können. Jede dieser Aufgaben ist eine Person, die Daten von Hand verschiebt. WC Vendors 2.7.3 ändert das. Es fügt eine WooCommerce Marktplatz-API hinzu, die es anderen Apps ermöglicht, Ihren Marktplatz sicher zu lesen und zu aktualisieren: Händler, Händlerbestellungen, Provisionen, Provisionssätze und Umsatzübersichten. Es fügt auch Marktplatz-Webhooks und eine Reihe von Fähigkeiten hinzu, die KI-Assistenten auf Ihrer Website entdecken und ausführen können.
In diesem Artikel erklären wir, was die neue API beinhaltet, wer sie nutzen kann und was Sie damit erstellen können. Dann führen wir Sie Schritt für Schritt durch die Einrichtung, von den ersten Anmeldeinformationen bis zu Ihrem ersten Webhook.
Was ist die WooCommerce Marktplatz-API?
Es ist eine Reihe von Webadressen auf Ihrer Website, die andere Software aufrufen kann, um Marktplatzdaten zu lesen oder zu ändern. Entwickler nennen diese Adressen Endpunkte. Jeder von ihnen beginnt mit /wp-json/wcvendors/v1 und wird im kostenlosen WC Vendors Plugin ab Version 2.7.3 ausgeliefert.
Die Veröffentlichung hat drei Teile, die zusammenarbeiten.
REST-Endpunkte für Händler, Bestellungen und Provisionen
Die Endpunkte decken die Datensätze ab, auf denen ein Marktplatz läuft. Apps können Anbieter auflisten und lesen, das Store-Profil und die Auszahlungsdetails eines Anbieters aktualisieren und Anbieter genehmigen, ablehnen, aktivieren oder deaktivieren. Sie können auch Provisionsdatensätze lesen, Anbieterbestellungen lesen, Provisionssätze lesen und ändern und eine Umsatzübersicht für jeden beliebigen Zeitraum abrufen.
Webhooks für Marktplatzereignisse
Webhooks funktionieren in die andere Richtung. Anstatt dass eine App Ihre Website nach Neuigkeiten fragt, teilt Ihre Website der App im Moment des Geschehens mit. WC Vendors fügt 11 Marktplatzereignisse zu WooCommerce-Webhooks hinzu, wie z. B. eine neue Anbieteranfrage, eine Anbietergenehmigung, eine neue Provision und eine neue Anbieterbestellung.
Fähigkeiten für KI-Agenten
WC Vendors registriert auch 10 Marktplatzfähigkeiten bei der WordPress Abilities API. Eine Fähigkeit ist eine benannte Aktion mit einer klaren Eingabe und Ausgabe, die KI-Tools finden und ausführen können. Fünf Fähigkeiten lesen nur Daten, wie z. B. eine Marktplatzübersicht. Die anderen fünf nehmen Änderungen vor, wie z. B. die Genehmigung eines Anbieters oder eines ausstehenden Produkts, sodass ein gut aufgebautes KI-Tool eine Person um Bestätigung bittet, bevor es fortfährt.
Dies ist es, was es einem Assistenten, der über das Model Context Protocol verbunden ist, ermöglicht, Fragen wie „Welche Anbieter warten auf Genehmigung?“ anhand Ihrer Live-Marktplatzdaten zu beantworten.
Warum ein Multi-Vendor-Store eine eigene API benötigt
WooCommerce verfügt bereits über eine REST-API für Produkte, Bestellungen und Kunden. Sie weiß jedoch nicht, dass Anbieter existieren. Sie kann einer App nicht sagen, welcher Anbieter eine Bestellung besitzt, wie viel Provision fällig ist oder ob ein Verkäufer noch auf die Genehmigung wartet.
Eine WooCommerce-Marktplatz-API schließt diese Lücke. Sie spricht in Marktplatzbegriffen, sodass eine App nach „dem Anbieter 42 geschuldete Provisionen“ fragt, anstatt die Antwort aus Rohbestelldaten zusammenzusetzen.
Sie ist auch für einen Shop mit vielen Verkäufern konzipiert. Die Anmeldeinformationen eines Anbieters reichen nur bis zu den eigenen Datensätzen dieses Anbieters. Das bedeutet, dass Sie Anbietern erlauben können, ihre eigenen Tools zu verbinden, ohne die Bestellungen, Kunden oder Einnahmen anderer preiszugeben.
Wer kann es nutzen und was jeder Benutzer sehen kann
Jede Anfrage meldet sich mit einer Anmeldeinformation an, und was zurückkommt, hängt davon ab, wem diese Anmeldeinformation gehört.
- Store-Besitzer: Jeder Benutzer, der WooCommerce verwalten kann, wie z. B. ein Administrator oder ein Shop-Manager, sieht alle Anbieter, Bestellungen, Provisionen und Berichte. Nur der Store-Besitzer kann Anbieter genehmigen, ablehnen, aktivieren oder deaktivieren und Provisionssätze ändern.
- Aktiver Anbieter: Sieht nur die eigenen Datensätze. Die Abfrage von Daten eines anderen Anbieters führt zu einem Fehler.
- Ausstehender oder inaktiver Anbieter: Erhält keinen Zugriff, auch nicht mit gültigen Anmeldeinformationen.
- Alle anderen: Erhalten keinen Zugriff.
Private Details bleiben privat
Bank- und Auszahlungsfelder erscheinen nur, wenn eine App einen einzelnen Anbieter liest oder aktualisiert. Anbieterlisten und Webhook-Nachrichten enthalten sie niemals, sodass eine Anfrage nicht die Bankdetails aller Verkäufer auf einmal abrufen kann.
Kundendetails bei Händlerbestellungen folgen den Einstellungen, die Sie bereits für das Händler-Dashboard verwenden. Sie finden sie unter WC Vendors > Einstellungen > Fähigkeiten > Bestellungen, wie in unserer Anleitungen zu den Fähigkeiten-Einstellungen erklärt. Wenn Sie dort die E-Mail-Adresse oder Telefonnummer eines Kunden vor Händlern verbergen, verbirgt die API diese ebenfalls, selbst wenn der Store-Besitzer sie aufruft.
Integrierte Ratenbegrenzungen
Jeder Benutzer kann 100 Anfragen pro Minute an jeden Endpunkt stellen. Wenn das Limit überschritten wird, wird eine Fehlermeldung "zu viele Anfragen" zurückgegeben, bis die Minute abgelaufen ist. Ratenbegrenzungen sind auf Websites, die für eine lokale oder Entwicklungsumgebung eingerichtet sind, deaktiviert, sodass Sie sie auf den meisten Test-Websites nicht sehen werden.
Was Sie damit bauen können
Hier sind einige Ideen, die nur das verwenden, was in WC Vendors 2.7.3 enthalten ist.
- Provisionsberichte für Ihren Buchhalter: Ziehen Sie alle Provisionen mit dem Status "fällig" für einen Händler vor dem Auszahlungstag ab. Wenn Sie noch Ihre Sätze einrichten, behandelt unsere Anleitung zur Berechnung von Händlerprovisionen die Optionen.
- Sofortige Anwendungsbenachrichtigungen: Senden Sie den Webhook "Händleranwendung eingereicht" an Ihren Team-Chat oder Ihr CRM. Ihr Team kann den Bewerber überprüfen und ihn über die API genehmigen, indem es denselben Prozess zur Händlergenehmigung wie auf dem Admin-Bildschirm verwendet.
- Händler-eigene Integrationen: Ein Händler erstellt seine eigenen Anmeldeinformationen und verbindet ein Inventur-Tool oder eine Versand-App. Diese App sieht die Bestellungen des Händlers und sonst niemandes.
- Wöchentliche Marktplatzberichte: Fordern Sie eine Verkaufzusammenfassung für die letzte Woche an und erhalten Sie Gesamtbestellungen, Bruttoumsatz, geschuldete Provisionen, Marktplatzerlöse und Ihre Top-10-Händler in einer Antwort.
- Ein KI-Assistent für den Marktplatz-Admin: Bitten Sie einen Assistenten um die Zusammenfassung des letzten Monats oder die Liste der Produkte, die auf Genehmigung warten. Unsere Schwestermarke StoreAgent zeigt, wie Sie Claude und ChatGPT mit Ihrem Shop verbinden.
Vor dieser Veröffentlichung bedeutete jede dieser Funktionen ein benutzerdefiniertes Plugin oder einen manuellen Export. Mit der WooCommerce Marketplace API sind dies eine Handvoll Anfragen, die jedes Automatisierungstool oder jeder Entwickler einrichten kann.
Einrichtung der WooCommerce Marketplace API
Es gibt keine Einstellung zum Einschalten. Sobald WC Vendors 2.7.3 aktiv ist, sind die Endpunkte live und jede Anfrage benötigt eine Anmeldeinformation. Befolgen Sie diese Schritte, um Ihre erste App zu verbinden.
Schritt 1: WC Vendors aktualisieren und Anwendungs-Passwörter überprüfen
- Aktualisieren Sie WC Vendors auf Version 2.7.3 oder höher. Wenn WordPress danach eine Benachrichtigung "WC Vendors Update erforderlich" anzeigt, klicken Sie auf Update ausführen.
- Gehen Sie in Ihrem WordPress-Admin zu Benutzer > Profil und scrollen Sie zu Anwendungs-Passwörter.
- Wenn Sie ein Formular zum Hinzufügen eines neuen Passworts sehen, sind Sie bereit. Wenn der Abschnitt besagt, dass HTTPS benötigt wird, aktivieren Sie zuerst HTTPS für Ihre Website.
- Wenn der Abschnitt fehlt, hat ein Sicherheits-Plugin oder Ihr Hoster die Anwendungspasswörter deaktiviert. Sie können sie wieder aktivieren oder stattdessen einen WooCommerce REST API-Schlüssel verwenden.
Schritt 2: Erstellen Sie eine Anmeldeinformation für den Store-Besitzer
Die API akzeptiert zwei Arten von Anmeldeinformationen, und beide melden sich über HTTPS an.
- Anwendungspasswort: Geben Sie unter Benutzer > Profil > Anwendungspasswörter einen Namen für die App ein, erstellen Sie das Passwort und kopieren Sie es sofort. WordPress zeigt es nur einmal an. Der offizielle Leitfaden für Anwendungspasswörter erklärt, wie sie funktionieren.
- WooCommerce REST API-Schlüssel: Gehen Sie zu WooCommerce > Einstellungen > Erweitert > REST API und fügen Sie einen Schlüssel für Ihren Benutzer hinzu. Ein Lese-Schlüssel kann nur Daten lesen. Wählen Sie Lesen/Schreiben, wenn die App etwas ändern muss.
Wenn Sie die KI-Funktionen nutzen möchten, erstellen Sie ein Anwendungspasswort. WooCommerce REST API-Schlüssel funktionieren nicht für Funktionen.
Schritt 3: Ermöglichen Sie Anbietern, ihre eigenen Anmeldeinformationen zu erstellen
Anbieter benötigen keine von Ihnen erstellten Anmeldeinformationen. Sie können diese von ihrem eigenen Dashboard aus erstellen.
- Der Anbieter öffnet sein Anbieter-Dashboard und geht zu Einstellungen, dann zum Tab API.
- Sie klicken auf API-Anmeldeinformationen generieren.
- Die neue Anmeldeinformation erscheint einmal mit einer Kopieren-Schaltfläche und der Warnung „Speichern Sie dies jetzt. Aus Sicherheitsgründen wird es nicht erneut angezeigt.“
- Danach zeigt der Tab den Namen der Anmeldeinformation, das Erstellungsdatum, das Datum der letzten Verwendung und eine Schaltfläche Neu generieren an.
Jeder Anbieter kann nur eine Anmeldeinformation gleichzeitig besitzen. Das erneute Generieren erfordert eine Bestätigung und deaktiviert dann sofort die alte, sodass jede App, die sie verwendet, aktualisiert werden muss. Der API-Tab erscheint nur, wenn Anwendungspasswörter auf Ihrer Website verfügbar sind.
Schritt 4: Machen Sie Ihre erste Anfrage
Melden Sie sich mit dem WordPress-Benutzernamen und dem Anwendungspasswort an. Diese Anfrage listet die ersten fünf Anbieter auf:
curl -u "USERNAME:APPLICATION_PASSWORD" \
"https://your-site.com/wp-json/wcvendors/v1/vendors?per_page=5"Die Antwort ist eine Liste von Anbietern im JSON-Format. Zwei Antwort-Header, X-WP-Total und X-WP-TotalPages, geben an, wie viele Datensätze und Seiten es gibt, und Sie können bis zu 100 Datensätze pro Seite anfordern.
Hier ist eine Anfrage, die die App eines Anbieters stellen könnte, um noch nicht ausgezahlte Provisionen anzuzeigen:
curl -u "VENDOR_USERNAME:APPLICATION_PASSWORD" \
"https://your-site.com/wp-json/wcvendors/v1/commissions?status=due"Schritt 5: Fügen Sie einen Marktplatz-Webhook hinzu
- Gehen Sie zu WooCommerce > Einstellungen > Erweitert > Webhooks und klicken Sie auf Webhook hinzufügen.
- Geben Sie einen Namen und die Liefer-URL ein, an die Ihre App die Nachricht erhalten soll.
- Öffnen Sie das Dropdown-Menü Topic und wählen Sie ein Marktplatzthema, z. B. Vendor approved oder Commission created.
- Setzen Sie Status auf Active und speichern Sie.
WooCommerce kümmert sich um Lieferung, Signierung und Lieferprotokolle. Seine Webhook-Dokumentation erklärt, wie Sie überprüfen, ob eine Nachricht wirklich von Ihrem Shop stammt.
Schritt 6: Verbinden Sie einen KI-Agenten mit Fähigkeiten
Fähigkeiten erfordern WordPress 6.9 oder neuer und ein Anwendungspasswort des Shop-Betreibers. Um zu sehen, was verfügbar ist, fordern Sie die Liste der Fähigkeiten in der Kategorie wcvendors an:
curl -u "OWNER_USERNAME:APPLICATION_PASSWORD" \
"https://your-site.com/wp-json/wp-abilities/v1/abilities?category=wcvendors"Die meisten Leute werden dies nicht manuell aufrufen. Ein MCP-kompatibles KI-Tool liest dieselbe Liste und entscheidet, welche Fähigkeit ausgeführt werden soll. Ein Beispiel von unseren Schwestermarken finden Sie hier: Wie Advanced Coupons es Ihnen ermöglicht, Coupons mit der WordPress Abilities API zu verwalten, oder wie Wholesale Suite Wholesale-Aufgaben von Claude oder ChatGPT ausführt.
Betreiben Sie Ihren Marktplatz von Claude oder ChatGPT mit StoreAgent
Möchten Sie einen KI-Assistenten, der diese Fähigkeiten nutzt, ohne selbst einen MCP-Server einzurichten? StoreAgent, unser Schwester-Plugin, gibt Ihrem Shop eine eigene MCP-Verbindung für Claude und ChatGPT. Sie genehmigen die Verbindung mit einer Anmeldung, sodass kein API-Schlüssel kopiert werden muss, und Sie wählen Lese- oder Lese- und Schreibzugriff.
Fähigkeiten von Ihren anderen Plugins erscheinen in der Fähigkeitsliste von StoreAgent, gruppiert nach Plugin, und jede bleibt deaktiviert, bis Sie sie einschalten. StoreAgent enthält auch einen WC Vendors Product Moderator, der ausstehende Verkäuferprodukte vor der Genehmigung durch KI prüft. MCP funktioniert mit jedem StoreAgent-Plan, einschließlich des kostenlosen.
Möchten Sie einen KI-Assistenten verbinden? Unser Schritt-für-Schritt-Leitfaden So verwenden Sie KI-Fähigkeiten in WC Vendors zeigt Ihnen, wie Sie Claude oder ChatGPT über StoreAgent mit Ihrem Marktplatz verbinden. Er erklärt auch, was jede der 10 Fähigkeiten tun kann, wer sie ausführen kann und wie Sie häufige Einrichtungsprobleme beheben.
Jeder Endpunkt, Webhook und jede Fähigkeit auf einen Blick
Endpunkte
Alle Routen beginnen mit /wp-json/wcvendors/v1.
| Methode | Route | Was es tut | Wer kann es benutzen |
|---|---|---|---|
| GET | /vendors | Anbieter auflisten | Shop-Betreiber, Verkäufer (eigener Datensatz) |
| GET, PUT | /vendors/{id} | Profil und Auszahlungsdetails eines Verkäufers lesen oder aktualisieren | Shop-Betreiber, Verkäufer (eigener Datensatz) |
| POST | /vendors/{id}/approve, /deny | Über eine ausstehende Bewerbung entscheiden | Shop-Betreiber |
| POST | /vendors/{id}/activate, /deactivate | Einen Verkäufer sperren oder wiederherstellen | Shop-Betreiber |
| GET, PUT | /vendors/{id}/commission | Legen Sie die eigene Provisionsrate eines Anbieters fest oder lesen Sie sie aus | Store-Besitzer (Anbieter können ihre eigenen lesen) |
| GET, PUT | /settings/commission | Legen Sie die globale Provisionsrate fest oder lesen Sie sie aus | Shop-Betreiber |
| GET | /commissions, /commissions/{id} | Provisionsdatensätze lesen | Store-Besitzer, Anbieter (eigene Datensätze) |
| GET | /orders, /orders/{id} | Anbieterbestellungen lesen | Store-Besitzer, Anbieter (eigene Bestellungen) |
| GET | /reports/sales | Umsatzübersicht für einen Datumsbereich | Store-Besitzer, Anbieter (eigene Umsätze) |
Webhook-Themen
- Anbieter: Anbieterantrag eingereicht, Anbieter genehmigt, Anbieter abgelehnt, Anbieter aktiviert, Anbieter deaktiviert, Anbieter aktualisiert und Anbieter gelöscht.
- Provisionen: Provision erstellt.
- Anbieterbestellungen: Anbieterbestellung erstellt, Anbieterbestellung aktualisiert und Anbieterbestellung gelöscht.
Berechtigungen
- Lesen: Anbieter auflisten, einen Anbieter abrufen, ausstehende Produkte auflisten, Provisionseinstellungen abrufen und eine Marktplatzübersicht abrufen.
- Schreiben: einen Anbieter genehmigen, einen Anbieter ablehnen, das Store-Profil eines Anbieters aktualisieren, ein Produkt genehmigen und ein Produkt ablehnen.
Keine Berechtigung bewegt Geld, ändert eine Provisionsrate, ändert, wohin ein Anbieter bezahlt wird, oder löscht einen Datensatz. Die Schreibberechtigungen senden die gleichen E-Mails wie die entsprechenden Schaltflächen in Ihrem WordPress-Admin, und ein abgelehnte Produkt geht als Entwurf mit Ihrem Grund an den Anbieter zurück.
Bewährte Praktiken für eine sichere Marktplatzintegration
Behandeln Sie die WooCommerce-Marktplatz-API wie jede andere Tür zu Ihrem Shop. Diese Gewohnheiten halten sie sicher und zuverlässig.
- Geben Sie jeder App den geringsten Zugriff, den sie benötigt. Wenn eine App nur Berichte liest, geben Sie ihr einen Lese-Schlüssel anstelle eines Lese-/Schreib-Schlüssels.
- Planen Sie Änderungen der Anbieteranmeldeinformationen. Ein Anbieter besitzt eine Anmeldeinformation, und die Neuerstellung unterbricht sofort jede App, die die alte verwendet hat.
- Überprüfen Sie die Kundeneinstellungen, bevor Sie ein Versand- oder Abrechnungstool verbinden. Wenn die Kundendetails leer zurückkommen, überprüfen Sie Berechtigungen > Bestellungen und klicken Sie auf Speichern.
- Behalten Sie eine eigene Kopie von allem, was Sie später benötigen könnten. Die Webhooks „Anbieter gelöscht“ und „Anbieterbestellung gelöscht“ senden nur die ID, da der Datensatz nicht mehr existiert.
- Überwachen Sie die Webhook-Gesundheit. WooCommerce sendet eine fehlgeschlagene Zustellung nicht erneut und schaltet einen Webhook nach mehr als fünf fehlgeschlagenen Zustellungen ab.
- Wissen Sie, welche Provisionstypen Pro benötigen. Ohne WC Vendors Pro akzeptiert die API nur prozentuale Provisionen. Neue Sätze gelten für neue Provisionen, und bestehende Datensätze ändern sich nicht.
- Schalten Sie ab, was Sie nicht verwenden. Das Hinzufügen von
define( 'WCV_DISABLE_ABILITIES', true );zuwp-config.phpentfernt die Berechtigungen, unddefine( 'WCV_DISABLE_REST_API', true );entfernt die gesamte API.
Für eine umfassendere Checkliste lesen Sie unseren Leitfaden zur WooCommerce Marktplatzsicherheit.
Schlussfolgerung
WC Vendors 2.7.3 gibt Ihrem Shop etwas, das er noch nie zuvor hatte: eine öffentliche, dokumentierte Möglichkeit für andere Software, mit Anbietern, Bestellungen und Provisionen zu arbeiten. Die WooCommerce Marktplatz-API übernimmt die täglichen Aufgaben, die früher Exporte und Copy & Paste bedeuteten, von der Abstimmung der Provisionen bis zur Genehmigung neuer Verkäufer.
Es wurde mit Blick auf die Risiken eines Multi-Vendor-Shops entwickelt. Anbieter sehen immer nur ihre eigenen Daten, Auszahlungsdetails bleiben aus Listen und Webhooks heraus und Kundeninformationen folgen denselben Regeln wie Ihr Anbieter-Dashboard. Webhooks halten Ihre anderen Tools auf dem neuesten Stand, ohne zu pollen, und Fähigkeiten ermöglichen es einem KI-Assistenten, Routineaufgaben zu erledigen, während Sie die Kontrolle über jede Änderung behalten.
Fangen Sie klein an. Erstellen Sie eine Anmeldeinformation, verbinden Sie einen Webhook und sehen Sie, wie viel manuelle Arbeit verschwindet. Bauen Sie dann von dort aus auf, während Ihr Marktplatz wächst.
Hier ist, was wir in diesem Artikel behandelt haben:
- Was ist die WooCommerce Marktplatz-API
- Warum ein Multi-Vendor-Shop seine eigene API benötigt
- Wer kann sie nutzen und was jeder Benutzer sehen kann
- Was Sie damit erstellen können
- So richten Sie die WooCommerce Marktplatz-API ein
- Jeder Endpunkt, Webhook und jede Fähigkeit auf einen Blick
- Best Practices für eine sichere Marktplatzintegration
Häufig gestellte Fragen
Benötige ich WC Vendors Pro, um die WooCommerce Marktplatz-API zu verwenden?
Nein. Die API, die Webhooks und die Fähigkeiten sind alle Teil des kostenlosen WC Vendors Plugins ab Version 2.7.3. Zwei Dinge hängen von Pro ab: Provisionsarten, die keine Prozentsätze sind, und die Liste der ausstehenden Produkte, die normalerweise leer ist, es sei denn, Pro ist so eingestellt, dass neue Produkte vor der Veröffentlichung überprüft werden.
Kann ein Anbieter die Bestellungen oder Provisionen eines anderen Anbieters sehen?
Nein. Die Anmeldeinformationen eines Anbieters geben nur die eigenen Datensätze dieses Anbieters zurück. Wenn die App eines Anbieters nach der Bestellung oder Provision eines anderen Anbieters fragt, antwortet die API, als ob der Datensatz nicht existiert.
Was passiert mit den älteren wcv-api/v1 Routen?
Sie bleiben bestehen und funktionieren weiter, sind aber eingefroren und erhalten keine neuen Funktionen. Neue Integrationen sollten die in diesem Artikel beschriebenen Routen wcvendors/v1 verwenden.
Welche WordPress-Version benötige ich für die KI-Funktionen?
Die Fähigkeiten erfordern WordPress 6.9 oder neuer, da dort die Abilities API hinzugefügt wurde. Die REST-Endpunkte und Webhooks funktionieren auch mit älteren unterstützten Versionen.
Kann ich die API ausschalten?
Ja. Fügen Sie define( ‘WCV_DISABLE_REST_API’, true ); zu Ihrer wp-config.php-Datei hinzu, um jede Route, jeden Webhook-Topic und jede Fähigkeit zu entfernen. Um nur die Fähigkeiten zu entfernen, verwenden Sie stattdessen define( ‘WCV_DISABLE_ABILITIES’, true );.
