Novadesko Dokumentation

Handbuch Demo

Deutsch

Werkzeugreferenz

Die 34 Werkzeuge des Novadesko-MCP-Servers: lesen, vorbereiten, senden und bestätigen, mit Parametern und benötigter Tariffunktion.

Aktualisiert am 23.10.2026 Diese Seite bearbeiten In der vollständigen Dokumentation öffnen

Diese Liste wird aus dem Werkzeugregister von Novadesko erzeugt. Die Schemata sind strikt: unbekannte Parameter, falsche Typen oder Werte außerhalb der Liste werden abgelehnt. Eine Funktion außerhalb des Tarifs des Unternehmens liefert eine Ablehnung mit dem Mindesttarif und dessen Preis.

Lesen (read)

Werkzeug	Parameter (* Pflicht)	Benötigte Funktion	Zweck
`get_company`	keine	keine	Profil des verbundenen Unternehmens, Abo, aktive Add-ons und gewährte Scopes. Zuerst aufrufen.
`search_parties`	`kind*` customer \| supplier `q` string `page` integer	Kundenverwaltung bei kind = customer	Sucht Kunden oder Lieferanten.
`get_party`	`kind` customer \| supplier `id` integer	Kundenverwaltung bei kind = customer	Vollständiger Kunden- oder Lieferantendatensatz: Daten, Prüfungen (USt, Art. 30 bis, Peppol), letzte Dokumente.
`search_documents`	`type` receipt \| invoice \| proforma \| order \| credit_note \| estimate \| purchase `q` string `paid` boolean `page` integer `from` string `to` string	keine	Sucht Dokumente (Angebote, Bestellungen, Rechnungen, Quittungen, Gutschriften, Einkäufe).
`get_document`	`document_id*` integer	keine	Dokumentdetail: Positionen, Beträge, Status, Peppol, Buchhaltungssync, Links.
`list_products`	`q` string `page` integer	keine	Produkte und Leistungen aus dem Katalog.
`get_revenue`	`from` string `to` string `compare` previous_year \| previous_period \| none `group_by` month \| none	keine	Umsatz in einem Zeitraum (Rechnungen + nicht umgewandelte Quittungen, abzüglich Gutschriften), Vergleich und Monatsaufteilung.
`get_top`	`from` string `to` string `kind` customers \| products `limit` integer	keine	Top-Kunden oder -Produkte in einem Zeitraum.
`get_unpaid_invoices`	keine	keine	Offene Rechnungen: Restbetrag, Verzug, bereits gesendete Mahnungen.
`get_reminders`	`document_id` integer	Zahlungserinnerungen	Mahneinstellungen und -verlauf (E-Mail und SMS).
`get_sms_credits`	keine	keine	Verbleibende SMS-Guthaben.
`get_peppol_status`	keine	keine	Peppol-Status: Kennung, Aktivierungsantrag, empfangene und gesendete Dokumente, Validierungen, Fehler. Nur lesend.
`get_accounting_sync_status`	`from` string	keine	Mit WinAuditor, WinBooks Connect, Horus und anderen Buchhaltungsintegrationen synchronisierte, wartende oder fehlerhafte Dokumente.
`get_bank_sync_status`	keine	keine	BankSync: Konten, letzte Synchronisierung, nicht zugeordnete Transaktionen. Nur lesend.
`get_import_mailbox`	keine	keine	Automatisches Import-Postfach: Adresse, empfangene Mails, importierte oder fehlerhafte Dokumente.
`get_document_settings`	keine	keine	Dokumenteinstellungen: AGB, Pflichtangaben, Kopf- und Fußzeilen, 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	je nach topic (Tabelle unten)	Von Novadesko berechnete Auswertungen (dieselben Zahlen wie Nova AI), je Thema.
`list_pending_actions`	keine	keine	Vorschauen, die in dieser Sitzung auf Bestätigung warten.
`search`	`query*` string	keine	Übergreifende Suche (Kunden, Lieferanten, Dokumente). Liefert IDs zum Lesen mit fetch. (nur MCP)
`fetch`	`id*` string	keine	Liest ein Suchergebnis (customer:ID, supplier:ID oder document:ID). (nur MCP)

Vorbereiten (write)

Werkzeug	Parameter (* Pflicht)	Benötigte Funktion	Zweck
`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	Kundenverwaltung bei kind = customer	Vorschau eines neuen Kunden oder Lieferanten (VIES-, Art. 30 bis- und Peppol-Prüfung). Speichert nichts.
`prepare_party_update`	`kind` customer \| supplier `id` integer `changes*` object	Kundenverwaltung bei kind = customer	Vorschau einer Änderung an einem Kunden- oder Lieferantendatensatz. Speichert nichts.
`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>	je nach type: Fakturierung, Bestellungen (order), Quittungen (receipt)	PDF-Vorschau eines neuen Angebots, einer Bestellung, Rechnung, Quittung, Proforma oder Gutschrift. Die Rechnungsnummer wird bei Bestätigung vergeben.
`prepare_document_update`	`document_id*` integer `date` string `due_date` string `object` string `notes` string `lines` array<object>	keine	PDF-Vorschau einer Änderung an einem bearbeitbaren Dokument (nicht gesperrt, nicht über Peppol gesendet). lines ersetzt alle Positionen.
`prepare_document_convert`	`document_id` integer `to_type` order \| invoice \| credit_note	je nach to_type	Umwandlungsvorschau: Angebot zu Bestellung oder Rechnung; Bestellung, Quittung oder Proforma zu Rechnung; Rechnung zu Gutschrift.
`prepare_document_import`	`data` object `file_name` string `file_base64*` string `accept_inconsistencies` boolean	keine	Importvorschau einer von der KI gelesenen Eingangsrechnung mit der Datei in Base64 (Anhang bleibt erhalten). Summen und USt werden geprüft, kein OCR-Guthaben verbraucht. (nur MCP)
`prepare_settings_update`	`terms_html` string `legal_notice_html` string `footer` array<object> `header` array<object>	keine	Vorschau (PDF für die AGB) einer Änderung von AGB, Pflichtangaben, Kopf- und Fußzeilen.
`prepare_payment`	`document_id` integer `amount` number `date` string `payment_type*` string `notes` string	keine	Vorschau einer Zahlung auf einer Rechnung, Quittung oder einem Einkauf: Betrag, Datum, Zahlungsart (z. B. banktransfert, cash, bankcard).
`prepare_peppol_request`	`request*` activate \| disable \| delete	Peppol-Aktivierung	Vorschau eines Peppol-Antrags, den das Novadesko-Team bearbeitet: aktivieren, deaktivieren oder löschen. Sendet nie ein Dokument über Peppol.
`prepare_support_ticket`	`subject` string `message` string	keine	Vorschau eines Support-Tickets bei Novadesko, nach Bestätigung im Namen des Nutzers erstellt.

Positionsobjekt in lines: kind (product | text), product_id, name, description, quantity, unit_price_ht, vat_rate, discount_pct, html. Preise ohne USt, vat_rate in Prozent. Typ text: einfacher HTML-Block, per Positivliste gefiltert.

Senden (send)

Werkzeug	Parameter (* Pflicht)	Benötigte Funktion	Zweck
`prepare_email`	`kind` customer \| supplier `party_id` integer `to` string `subject` string `body_html` string	keine	Vorschau einer E-Mail an einen Kunden oder Lieferanten, nur an eine Adresse aus dem Datensatz.
`prepare_reminder`	`document_id` integer `channel` email \| sms \| both `subject` string `message` string `sms_message` string	Zahlungserinnerungen (+ SMS-Versand bei channel = sms oder both)	Vorschau einer Mahnung für eine offene Rechnung per E-Mail, SMS oder beides (SMS-Guthaben geprüft).

Ausführung

Werkzeug	Parameter (* Pflicht)	Benötigte Funktion	Zweck
`confirm_action`	`confirmation_token*` string	keine	Führt eine vorbereitete Aktion aus, nur nach ausdrücklicher Zustimmung des Nutzers zur Vorschau. Einmal-Token. (nur MCP)
`cancel_action`	`confirmation_token*` string	keine	Bricht eine wartende Vorschau ab. (nur MCP)

Themen von get_business_insights

topic	Inhalt	Benötigte Funktion
`accounting`	vorläufige GuV und Bilanz, Kasse	Detaillierte Berichte
`vat`	geschuldete oder erstattungsfähige USt, Zeiträume	USt-Verwaltung
`bank`	Bankliquidität und BankSync-Verbindungen	keine
`purchases`	Einkäufe, Lieferanten und Ausgabenkategorien	keine
`transactions`	Einnahmen des Monats nach Zahlungsart	keine
`monthly_averages`	durchschnittlicher Umsatz und Ausgaben über 12 Monate	keine
`fixed_charges`	wiederkehrende Fixkosten	keine
`projections`	Finanzprognosen und Gewinnschwelle	keine
`payment_plans`	Zahlungspläne	Zahlungspläne
`credits`	laufende Kredite	Kredite
`leases`	Mietverträge und Mieten	Mietverträge
`vehicles`	Fahrzeuge und Fahrzeugkosten	Fahrtenbuch
`social_contributions`	Sozialbeiträge	Sozialbeiträge
`tax_estimation`	Steuerschätzung	Steuerschätzung
`stock`	tatsächlicher Bestand	Lagerverwaltung
`nace`	KBO-Tätigkeiten (NACE-Codes)	keine

Dokumenttypen

estimate, order, invoice, receipt, credit_note, proforma, purchase (Einkäufe, nur lesend).

Siehe auch