Wholesale Suite API overzicht

Als u groothandelsprijzen buiten WordPress beheert, kunt u het meeste ervan via HTTP doen in plaats van in de admin. De Wholesale Suite API breidt de WooCommerce REST API uit, zodat u groothandelsproducten, variaties, rollen, kortingen en analyses vanuit uw eigen code kunt lezen en schrijven. Dit artikel geeft een overzicht van wat elke endpointgroep behandelt, welke plugin deze levert en waar de volledige referentie te vinden is.

Vereisten

• WooCommerce Wholesale Prices 1.12 of later. De batch-endpoints vereisen 1.16 of later.
• De groothandelsproduct-, variatie- en rol-endpoints worden geleverd met WooCommerce Wholesale Prices, de gratis plugin. U heeft WooCommerce Wholesale Prices Premium hier niet voor nodig.
• WooCommerce Wholesale Prices Premium 1.27 of later, voor de groothandel kortings-endpoints. De Premium API kwam in versie 1.25, en de categorie- en algemene kortings-endpoints kwamen in 1.27. De analytics-endpoints vereisen ook Premium.
• WooCommerce Wholesale Lead Capture 2.0 of hoger, voor de lead-eindpunten.

Wholesale Suite introduceert een speciaal eindpunt: wholesale/v1/ en wwlc/v1. Deze eindpunten geven u de flexibiliteit om belangrijke aspecten van uw groothandelswinkel programmatisch te beheren.

Belangrijkste functies van de Wholesale Suite API

• Groothandelsproducten: lijst, maak, update of verwijder groothandelsproducten. Werk er veel tegelijk bij met de batch-endpoint, wholesale/v1/products/batch, die WooCommerce Wholesale Prices 1.16 of later vereist.
• Groothandelvariaties: lijst, maak, update of verwijder de variaties van een product. De batch-endpoint is wholesale/v1/products/{product_id}/variations/batch.
• Groothandelsrollen: lijst en update de rollen die bepalen wie welke prijzen krijgt. De gratis plugin levert één groothandelsrol, en Premium voegt maken en verwijderen toe.
• Groothandelleads: lijst, maak, update of verwijder groothandelleads. Deze endpoints worden geleverd met WooCommerce Wholesale Lead Capture en gebruiken de wwlc/v1 namespace.
• Groothandelskortingen: lees en stel kortingen op categorieniveau en algemene kortingen in via de category-discount en general-discount endpoints. Deze vereisen WooCommerce Wholesale Prices Premium 1.27 of later.
• Groothandelsanalyses: haal groothandelsverkoopstatistieken op voor producten, klanten of algemene groothandaankopen. Deze bevinden zich in hun eigen namespace, wholesale/v1/analytics, en vereisen Premium.

Waarom de Wholesale Suite API gebruiken

Deze API-integratie maakt het beheer van uw wholesale winkel flexibeler en naadlozer, vooral als u uw wholesale gegevens wilt automatiseren of synchroniseren met andere systemen of platforms. Of u nu grote catalogi beheert, prijzen in bulk aanpast of gebruikersrollen aanpast, met deze API kunt u dit allemaal doen zonder elke instelling handmatig in uw admin dashboard aan te passen.

Aan de slag met de Wholesale Suite API

Om te interageren met de Wholesale Suite API, gebruikt u WordPress REST API Authentication en standaard HTTP-verben (GET, POST, PUT, DELETE). U kunt deze functionaliteit integreren met elk platform of systeem dat HTTP-gebaseerde API-verzoeken ondersteunt.

Voor volledige details over het gebruik van de Wholesale Suite API, inclusief beschikbare methoden, parameters en voorbeeldverzoeken, raadpleeg de volledige API-documentatie.

REST API trigger actie allowlist

Wholesale Suite heeft een tweede endpoint voor het uitvoeren van onderhoudsacties, zoals het wissen van productcaches. Het bevindt zich in de wwp/v1 namespace, niet wholesale/v1, dus het is gemakkelijk te missen.

Verzend een POST-verzoek naar /wp-json/wwp/v1/admin/action met een action waarde in de body. Het verzoek vereist beheerdersrechten.

Elke actienaam moet op een toegestane lijst staan. Als dat niet zo is, komt het antwoord terug met een status van error en het bericht Invalid action. Een toegestane actie voert zijn handler uit en retourneert een status en een bericht.

Deze actienamen zijn beschikbaar wanneer de bijbehorende plugin actief is:

• 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

Om uw eigen actie toe te voegen, registreer deze met de wwp_allowed_trigger_actions filter in PHP. Wholesale Suite pikt ook elke hook op waarvan de naam begint met wwp_trigger_ en behandelt de rest van de naam als een toegestane actie. U kunt geen actienaam toevoegen via de REST API zelf.

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.',
    );
} );

Er is een tweede, aparte toegestane lijst voor groepinstellingenacties. Deze gebruikt de wwp_allowed_group_actions filter en draait op het instellingen opslaan-eindpunt, /wp-json/wwp/v1/admin/save. Als uw actie instellingen opslaat, hoort deze op die lijst thuis.

Help & Ondersteuning

We hebben een toegewijd ondersteuningsteam voor Wholesale Suite dat onze producten, WooCommerce en de branche zeer goed kent. U bent welkom om hun expertise op elk moment, wereldwijd, te benutten.

Als u een bestaande klant bent, ga dan naar het ondersteuningsticket aanvraagformulier en stuur ons een bericht.

Als u een gebruiker bent van de gratis plugin, stuur ons dan een ondersteuningsverzoek op het forum. We volgen actief de WordPress.org ondersteuningsforums voor de gratis plugin en helpen onze gebruikers daar zo goed mogelijk.