Wenn Sie Großhandelspreise außerhalb von WordPress verwalten, können Sie die meiste davon über HTTP anstatt im Adminbereich erledigen. Die Wholesale Suite API erweitert die WooCommerce REST API, sodass Sie Großhandelsprodukte, Variationen, Rollen, Rabatte und Analysen aus Ihrem eigenen Code lesen und schreiben können. Dieser Artikel listet auf, welche Endpunktgruppe was abdeckt, welches Plugin sie bereitstellt und wo Sie die vollständige Referenz finden.
Voraussetzungen
- WooCommerce Wholesale Prices 1.12 oder neuer. Die Batch-Endpunkte benötigen 1.16 oder neuer.
- Die Endpunkte für Großhandelsprodukte, -variationen und -rollen werden mit WooCommerce Wholesale Prices, dem kostenlosen Plugin, geliefert. Sie benötigen WooCommerce Wholesale Prices Premium nicht dafür.
- WooCommerce Wholesale Prices Premium 1.27 oder neuer für die Endpunkte für Großhandelsrabatte. Die Premium-API kam in Version 1.25, und die Endpunkte für Kategorie- und allgemeine Rabatte kamen in 1.27. Die Analyse-Endpunkte benötigen ebenfalls Premium.
- WooCommerce Wholesale Lead Capture 2.0 oder neuer, für die Lead-Endpunkte.
Wholesale Suite führt einen dedizierten Endpunkt ein: wholesale/v1/ und wwlc/v1. Diese Endpunkte bieten Ihnen die Flexibilität, wichtige Aspekte Ihres Großhandelsgeschäfts programmatisch zu verwalten und mit ihnen zu interagieren.
Hauptfunktionen der Wholesale Suite API
- Großhandelsprodukte: Listen, erstellen, aktualisieren oder löschen Sie Großhandelsprodukte. Aktualisieren Sie viele auf einmal mit dem Batch-Endpunkt wholesale/v1/products/batch, der WooCommerce Wholesale Prices 1.16 oder neuer benötigt.
- Großhandelsvariationen: Listen, erstellen, aktualisieren oder löschen Sie die Variationen eines Produkts. Der Batch-Endpunkt ist wholesale/v1/products/{product_id}/variations/batch.
- Großhandelsrollen: Listen und aktualisieren Sie die Rollen, die steuern, wer welche Preise erhält. Das kostenlose Plugin liefert eine Großhandelsrolle, und Premium fügt Erstellen und Löschen hinzu.
- Großhandelsanfragen: Listen, erstellen, aktualisieren oder löschen Sie Großhandelsanfragen. Diese Endpunkte werden mit WooCommerce Wholesale Lead Capture geliefert und verwenden den Namensraum wwlc/v1.
- Großhandelsrabatte: Lesen und setzen Sie Rabatte auf Kategorieebene und allgemeine Rabatte über die Endpunkte category-discount und general-discount. Diese benötigen WooCommerce Wholesale Prices Premium 1.27 oder neuer.
- Großhandelsanalysen: Rufen Sie Kennzahlen für Großhandelsverkäufe für Produkte, Kunden oder allgemeine Großhandelseinkäufe ab. Diese befinden sich in ihrem eigenen Namensraum wholesale/v1/analytics und benötigen Premium.
Warum die Wholesale Suite API verwenden?
Diese API-Integration macht die Verwaltung Ihres Großhandelsgeschäfts flexibler und nahtloser, insbesondere wenn Sie Ihre Großhandelsdaten automatisieren oder mit anderen Systemen oder Plattformen synchronisieren müssen. Egal, ob Sie große Kataloge verwalten, Preise in großen Mengen anpassen oder Benutzerrollen anpassen, diese API ermöglicht es Ihnen, all dies zu tun, ohne jede Einstellung in Ihrem Admin-Dashboard manuell anpassen zu müssen.
Erste Schritte mit der Wholesale Suite API
Um mit der Wholesale Suite API zu interagieren, verwenden Sie WordPress REST API-Authentifizierung und Standard-HTTP-Verben (GET, POST, PUT, DELETE). Sie können diese Funktionalität mit jeder Plattform oder jedem System integrieren, das HTTP-basierte API-Anfragen unterstützt.
Vollständige Details zur Verwendung der Wholesale Suite API, einschließlich verfügbarer Methoden, Parameter und Beispielanfragen, finden Sie in der vollständigen API-Dokumentation.
REST API Trigger-Aktions-Allowlist
Wholesale Suite verfügt über einen zweiten Endpunkt zum Ausführen von Wartungsaktionen, wie z. B. dem Leeren von Produktcaches. Er befindet sich im Namensraum wwp/v1, nicht in wholesale/v1, daher ist er leicht zu übersehen.
Senden Sie eine POST-Anfrage an /wp-json/wwp/v1/admin/action mit einem action-Wert im Body. Die Anfrage benötigt Administratorzugriff.
Jeder Aktionsname muss auf einer Zulassungsliste stehen. Wenn nicht, wird die Antwort mit dem Status error und der Meldung Invalid action zurückgegeben. Eine zulässige Aktion führt ihren Handler aus und gibt einen Status und eine Meldung zurück.
Diese Aktionsnamen sind verfügbar, wenn das entsprechende Plugin aktiv ist:
- WooCommerce Wholesale Prices Premium: clear_var_prod_price_range_caching, clear_product_caching, clear_unused_product_meta, initialize_product_visibility_meta, force_fetch_update_data
- WooCommerce Wholesale Lead Capture: force_fetch_update_data, create_lead_pages
- WooCommerce Wholesale Order Form: schedule_database_optimization
Um Ihre eigene Aktion hinzuzufügen, registrieren Sie sie mit dem wwp_allowed_trigger_actions Filter in PHP. Wholesale Suite erkennt auch jeden Hook, dessen Name mit wwp_trigger_ beginnt, und behandelt den Rest des Namens als zulässige Aktion. Sie können einen Aktionsnamen nicht über die REST-API selbst hinzufügen.
add_filter( 'wwp_allowed_trigger_actions', function ( $actions ) {
$actions[] = 'my_custom_action';
return $actions;
} );
add_filter( 'wwp_trigger_my_custom_action', function ( $params ) {
// Run your task here.
return array(
'status' => 'success',
'message' => 'Custom action finished.',
);
} );Es gibt eine zweite, separate Zulassungsliste für Gruppen-Einstellungsaktionen. Sie verwendet den wwp_allowed_group_actions Filter und läuft auf dem Einstellungs-Speicherendpunkt, /wp-json/wwp/v1/admin/save. Wenn Ihre Aktion Einstellungen speichert, gehört sie stattdessen auf diese Liste.
Hilfe & Support
Wir haben ein engagiertes Support-Team für Wholesale Suite, das unsere Produkte, WooCommerce und die Branche sehr gut kennt. Sie können seine Expertise jederzeit und weltweit nutzen.
Wenn Sie bereits Kunde sind, gehen Sie bitte zum Support-Ticket-Anfrageformular und senden Sie uns eine Nachricht.
Wenn Sie ein kostenloser Plugin-Benutzer sind, senden Sie uns bitte eine Supportanfrage im Forum. Wir überwachen aktiv die WordPress.org-Supportforen für das kostenlose Plugin und helfen unseren Benutzern dort so gut wir können.
