MCP-tools · Klanten, leveranciers en facturen
Debiteuren: get_customers
De klanten van een administratie met code, naam en de contact-, adres- en btw-gegevens die het pakket levert. Je kunt zoeken op naam of code, of alleen actieve klanten opvragen.
Wat de tool teruggeeft
Deze beschrijving krijgt je AI-assistent van FinanceMCP mee, zodat hij weet wanneer hij de tool gebruikt:
Debiteuren (klanten) van één administratie met code, naam en de contact-, adres- en btw-gegevens die het pakket levert. Optioneel te zoeken op naam of code, of alleen actieve relaties.
De tool leest alleen en verandert niets in je administratie.
Parameters
| Parameter | Soort | Verplicht | Betekenis |
|---|---|---|---|
administrationId | tekst | ja | De administratie, zoals list_administrations die teruggeeft. |
search | tekst | nee | Zoekterm op naam of code. |
activeOnly | ja of nee | nee | Alleen actieve relaties. |
pageSize | geheel getal | nee | Aantal regels per pagina. |
cursor | tekst | nee | Vervolgcursor uit het vorige antwoord, voor de volgende pagina. |
Je hoeft deze parameters niet zelf in te vullen: je assistent leidt ze af uit je vraag.
Voorbeeld
Een vraag die je assistent met deze tool beantwoordt:
Wat is het btw-nummer van klant De Vries?
Het antwoord van de tool, ingekort en met verzonnen cijfers:
{
"items": [
{
"relationId": "c-1042",
"customerCode": "1042",
"name": "De Vries Installatietechniek B.V.",
"isActive": true,
"vatNumber": "NL000099998B57",
"paymentTermDays": 30,
"address": {
"city": "Eindhoven",
"countryCode": "NL"
}
}
],
"nextCursor": null,
"warnings": []
}Per pakket
| Pakket | Levert | Toelichting |
|---|---|---|
| Exact Online | volledig | |
| Moneybird | volledig | Moneybird maakt geen onderscheid tussen klant en leverancier; de tool geeft alle contacten. |
| Business Central | volledig | |
| Twinfield | volledig | |
| e-Boekhouden.nl | volledig |
Wat een pakket niet levert, meldt de tool in het antwoord onder warnings, zodat je assistent het kan benoemen.