Btw-aangiftecijfers: `get_vat_return`

De cijfers voor de btw-aangifte per tijdvak, per rubriek, met de voorbelasting in rubriek 5b en het saldo dat je betaalt of terugkrijgt. Het blijft een benadering; de officiële aangifte doe je in je pakket of via je accountant.

Wat de tool teruggeeft

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

Btw-aangifte per tijdvak: de rubriekbedragen (NL-benadering op basis van de mutaties) inclusief de voorbelasting in rubriek 5b. Tijdvak via period + periodType: maandaangevers periodType=Month (default, period = boekperiode/maand), kwartaalaangevers periodType=Quarter met period 1-4 (kwartaal 2 = april t/m juni). Tekenconventie: payable is het saldo af te dragen btw minus voorbelasting, positief = te betalen, negatief = terug te ontvangen (teruggaaf). Geen officiële aangifte; aansluiting blijft bij accountant/pakket.

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-13) binnen het boekjaar.
`periodType`	keuze: Month, Quarter	nee	Tijdvaktype van period: Month (boekperiode/maand, standaard) of Quarter (kwartaal 1-4; kwartaal 2 = maanden 4-6).

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 komt er in rubriek 1a van de aangifte over september?

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

{
  "fiscalYear": 2026,
  "period": 9,
  "currency": "EUR",
  "payable": 5895.00,
  "boxes": [
    {
      "code": "1a",
      "description": "Leveringen/diensten belast met hoog tarief",
      "baseAmount": 48600.00,
      "vatAmount": 10206.00
    },
    {
      "code": "5b",
      "description": "Voorbelasting",
      "baseAmount": null,
      "vatAmount": 4311.00
    }
  ],
  "icp": []
}

Per pakket

Pakket	Levert	Toelichting
Exact Online	volledig
Moneybird	nee	Gebruik get_vat_summary voor een afgeleid overzicht; het antwoord verwijst daarnaar.
Business Central	nee	Gebruik get_vat_summary voor een afgeleid overzicht; het antwoord verwijst daarnaar.
Twinfield	volledig	Afgeleid uit de boekingen op de btw-rekeningen, met de rubrieken uit de btw-codes van Twinfield.
e-Boekhouden.nl	nee	Gebruik get_vat_summary voor een afgeleid overzicht; het antwoord verwijst daarnaar.

Wat een pakket niet levert, meldt de tool in het antwoord onder warnings, zodat je assistent het kan benoemen.

Btw-aangiftecijfers: get_vat_return

Wat de tool teruggeeft

Parameters

Voorbeeld

Per pakket

Btw-aangiftecijfers: `get_vat_return`