Btw-overzicht: get_vat_summary

Wat de tool teruggeeft

Deze beschrijving krijgt je AI-assistent van FinanceMCP mee, zodat hij weet wanneer hij de tool gebruikt:

Btw-overzicht per categorie, een afgeleide rapportage, geen btw-aangifte. Tijdvak via period + periodType: maandaangevers periodType=Month (default), kwartaalaangevers periodType=Quarter met period 1-4. Optioneel te begrenzen met een datumbereik (dateFrom/dateTo) binnen het boekjaar.

De tool leest alleen en verandert niets in je administratie.

Voorbeeld

Een vraag die je assistent met deze tool beantwoordt:

Hoeveel btw moeten we over het derde kwartaal afdragen?

Het antwoord van de tool, ingekort en met verzonnen cijfers:

{
  "fiscalYear": 2026,
  "period": 3,
  "currency": "EUR",
  "lines": [
    {
      "category": "HighRate",
      "baseAmount": 142800.00,
      "vatAmount": 29988.00,
      "direction": "Payable"
    },
    {
      "category": "LowRate",
      "baseAmount": 6200.00,
      "vatAmount": 558.00,
      "direction": "Payable"
    },
    {
      "category": "HighRate",
      "baseAmount": 61300.00,
      "vatAmount": 12873.00,
      "direction": "Receivable"
    }
  ],
  "warnings": []
}