MCP-tools · Klanten, leveranciers en facturen
Inkoopfacturen: get_purchase_invoices
Inkoopfacturen over een periode, met het factuurnummer van de leverancier, het betalingskenmerk, de bedragen en de status. Factuurregels komen alleen mee als je assistent daarom vraagt.
Wat de tool teruggeeft
Deze beschrijving krijgt je AI-assistent van FinanceMCP mee, zodat hij weet wanneer hij de tool gebruikt:
Inkoopfacturen; regels alleen met includeLines=true. Het veld externalDocumentNumber is het factuurnummer van de leverancier (Exact: YourRef) en paymentReference het betalingskenmerk van de boeking.
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. |
dateFrom | tekst | nee | Begin van het datumbereik, als jjjj-mm-dd. |
dateTo | tekst | nee | Einde van het datumbereik, als jjjj-mm-dd. |
status | keuze: Draft, Open, PartiallyPaid, Paid, Cancelled | nee | Filter op factuurstatus. |
relationId | tekst | nee | Beperk tot één klant of leverancier, met het id uit get_customers of get_suppliers. |
includeLines | ja of nee | nee | Ook de factuurregels meegeven; zonder regels is het antwoord sneller. |
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:
Welke inkoopfacturen van Groothandel Maasdal zijn er dit jaar binnengekomen?
Het antwoord van de tool, ingekort en met verzonnen cijfers:
{
"items": [
{
"invoiceNumber": "I-26-0388",
"externalDocumentNumber": "F2026-7781",
"paymentReference": "1000 2026 7781 0001",
"relationId": "s-2210",
"relationName": "Groothandel Maasdal B.V.",
"invoiceDate": "2026-09-12",
"dueDate": "2026-10-12",
"amountExclVat": 1250.00,
"vatAmount": 262.50,
"amountInclVat": 1512.50,
"outstandingAmount": 1512.50,
"status": "Open"
}
],
"nextCursor": null,
"warnings": []
}Per pakket
| Pakket | Levert | Toelichting |
|---|---|---|
| Exact Online | volledig | |
| Moneybird | volledig | |
| Business Central | volledig | |
| Twinfield | deels | Zonder factuurregels; de btw per factuur komt uit de bijbehorende boeking. |
| e-Boekhouden.nl | volledig | Opgebouwd uit de inkoopmutaties, omdat e-Boekhouden.nl geen aparte inkoopfacturen kent. |
Wat een pakket niet levert, meldt de tool in het antwoord onder warnings, zodat je assistent het kan benoemen.