Nieuwe functie! WooCommerce Marketplace API In WC Vendors

Het runnen van een multi-vendor winkel brengt veel kopiëren en plakken met zich mee. Commissietotalen gaan naar een spreadsheet, nieuwe verkopersaanvragen worden doorgestuurd naar een teamchat, en verkopers vragen om exports zodat ze hun eigen inventaris of verzendtools kunnen bijwerken. Elk van die taken is een persoon die handmatig gegevens verplaatst. WC Vendors 2.7.3 verandert dat. Het voegt een WooCommerce marketplace API toe waarmee andere apps uw marktplaats veilig kunnen lezen en bijwerken: verkopers, verkopersbestellingen, commissies, commissietarieven en verkoopoverzichten. Het voegt ook marktplaats webhooks en een reeks abilities toe die AI-assistenten kunnen ontdekken en uitvoeren op uw site.

In dit artikel leggen we uit wat de nieuwe API inhoudt, wie deze kan gebruiken en wat u ermee kunt bouwen. Daarna lopen we stap voor stap door de installatie, van de eerste inloggegevens tot uw eerste webhook.

Wat is de WooCommerce Marketplace API?

Het is een set webadressen op uw site die andere software kan aanroepen om marktplaatsgegevens te lezen of te wijzigen. Ontwikkelaars noemen deze adressen endpoints. Ze beginnen allemaal met /wp-json/wcvendors/v1 en worden geleverd in de gratis WC Vendors plugin vanaf versie 2.7.3.

De release heeft drie delen die samenwerken.

REST-endpoints voor verkopers, bestellingen en commissies

De endpoints dekken de records waarop een marktplaats draait. Apps kunnen verkopers (vendors) vermelden en lezen, het winkelprofiel en de uitbetalingsgegevens van een verkoper bijwerken, en verkopers goedkeuren, weigeren, activeren of deactiveren. Ze kunnen ook commissierecords lezen, verkopersorders lezen, commissietarieven lezen en wijzigen, en een verkoopsamenvatting voor elke periode ophalen.

Webhooks voor marktplaatsgebeurtenissen

Webhooks werken in de andere richting. In plaats van dat een app je site om nieuws vraagt, vertelt je site de app het moment dat er iets gebeurt. WC Vendors voegt 11 marktplaatsgebeurtenissen toe aan WooCommerce webhooks, zoals een nieuwe verkopersaanvraag, een verkopersgoedkeuring, een nieuwe commissie en een nieuwe verkopersorder.

Mogelijkheden voor AI-agenten

WC Vendors registreert ook 10 marktplaatsmogelijkheden bij de WordPress Abilities API. Een mogelijkheid is een benoemde actie met een duidelijke input en output die AI-tools kunnen vinden en uitvoeren. Vijf mogelijkheden lezen alleen gegevens, zoals een marktplaats samenvatting. De andere vijf voeren wijzigingen door, zoals het goedkeuren van een verkoper of een wachtend product, dus een goed gebouwde AI-tool vraagt eerst om bevestiging van een persoon.

Dit is wat een assistent, verbonden via het Model Context Protocol, in staat stelt vragen te beantwoorden zoals "Welke verkopers wachten op goedkeuring?" met behulp van uw live marktplaatsgegevens.

Waarom een Multi-Vendor Winkel Zijn Eigen API Nodig Heeft

WooCommerce heeft al een REST API voor producten, orders en klanten. Het weet echter niet dat verkopers bestaan. Het kan een app niet vertellen welke verkoper een order bezit, hoeveel commissie verschuldigd is, of of een verkoper nog wacht op goedkeuring.

Een WooCommerce marktplaats API vult die leemte. Het spreekt in marktplaats termen, dus een app vraagt om "aan verkoper 42 verschuldigde commissies" in plaats van het antwoord samen te stellen uit ruwe ordergegevens.

Het is ook gebouwd voor een winkel met veel verkopers. De inloggegevens van een verkoper reiken alleen tot de eigen records van die verkoper. Dat betekent dat u verkopers hun eigen tools kunt laten verbinden zonder de orders, klanten of inkomsten van iemand anders bloot te leggen.

Wie Kan Het Gebruiken En Wat Elke Gebruiker Kan Zien

Elk verzoek meldt zich aan met een inloggegeven, en wat er terugkomt, hangt af van wie dat inloggegeven toebehoort.

• Winkel eigenaar: Elke gebruiker die WooCommerce kan beheren, zoals een Administrator of een Shop Manager, ziet alle verkopers, orders, commissies en rapporten. Alleen de winkel eigenaar kan verkopers goedkeuren, weigeren, activeren of deactiveren en commissietarieven wijzigen.
• Actieve verkoper: Ziet alleen de eigen records. Het opvragen van gegevens van een andere verkoper geeft een foutmelding.
• In afwachting van of inactieve verkoper: Krijgt geen toegang, zelfs niet met een geldig inloggegeven.
• Iedereen anders: Krijgt geen toegang.

Privégegevens blijven privé

Bank- en uitbetalingsvelden verschijnen alleen wanneer een app een enkele verkoper leest of bijwerkt. Verkoperslijsten en webhookberichten bevatten ze nooit, dus één verzoek kan niet alle bankgegevens van de verkopers tegelijk ophalen.

Klantgegevens op leveranciersbestellingen volgen de instellingen die u al gebruikt voor het leveranciersdashboard. U vindt ze onder WC Vendors > Instellingen > Mogelijkheden > Bestellingen, zoals uitgelegd in onze handleiding voor mogelijkhedeninstellingen. Als u daar het e-mailadres of telefoonnummer van een klant verbergt voor leveranciers, verbergt de API dit ook, zelfs wanneer de winkelier deze aanroept.

Ingebouwde snelheidslimieten

Elke gebruiker kan 100 verzoeken per minuut naar elk eindpunt sturen. Het overschrijden van de limiet retourneert een "te veel verzoeken"-fout totdat de minuut voorbij is. Snelheidslimieten zijn uitgeschakeld op sites die zijn ingesteld op een lokale of ontwikkelomgeving, dus u zult ze op de meeste testwebsites niet zien.

Wat u ermee kunt bouwen

Hier zijn een paar ideeën die alleen gebruiken wat wordt meegeleverd in WC Vendors 2.7.3.

• Commissierapporten voor uw boekhouder: Haal elke commissie met de status "verschuldigd" voor één leverancier op vóór de uitbetalingsdag. Als u nog steeds uw tarieven instelt, behandelt onze handleiding over hoe u leveranciers commissie in rekening brengt de opties.
• Directe aanmeldingsmeldingen: Stuur de webhook "Leveranciersaanmelding ingediend" naar uw teamchat of CRM. Uw team kan de aanvrager beoordelen en goedkeuren via de API, met behulp van hetzelfde goedkeuringsproces voor leveranciers als het admin-scherm.
• Leveranciers-eigen integraties: Een leverancier maakt zijn eigen inloggegevens aan en koppelt een voorraadtool of verzendapp. Die app ziet de bestellingen van de leverancier, en niemand anders.
• Wekelijkse marktplaatsrapporten: Vraag een verkoopsamenvatting voor vorige week aan en ontvang totale bestellingen, bruto-inkomsten, verschuldigde commissie, marktplaatswinsten en uw top 10 leveranciers in één antwoord.
• Een AI-assistent voor marktplaatsbeheer: Vraag een assistent om de samenvatting van vorige maand of de lijst met producten die wachten op goedkeuring. Ons zusterbedrijf StoreAgent laat zien hoe u Claude en ChatGPT aan uw winkel koppelt.

Vóór deze release betekende elk van deze een aangepaste plugin of een handmatige export. Met de WooCommerce marktplaats API zijn het een paar verzoeken die elke automatiserings-tool of ontwikkelaar kan instellen.

Hoe de WooCommerce Marktplaats API in te stellen

Er is geen instelling om in te schakelen. Zodra WC Vendors 2.7.3 actief is, zijn de eindpunten live en vereist elk verzoek een inloggegevens. Volg deze stappen om uw eerste app te verbinden.

Stap 1: Update WC Vendors en controleer Applicatie wachtwoorden

1. Update WC Vendors naar versie 2.7.3 of hoger. Als WordPress daarna een melding "WC Vendors Update Vereist" toont, klik dan op Voer de update uit.
2. Ga naar Gebruikers > Profiel in uw WordPress-admin en scrol naar Applicatie wachtwoorden.
3. Als u een formulier ziet om een nieuw wachtwoord toe te voegen, bent u klaar. Als de sectie aangeeft dat HTTPS nodig is, schakel dan eerst HTTPS in voor uw site.
4. Als de sectie ontbreekt, heeft een beveiligingsplugin of je host de Toepassingswachtwoorden uitgeschakeld. Je kunt ze weer inschakelen, of in plaats daarvan een WooCommerce REST API-sleutel gebruiken.

Stap 2: Maak een inloggegevens voor de winkelier

De API accepteert twee soorten inloggegevens, en beide loggen in via HTTPS.

• Toepassingswachtwoord: Ga in Gebruikers > Profiel > Toepassingswachtwoorden, voer een naam in voor de app, maak het wachtwoord aan en kopieer het meteen. WordPress toont het maar één keer. De officiële handleiding Toepassingswachtwoorden legt uit hoe ze werken.
• WooCommerce REST API-sleutel: Ga naar WooCommerce > Instellingen > Geavanceerd > REST API en voeg een sleutel toe voor je gebruiker. Een Lees-sleutel kan alleen gegevens lezen. Kies Lezen/Schrijven als de app iets moet wijzigen.

Als je van plan bent de AI-mogelijkheden te gebruiken, maak dan een Toepassingswachtwoord aan. WooCommerce REST API-sleutels werken niet voor deze mogelijkheden.

Stap 3: Laat verkopers hun eigen inloggegevens aanmaken

Verkopers hebben geen inloggegevens van jou nodig. Ze kunnen dit zelf doen vanuit hun eigen dashboard.

1. De verkoper opent zijn verkopersdashboard en gaat naar Instellingen, vervolgens naar het tabblad API.
2. Ze klikken op API-inloggegevens genereren.
3. De nieuwe inloggegevens verschijnen één keer met een Kopieer-knop en de waarschuwing “Bewaar dit nu. Voor de veiligheid wordt het niet meer getoond.”
4. Daarna toont het tabblad de naam van de inloggegevens, de datum waarop deze zijn aangemaakt, wanneer ze voor het laatst zijn gebruikt en een Opnieuw genereren-knop.

Elke verkoper kan één set inloggegevens tegelijk hebben. Het opnieuw genereren ervan vraagt om bevestiging, schakelt dan onmiddellijk de oude uit, dus elke app die deze gebruikt, moet worden bijgewerkt. Het API-tabblad verschijnt alleen wanneer Toepassingswachtwoorden beschikbaar zijn op je site.

Stap 4: Maak je eerste verzoek

Log in met de WordPress-gebruikersnaam en het Toepassingswachtwoord. Dit verzoek toont de eerste vijf verkopers:

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

Het antwoord is een lijst met verkopers in JSON-formaat. Twee antwoordheaders, X-WP-Total en X-WP-TotalPages, vertellen je hoeveel records en pagina's er zijn, en je kunt maximaal 100 records per pagina opvragen.

Hier is een verzoek dat de app van een verkoper zou kunnen doen om commissies te zien die nog niet zijn uitbetaald:

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

Stap 5: Voeg een marktplaats webhook toe

1. Ga naar WooCommerce > Instellingen > Geavanceerd > Webhooks en klik op Webhook toevoegen.
2. Voer een naam en de leverings-URL in waar je app het bericht moet ontvangen.
3. Open het dropdownmenu Onderwerp en kies een marktplaatsthema, bijvoorbeeld Verkoper goedgekeurd of Commissie aangemaakt.
4. Stel Status in op Actief en sla op.

WooCommerce regelt de levering, ondertekening en leveringslogboeken. De webhookdocumentatie legt uit hoe je kunt controleren of een bericht echt van je winkel afkomstig is.

Stap 6: Koppel een AI-agent met vaardigheden

Vaardigheden vereisen WordPress 6.9 of hoger en een Applicatie Wachtwoord van de winkelier. Om te zien wat er beschikbaar is, vraag de lijst met vaardigheden op in de categorie wcvendors:

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

De meeste mensen zullen dit niet handmatig aanroepen. Een MCP-compatibele AI-tool leest dezelfde lijst en bepaalt welke vaardigheid moet worden uitgevoerd. Zie voor een uitgewerkt voorbeeld van onze zusterbedrijven hoe Advanced Coupons u in staat stelt coupons te beheren met de WordPress Abilities API, of hoe Wholesale Suite groothandeltaken uitvoert vanuit Claude of ChatGPT.

Wilt u een AI-assistent verbinden? Onze stapsgewijze handleiding, Hoe AI-vaardigheden te gebruiken in WC Vendors, laat u zien hoe u Claude of ChatGPT via StoreAgent kunt verbinden met uw marktplaats. Het legt ook uit wat elk van de 10 vaardigheden kan doen, wie ze kan uitvoeren en hoe u veelvoorkomende installatieproblemen kunt oplossen.

Elk eindpunt, webhook en elke vaardigheid in één oogopslag

Eindpunten

Alle routes beginnen met /wp-json/wcvendors/v1.

Methode	Route	Wat het doet	Wie kan het gebruiken
GET	/vendors	Verkopers weergeven	Winkelier, verkoper (eigen record)
GET, PUT	/vendors/{id}	Lees of werk het winkelprofiel en de uitbetalingsgegevens van een verkoper bij	Winkelier, verkoper (eigen record)
POST	/vendors/{id}/approve, /deny	Beslis over een wachtende aanvraag	Winkelier
POST	/vendors/{id}/activate, /deactivate	Schort een verkoper op of herstel deze	Winkelier
GET, PUT	/vendors/{id}/commission	Lees of stel het eigen commissietarief van een verkoper in	Winkel eigenaar (verkopers kunnen hun eigen lezen)
GET, PUT	/instellingen/commissie	Lees of wijzig het globale commissietarief	Winkelier
GET	/commissies, /commissies/{id}	Commissierecords lezen	Winkel eigenaar, verkoper (eigen records)
GET	/bestellingen, /bestellingen/{id}	Verkoperbestellingen lezen	Winkel eigenaar, verkoper (eigen bestellingen)
GET	/rapporten/verkoop	Verkoopoverzicht voor een periode	Winkel eigenaar, verkoper (eigen verkoop)

Webhook-onderwerpen

• Verkopers: Verkopersaanvraag ingediend, Verkoper goedgekeurd, Verkoper geweigerd, Verkoper geactiveerd, Verkoper gedeactiveerd, Verkoper bijgewerkt en Verkoper verwijderd.
• Commissies: Commissie aangemaakt.
• Verkoperbestellingen: Verkoperbestelling aangemaakt, Verkoperbestelling bijgewerkt en Verkoperbestelling verwijderd.

Mogelijkheden

• Lezen: verkoperslijst, verkoper ophalen, wachtende productenlijst, commissie-instellingen ophalen en marktplaats samenvatting ophalen.
• Schrijven: verkoper goedkeuren, verkoper afwijzen, winkelprofiel van een verkoper bijwerken, product goedkeuren en product afwijzen.

Geen enkele mogelijkheid verplaatst geld, verandert een commissietarief, verandert waar een verkoper wordt betaald, of verwijdert een record. De schrijf-mogelijkheden sturen dezelfde e-mails als de bijbehorende knoppen in uw WordPress-admin, en een afgewezen product gaat terug naar de verkoper als een concept met uw reden erbij.

Best Practices Voor Een Veilige Marktplaats Integratie

Behandel de WooCommerce marktplaats API als elke andere deur naar uw winkel. Deze gewoonten houden het veilig en betrouwbaar.

• Geef elke app de minste toegang die het nodig heeft. Als een app alleen rapporten leest, geef het dan een Lees-sleutel in plaats van een Lees/Schrijf-sleutel.
• Plan voor wijzigingen in verkopersgegevens. Een verkoper beheert één credential, en het opnieuw genereren ervan snijdt elke app af die de oude gebruikte.
• Controleer klantinstellingen voordat u een verzend- of boekhoudtool verbindt. Als de klantgegevens leeg terugkomen, bekijk dan Mogelijkheden > Bestellingen en klik op Opslaan.
• Bewaar uw eigen kopie van alles wat u later nodig zou kunnen hebben. De webhooks "Verkoper verwijderd" en "Verkoperbestelling verwijderd" sturen alleen de ID, omdat het record niet meer bestaat.
• Houd de webhook-gezondheid in de gaten. WooCommerce stuurt een mislukte levering niet opnieuw, en schakelt een webhook uit na meer dan vijf mislukte leveringen.
• Weet welke commissietypes Pro vereisen. Zonder WC Vendors Pro accepteert de API alleen percentage commissie. Nieuwe tarieven zijn van toepassing op nieuwe commissies, en bestaande records veranderen niet.
• Schakel uit wat u niet gebruikt. Het toevoegen van define( 'WCV_DISABLE_ABILITIES', true ); aan wp-config.php verwijdert de mogelijkheden, en define( 'WCV_DISABLE_REST_API', true ); verwijdert de hele API.

Lees voor een uitgebreidere checklist onze gids over WooCommerce marketplace beveiliging.

Conclusie

WC Vendors 2.7.3 geeft uw winkel iets wat het nog nooit eerder had: een openbare, gedocumenteerde manier voor andere software om met verkopers, bestellingen en commissies te werken. De WooCommerce marketplace API neemt de dagelijkse taken over die vroeger export en copy-paste inhielden, van het afstemmen van commissies tot het goedkeuren van nieuwe verkopers.

Het is gebouwd met de risico's van een multi-vendor winkel in gedachten. Verkopers zien alleen hun eigen gegevens, uitbetalingsgegevens blijven buiten lijsten en webhooks, en klantgegevens volgen dezelfde regels als uw verkopersdashboard. Webhooks houden uw andere tools up-to-date zonder te pollen, en abilities laten een AI-assistent routinematige administratie afhandelen terwijl u de controle over elke wijziging behoudt.

Begin klein. Maak één credential aan, verbind één webhook en zie hoeveel handmatig werk verdwijnt. Bouw het daarna uit naarmate uw marketplace groeit.

Hier is wat we in dit artikel hebben behandeld:

• Wat is de WooCommerce marketplace API
• Waarom een multi-vendor winkel zijn eigen API nodig heeft
• Wie kan het gebruiken en wat elke gebruiker kan zien
• Wat u ermee kunt bouwen
• Hoe de WooCommerce marketplace API in te stellen
• Elke endpoint, webhook en ability in één oogopslag
• Best practices voor een veilige marketplace-integratie

Veelgestelde Vragen