Pro Doen LogoPro Doen
Inloggen

Pro Doen — Documentatie · Gebruik AI-tools

Prijslijst WebMCP-tools

In de ingelogde Pro Doen-omgeving zijn vier tools voor prijsregels en twee voor media-upload beschikbaar, naast de tools voor projecten en het weergeven en importeren van projectaanbiedingen. Ze gebruiken jouw browsersessie en bedrijfsrechten — geen aparte API-sleutel.

Wil je dezelfde interfaces gebruiken in een browser zonder WebMCP-ondersteuning? Open dan de Pro Doen WebMCP Tool. Daar kies je een call, voer je de invoer als JSON in en krijg je de uitkomst als JSON terug. De Tool gebruikt dezelfde definities, sessie en bedrijfsrechten als WebMCP.

prodoen_company_pricelist_items_list

Geeft een compacte alfabetische lijst terug. Elke regel bevat minimaal id en title, plus onder meer eenheid, verkoopprijs, btw, vakgebied, merk, productcode en EAN wanneer bekend.

Optionele invoer:

  • query — zoeken op naam, merk, productcode of EAN;
  • limit — maximaal 1–250 resultaten (standaard 100).

prodoen_company_pricelist_items_get

Haalt één volledige prijsregel op met het exacte id uit de lijstcall. Het antwoord bevat alle commerciële en technische velden en gekoppelde afbeeldingen. Een ID van een ander bedrijf levert geen resultaat op.

prodoen_company_pricelist_items_import_item

Maakt één nieuwe prijsregel aan. Minimale invoer: title en unitType. Optioneel: prijs, btw, vakgebied, merk, productinformatie en afbeeldingen.

prodoen_company_pricelist_items_update

Werkt één bestaande prijsregel bij aan de hand van het exacte id. Alleen meegestuurde velden veranderen. Gebruik null om een optioneel veld te wissen en images: [] om alle afbeeldingen van de regel te verwijderen. Een meegestuurde images-lijst vervangt altijd de volledige bestaande afbeeldingslijst.

Nieuwe afbeeldingen upload je eerst met prodoen_company_media_upload_prepare en prodoen_company_media_upload_confirm. Daarna geef je de bevestigde mediaFileId-waarden mee aan de updatecall. Een regel of afbeelding van een ander bedrijf of een andere gebruiker kan niet worden bijgewerkt of gekoppeld.

Aanbevolen werkwijze voor je AI-client

  1. Roep prodoen_company_pricelist_items_list aan en bekijk bestaande namen en ID's.
  2. Gebruik prodoen_company_pricelist_items_get voor regels die inhoudelijk of financieel gecontroleerd moeten worden.
  3. Laat de AI afwijkingen, ontbrekende velden en mogelijke doublures samenvatten.
  4. Geef expliciet aan welke regels aangemaakt of bijgewerkt mogen worden.
  5. Gebruik voor bestaande regels de updatecall met het eerder opgehaalde id; maak alleen echt nieuwe regels aan met de importcall.
  6. Roep de lijst opnieuw aan en controleer gewijzigde regels via hun id.

Voorbeeldinstructie aan je AI-client:

Lees eerst mijn huidige prijslijst. Vergelijk deze met het aangeleverde bestand, toon mogelijke doublures en ontbrekende waarden, en wijzig pas na mijn akkoord. Werk bestaande regels bij via hun ID, maak alleen nieuwe regels aan wanneer er geen match bestaat en controleer daarna iedere gewijzigde regel.

Prijslijst importeren

Geef bij een import minimaal aan:

  • welke kolom naam, eenheid, verkoopprijs, inkoopprijs en btw bevat;
  • of bedragen inclusief of exclusief btw zijn;
  • hoe producten, diensten en vaste pakketten worden onderscheiden;
  • welke afbeeldingen bij welke regel horen;
  • hoe bestaande regels herkend worden (EAN, productcode, naam);
  • of bestaande regels mogen worden bijgewerkt of alleen nieuwe regels toegevoegd.

Laat de AI altijd eerst een voorbeeld en doublurecontrole tonen vóór een grote import.

Hoe WebMCP technisch werkt

WebMCP draait op de ingelogde prijslijstpagina. De pagina registreert de tools in de browser en roept vervolgens beveiligde same-origin Next.js-API's aan. Er draait geen aparte MCP-server in de app — import, validatie en bedrijfsrechten lopen via dezelfde serverlaag als de gewone UI.

WebMCP publiceert de tools automatisch op /mijn/bedrijf/prijslijst wanneer je omgeving en browser WebMCP ondersteunen.

Zonder WebMCP voert de Pro Doen WebMCP Tool dezelfde calls handmatig uit. Beide routes sturen de JWT van de ingelogde gebruiker als Authorization-header mee en gebruiken daarnaast de bijbehorende beveiligde sessiecookie.

Meer context

Voor een overzicht van AI in Pro Doen en welke koppelingen er aankomen, zie AI en MCP in Pro Doen.