Referentie van de tools
De 34 tools van de Novadesko MCP-server: raadplegen, voorbereiden, versturen en bevestigen, met parameters en vereiste abonnementsfunctie.
Deze lijst komt rechtstreeks uit het toolregister van Novadesko. De schema's zijn strikt: een onbekende parameter, een fout type of een waarde buiten de lijst wordt geweigerd. Een functie die niet in de formule van het bedrijf zit, geeft een weigering met de minimale formule en de prijs.
Raadplegen (read)#
| Tool | Parameters (* verplicht) | Vereiste functie | Functie |
|---|
get_company | geen | geen | Profiel van het verbonden bedrijf, abonnement, actieve add-ons en toegekende scopes. Als eerste aanroepen. |
search_parties | kind* customer | supplier
q string
page integer | Klantenbeheer als kind = customer | Zoekt klanten of leveranciers. |
get_party | kind* customer | supplier
id* integer | Klantenbeheer als kind = customer | Volledige fiche van een klant of leverancier: gegevens, controles (btw, 30 bis, Peppol), laatste documenten. |
search_documents | type receipt | invoice | proforma | order | credit_note | estimate | purchase
q string
paid boolean
page integer
from string
to string | geen | Zoekt documenten (offertes, bestelbonnen, facturen, ontvangstbewijzen, creditnota's, aankopen). |
get_document | document_id* integer | geen | Detail van een document: regels, bedragen, status, Peppol, boekhoudsynchronisatie, links. |
list_products | q string
page integer | geen | Producten en diensten uit de catalogus. |
get_revenue | from string
to string
compare previous_year | previous_period | none
group_by month | none | geen | Omzet over een periode (facturen + niet-omgezette ontvangstbewijzen, min creditnota's), vergelijking en maandoverzicht. |
get_top | from string
to string
kind customers | products
limit integer | geen | Beste klanten of producten over een periode. |
get_unpaid_invoices | geen | geen | Onbetaalde facturen: openstaand saldo, achterstand, verstuurde herinneringen. |
get_reminders | document_id integer | Betalingsherinneringen | Instellingen en geschiedenis van herinneringen (e-mail en sms). |
get_sms_credits | geen | geen | Resterend sms-tegoed. |
get_peppol_status | geen | geen | Peppol-status: identificatie, activatieaanvraag, ontvangen en verzonden documenten, validaties, fouten. Alleen lezen. |
get_accounting_sync_status | from string | geen | Documenten gesynchroniseerd, in wachtrij of in fout met WinAuditor, WinBooks Connect, Horus en de andere boekhoudintegraties. |
get_bank_sync_status | geen | geen | BankSync: rekeningen, laatste synchronisatie, niet-gekoppelde transacties. Alleen lezen. |
get_import_mailbox | geen | geen | Automatische importmailbox: adres, ontvangen mails, geïmporteerde of foutieve documenten. |
get_document_settings | geen | geen | Documentinstellingen: algemene voorwaarden, vermeldingen, kop- en voetteksten, logo. |
get_business_insights | topic* accounting | vat | bank | purchases | transactions | monthly_averages | fixed_charges | projections | payment_plans | credits | leases | vehicles | social_contributions | tax_estimation | stock | nace | volgens topic (tabel hieronder) | Beheeranalyses berekend door Novadesko (dezelfde cijfers als Nova AI), volgens het gekozen onderwerp. |
list_pending_actions | geen | geen | Voorbeelden die op bevestiging wachten in deze sessie. |
search | query* string | geen | Doorzoekt alles (klanten, leveranciers, documenten). Geeft ID's terug om te lezen met fetch. (alleen MCP) |
fetch | id* string | geen | Leest een resultaat van search (customer:ID, supplier:ID of document:ID). (alleen MCP) |
Voorbereiden (write)#
| Tool | Parameters (* verplicht) | Vereiste functie | Functie |
|---|
prepare_party_create | kind* customer | supplier
company string
first_name string
last_name string
email string
phone string
address string
postal_code string
city string
country_code string
vat_number string
iban string
is_individual boolean | Klantenbeheer als kind = customer | Voorbeeld van een nieuwe klant of leverancier (controles VIES, artikel 30 bis, Peppol). Slaat niets op. |
prepare_party_update | kind* customer | supplier
id* integer
changes* object | Klantenbeheer als kind = customer | Voorbeeld van een wijziging aan een klant- of leveranciersfiche. Slaat niets op. |
prepare_document_create | type* estimate | order | invoice | receipt | credit_note | proforma
customer_id* integer
date string
due_date string
object string
notes string
parent_document_id integer
lines* array<object> | volgens type: Facturatie, Bestelbonnen (order), Ontvangstbewijzen (receipt) | Pdf-voorbeeld van een nieuwe offerte, bestelbon, factuur, ontvangstbewijs, proforma of creditnota. Het wettelijke nummer volgt bij bevestiging. |
prepare_document_update | document_id* integer
date string
due_date string
object string
notes string
lines array<object> | geen | Pdf-voorbeeld van een wijziging aan een wijzigbaar document (niet vergrendeld, niet via Peppol verstuurd). lines vervangt alle regels. |
prepare_document_convert | document_id* integer
to_type* order | invoice | credit_note | volgens to_type | Voorbeeld van een omzetting: offerte naar bestelbon of factuur; bestelbon, ontvangstbewijs of proforma naar factuur; factuur naar creditnota. |
prepare_document_import | data* object
file_name* string
file_base64* string
accept_inconsistencies boolean | geen | Voorbeeld van de import van een aankoopfactuur die de AI heeft gelezen, met het bestand in base64 (bijlage bewaard). Controle van totalen en btw, geen OCR-tegoed verbruikt. (alleen MCP) |
prepare_settings_update | terms_html string
legal_notice_html string
footer array<object>
header array<object> | geen | Voorbeeld (pdf voor de voorwaarden) van een update van algemene voorwaarden, wettelijke vermeldingen, kop- en voetteksten. |
prepare_payment | document_id* integer
amount* number
date string
payment_type* string
notes string | geen | Voorbeeld van een betaling op een factuur, ontvangstbewijs of aankoop: bedrag, datum, betaalwijze (bv. banktransfert, cash, bankcard). |
prepare_peppol_request | request* activate | disable | delete | Peppol-activatie | Voorbeeld van een Peppol-aanvraag die het Novadesko-team behandelt: activeren, deactiveren of verwijderen. Verstuurt nooit een document via Peppol. |
prepare_support_ticket | subject* string
message* string | geen | Voorbeeld van een supportticket bij Novadesko, aangemaakt op naam van de gebruiker na bevestiging. |
Regelobject in lines: kind (product | text), product_id, name, description, quantity, unit_price_ht, vat_rate, discount_pct, html. Prijzen zijn exclusief btw, vat_rate in procent. Type text: eenvoudig HTML-blok, gefilterd via een whitelist.
Versturen (send)#
| Tool | Parameters (* verplicht) | Vereiste functie | Functie |
|---|
prepare_email | kind* customer | supplier
party_id* integer
to string
subject* string
body_html* string | geen | Voorbeeld van een e-mail aan een klant of leverancier, alleen naar een adres uit de fiche. |
prepare_reminder | document_id* integer
channel* email | sms | both
subject string
message string
sms_message string | Betalingsherinneringen (+ Sms versturen als channel = sms of both) | Voorbeeld van een herinnering voor een onbetaalde factuur per e-mail, sms of beide (sms-tegoed gecontroleerd). |
Uitvoering#
| Tool | Parameters (* verplicht) | Vereiste functie | Functie |
|---|
confirm_action | confirmation_token* string | geen | Voert een voorbereide actie uit, alleen na uitdrukkelijk akkoord van de gebruiker op het voorbeeld. Token voor eenmalig gebruik. (alleen MCP) |
cancel_action | confirmation_token* string | geen | Annuleert een wachtend voorbeeld. (alleen MCP) |
Onderwerpen van get_business_insights#
| topic | Inhoud | Vereiste functie |
|---|
accounting | voorlopige resultatenrekening en balans, kas | Gedetailleerde rapporten |
vat | verschuldigde of terug te vorderen btw, periodes | Btw-beheer |
bank | banksaldo en BankSync-koppelingen | geen |
purchases | aankopen, leveranciers en kostencategorieën | geen |
transactions | ontvangsten van de maand per betaalwijze | geen |
monthly_averages | gemiddelde omzet en uitgaven over 12 maanden | geen |
fixed_charges | terugkerende vaste kosten | geen |
projections | financiële prognoses en break-evenpunt | geen |
payment_plans | betalingsplannen | Betalingsplannen |
credits | lopende kredieten | Kredieten |
leases | huurcontracten en huurgelden | Huurcontracten |
vehicles | voertuigen en voertuigkosten | Rittenboek |
social_contributions | sociale bijdragen | Sociale bijdragen |
tax_estimation | fiscale raming | Fiscale raming |
stock | werkelijke voorraad | Voorraadbeheer |
nace | KBO-activiteiten (NACE-codes) | geen |
Documenttypes#
estimate, order, invoice, receipt, credit_note, proforma, purchase (aankopen, alleen lezen).
Zie ook#
