MCP-tools

De MCP-server biedt eenenveertig tools en drie naslagstukken. Je assistent krijgt ze alle eenenveertig te zien; de scopes van de API-key bepalen welke hij ook mag aanroepen. Mist de key de juiste scope, dan weigert de tool met een melding welke scope ontbreekt.

Bedragen komen terug als tekst met een punt als decimaalteken en vier cijfers erachter, bijvoorbeeld 1234.5600. Datums zijn altijd JJJJ-MM-DD.

Diezelfde vorm geldt ook de andere kant op, en daar is Muntar streng in. Een punt is altijd het decimaalteken: 1.234 is 1,234 en nooit 1234. Een duizendtalscheiding, een komma en een valutateken bestaan niet. Een bedrag heeft hoogstens vier decimalen, een aantal acht en een koers tien; staat er een cijfer te veel, dan weigert de tool in plaats van af te ronden. Een datum is JJJJ-MM-DD en moet echt bestaan, een valuta is een ISO-code van drie letters, en een id komt precies zoals hij is uit een lees-tool. Een bedrag past ook binnen de kolom waarin het terechtkomt: veertien cijfers vóór de punt voor een bedrag, zestien voor een aantal, tien voor een koers.

Wat daar niet aan voldoet gaat niet door: de tool weigert met een zin die het veld, de ontvangen waarde en de toegestane vorm noemt, schrijft niets, en zet de weigering in de probleemwachtrij. Datzelfde geldt voor een waarde van het verkeerde soort (een getal waar tekst hoort), een keuze die niet in de lijst staat en een veld dat ontbreekt: die worden op de vorm van de tool zelf geweigerd en komen als SCHEMA in de wachtrij.

Bij elk bedrag hoort een valutacode, in hetzelfde antwoord: de eigen munt van de rekening of regel, of de basisvaluta van de werkruimte. Staat een rekening in een andere munt dan de basisvaluta en kent Muntar de koers van die dag nog niet, dan weigert een schrijvende tool met RATE_MISSING in plaats van te gokken; je assistent legt de koers dan vast met muntar_set_manual_rate en probeert het opnieuw.

Overzicht

Tool	Doel	Scope	Bevestiging
muntar_list_entities	Je entiteiten opsommen	Lezen	nee
muntar_list_accounts	Je rekeningen opsommen	Lezen	nee
muntar_list_categories	Je categorieën opsommen	Lezen	nee
muntar_get_networth	Netto vermogen op een peildatum	Lezen	nee
muntar_get_account_health	Of die cijfers wel compleet zijn	Lezen	nee
muntar_get_category_report	Waar het geld heen ging, per categorie en periode	Lezen	nee
muntar_get_transactions	Transacties opvragen, met filters	Lezen	nee
muntar_get_free_capital	Vrij inzetbaar vermogen	Lezen	nee
muntar_list_imports	Je imports opsommen	Lezen	nee
muntar_get_import_lines	De regels van een import lezen	Lezen	nee
muntar_list_rules	Je regels opsommen	Lezen	nee
muntar_preview_import	Een bankbestand doorlezen zonder op te slaan	Importeren	nee
muntar_stage_import	Datzelfde bestand klaarzetten voor beoordeling	Importeren	nee
muntar_update_import_lines	De regels van een import beoordelen	Schrijven	soms
muntar_accept_pending	De openstaande regels accepteren	Schrijven	nee
muntar_ignore_pending	De openstaande regels negeren	Schrijven	nee
muntar_discard_import	Een klaargezette import weggooien	Schrijven	ja
muntar_commit_import	Een klaargezette import boeken	Import bevestigen	ja
muntar_undo_import	Een geboekte import terugdraaien	Import bevestigen	ja
muntar_record_entry	Eén boeking vastleggen	Schrijven	ja
muntar_recategorize_entry	De categorie van een geboekte regel wijzigen	Schrijven	ja
muntar_set_account_balance	Het saldo van een rekening rechtzetten	Schrijven	ja
muntar_undo_balance_correction	Zo’n correctie terugdraaien	Schrijven	ja
muntar_update_entity	Naam of kleur van een entiteit aanpassen	Schrijven	ja
muntar_reverse_entry	Eén geboekte regel tegenboeken	Schrijven	ja
muntar_suggest_category	De AI-provider categorieën laten voorstellen bij een import	Schrijven	nee
muntar_propose_categories	Zelf categorieën voorstellen bij een import	Schrijven	nee
muntar_propose_transfers	Zelf overboekingen voorstellen bij een import	Schrijven	nee
muntar_set_manual_rate	Een wisselkoers voor één dag vastleggen	Schrijven	nee
muntar_create_category	Een categorie aanmaken	Schrijven	ja
muntar_rename_category	Een categorie hernoemen	Schrijven	ja
muntar_move_category	Een categorie verplaatsen	Schrijven	ja
muntar_merge_category	Twee categorieën samenvoegen	Schrijven	ja
muntar_delete_category	Een categorie verwijderen of archiveren	Schrijven	ja
muntar_restore_category	Een gearchiveerde categorie terugzetten	Schrijven	ja
muntar_create_rule	Een regel aanmaken	Schrijven	ja
muntar_update_rule	Een regel wijzigen	Schrijven	ja
muntar_delete_rule	Een regel verwijderen	Schrijven	ja
muntar_reapply_rules	De regels opnieuw toepassen op een klaargezette import	Schrijven	nee
muntar_create_account	Een rekening aanmaken	Schrijven	ja
muntar_rename_account	Een rekening hernoemen of haar IBAN wijzigen	Schrijven	ja
muntar_archive_account	Een rekening archiveren	Schrijven	ja
muntar_link_iban	Een IBAN aan een rekening koppelen	Schrijven	ja
muntar_unlink_iban	Een extra IBAN loskoppelen	Schrijven	ja
muntar_list_problems	De probleemwachtrij lezen	Lezen	nee
muntar_resolve_problem	Een regel in de probleemwachtrij afvinken	Schrijven	ja

muntar_list_entities

Somt alle actieve entiteiten van de werkruimte op. Geen invoer nodig.

Terug: per entiteit het id, de naam, de slug, het soort (privépersoon, eenmanszaak, VOF, BV of huishouden), de vaste kleur en hoeveel actieve rekeningen en categorieën eronder hangen.

muntar_list_accounts

Somt je rekeningen op. Categorieën zitten er niet bij; daarvoor is muntar_list_categories.

Mee te geven: eventueel één entiteit. Laat je dat weg, dan komen alle entiteiten mee.

Terug: per rekening het id, de naam, de entiteit, het soort rekening, de valuta, de primaire IBAN, alle gekoppelde IBAN’s met hun label, de bovenliggende rekening als die er is, of het geld vrij opneembaar is, en of het saldo uit boekingen of uit handmatige waarderingen komt.

muntar_list_categories

Somt de inkomsten- en uitgavecategorieën per entiteit op, ook de gearchiveerde. Bedoeld om te gebruiken vóór je een categorie noemt, zodat er geen categorie verzonnen wordt die niet bestaat, en om een categorie te vinden voor muntar_move_category, muntar_merge_category, muntar_delete_category of muntar_restore_category.

Mee te geven: eventueel één entiteit.

Terug: per entiteit de categorieën met id, naam, of het inkomen of uitgave is, de bovenliggende categorie, of hij gearchiveerd is, en hoeveel geboekte regels, klaargezette importregels en regels erop staan.

muntar_get_networth

Netto vermogen per entiteit en samengeteld.

Mee te geven: eventueel één entiteit, eventueel een peildatum (standaard vandaag) en de vorm van het antwoord. Kort geeft alleen de totalen, uitgebreid voegt een uitsplitsing per rekening toe. De samengetelde totalen blijven altijd over de hele werkruimte gaan, ook als je op één entiteit filtert.

Terug: de peildatum, de basisvaluta, de totalen per entiteit en samengeteld, en bij de uitgebreide vorm het saldo per rekening.

muntar_get_account_health

Of je netto vermogen ook waar kan zijn, en zo niet, wat eraan mankeert. Dit is de tool achter de waarschuwing op je overzicht.

Mee te geven: eventueel een peildatum en eventueel één entiteit.

Terug: per signaal de rekening, hoe erg het is, de getallen die het onderbouwen en welke tool of welk scherm het oplost. Daarnaast dezelfde rekeningen met hun saldo als het overzicht toont, zodat een melding bij een naam en een bedrag hoort. Is er niets te melden, dan komt er een lege lijst terug.

Een assistent hoort dit erbij te vragen voordat hij een bedrag uit muntar_get_networth als feit presenteert. Die tool telt precies op wat er geboekt staat en zegt niets over of dat compleet is.

muntar_get_category_report

De uitsplitsing van uitgaven of inkomsten over categorieën, voor een periode. Dezelfde cijfers als het scherm Waar je geld heen gaat.

Mee te geven: een begin- en einddatum (allebei meegerekend), of het om uitgaven of inkomsten gaat, en eventueel één entiteit.

Terug: per hoofdcategorie het bedrag, het aandeel en het aantal boekingen, met de subcategorieën eronder. De entiteit staat erbij, want elke entiteit heeft zijn eigen categorieboom en dezelfde naam kan dus meerdere keren voorkomen.

Twee dingen om op te letten bij het samenvatten. Een categorie kan negatief zijn: een terugbetaling boekt op de oorspronkelijke uitgavencategorie. En het aantal boekingen zegt of iets een patroon is of een aanschaf; een categorie met één boeking en een groot bedrag is meestal iets dat je gekocht hebt en nog hebt.

muntar_set_account_balance

Het saldo van één rekening op het bedrag zetten dat er echt op staat, per een datum. Muntar rekent zelf het verschil uit en boekt het boekhoudkundig correct; zie Klopt dit getal? voor wat er onder water gebeurt.

Mee te geven: de rekening, het bedrag en de datum.

Terug: welke route Muntar koos, wat er eerst stond, het verschil, en een sleutel waarmee je het kunt terugdraaien. Stond het bedrag er al, dan is het verschil nul en is er niets geboekt.

Vraagt eerst om bevestiging. De vraag noemt de rekeningnaam, het huidige saldo en wat er gaat gebeuren.

muntar_undo_balance_correction

Draait één saldocorrectie terug met de sleutel uit muntar_set_account_balance. De correctie wordt verwijderd, niet tegengeboekt. Dit is de enige tool die iets uit de boeken haalt; een geïmporteerde of handmatig geboekte transactie wordt geweigerd en corrigeer je met muntar_reverse_entry.

Vraagt eerst om bevestiging.

muntar_update_entity

Naam en kleur van een bestaande entiteit. Het soort entiteit kan niet gewijzigd worden.

Mee te geven: de entiteit, en een naam, een kleur of allebei.

Vraagt eerst om bevestiging. Alleen een eigenaar mag dit.

muntar_get_transactions

Geboekte transacties, nieuwste eerst.

Mee te geven: het aantal per pagina (1 tot 200, standaard 50), hoeveel er overgeslagen worden, en optioneel een entiteit, een rekening, een categorie, een zoekterm en een periode van en tot.

Terug: per transactie de datum, de omschrijving, de entiteit, de rekening, de categorie, de tegenpartij, het soort boeking, en of hij is tegengeboekt. Bij een koop of verkoop komt het tickersymbool mee, bij een overboeking de andere rekening. Onderaan staat hoeveel er in totaal aan het filter voldoen en waar de volgende pagina begint.

Een overboeking of kapitaalstorting heeft nooit een categorie. Liep hij tussen twee munten en is het ontvangen bedrag apart ingevuld, dan komt het bedrag op Valutakosten als eigen veld mee, in je basisvaluta, naast het verzonden bedrag; die boeking blijft dus een overboeking en wordt geen uitgave.

Het bedrag staat in de eigen munt van de rekening, met de valutacode erbij. Wijkt die munt af van de basisvaluta, dan komt het omgerekende bedrag ernaast te staan, met de bron en de datum van de gebruikte koers; de basisvaluta zelf staat één keer in het antwoord. Een regel die uit een buitenlandse kaartbetaling komt draagt daarnaast het oorspronkelijke bedrag zoals de bank het toonde, puur ter informatie.

Een tegengeboekte transactie blijft gewoon in de lijst staan, met de tegenboeking ernaast: Muntar verwijdert nooit iets. Je assistent ziet aan drie velden welke bij welke hoort, zodat hij ze niet allebei meetelt als hij optelt.

muntar_get_free_capital

Het liquide netto vermogen na aftrek van de noodbuffer en de reserves. Geen invoer nodig.

Terug: het vrij inzetbare bedrag, hetzelfde bedrag zonder ondergrens, de buffer, het totaal aan reserves, een eventueel tekort, en een gestructureerde uitleg van elke aftrek. Het vrij inzetbare bedrag zakt nooit onder nul; zit je onder je buffer, dan lees je dat aan het tekort af.

muntar_list_imports

Somt je imports op, nieuwste eerst. Ook een import die je in het scherm hebt klaargezet, staat erin; zo vindt je assistent hem terug.

Mee te geven: eventueel een status. Klaargezet (STAGED) is de status waarin een import wacht op beoordeling.

Terug: per import het id, de bestandsnaam, de status, de rekening, de entiteit, het aantal regels, de periode en de tellingen van het klaarzetten, zoals hoeveel regels toen nog een categorie nodig hadden.

muntar_get_import_lines

Leest de regels van één import, op volgorde en per pagina, samen met de categorieën van de entiteit van die import. Bedoeld om daarna zelf categorieën voor te stellen.

Mee te geven: het id van de import, een filter, het aantal per pagina (1 tot 500, standaard 200) en hoeveel er overgeslagen worden.

Filter	Welke regels
open (standaard)	Nog te beoordelen, nog zonder categorie en nog zonder AI-voorstel
needs_category	Nog te beoordelen en door Muntar zelf niet ingedeeld, ook als er al een voorstel op staat
all	Alle regels van de import

Terug: per regel het id, de datum, het bedrag (negatief bij een uitgave), de omschrijving, de naam van de tegenpartij, het soort regel, de status, de categorie die er nu staat en waar die vandaan komt. Het IBAN van de tegenpartij, het saldo en de brontekst uit het bankbestand komen bewust niet mee. Daarnaast de categorieën met id, naam en of het een uitgave of inkomen is.

muntar_propose_categories

Zet de categorievoorstellen van je assistent op de regels van een klaargezette import. Hier is je assistent zelf de AI: er is geen AI-provider in Muntar voor nodig.

Mee te geven: het id van de import en per regel het id, de gekozen categorie en hoe zeker de assistent is, als getal van 0 tot en met 1. Tot 250 voorstellen per keer.

Een voorstel landt alleen op een regel die nog open staat en die Muntar zelf niet kon indelen. De categorie moet bij de entiteit van de import horen, en mag van beide soorten zijn. Geld dat binnenkomt op een uitgavencategorie is een terugbetaling op die uitgave; geld dat afgaat op een inkomstencategorie is een verrekening met dat inkomen. Zo kan één categorie voor een tegenpartij beide kanten dragen. Wat niet klopt, wordt per regel afgewezen met de reden erbij; de rest wordt gezet. Een eerder voorstel van de assistent mag hij overschrijven, ook een overboekingsvoorstel.

Net als bij muntar_suggest_category komt er geen bevestigingsvraag: er ontstaat geen boeking. In het reviewscherm staat het voorstel met de bron “Assistent” en het percentage zekerheid. Het wordt pas een boeking als jij de regel accepteert en de import boekt.

Terug: hoeveel voorstellen er gezet zijn en welke zijn afgewezen, met de reden.

muntar_propose_transfers

Stelt voor dat een regel geld naar of van een eigen rekening is, in plaats van een uitgave of inkomen. Denk aan opwaarderen van een rekening bij een andere bank, inleg op je pensioen of een storting op je beleggingsrekening.

Mee te geven: het id van de import en per regel het id, de eigen rekening aan de andere kant en hoe zeker de assistent is, als getal van 0 tot en met 1. Tot 250 voorstellen per keer. De rekening haalt de assistent uit muntar_list_accounts; het mag een betaal-, spaar-, contant-, beleggings- of pensioenrekening zijn, of een rekening voor overig bezit.

Hoort de rekening bij dezelfde entiteit als de import, dan wordt het een overboeking. Hoort hij bij een andere entiteit, dan een kapitaalbeweging. Net als bij de andere voorstellen komt er geen bevestigingsvraag, blijft de regel open tot jij hem accepteert, en wordt per regel afgewezen wat niet klopt: een categorie als tegenrekening, de rekening van de import zelf, of een regel die Muntar al zelf als overboeking herkende.

Terug: hoeveel voorstellen er gezet zijn en welke zijn afgewezen, met de reden.

muntar_update_import_lines

Beoordeelt de regels van een klaargezette import: dezelfde handeling als in het reviewscherm, maar dan door je assistent. Er wordt nog niets geboekt.

Mee te geven: het id van de import en per regel het id, en verder wat er moet veranderen: het soort regel, de categorie, de tegenrekening, een aantekening en de status. Tot 1000 regels per keer.

Veld	Wat je ermee zet
Soort	Uitgave, inkomen, overboeking, kapitaalbeweging, koop van een belegging, of niet boeken
Categorie	Een categorie van de entiteit van de import, of leeg om de keuze te wissen
Tegenrekening	De eigen rekening aan de andere kant van een overboeking, of leeg
Aantekening	Tekst die bij de boeking komt te staan
Status	Geaccepteerd, genegeerd of weer open

Wat je bij een regel weglaat, blijft zoals het was. Wijzig je iets zonder een status mee te geven, dan komt de regel op “gewijzigd” te staan en telt hij bij het boeken mee als geaccepteerd.

Raakt de aanroep een regel die jij of je assistent al beoordeeld had, dan vraagt de tool eerst om bevestiging, met het aantal van die regels erin. Raakt hij alleen regels die nog open staan, dan vraagt hij niets: er valt dan geen keuze te overschrijven.

Verandert de beoordeling van een van die regels terwijl de vraag openstaat, bijvoorbeeld omdat jij ze intussen in het scherm afhandelt, dan weigert de tool alsnog en schrijft hij niets: je antwoord ging dan over een andere situatie.

Klopt er iets niet aan één regel, dan gaat de hele aanroep niet door en is er niets geschreven. Dat geldt voor een regel die niet bij deze import hoort, een categorie van een andere entiteit, een tegenrekening die geen eigen rekening is, en dezelfde regel twee keer in één aanroep.

Terug: hoeveel regels er bijgewerkt zijn en hoeveel daarvan al beoordeeld waren.

muntar_accept_pending

Zet in één keer alle nog openstaande regels van een import op geaccepteerd, met het voorstel dat erop staat. Dit is de knop “Accepteer de rest” uit het reviewscherm.

Mee te geven: het id van de import, en of regels zonder categorie overgeslagen moeten worden. Standaard blijven die staan, want ze zouden het boeken laten mislukken.

Regels die al beoordeeld zijn blijven ongemoeid, dus er valt niets van jou te overschrijven en de tool vraagt niets. Geboekt wordt er nog niet.

Terug: hoeveel regels er geaccepteerd zijn.

muntar_ignore_pending

Zet alle nog openstaande regels op genegeerd. Ze worden niet geboekt, maar tellen wel als beoordeeld, zodat de rest van de import wel geboekt kan worden. De uitweg voor een regel waar geen passende categorie voor is.

Mee te geven: het id van de import.

Ook hier blijft een al beoordeelde regel staan, dus geen bevestigingsvraag. Een tweede aanroep raakt niets meer.

Terug: hoeveel regels er op genegeerd zijn gezet.

muntar_discard_import

Gooit een klaargezette import weg, met al zijn regels. De regels van die import zijn nog niet geboekt, dus daar komt geen tegenboeking aan te pas. Daarna kun je hetzelfde bestand opnieuw klaarzetten.

Mee te geven: het id van de import.

Heb je het beginsaldo van deze import al apart geboekt, dan is dat een echte boeking. Die blijft staan en wordt niet teruggedraaid; ze verliest alleen haar verwijzing naar de import. De bevestiging noemt hoeveel boekingen dat zijn, zodat je weet wat er achterblijft; wil je die ook weg, dan boek je ze zelf tegen met muntar_reverse_entry.

Vraagt eerst om bevestiging, met de naam van het bestand, de rekening, de entiteit, het aantal regels en het aantal boekingen dat blijft staan. Een al geboekte import gaat niet zo weg: die weigert de tool, met de verwijzing naar muntar_undo_import.

Terug: het id, de bestandsnaam, het aantal regels dat is weggegooid en het aantal boekingen dat is blijven staan.

muntar_create_category

Maakt een nieuwe categorie aan, op het hoogste niveau of onder een bestaande categorie. Bedoeld voor een regel die in geen bestaande categorie past.

Mee te geven: de entiteit, de naam (tot 80 tekens), of het een uitgave- of inkomstencategorie is, en eventueel de bovenliggende categorie. Die moet van dezelfde entiteit en hetzelfde soort zijn, en zelf op het hoogste niveau staan: de boom is twee niveaus diep.

Vraagt eerst om bevestiging, met de naam, het soort en de plek in de boom. Bestaat er op die plek al een categorie met die naam, dan weigert de tool.

Terug: het id, de naam, het soort, de bovenliggende categorie en de naam met de bovenliggende categorie ervoor, zoals “Wonen › Tuin”.

muntar_rename_category

Geeft een bestaande categorie een andere naam. Boekingen, regels en subcategorieën blijven aan de categorie hangen; alleen de naam verandert.

Mee te geven: de categorie en de nieuwe naam (tot 80 tekens).

Vraagt eerst om bevestiging, met de oude en de nieuwe naam. Een rekening die geen categorie is, hernoemt de tool niet.

Terug: hetzelfde als bij aanmaken, plus de vorige naam.

muntar_move_category

Zet een categorie onder een andere groep, of terug op het hoogste niveau. Alleen binnen dezelfde entiteit en hetzelfde soort; een groep met subcategorieën blijft op het hoogste niveau.

Mee te geven: de categorie en eventueel de nieuwe bovenliggende categorie. Laat je die weg, dan gaat de categorie naar het hoogste niveau.

Vraagt eerst om bevestiging, met de naam en de nieuwe plek. Staat er op de nieuwe plek al een categorie met dezelfde naam, dan weigert de tool.

Terug: hetzelfde als bij aanmaken.

muntar_merge_category

Laat een categorie opgaan in een andere categorie van dezelfde entiteit en hetzelfde soort: de weg als er twee categorieën voor hetzelfde bestaan.

Mee te geven: de categorie die verdwijnt (de bron) en de categorie die overblijft (het doel). Heeft de bron subcategorieën, dan moet het doel zelf op het hoogste niveau staan.

Vraagt eerst om bevestiging, met de naam en de aantallen van de bron en de naam van het doel, bijvoorbeeld “Boodschappen (211 geboekte regels, 3 regels) samenvoegen in Eten › Supermarkt?”. Geboekte regels, regels, regels in een open import en subcategorieën gaan naar het doel; bedragen en saldi veranderen niet. Heeft het doel al een subcategorie met dezelfde naam als een van de subcategorieën die meegaan, dan weigert de tool.

Terug: de naam van de bron, het doel, en per soort hoeveel er zijn verhuisd.

muntar_delete_category

Verwijdert een categorie. Is de categorie leeg, en bij een groep ook al haar subcategorieën, dan gaat ze in één keer weg. Is dat niet zo, dan beslist if_not_empty wat er gebeurt.

Mee te geven: de categorie en if_not_empty, met de waarde “refuse” (weigeren) of “archive” (archiveren in plaats van verwijderen).

Vraagt eerst om bevestiging, met de naam, de aantallen en, bij een groep, de subcategorieën die meegaan. Is de categorie niet leeg en staat if_not_empty op “refuse”, dan weigert de tool met de aantallen zonder iets te vragen: er is dan toch niets te bevestigen. Een categorie die Muntar zelf gebruikt verwijdert of archiveert de tool nooit, ook niet als een groep zo’n categorie als subcategorie heeft.

Terug: of de categorie verwijderd of gearchiveerd is, het id, de naam, bij verwijderen de subcategorieën die meegingen, en of er iets veranderd is. Was de categorie al gearchiveerd (en nog steeds niet leeg), dan verandert er bij “archive” niets: dat zie je aan changed.

muntar_restore_category

Zet een gearchiveerde categorie terug, met de subcategorieën die in dezelfde archivering meegingen.

Mee te geven: de categorie.

Vraagt eerst om bevestiging, met de naam. Staat de bovenliggende groep of de entiteit zelf nog in het archief, dan weigert de tool: zet die eerst terug. Een categorie die al actief is, blijft ongemoeid.

Terug: het id, de naam, en of er iets veranderd is.

muntar_list_rules

Somt alle regels van de werkruimte op, in de volgorde waarin ze worden doorlopen: op prioriteit, en bij gelijke prioriteit op aanmaakvolgorde. De eerste regel die past, wint. Geen invoer nodig.

Terug: per regel het id, de entiteit waarvoor hij geldt (leeg betekent: voor elke entiteit), het soort en het patroon, het doel met soort en naam, de prioriteit, hoe vaak hij is toegepast en of hij handmatig of uit een correctie ontstond.

Het doel is “CATEGORY” met een categorie, of “ACCOUNT” met een eigen rekening. Dat tweede maakt van de transactie een overboeking.

muntar_create_rule

Maakt een nieuwe regel aan.

Mee te geven: het soort (IBAN, naam exact, naam bevat of reguliere expressie), het patroon en het doel. Het doel is een categorie of een eigen rekening. Optioneel zijn de entiteit, want zonder entiteit geldt de regel voor alle entiteiten, en de prioriteit, die standaard 100 is.

Vraagt eerst om bevestiging, met het patroon, het doel en de entiteit erin. Bestaat er al een regel met dezelfde entiteit, hetzelfde soort en hetzelfde patroon, dan komt er geen tweede bij: die bestaande regel krijgt het nieuwe doel.

Terug: de regel zoals hij daarna in je werkruimte staat.

Een nieuwe regel telt mee vanaf de volgende import. Staat er al een import klaar, dan is muntar_reapply_rules de volgende stap.

muntar_update_rule

Wijzigt een bestaande regel: het soort en het patroon, het doel, of de prioriteit. Wat je weglaat blijft zoals het was.

Mee te geven: de regel, en minstens één veld dat verandert.

Verandert het doel, dan hoef je het soort doel niet apart te noemen: geef je precies één van de twee id’s mee, dan volgt het soort daaruit. Geef je er twee, of een soort zonder de bijbehorende id, dan weigert de tool in plaats van er een te laten vallen.

De entiteit van een regel verandert niet; maak daarvoor een nieuwe regel. Het aantal toepassingen blijft staan.

Vraagt eerst om bevestiging, waarin staat wat de regel nu doet en wat er verandert. Zou de wijziging de regel gelijk maken aan een andere regel, dan weigert de tool.

Terug: de regel zoals hij daarna in je werkruimte staat.

muntar_delete_rule

Verwijdert een regel.

Mee te geven: de regel.

Vraagt eerst om bevestiging, met het patroon, het doel en het aantal toepassingen. Je boekingen veranderen er niet door; alleen toekomstige imports gaan anders.

Terug: het id, het patroon, het soort en het doel van de verwijderde regel.

muntar_reapply_rules

Rekent de voorstellen van een klaargezette import opnieuw uit met de regels zoals ze nu zijn. Hiermee doet een net gemaakte regel meteen iets met een import die al klaarstaat.

Mee te geven: het id van de batch.

Alleen regels die nog openstaan worden opnieuw beoordeeld. Wat je al accepteerde, aanpaste of negeerde blijft zoals het is, en een voorstel van de AI of van je assistent blijft ook staan.

Schrijft geen boeking en vraagt daarom niet om bevestiging. De tool staat wel als ingrijpend gemarkeerd, juist om die laatste uitzondering: sommige clients vragen daardoor zelf om toestemming voordat ze hem aanroepen.

Terug: hoeveel openstaande regels opnieuw langs de regels gingen, hoeveel er veranderden, en hoeveel regels alsnog op genegeerd zijn gezet omdat de tegenkant van die overboeking al geboekt is. Daar kan een regel bij zitten die je al had beoordeeld. Dat laatste getal hoort je assistent te noemen zodra het niet nul is.

muntar_create_account

Maakt een rekening aan onder een entiteit.

Mee te geven: de entiteit, de naam en het soort rekening. Optioneel zijn de valuta, een IBAN, een beginsaldo en de datum daarvan.

Het soort is een van de zeven uit het rekeningformulier: betaalrekening, spaarrekening, contant, beleggingsrekening, pensioenbeleggen, overig bezit of een lening. Een auto of motor die je koopt is overig bezit: de bankregel wordt dan een overboeking naar die rekening, en de waarde werk je later bij met een waardering.

Laat je de valuta weg, dan krijgt de rekening de basisvaluta van de werkruimte. Staat de rekening in een andere munt en kent Muntar de koers van de beginsaldodatum niet, dan weigert de tool met RATE_MISSING en is er niets aangemaakt; leg de koers eerst vast met muntar_set_manual_rate.

Vraagt eerst om bevestiging, met de naam, het soort, de entiteit, de valuta en het eventuele beginsaldo.

Terug: het id, de naam, de slug, de entiteit, het soort, de valuta en de IBAN.

muntar_rename_account

Geeft een rekening een andere naam, en kan in dezelfde stap de primaire IBAN zetten, wijzigen of wissen.

Mee te geven: de rekening en de nieuwe naam. De IBAN is optioneel: laat je hem weg, dan blijft de bestaande staan; geef je een lege tekst mee, dan wordt hij gewist.

Je boekingen, imports en regels blijven aan dezelfde rekening hangen. Een categorie hernoem je met muntar_rename_category; die weigert deze tool.

Vraagt eerst om bevestiging, met de oude en de nieuwe naam en wat er met de IBAN gebeurt.

Terug: de rekening zoals hij daarna in je werkruimte staat, met de vorige naam erbij.

muntar_archive_account

Archiveert een rekening. Hij verdwijnt uit de keuzelijsten en de overzichten, de boekingen blijven staan. Subrekeningen gaan mee.

Mee te geven: de rekening.

Terugzetten doe je in de app, onder “Rekeningen & entiteiten”. Is de rekening al gearchiveerd, dan weigert de tool in plaats van te doen alsof er iets veranderde.

Vraagt eerst om bevestiging, met de naam.

Terug: het id en de naam.

muntar_link_iban

Koppelt een IBAN aan een bestaande rekening, zodat de import weet bij welke rekening de regels met die IBAN horen.

Mee te geven: de rekening en de IBAN, met of zonder spaties. Een label is optioneel.

Had de rekening nog geen IBAN, dan wordt dit de primaire; anders komt hij erbij als extra nummer. Alleen een betaal-, spaar- of beleggingsrekening kan er een dragen. Hoort de IBAN al bij een andere rekening, dan weigert de tool met de naam van die rekening erbij, zonder iets te vragen.

Vraagt eerst om bevestiging. Die bevestiging waarschuwt ook dat je alleen een IBAN koppelt die van de rekening zelf is: een gedeelde stortings-IBAN van een pensioenfonds of een broker hoort bij een regel en niet bij een rekening.

Terug: het id van de koppeling, de rekening, de IBAN, en of hij de primaire werd.

muntar_unlink_iban

Haalt een extra IBAN los van een rekening. De boekingen blijven staan; alleen de koppeling verdwijnt.

Mee te geven: de rekening en de IBAN.

De primaire IBAN gaat niet zo weg: die wis je met muntar_rename_account en een lege IBAN. Staat er nog een niet-teruggedraaide import op de IBAN, dan blijft hij zitten tot je die import terugdraait.

Vraagt eerst om bevestiging.

Terug: de rekening en de losgekoppelde IBAN.

Het bestand bij de twee importtools

muntar_preview_import en muntar_stage_import nemen dezelfde invoer: de rekening waartegen geïmporteerd wordt, en het bestand. Het bestand geef je als geplakte tekst mee, tot 5 MB per keer. Een pad naar een bestand op de server is geen geldige bron; die weg staat uit. De bron wordt herkend aan de kop van het bestand, niet geraden.

muntar_preview_import

Leest het bestand door en vertelt wat erin zit. Slaat niets op.

Terug: de herkende bron, de gebruikte tekstcodering, de rekening, de periode, de saldocheck, en per soort een telling: hoeveel regels in totaal, hoeveel nieuw, hoeveel duplicaat, hoeveel nog een categorie nodig hebben, hoeveel overboekingen, kapitaalstortingen en beleggingskopen erin zitten en hoeveel er niet ondersteund worden. IBAN’s uit het bestand die niet bij de gekozen rekening horen, komen apart terug, net als de waarschuwingen uit het inlezen.

muntar_stage_import

Zet dezelfde inhoud klaar voor beoordeling. Duplicaten worden overgeslagen. Er wordt nog niets geboekt.

Terug: het id van de klaargezette batch, hoeveel regels erin zitten, dezelfde tellingen als hierboven en de IBAN’s die niet meegingen. Hetzelfde bestand een tweede keer klaarzetten geeft een fout die naar de bestaande batch verwijst.

muntar_commit_import

Boekt een klaargezette batch definitief. Elke geaccepteerde of aangepaste regel wordt één boeking, in één keer: alles of niets. Staan er nog regels open, dan weigert de tool met uitleg.

Mee te geven: het id van de batch.

Vraagt eerst om bevestiging. Herhaal je dezelfde aanroep, bijvoorbeeld na een verbroken verbinding, dan boekt hij niet nog een keer.

Terug: welke boekingen er zijn ontstaan, hoeveel regels geboekt en hoeveel overgeslagen zijn, de vroegste datum, en een melding als een beloofde openingsboeking er toch niet gekomen is.

muntar_undo_import

Draait een geboekte batch volledig terug met tegenboekingen. De originele boekingen blijven staan.

Mee te geven: het id van de batch.

Vraagt eerst om bevestiging. Een tweede keer terugdraaien lukt niet: die batch staat dan niet meer op geboekt.

Terug: de aangemaakte tegenboekingen, hoeveel er al eerder waren teruggedraaid en de vroegste datum.

muntar_record_entry

Legt één boeking vast via een van de zes sjablonen.

Sjabloon	Wat je meegeeft
EXPENSE en INCOME	Rekening, categorie, bedrag, datum, omschrijving, eventueel de tegenpartij
TRANSFER	Van-rekening en naar-rekening binnen één entiteit, bedrag, datum, omschrijving
CAPITAL_MOVE	Van-rekening en naar-rekening van twee verschillende entiteiten, bedrag, datum, omschrijving
BUY_SECURITY	Cashrekening, kostencategorie, tickersymbool, aantal, prijs per stuk, eventuele kosten, datum, omschrijving
VALUATION	De rekening, de waarde en de datum; geen omschrijving

De entiteit volgt uit de rekening, die geef je niet apart mee. Bedragen en aantallen geef je als tekst mee, met een punt als decimaalteken. Een veld dat bij een ander sjabloon hoort, wordt geweigerd en niet genegeerd: een aantal of een kostencategorie bij een uitgave betekent dat er iets anders bedoeld werd dan er staat.

Het bedrag staat altijd in de eigen munt van de rekening waarop het landt, nooit in de basisvaluta. Je assistent mag die munt er als controle bij zetten; klopt hij niet met de rekening, dan weigert de tool in plaats van in de verkeerde munt te boeken.

Gaat een overboeking of kapitaalstorting tussen twee rekeningen in verschillende munten en ken je het werkelijk ontvangen bedrag apart (uit een tweede bankbevestiging), dan kan je assistent dat tweede bedrag meegeven, samen met de kostenrekening die het verschil opvangt. Dat verschil komt als eigen regel op Valutakosten te staan. Zonder dat tweede bedrag rekent Muntar met de koers van de boekdatum.

Een sleutel om de boeking te herkennen is verplicht. Dezelfde sleutel opnieuw gebruiken boekt niet dubbel.

Vraagt eerst om bevestiging, met per sjabloon een samenvatting van wat er gaat gebeuren: bedrag, munt, rekening, categorie en datum, en bij een belegging ook het tickersymbool, het aantal, de prijs per stuk, de kostencategorie en het totaal. Elk bedrag staat er met zijn muntcode bij, en elke rekening en categorie met zijn naam.

Bij een uitgave, inkomst, overboeking of kapitaalstorting op een rekening in een andere munt dan je basisvaluta komt daar het omgerekende bedrag bij, met de koers die ervoor gebruikt wordt, de dag waarvan die koers is en waar hij vandaan komt. Zo zie je een verkeerd ingevoerde koers vóórdat je akkoord geeft.

Bij een koop van een belegging staat de tegenwaarde achter het totaalbedrag, het bedrag dat van de cashrekening af gaat. De prijs per stuk en de kosten blijven in de munt van die rekening staan.

Alleen een waardering toont die omrekening niet, en dat is geen omissie: de waarde van een waardering wordt pas bij het tonen omgerekend, tegen de koers van dat moment, dus een bedrag in de bevestiging zou morgen al anders zijn. Het bedrag staat er wel, met zijn valutacode.

Terug: de aangemaakte boekingen. Bij een waardering is er geen boeking, alleen de vastgelegde waarde, met de munt erbij.

muntar_recategorize_entry

Zet een al geboekte uitgave of inkomst in een andere categorie. De bestaande boeking wordt niet aangepast: hij gaat tegen, en er komt een nieuwe boeking met dezelfde gegevens en de nieuwe categorie. Zo blijft de correctie zichtbaar, net als wanneer je in het scherm op “Categorie wijzigen” drukt.

Mee te geven: de boeking, de nieuwe categorie en een sleutel om de correctie te herkennen. Die categorie moet bij dezelfde entiteit horen als de boeking. De sleutel is verplicht, net als bij muntar_record_entry: dezelfde sleutel opnieuw gebruiken boekt niet nog een keer tegen.

Alleen een uitgave of inkomst die nog niet is tegengeboekt en zelf geen tegenboeking is. Een overboeking, een kapitaalbeweging en een koop van een belegging weigert de tool: daar valt geen categorie te wijzigen.

Vraagt eerst om bevestiging, met de omschrijving, de datum, het bedrag met zijn munt, de rekening en beide categorieën.

Terug: de oorspronkelijke boeking, de tegenboeking, de nieuwe boeking en de categorie waar hij nu op staat.

Wil je dat dit voortaan vanzelf goed gaat, maak dan daarna een regel met muntar_create_rule.

muntar_reverse_entry

Draait één geboekte transactie terug met een tegenboeking: dezelfde regels met omgekeerd teken, gekoppeld aan het origineel. Het origineel blijft in het overzicht staan.

Mee te geven: de boeking.

Hoort de boeking bij een kapitaalbeweging tussen twee entiteiten, dan gaat de gespiegelde boeking van de andere entiteit mee tegen. De bevestiging zegt dat er met zoveel woorden bij.

Vraagt eerst om bevestiging. Een boeking die al is tegengeboekt weigert de tool. Gaat het om een hele import, gebruik dan muntar_undo_import.

Terug: de boeking, de aangemaakte tegenboeking of tegenboekingen en de datum.

muntar_suggest_category

Vraagt de ingestelde AI-provider om een categorievoorstel voor de regels van een klaargezette import die nog geen categorie hebben. Een voorstel dat je assistent zelf al zette, blijft staan.

Mee te geven: het id van de batch.

Deze tool vraagt niet om bevestiging: hij schrijft alleen een voorstel bij de regels, geen boeking. Het antwoord zegt dat ook met zoveel woorden. Dat geldt ook voor muntar_propose_categories, muntar_propose_transfers en muntar_set_manual_rate.

Terug: hoeveel regels een voorstel kregen, hoeveel er overgeslagen zijn, of de provider onbereikbaar was en of er wel een provider is ingesteld. Is de provider onbereikbaar, dan blijven die regels zonder categorie staan. Is er geen provider ingesteld, dan zegt het antwoord dat en verwijst het naar muntar_get_import_lines en muntar_propose_categories, waarmee de assistent het zelf doet.

Welke gegevens hierbij naar de provider gaan, staat op AI-instellingen.

muntar_set_manual_rate

Legt zelf een wisselkoers vast voor één valutapaar en één dag, geldig binnen jouw werkruimte. Dit is de uitweg wanneer een schrijvende tool met RATE_MISSING weigert omdat Muntar de koers van die dag niet heeft: je assistent legt hem vast met precies de munt en de datum uit die melding, en probeert de boeking daarna opnieuw.

Mee te geven: de vreemde munt, de basisvaluta van je werkruimte waartegen de koers geldt, de datum en de koers zelf (“1 munt is zoveel basisvaluta”, als tekst met een punt als decimaalteken).

Schrijft geen boeking en vraagt daarom niet om bevestiging. De boeking die deze koers vervolgens gebruikt, vraagt dat wél, en laat je in de bevestiging het omgerekende bedrag en deze koers zien.

Stond er al een handmatige koers voor dezelfde munt en dag waarop nog niet geboekt is, dan vervangt deze hem. Is er wél al op geboekt, dan ligt de koers vast en weigert de tool met RATE_IN_USE: die boeking corrigeer je dan met een tegenboeking, niet door de historie te herschrijven.

Elke koers die je assistent zo vastlegt komt in het logboek te staan, met de tool erbij.

Terug: het id van de vastgelegde koers. Bij een vervanging is dat een nieuw id.

muntar_list_problems

Leest de probleemwachtrij van je werkruimte: elke aanroep die op de invoergrens is geweigerd en elke onverwachte fout die is afgevangen.

Mee te geven: het filter (open, standaard, resolved of all) en hoeveel regels je hoogstens wilt (1 tot en met 100).

Een key op een alleen-lezen lidmaatschap kan deze tool niet gebruiken, en muntar_resolve_problem ook niet: een regel kan een interne foutmelding dragen.

Per regel: het soort, de tool waar het misging, de code, het veld, de ontvangen waarde ingekort, de melding die de aanroeper kreeg, wie het deed en of de regel al is afgevinkt. Bij een onverwachte fout staat de onderliggende melding erbij. Een IBAN staat er gemaskeerd in.

Terug: de regels, hoeveel er in dit filter staan en hoeveel er in totaal nog open staan.

muntar_resolve_problem

Vinkt één regel in de probleemwachtrij af, met een korte notitie over wat de oorzaak was en wat eraan gedaan is. De regel blijft staan en is met filter resolved terug te lezen.

Mee te geven: de regel en, optioneel, die notitie.

Vraagt eerst om bevestiging, met de tool, de code en de datum van die regel erin. Een regel die al is afgevinkt weigert de tool. Vink pas af als de oorzaak weg is, niet als de aanroep de tweede keer wel lukte.

Terug: de regel, of er echt iets veranderd is, en de tool en code waar hij over ging.

Naslag

Naast de tools staan er drie stukken tekst klaar die een assistent kan opvragen.

Adres	Wat erin staat
muntar://schema-guide	Uitleg van entiteiten, rekeningen, categorieën en de zes sjablonen
muntar://conventions	De afspraken over bedragen, valuta en koersen, datums, id’s en hoe schrijven verloopt
muntar://entity/{slug}/summary	Een korte samenvatting van één entiteit, met rekeningen en netto vermogen

De eerste twee zijn voor elke werkruimte hetzelfde. De derde vraagt de scope “Lezen” en gaat alleen over jouw werkruimte. De slug haal je uit muntar_list_entities.

Zie ook

• Wat een assistent kan doen
• API-keys en MCP
• Importeren
• Regels beheren