MCP-tools · Klanten, leveranciers en facturen
Omzet per klant: get_revenue_by_customer
De omzet per klant over een boekjaar of een maand, uit de verkoopfacturen: aflopend gesorteerd, standaard de tien grootsten. Creditnota's tellen negatief mee; concepten en geannuleerde facturen tellen niet mee.
Wat de tool teruggeeft
Deze beschrijving krijgt je AI-assistent van FinanceMCP mee, zodat hij weet wanneer hij de tool gebruikt:
Omzet per klant uit de verkoopfacturen van een boekjaar, optioneel één periode (kalendermaand): per relatie het gefactureerde bedrag exclusief btw (creditnota's tellen negatief mee), aflopend gesorteerd, standaard de top 10 (maximaal 100). Conceptfacturen en geannuleerde facturen tellen niet mee.
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. |
fiscalYear | geheel getal | ja | Het boekjaar, bijvoorbeeld 2026. |
period | geheel getal | nee | Boekperiode (1-12) als kalendermaand binnen het boekjaar; zonder periode het hele boekjaar. |
top | geheel getal | nee | Aantal klanten in de top (standaard 10, maximaal 100). |
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:
Wie waren dit jaar onze vijf grootste klanten?
Het antwoord van de tool, ingekort en met verzonnen cijfers:
{
"fiscalYear": 2026,
"period": null,
"top": 5,
"basis": "amountExclVat",
"currency": "EUR",
"customersTotal": 64,
"customers": [
{
"relationId": "c-1042",
"relationName": "De Vries Installatietechniek B.V.",
"revenue": 48300.00,
"invoiceCount": 11
},
{
"relationId": "c-1107",
"relationName": "Bakkerij Van Rooij",
"revenue": 31250.00,
"invoiceCount": 24
}
],
"warnings": []
}Per pakket
| Pakket | Levert | Toelichting |
|---|---|---|
| Exact Online | volledig | |
| Moneybird | volledig | |
| 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.