Ga naar inhoud

MCP-tools

De MCP-server biedt achtenveertig tools en drie naslagstukken. Je assistent krijgt ze alle achtenveertig 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.

Een schrijvende tool vraagt geen bevestiging: de toestemming geef je in je eigen client (zie Toestemming en het logboek). Elke schrijvende tool komt in het logboek te staan, met de tool en wat er stond en wat er kwam.

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

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.

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.

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.

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.

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.

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.

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.

Het logboek bewaart wat er eerst stond, zodat je de correctie met muntar_undo_balance_correction kunt terugdraaien.

De beginstand van één rekening invullen: wat er op stond vlak voor de eerste geboekte transactie. Dit lost elke melding op die om een beginstand vraagt; zie De beginstand invullen.

Mee te geven: de rekening en het bedrag. De datum kiest Muntar zelf: de dag voor de eerste boeking op die rekening.

Terug: die datum, wat er op die dag al stond en het verschil dat is bijgeboekt. Een beginstand van 0 mag; er wordt dan niets geboekt, maar de beginstand is wel vastgelegd. Een rekening die met een waardering werkt wordt geweigerd: daar zet je de waarde met muntar_set_account_balance.

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.

Naam en kleur van een bestaande entiteit. Het soort entiteit kan niet gewijzigd worden. Alleen een eigenaar mag dit.

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

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.

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.

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.

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.

Draagt een regel de markering “Mogelijk dubbel”, “Tegenkant al geboekt” of “Al eerder geïmporteerd” (zie Dubbele regels), dan staat er ook duplicateOf bij: de datum, het bedrag, de rekening en het bestand van de transactie waar hij op lijkt, en of die al geboekt is of nog klaarstaat. Zo kan de assistent de gebruiker vertellen waarmee een regel botst voordat die tussen “dezelfde transactie” en “een aparte betaling” kiest.

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 ontstaat er 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.

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 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.

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. Een open regel met de markering mogelijk dubbel blijft dan open: daar hoort eerst de keuze bij of het dezelfde transactie is (genegeerd) of een aparte (geaccepteerd).

Raakt de aanroep een regel die jij of je assistent al beoordeeld had, dan zet de tool hem toch om, en staat in het logboek om hoeveel van die regels het ging. Raakt hij alleen regels die nog open staan, dan overschrijft hij niets van jou.

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.

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. Geboekt wordt er nog niet.

Een regel met de markering mogelijk dubbel (de vlag POSSIBLE_DUPLICATE) gaat nooit mee, ook niet als je regels zonder categorie laat meenemen. Die regel lijkt al geboekt, of staat klaar in een andere import uit een ander bestand. Je assistent of jij beslist per regel met muntar_update_import_lines: geaccepteerd als het een aparte transactie is, genegeerd als het dezelfde is.

Terug: hoeveel regels er geaccepteerd zijn, en hoeveel mogelijk dubbele regels bewust open bleven staan.

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. Een regel met de markering mogelijk dubbel gaat niet mee, net als bij muntar_accept_pending: het kan ook een echte tweede betaling zijn. Die regel blijft open tot je assistent of jij per regel beslist met muntar_update_import_lines.

Mee te geven: het id van de import.

Ook hier blijft een al beoordeelde regel staan. Een tweede aanroep raakt niets meer.

Terug: hoeveel regels er op genegeerd zijn gezet, en hoeveel mogelijk dubbele regels bewust open bleven staan.

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. Het antwoord 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. 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.

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.

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”.

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).

Een rekening die geen categorie is, hernoemt de tool niet. Het logboek bewaart de oude naam.

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

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.

Staat er op de nieuwe plek al een categorie met dezelfde naam, dan weigert de tool. Het logboek bewaart de vorige plek.

Terug: hetzelfde als bij aanmaken.

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.

Het antwoord en het logboek noemen 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.

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).

Is de categorie niet leeg en staat if_not_empty op “refuse”, dan weigert de tool met de aantallen erbij. 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.

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

Mee te geven: de categorie.

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.

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.

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.

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.

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.

Zou de wijziging de regel gelijk maken aan een andere regel, dan weigert de tool. Het logboek bewaart wat de regel voorheen deed.

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

Verwijdert een regel.

Mee te geven: de regel.

Je boekingen veranderen er niet door; alleen toekomstige imports gaan anders. Het logboek bewaart het patroon en het doel, zodat je de regel desgewenst opnieuw aanmaakt.

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

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. De tool staat wel als ingrijpend gemarkeerd, juist om die laatste uitzondering: sommige clients vragen daardoor zelf om jouw 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.

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.

Het logboek bewaart 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.

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.

Het logboek bewaart de oude naam en wat er met de IBAN gebeurde.

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

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.

Terug: het id en de naam.

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. Koppel alleen een IBAN 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.

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.

Terug: de rekening en de losgekoppelde IBAN.

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.

De rekening is een betaal-, spaar- of beleggingsrekening, of een contante rekening als het bestand een QIF is die zijn rekeningen bij naam noemt. Pensioen, overig bezit en een lening krijgen nooit regels uit een bestand. Kiest de assistent een rekening die het bestand niet kan ontvangen, dan krijgt hij die uitleg terug, met de rekeningen die wel kunnen.

Een import vraagt meer van de server dan een leesvraag. Daarom lopen er maar een paar tegelijk: per werkruimte twee, en over de hele server een handvol. Dat geldt voor muntar_preview_import, muntar_stage_import, muntar_assign_import en muntar_commit_import. Is het druk, dan wacht je aanroep even op zijn beurt. Duurt dat te lang, dan krijgt de assistent de melding dat er te veel imports tegelijk lopen, of dat de server het te druk heeft. In beide gevallen is er niets weggeschreven, en is dezelfde aanroep na enkele seconden opnieuw doen het juiste antwoord.

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 mogelijk dubbel, 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.

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.

Bevat het bestand meerdere rekeningen, zoals een QIF uit een boekhoudprogramma of een bankexport met meerdere IBAN’s, dan weigert deze tool met een verwijzing naar muntar_assign_import.

Wijst in één keer alle rekeningen toe die in een bestand met meerdere rekeningen staan: een QIF uit een boekhoudprogramma, of een bankexport met meerdere IBAN’s. Vraagt de scope “Importeren” voor het overzicht, en daarnaast “Schrijven” zodra je assistent ook assignments meegeeft.

Zonder assignments krijgt je assistent een overzicht: per rekening uit het bestand het aantal regels, de periode, de meest voorkomende tegenpartijen, of hij al gekoppeld is, een voorstel voor een bestaande rekening bij een gelijke naam, en welke van je eigen rekeningen voor die rekening niet te kiezen zijn. In deze stand wordt er niets opgeslagen, ook geen bewaard bestand: bij een tweede aanroep stuurt de assistent het bestand gewoon opnieuw mee.

Met assignments geeft de assistent per rekening uit het bestand een keuze mee: een bestaande rekening, een nieuwe (met naam, soort en entiteit), of overslaan. Muntar maakt dan de nieuwe rekeningen aan, koppelt de rekeningen uit het bestand en zet per rekening een import klaar, net als muntar_stage_import voor één rekening doet. Het antwoord noemt per rekening de keuze en de tellingen: hoeveel rekeningen erbij komen, hoeveel er gekoppeld worden en voor hoogstens hoeveel rekeningen er een import klaarkomt (twee rekeningen uit het bestand kunnen op dezelfde rekening uitkomen, en een rekening waar dit bestand al eerder voor geïmporteerd is, krijgt er geen nieuwe bij). Er wordt nog niets geboekt: dat gaat daarna zoals bij elke import, met muntar_get_import_lines en muntar_commit_import.

Een contante rekening kan alleen regels krijgen uit een bestand dat zijn rekeningen bij naam noemt, zoals een QIF; een bankexport met IBAN’s komt er nooit op terecht. Pensioen, overig bezit en een lening krijgen nooit regels uit een bestand.

Zijn alle rekeningen uit het bestand al gekoppeld, geef dan assignments: [] mee; de tool zet dan meteen de imports klaar, of meldt dat ze al eerder geïmporteerd zijn.

Terug: het overzicht per rekening, welke van je eigen rekeningen niet te kiezen waren, en in de toewijsstand de nieuw klaargezette batches, de rekeningen waar dit bestand al eerder voor geïmporteerd was, en de overgeslagen rekeningen.

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.

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, een melding als een beloofde openingsboeking er toch niet gekomen is, en welke regels (met hun regelnummer in het bestand) niet geboekt zijn omdat de andere kant van een overboeking tussen je eigen rekeningen al geboekt was. Dat laatste is geen fout: zo telt elke overboeking één keer.

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

Mee te geven: het id van de batch.

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.

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.

Terug: per sjabloon 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 vooraf getoond bedrag 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.

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.

Het logboek bewaart 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.

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. Het antwoord noemt dat er met zoveel woorden bij.

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

De tool weigert ook als je dezelfde transactie in een geboekte import negeerde omdat hij al als deze boeking in je boeken stond (zie mogelijk dubbel). Tegenboeken zou hem dan nergens meer laten staan. De melding noemt die import; maak hem eerst ongedaan met muntar_undo_import, of laat de boeking staan. De categorie wijzigen met muntar_recategorize_entry kan wel.

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

Start (of volgt) een achtergrondtaak die de ingestelde AI-provider om een categorievoorstel vraagt voor elke regel van een klaargezette import die nog geen categorie heeft. Een voorstel dat je assistent zelf al zette met muntar_propose_categories, blijft staan.

Mee te geven: het id van de batch. Optioneel het id van een taak (job_id) en restart.

De taak draait op de achtergrond en deze aanroep keert snel terug, met het id van de taak. Loopt de taak nog, roep de tool dan opnieuw aan met hetzelfde batch-id en dat taak-id om de stand te zien. Met een taak-id volgt de tool alleen die taak en geeft hij de stand of de eindstatus terug; hij start dan nooit een nieuwe taak. Dat werkt ook nog als de import intussen geboekt of verwijderd is.

Zonder taak-id volgt de tool een taak die al loopt, of start hij er een. Er loopt hoogstens één taak per batch, ook als het scherm en deze tool tegelijk aanroepen. Heb je de laatste taak met “Stoppen” op het beoordelingsscherm gestopt, dan start de tool zonder taak-id geen nieuwe. Het antwoord zegt dan dat jij hem stopte. Een nieuwe taak start hij pas met restart op waar, en een assistent hoort dat alleen te doen als jij erom vraagt.

Deze tool 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: het id van de taak, de stand van de taak (in de wachtrij, bezig, klaar, mislukt of gestopt), of er verder gewacht moet worden, hoeveel regels er in totaal zijn, hoeveel er al bekeken zijn en hoeveel er een voorstel kregen. Mislukt de taak, dan staat de reden erbij. Die reden kan ook bij een taak staan die klaar is: dan mislukte een deel en kregen de andere regels wel een voorstel; bij een verkeerde AI-instelling, een onbruikbaar antwoord of een afgekapt antwoord kan de assistent het ook zelf doen. Is er geen provider ingesteld, dan start er geen taak en verwijst het antwoord naar muntar_get_import_lines en muntar_propose_categories, waarmee de assistent het zelf doet. Hadden alle regels al een categorie of een voorstel, dan start er ook geen taak.

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

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. De boeking die deze koers vervolgens gebruikt, laat in zijn antwoord 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.

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.

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.

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.

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.