# MCP tools > Elke tool op de TradeCatalog MCP-server, zijn invoer, wie er gebruik van kan maken en wat het retourneert. Tools gebruiken uw huidige werkruimte-rol bij elke aanroep. Lees-only verbindingen werken nog steeds. Het maken van wijzigingen vereist de extra `tradecatalog:write`-bereik. Consequente acties tonen een Bevestig/Aannemen-kaart in compatibele clients, met een ingelogd review-link als fallback, en worden pas uitgevoerd nadat u het hebt goedgekeurd. Resultaten zijn JSON-tekst; het oorspronkelijke zoektools-formaat geeft prijzen weer, terwijl beheertools gehele getallen van munteenheden en basispunten (100 = 1%) gebruiken. De meeste tools nemen een `workspace`: de werkruimte-adres van `list_workspaces`, zoals `northgate`. De AI-app roept meestal `list_workspaces` eerst zelf aan. Wanneer een tool iets niet kan doen, bijvoorbeeld u niet persoon bent bij die werkruimte of de klant niet bestaat, geeft het een foutmelding die de AI-app kan lezen en actie ondernemen, zoals "Geen klant \"OAK99\". Gebruik list_customers voor accountcodes." Wanneer een leverancierscatalogus alleen prijzen heeft voor de geselecteerde klant, `set_basket_quantity`, `send_order` en `reorder` geven die foutmelding terug. `get_basket`, `list_buyer_orders` en `get_buyer_order` werken nog steeds, zodat bestaande bestellingen leesbaar blijven. De leverancier stelt dit in Instellingen en kan het per klant overschrijven (`ordering`: `follow`, `prices_only` of `can_order` op `update_customer`). Wanneer de leverancier de prijslijstdownloaden heeft uitgeschakeld, geeft `download_my_price_list` een foutmelding en antwoordt de ingelogde CSV-link met 403. `quote_configured_product` leest de lijnprijs van het geselecteerde klantaccount voor `productId`, `qty` en optionele `configuration`, zonder een winkelwagen te veranderen. `set_configured_basket_line` maakt een aparte lijn aan of werkt de exacte `lineId` (`qty: 0` verwijdert) bij. Geef de volledige specificatie op bij bewerkingen. Lees `get_basket` opnieuw na wijzigingen en beoordeel alle selecties, maten en huidige prijzen voordat u `send_order` uitvoert. Een wijziging in specificatie of prijsversie maakt de oude beoordeling ongeldig, zelfs als het totaal hetzelfde is. Medewerkers kunnen `save_product_family` gebruiken voor gedeelde variant metadata en `save_ordering_draft` voor een beoordeelde geavanceerde prijsontwerp. Het laatste vereist Pro en globale prijsrechten; publicatie gebruikt de bestaande prijsveranderingen beoordeling. Productimporten accepteren optionele familie, bestelincrement en besteldefinities. Zie [trade catalogue setup](/docs/guides/trade-catalogues). ## Stel een leverancierswerkruimte in `create_workspace` maakt een Free leverancierswerkplek voor de ingelogde, geverifieerde persoon, nadat zij een kaart hebben bevestigd. Vraag om de bedrijfsnaam, productvaluta, tijdzone en land. De persoon wordt de eigenaar. Er wordt geen abonnement of betaling aangemaakt. Roep daarna `list_workspaces` opnieuw aan en gebruik de geretourneerde adres voor product- en klantinstellingen. Beoordelaars en gastlogins kunnen geen werkplekken aanmaken. Free omvat maximaal 100 producten en verbonden AI-apps. Elk SKU telt, inclusief verborgen en inactieve producten. Bij het toegestane aantal blijven bestaande producten, bewerkingen en bestellingen werken; het aanmaken van meer producten is niet beschikbaar. Leg deze bevoegdheid uit zonder upgrades te promoten of de abonnementscheckout te starten in de plugin. ## list_workspaces Leverancierswerkruimtes waarin u werkt, en handelsportalen waar u koopt. Begin hier. **Wie:** iedereen die is ingelogd. **Invoer:** geen enkele. ```json { "supplierWorkspaces": [ { "workspace": "northgate", "name": "Northgate Fixings", "role": "owner" } ], "tradePortals": [ { "workspace": "hartley-timber", "supplier": "Hartley Timber", "yourAccount": "Northgate Fixings", "accountId": "example-account-id" } ] } ``` ## search_products Zoek een catalogus op SKU, fabrikantreferentie, naam, merk of categorie. Geeft maximaal **25** producten terug. **Wie:** medewerkers en aankopers. | Invoer | Type | Verplicht | Beschrijving | | ----------- | ------ | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | `workspace` | string | ja | Werkplek adres. | | `query` | string | ja | Wat te zoeken. Leeg lijst producten op naam. | | `accountId` | string | klanten met meer dan één account | Selecteer uw exacte account uit `list_workspaces`. | | `customer` | string | nee | Medewerkers alleen: een klantaccountcode of naam, om hun prijzen te zien en alleen wat zij kunnen zien. Genegeerd voor klanten. | - **Aankopers** zien altijd de prijzen van hun eigen account en alleen actieve producten die zij kunnen zien. - **Medewerkers** zien lijstprijzen en elk product, of de weergave van een genoemde klant. ```json { "supplier": "Northgate Fixings", "pricesFor": "Oakfield Joinery", "taxNote": "ex VAT", "products": [ { "sku": "HX-8510", "name": "Hex bolt M10 x 50 zinc", "unit": "Box of 100", "availability": "in_stock", "price": "£15.73", "listPrice": "£18.50", "why": "Brand discount −15%" } ] } ``` Wanneer de leverancier **Klanten de standaardprijs naast hun eigen prijs tonen** heeft uitgeschakeld, laten de zoekresultaten van een koper `listPrice` en `why` weg, en dragen `get_buyer_product`, `get_basket` en `get_buyer_order` ook geen lijstprijs of prijsreden meer. Probeer: "Zoek Northgate naar M10 hex bouten tegen de prijzen van Oakfield." ## download_products_csv en download_my_price_list Deze tools geven een link naar een bestaande CSV-download in TradeCatalog. Open het terwijl u ingelogd bent; het retourneren van een link downloadt of stuurt het bestand niet naar de chat. - `download_products_csv`: medewerkers kiezen `workspace` om de productlijst van die leverancier te downloaden. - `download_my_price_list`: kopers kiezen `workspace` en het exacte `accountId` uit `list_workspaces` om alleen de overeengekomen prijzen van dat account te downloaden. - `download_my_price_list_pdf`: hetzelfde account, als een gemarkeerde PDF (Pro). Beide tools zijn geblokkeerd wanneer de leverancier prijslijstdownloads heeft uitgeschakeld. ## check_price Wat een klant betaalt voor een SKU op een hoeveelheid, en welk regelset de prijs bepaald. **Wie:** alleen medewerkers. | Invoer | Type | Verplicht | Beschrijving | | ----------- | ------- | --------- | ----------------------------- | | `workspace` | string | ja | Werkplek adres. | | `customer` | string | ja | Accountcode of naam. | | `sku` | string | ja | De SKU. | | `qty` | integer | nee | 1 tot 1.000.000. Standaard 1. | ```json { "customer": "Oakfield Joinery", "sku": "HX-8510", "name": "Hex bolt M10 x 50 zinc", "qty": 20, "unitPrice": "£15.73", "lineTotal": "£314.60", "listPrice": "£18.50", "why": "Brand discount −15%", "taxNote": "ex VAT" } ``` Probeer: “Wat betaalt OAK01 voor 20 van HX-8510, en waarom?” ## list_customers Handelsklanten met accountcodes, contactmails, actieve status en accountkorting. **Wie:** alleen medewerkers. **Invoer:** `workspace`. ```json [ { "accountCode": "OAK01", "name": "Oakfield Joinery", "email": "accounts@oakfieldjoinery.co.uk", "active": true, "discount": "5%" } ] ``` Probeer: “Welke klanten hebben geen korting ingesteld?” ## list_orders Recente bestellingen, nieuwste eerst, maximaal **50**. **Wie:** medewerkers zien elke klantens bestellingen; kopers zien alleen hun eigen account. | Invoer | Type | Verplicht | Beschrijving | | ----------- | ------ | --------- | ---------------------------------------------------------------------------------------- | | `workspace` | string | ja | Werkplek adres. | | `status` | string | nee | `new`, `pending`, `acknowledged`, `processed`, `dispatched`, `completed` of `cancelled`. | ```json [ { "reference": "SO-000142", "customer": "Oakfield Joinery", "status": "new", "total": "£314.60", "poNumber": "PO-88231", "placed": "2026-09-27T07:48:12.000Z" } ] ``` Probeer: “Heeft iemand sinds gisteren nieuwe bestellingen? Tel ze op per klant.” ## recent_activity De activiteitenlog van wijzigingen aan klanten, kortingen en prijzen, nieuwste eerst, maximaal **50** items. Optioneel de geschiedenis van één klant. **Wie:** alleen medewerkers. Eigenaars en beheerders zien de volledige log; andere medewerkers zien alleen wijzigingen over klanten die zij kunnen zien. | Invoer | Type | Verplicht | Beschrijving | | ----------- | ------ | --------- | -------------------- | | `workspace` | string | ja | Werkplek adres. | | `customer` | string | nee | Accountcode of naam. | ```json [ { "when": "2026-09-26T14:21:03.000Z", "who": "Jo Hartley", "customer": "Oakfield Joinery", "what": "Set Northgate brand discount to 15% (was 12.5%)" } ] ``` Probeer: “Wie heeft de prijzen van Oakfield deze maand gewijzigd?” ## Notities - Klantnamen en accountcodes worden zonder rekening te houden met hoofdletters overeengesteld. Een exacte accountcode is veiligst. - `list_workspaces` retourneert koper `accountId` waarden. Geef het bedoelde op naar `search_products` en elke koperactie. Gok nooit tussen accounts. - Pagina productzoekopdrachten met `offset` en het geretourneerde `nextOffset`. Gebruik `list_buyer_orders` voor een expliciet geselecteerde koperaccount. ## Veranderingen en bevestigingen Koperwagentje bewerkingen, markeren updates als gelezen en het maken van ongepubliceerde prijsontwerpen lopen direct wanneer geautoriseerd. Andere schrijfbewerkingen retourneren `awaiting_confirmation`, een `actionId` en een `reviewUrl`. ChatGPT en compatibele clients tonen een kaart met het exacte werkplek en voorgestelde wijziging: kies **Bevestigen** of **Annuleren** zonder de conversatie te verlaten. Clients zonder kaarten gebruiken de ingelogde beoordelingslink. Beoordelingen verlopen na 15 minuten en worden maximaal één keer uitgevoerd. Het loskoppelen van de app of het verwijderen van de vereiste werkplektoegang maakt onafgewerkte beoordelingen ongeldig. Gewijzigde bestelwagentjes en prijsveranderingen voorbeelden vereisen een nieuwe beoordeling. Gebruik `get_action_status` om het resultaat te lezen; een wachtende aanvraag is geen voltooide actie. De `decide_action` helper is alleen beschikbaar voor de kaart UI. Zijn tijdelijke bevestigingsmogelijkheid is verborgen van modeluitvoer en gebonden aan de aanvragende persoon, OAuth-verbinding en voorstel. Een modelbericht of actie-ID kan geen wijziging goedkeuren. Dezelfde rol, momentopname, verloop en enkelvoudige controle gelden voor zowel kaart- als browser-goedkeuringen. Elke aankoperactie vereist uw exacte `accountId`. Voor `send_order`, kopieer de winkelwagen `fingerprint` naar `expectedBasket`, samen met `expectedTotal`. Prijzen, hoeveelheden en account worden opnieuw gecontroleerd voordat ze worden verzonden. Gebruik de aparte overdrachtstools voor werk dat eindigt in de ingelogde app: eigenaren gebruiken `open_api_key_settings`, `download_workspace_export` en `open_logo_settings`; medewerkers gebruiken `open_import_page`, `open_product_image_upload` en `open_product_file_manager`. De twee productoverdrachten vereisen een door de huurder gecontroleerde `productId`. Bestandskoppelingen van `get_product` en `get_buyer_product` vereisen uw ingelogde browser; het retourneren van een koppeling betekent niet dat het document is gelezen of dat een upload, verwijdering, export of certificaat is voltooid. Platformbeheer wordt nooit doorgegeven via OAuth. ## Goedgekeurde klantenlijsten Medewerkers gebruiken `get_customer` om de catalogusomvang en goedgekeurde producten van de klant te lezen. `set_catalogue_scope` verandert tussen `all` en `approved`. `approve_products` voegt expliciete producten of een categorie toe; `unapprove_product` verwijdert één product. Deze wijzigingen vereisen een beoordeling van het exacte klantaccount, de huidige lijst en de betrokkene producten. Categorielidmaatschap wordt opnieuw gecontroleerd bij bevestiging. Aankopers blijven beperkt tot hun geselecteerde account en de producten die zichtbaar zijn voor dat account. ## Leverancier- en koperhulpmiddelen `create_workspace` is beschikbaar zelfs wanneer `list_workspaces` leeg is. Het maakt een Free leverancierswerkplek en eigenaarslidmaatschap pas na bevestiging. De optionele `/mcp/account`-verbinding biedt ook `open_billing`: eigenaren kunnen beveiligde abonnementsfacturatie openen en betaling bevestigen in Stripe, en vervolgens kijken naar `get_settings` voor de resulterende staat. Factuurkoppelingen voltooien geen betalingen. De standaard `/mcp`-verbinding die wordt gebruikt door de ChatGPT-plugin exposeert geen `open_billing`. Zie [aanmelden en betalen](/docs/mcp#sign-up-and-pay-with-an-agent). MCP 3.0.0 toont elke model-aanroepbare operatie direct met zijn eigen naam, beschrijving, invoerschema en annotaties. De vorige tools `bulk_products` en `open_workspace_action` worden vervangen door de individuele operaties hieronder; vernieuw de tooldefinities van uw client na het bijwerken. Het MCP `tools/list`-antwoord is het autoritatieve invoerschema. De volgende tools vullen de zoektools hierboven aan: | Tool | Doel | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `open_api_key_settings` | Alleen eigenaar: retourneert de ingelogde API-instellingenpagina voor het aanmaken van referenties. Het openen van de link maakt geen sleutel aan. Vraag gebruikers nooit om geheimen in chat te plakken. | | `download_workspace_export` | Alleen eigenaar: retourneert de ingelogde volledige werkplek exportlink. De gebruiker moet de link openen om het te downloaden; deze tool leest of verplaatst de export niet. | | `open_logo_settings` | Alleen eigenaar: retourneert de ingelogde merkinstellingenpagina voor het uploaden van een leverancierslogo. Het openen van de link uploadt of verandert het logo niet. | | `open_import_page` | Medewerker: retourneert de ingelogde bestandsimportpagina. De gebruiker uploadt en beoordeelt het bestand in TradeCatalog; het openen van de link importeert niets. | | `open_product_image_upload` | Medewerker: retourneert de ingelogde editor voor een bestaand product om een afbeelding te uploaden. Het openen van de link uploadt of wijzigt geen afbeelding. | | `open_product_file_manager` | Medewerker: retourneert de ingelogde editor voor een bestaand product om productbestanden te uploaden of te verwijderen. Het openen van de link leest, uploadt of verwijdert geen bestanden. | | `delete_workspace` | Alleen eigenaar: verwijder deze werkruimte permanent, haar catalogus, klanttoegang en afbeeldingen, en annuleer haar abonnement. Vereist ingelogde beoordeling en het typen van de naam van de werkruimte. Dit kan niet ongedaan worden gemaakt in de app. | | `get_workspace` | Medewerker: huidige rol, catalogus en besteltotalen. Bedragen zijn gehele munteenheden; percentages zijn basispunten (100 = 1%). | | `get_catalogue_options` | Medewerker: lijst categorie- en merk-ID's voor catalogus- en kortingseizoenen. | | `get_product` | Medewerker: productvelden, huidige lijstprijs, zichtbaarheid, klantbeperkingen, afbeeldingen en bijgevoegde bestanden (specificatiebladen). | | `save_product` | Maak een product aan of bewerk het. Lees eerst het huidige product en behoud de velden die de gebruiker niet heeft gevraagd te wijzigen. listPrice is in mindere eenheden; wijzigingen in bestaande prijzen gebruiken de app prijswijzigingsstroom. Vereist beoordeling. | | `set_product_image` | Kies de hoofdafbeelding of verwijder deze. Het verwijderen verwijdert deze afbeelding uit de galerij en de volgende wordt de hoofdafbeelding. Vereist beoordeling. | | `create_category` | Maak een genaamd categorie aan, eventueel onder een oudercategorie. Vereist beoordeling. | | `update_category` | Hernoem of verplaats een categorie. De producten blijven erin. Vereist beoordeling. | | `delete_category` | Verwijder een categorie en haar categorie-kortingsregels. Producten en onderliggende categorieën gaan één niveau omhoog. Vereist beoordeling. | | `hide_products` | Medewerker: verberg expliciete product-ID's voor kopers zonder ze te verwijderen. Vereist beoordeling. | | `show_products` | Medewerker: maak expliciete product-ID's actief. Beperkingen van klantcatalogus blijven van toepassing. Vereist beoordeling. | | `move_products` | Medewerker: verplaats expliciete product-ID's naar één categorie, of geef null door om hun categorie te verwijderen. Vereist beoordeling. | | `delete_products` | Medewerker: verwijder expliciete product-ID's permanent, inclusief hun prijzen, afbeeldingen en winkelwagenlijnen. Historische bestellingen behouden hun kopieën. Vereist beoordeling. | | `clear_catalogue` | Eigenaar alleen: verwijder permanent elk product, prijs en foto. Vereist ingelogd beoordeling en het typen van de huidige verwijderingszin. | | `get_customer` | Medewerker: klantvoorwaarden, prijslijst, catalogusbereik, goedgekeurde producten, kortingregels, overeengekomen prijzen, kopers en uitstaande uitnodigingen. `priceLists` zijn de lijsten die je kunt toewijzen met `update_customer`. Het toewijzen van een andere niet-Standard-prijslijst vereist Pro. | | `create_customer` | Maak een handelsaccount aan. De contactmail kan zich aanmelden als dat account, dus bevestig de adresgegevens. Vereist beoordeling. | | `update_customer` | Wijzig klantgegevens, accountcode (`accountCode`; uniek per leverancier, hoofdletters worden genegeerd, laat leeg om te behouden), contactloginmail, extra update-mails (`notifyEmails`), actieve status, de hele lijst percentage (`discountBp`, 0 tot 10.000) en zijn `adjustment` (`discount` of `markup`; laat leeg om te behouden), bestelling (`follow`, `prices_only` of `can_order`) en `priceListId` (null is Standard). Basispunten: 100 = 1%. Lees eerst get_customer. Vereist beoordeling. Het toewijzen van een andere niet-Standard-prijslijst vereist Pro. | | `save_discount_rule` | Stel een klantcategorie, merk of productpercentage in, in basispunten (0 tot 10.000). `adjustment` is `discount` of `markup`; laat het weg voor een korting. De meest specifieke regel wint en niets stakt. Wijzigt prijzen direct. Vereist beoordeling. Vereist Pro. | | `remove_discount_rule` | Verwijder de geselecteerde klantkortingsregel. Prijzen kunnen direct stijgen. Vereist beoordeling. | | `set_fixed_price` | Stel een klantgerichte productprijs in in gehele mindere valutaeenheden. Optioneel `note` is een opmerking; `noteVisible` toont het aan die klant. `internalNote` blijft intern. Vereist beoordeling. Vereist Pro. | | `end_fixed_price` | Eindig een vaste klantprijs nu zodat normale kortingregels van toepassing zijn. Vereist beoordeling. | | `list_staff` | Medewerker: lijst de werkruimteteamleden en uitstaande uitnodigingen. | | `invite_staff` | Alleen eigenaar: e-mail een uitnodiging om medewerker- of eigenaarsrechten te verlenen. Vereist beoordeling van de ontvanger en rol. | | `invite_buyer` | Medewerker: e-mail een uitnodiging naar een specifiek klantaccount. Vereist beoordeling van de ontvanger en account. | | `remove_buyer` | Verwijder een lidmaatschap van het genoemde klantaccount. Vereist beoordeling. | | `preview_product_import` | Bekijk geparseerde rijen zonder te importeren. Repareer onzeker bronprijs niet stil. | | `import_products` | Importeer maximaal 100 geparseerde rijen. listPrice gaat naar priceList (uitlaten voor Standard); listPrices noemt andere lijsten. Elke lijst wijzigt een concept. Vereist beoordeling. Afbeeldings-URL's kunnen worden opgehaald. | | `import_customers` | Importeer maximaal 100 klanten. Optionele priceList noemt hun lijst; aanpassing is korting of mark-up. Een onbekende lijstnaam is een fout. Vereist beoordeling. | | `preview_agreed_prices` | Bekijk maximaal 2.000 overeengekomen prijzen (accountcode, SKU, geheel getal minoreenheidsprijs en een optionele opmerking) zonder op te slaan. Alleen voor Pro. Onbekende accounts en SKUs worden gemeld en overgeslagen. Wanneer een account en SKU herhaald worden, wordt de laatste rij gebruikt. | | `import_agreed_prices` | Sla maximaal 2.000 overeengekomen prijzen op voor bestaande accounts en SKUs. Alleen voor Pro. Elke prijs wordt versiebeheerd vanaf nu, in batches van 100. Onbekende rijen worden overgeslagen. Vereist beoordeling. | | `list_import_layouts` | Lijst de opgeslagen kolomtoewijzingen van deze leverancier. | | `save_import_layout` | Sla een herbruikbare kolomtoewijzing op voor deze leverancier. Vereist beoordeling. | | `list_price_changes` | Lijst concepten en geplande of gepubliceerde prijsveranderingen. | | `draft_price_change` | Maak een concept percentageprijsverandering aan voor één prijslijst (`priceListId`; weglaten voor Standard). Een batch mengt nooit lijsten. Onderhandelde basispunten: 600 = +6%, van −90% tot +100%. Publiceert of e-mailt geen klanten. Vereist Pro. | | `preview_price_change` | Lees het impact, waarschuwingen, vaste prijzen en planningstrijd voor publicatie. | | `publish_price_change` | Publiceer nu of op een ISO-tijdstempel, optioneel e-mailen aan klanten (bij publicatie of op een geplande `notifyAt`) en verander overeengekomen prijzen. Vereist beoordeling van de huidige voorbeeldweergave; gewijzigde voorbeeldweergaven ongeldig maken goedkeuring. Pro is vereist, behalve voor directe Standard-prijsimporten zonder e-mails of veranderingen in overeengekomen prijzen. | | `cancel_price_change` | Annuleer een geplande prijsverandering. Klanten kunnen per e-mail een annulering ontvangen. Vereist beoordeling. | | `discard_price_draft` | Verwijder een niet-gepubliceerde prijsverandering permanent. Vereist beoordeling. | | `get_staff_order` | Medewerker: bestellijnen, klant, notities en statusgeschiedenis. | | `set_order_status` | Accepteer, verwerk, voltooi of annuleer een bestelling met behulp van de toegestane overgangen van de app. Kan de koper per e-mail informeren. Vereist beoordeling. | | `get_settings` | Lees leveranciersinstellingen en abonnementsstatus; geen betaalgegevens worden geretourneerd. | | `save_settings` | Alleen eigenaar: wijzig bedrijfsgegevens, bestellingsontvangers, valuta, directoryvermelding, zoekvoorkeuren of of klanten de standaardprijs naast hun eigen prijs zien (`showStandardPrice`; `false` toont alleen hun eigen prijs), hoe producten voor klanten worden geordend (`productOrder`: `name`, `sku`, `category` of `custom`; `category` volgt de volgorde van de Categorieën-pagina, A tot Z op naam binnen elke categorie, ongecategoriseerd laatst), welke cataloguskolommen ze zien en in welke volgorde (`catalogueColumns`), de titel voor elke handelsdealnotitie van een product (`dealLabel`), of de gemarkeerde klantensign-in de medewerkerssign-in link verbergt (`hidePortalStaffLink`; eigenaar of admin, standaard waar), of de medewerkerspagina-onderkoppen en hoe-to links worden verborgen (`hideStaffGuides`; alleen eigenaar of admin, standaard waar), of de sign-in-pagina op gebruikersnaam en wachtwoord opent (`loginUsernameFirst`; alleen eigenaar of admin, standaard waar zodat e-mail eerst blijft), en welke delen van de gemarkeerde PDF-prijslijst te printen (`pdfShowLogo`, `pdfShowDate`, `pdfShowSupplierName`, `pdfShowCustomerName`, `pdfShowPageNumbers`; elk standaard waar, false verbergt dat deel). Lees eerst de huidige instellingen. Vereist beoordeling. | | `list_api_keys` | Eigenaar alleen: lijst met sleutellabels en bereiken. Geeft nooit geheimen terug. | | `revoke_api_key` | Eigenaar alleen: verbreek onmiddellijk een API-integratie. Vereist beoordeling. | | `list_news` | Medewerker: lijst met aankondigingen, inclusief verlopen berichten. | | `post_news` | Publiceer een aankondiging aan kopers, nu of vanaf `startsLocal` (leveranciers tijd). Optioneel `endsOn` verbergt het op `YYYY-MM-DDTHH:mm` in de leveranciers-tijdzone, of aan het einde van een `YYYY-MM-DD`. emailCustomers stuurt ook e-mails naar abonnees wanneer het begint. Vereist beoordeling van het exacte bericht en doelgroep. | | `remove_news` | Verwijder een gepubliceerde aankondiging. Verzonden e-mails kunnen niet worden teruggetrokken. Vereist beoordeling. | | `list_support_tickets` | Alleen eigenaar en beheerder: lijst met ondersteuningstickets van dit werkplek. | | `get_support_ticket` | Alleen eigenaar en beheerder: lees berichten op een ticket dat behoort tot deze werkplek. | | `open_support_ticket` | Alleen eigenaar en beheerder: stuur een ondersteuningsverzoek naar Happy Webs. Vereist beoordeling van het exacte bericht. | | `reply_to_support` | Alleen eigenaar en beheerder: stuur een antwoord op een bestaande ondersteuningsgesprek. Vereist beoordeling. | | `get_buyer_product` | Lees een zichtbaar product met prijzen en bijgevoegde bestanden (specificatiebladen) voor het expliciet geselecteerde account. | | `get_basket` | Lees huidige hoeveelheden en prijzen voor uw expliciet geselecteerde klantaccount. | | `set_basket_quantity` | Stel een absolute hoeveelheid in (0 verwijdert de regel). Werkt alleen op uw winkelwagen; stuurt geen bestelling. | | `send_order` | Stuur de winkelwagen van het geselecteerde account naar de leverancier, met een kopie van de kopersemail. Vereist ingelogd beoordelen van exacte producten, hoeveelheden, prijzen, PO en opmerkingen. Als de winkelwagen verandert, vraag een nieuwe beoordeling aan. Kopieer expectedBasket van get_basket.fingerprint. | | `list_buyer_orders` | Lees bestellingen voor het expliciet geselecteerde account. | | `get_buyer_order` | Lees regels en statusgeschiedenis voor een bestelling van het geselecteerde account. | | `reorder` | Voeg beschikbare producten uit een vorige bestelling toe aan uw winkelwagen tegen huidige prijzen. Stuurt geen bestelling. Vereist beoordeling. | | `get_buyer_updates` | Lees de huidige nieuwsberichten, prijsveranderingen en ongelezen updates voor het geselecteerde klantaccount. | | `mark_updates_read` | Markeer de momenteel beschikbare updates van het geselecteerde account als gelezen. | | `get_action_status` | Lees het resultaat van een beoordeling die is aangevraagd door deze verbinding. | Medewerker bestellingen invoeren gebruikt `preview_customer_order` en wordt vervolgens gecontroleerd `create_customer_order` met exacte prijzen en een herprobeer UUID. Verwerking gebruikt `set_order_status` met openbare `note`, particulier `internalNote`/`correctionReason`, en `expectedRevision`. Gecontroleerde `set_order_delivery` registreert een klantzichtbare leveringsmethode en optionele koerier, referentie en HTTPS-link. Deze tools volgen de huidige rechten en klantbereik van de lidmaatschap. Zie [Bestellingen](/docs/api/orders) voor de velden en gedrag.