bimetricsEntwickler
Tools und Vorlagen

Tool-Übersicht, MCP-Version 2026-11-17

DATEV-Export starten, Kassenbuch führen, Anlagen und Abschreibungen, Kostenstellen, Summen- und Saldenliste, Mahnlauf, Fremdwährung, Kontakte zusammenführen sowie Ergänzungen bei Zuordnungen, Rechnungen und Angeboten.

Als Markdown ansehen

Diese MCP-Version ergänzt die Werkzeuge der MCP-Version 2026-11-05, mit denselben Lese- und Schreibrechten, um neue Werkzeuge und Änderungen an bestehenden. Es gilt die Anlage „MCP-Verbindungen“ aus dem Rechtspaket 2026-11-17-v1. Für die neuen Werkzeuge ist nach Anlage 2.3 eine neue Freigabe nötig. Bestehende Verbindungen behalten ihren Umfang, bis du neu verbindest.

Die neuen Werkzeuge nutzen dieselben Dienste und Befehle wie App und REST-API, mit denselben Sperren und Rollen. Wo MCP strenger ist, steht es dabei. Weiter gilt: Überwiesen wird nichts. Ausgestellte Rechnungen, Buchungen und Kontakte mit Belegen lassen sich nicht löschen. Was sich nicht zurücknehmen lässt, etwa der DATEV-Export mit Festschreibung oder der Abschluss eines Kassenmonats, führt die Anwendung erst nach einer Vorschau und deinem ausdrücklichen Ja aus.

Auf der Freigabeseite

Der Schalter Ändern wie in der App nennt jetzt auch den DATEV-Export mit Festschreibung. Unter Details stehen zusätzlich das Kassenbuch, Anlagen und Abschreibungen, Kostenstellen, der Mahnlauf und das Zusammenführen von Kontakten. Kontakte liest die Anwendung jetzt samt Notiz.

DATEV-Export

WerkzeugWas es tut
preview_datev_exportNur mit Schreibzugriff, denn es bucht wie der Export in der App zuerst, was noch nicht gebucht ist. Nennt die Zahl der offenen Buchungen des Zeitraums, die der Export festschreibt (openBookings), dazu Nachträge außerhalb des Zeitraums und Stornos auf Konten, die DATEV nicht mehr annimmt. Schreibt nichts fest. Liefert einen previewToken, 15 Minuten gültig, der nur für diese Angaben und diese Zahl gilt.
start_datev_exportFragt vorher nach. Startet den Export genau so, wie die Vorschau ihn zeigte, mit openBookings, previewToken, idempotencyKey und confirmed. Ein Export mit Buchungen schreibt die offenen Buchungen des Zeitraums fest; das lässt sich nicht rückgängig machen, eine Korrektur geht danach nur per Storno und Neubuchung. Weicht die Zahl inzwischen ab, schreibt bimetrics nichts fest und nennt die neue Zahl.
get_datev_exportLesend. Stand, Schritt, Fehler mit Bedeutung und ob festgeschrieben ist. Die Datei gibt es nicht im Chat, nur den Link auf Einstellungen › Exporte in der App, wo du sie herunterlädst.
cancel_datev_exportBricht einen Export ab, solange er wartet. Dann wird nichts festgeschrieben.
  • Wie in App und REST-API nur Zeiträume innerhalb eines Kalenderjahres.
  • bimetrics schickt nichts an die Kanzlei. Du lädst die Datei in der App herunter und gibst sie weiter.
  • get_export_check nennt zusätzlich Belege mit offenem Belegtyp (kindReview), Belege in Fremdwährung ohne Euro-Betrag (foreignCurrency), bei Ist-Versteuerung Zahlungseingänge ohne Zuordnung und ohne Rechnungsnummer (cashBasis), Nachträge in schon exportierten Monaten (addenda, je Monat und je Jahr mit dem Hinweistext aus Meldungen.csv) und Stornos auf Konten, die DATEV nicht mehr annimmt (reservedReversals).
  • search_bookings und get_booking nennen einen Nachtrag mit addendum: DATEV hat die Buchung noch nicht, obwohl ein Export ihr Datum schon umfasste.
  • set_datev_asset_mode hält fest, ob deine Kanzlei die Abschreibungen selbst in DATEV rechnet. Davon hängt ab, ob der Export Abschreibungen und Restbuchwerte mitliefert.

Kassenbuch

WerkzeugWas es tut
list_cash_booksLesend. Ob Kassenbücher eingeschaltet sind, und je Kassenbuch Konto, Beginn, Anfangsbestand, Bestand, letzter abgeschlossener Monat und ob es stillgelegt ist.
get_cash_bookLesend. Ein Monat mit Bestand vorher und nachher und jedem Tag mit seinen Buchungen.
preview_cash_book_entries, create_cash_book_entriesBuchungen prüfen und nach deinem Ja erfassen: Ausgaben mit Eigenbeleg, Einlagen und Entnahmen, Geldtransit zwischen Bank und Kasse und die Barzahlung eines Belegs. Einzelne Barverkäufe erfasst du hier nicht: bimetrics ist keine Registrierkasse.
reverse_cash_book_entryFragt vorher nach. Storniert eine Buchung mit Grund und eigener Nummer. Buchungen werden nie geändert oder gelöscht.
link_cash_book_bank_transactionOrdnet einer Geldtransit-Buchung den Bankumsatz mit dem Gegenbetrag zu.
preview_cash_count, record_cash_countVergleicht gezähltes Geld mit dem Bestand und hält die Zählung nach deinem Ja fest. Eine Differenz bucht bimetrics nur, wenn du das so entscheidest.
preview_cash_month_close, close_cash_monthPrüft den Monatsabschluss und schließt den Monat nach deinem Ja endgültig ab. Danach geht nichts mehr in den Monat, seine Buchungen sind festgeschrieben. Nur Inhaber und Kanzlei.
download_cash_bookLesend. Ein Monat als PDF zum Drucken oder Weitergeben.
download_cash_book_audit_exportLesend. Der Prüfungsexport eines Jahres als ZIP mit Buchungen, Änderungsprotokoll und Prüfsummen.
set_cash_book_enabled, save_cash_bookNur für den Inhaber und nur auf deinen Wunsch: Kassenbücher einschalten, ein Kassenbuch anlegen, umbenennen oder endgültig stilllegen.

Wie in der App: höchstens drei Kassenbücher zugleich, vorerst nur als Handkasse. Der Bestand darf nach keiner Buchung unter 0 fallen.

Anlagen und Abschreibungen

WerkzeugWas es tut
list_assets, get_assetLesend. Das Anlagenverzeichnis eines Jahres mit den Werten des Jahres, eine Anlage mit Plan je Jahr und ihren Buchungen.
get_asset_reportLesend. Anlage AVEÜR oder Anlagenspiegel eines Jahres aus gebuchten Werten.
search_useful_lifeLesend. Sucht die Nutzungsdauer in der amtlichen AfA-Tabelle mit Wörtern aus dem Alltag.
preview_asset, create_assetPrüft eine neue Anlage und legt sie nach deinem Ja an: aus Belegpositionen, als Altbestand oder als Einlage aus dem Privatvermögen. Die AfA bis heute wird nachgebucht.
list_opening_candidates, preview_asset_import, import_assetsAltbestand übernehmen: Positionen älterer Belege finden, eine Liste von bis zu 100 Anlagen prüfen und nach deinem Ja übernehmen.
preview_asset_plan, change_asset_planEine neue Restnutzungsdauer prüfen und nach deinem Ja ab dem ersten noch nicht gebuchten Monat setzen.
preview_asset_disposal, dispose_assetVerkauf oder Verschrottung prüfen und nach deinem Ja buchen: AfA bis zum Abgang, Restbuchwert, Gewinn oder Verlust.
reverse_asset_disposalFragt vorher nach. Nimmt einen Abgang zurück.
reverse_assetFragt vorher nach. Nimmt eine Anlage zurück (innerhalb von 30 Tagen, solange nichts festgeschrieben ist) oder storniert sie mit Grund. Eine Anlage wird nie gelöscht.

Kostenstellen und Auswertungen

WerkzeugWas es tut
list_cost_centersLesend. Kostenstellen und Verteilungen mit Nummer (KOST1 im DATEV-Export), Anteilen und ob sie benutzt sind.
save_cost_centerNur auf deinen Wunsch: anlegen, umbenennen, archivieren oder zurückholen. Benutzte Kostenstellen behalten Nummer und Anteile. Gelöscht wird nichts.
get_cost_center_reportLesend. Erträge, Aufwand, gezahlte Personalkosten und Ergebnis je Kostenstelle für Monat, Quartal oder Jahr, im Vergleich zum Zeitraum davor.
get_open_itemsLesend. Die Offene-Posten-Liste zum Stichtag je Kunde oder Lieferant, mit Summen nach Alter und den Posten, wie „Offene Posten“ in der App und wie die Kanzlei sie liest.
download_open_itemsLesend. Dieselbe Liste als PDF zum Ausdrucken oder als CSV, etwa für die Kanzlei.
get_trial_balanceLesend. Die Summen- und Saldenliste eines Zeitraums innerhalb eines Kalenderjahres mit EB-Wert, Soll, Haben und Saldo je Konto, wie der Reiter „Salden“ in der App. Höchstens 150 Konten je Aufruf, die nächsten mit offset.

Eine Kostenstelle kommt mit update_document oder apply_bulk_document_change an einen Beleg.

Zuordnungen

WerkzeugWas es tut
preview_match_cash_discount, settle_match_cash_discountDen offenen Betrag einer Zuordnung als Skonto ausgleichen, ohne sie vorher aufzuheben.
preview_match_reminder_charges, settle_match_reminder_chargesWas über den Rechnungsbetrag hinaus gezahlt wurde, als Mahnkosten und Zinsen der letzten Mahnung buchen.
preview_match_exchange_difference, settle_match_exchange_differenceDen Rest einer Zuordnung mit Belegen in Fremdwährung als Kursdifferenz buchen. Bei ungewöhnlich großer Abweichung (aboveLimit) erst nach Rückfrage.
preview_match_euro_amount, apply_match_euro_amountFür den Beleg einer Zuordnung den Euro-Betrag der Zahlungen übernehmen.
write_off_documentFragt vorher nach. Bucht den Rest eines Belegs als Rundungsdifferenz (höchstens 1 €) oder bei einer Ausgangsrechnung als Forderungsverlust mit Begründung aus. Zurück mit reverse_document_payment.
set_rule_learningSchaltet „Aus Zuordnungen lernen“ für die Firma ein oder aus, nur auf deinen Wunsch.
set_document_template_auto_assignSchaltet ein, dass bimetrics Bankumsätze einer Belegvorlage selbst zuordnet, nach dem Muster einer Zuordnung, die du vorher von Hand gemacht hast.
  • Skonto, Mahnkosten, Kursdifferenz und Euro-Betrag bucht bimetrics über MCP nicht, wenn die Buchungen schon an DATEV exportiert sind; das geht nur in der App.
  • get_open_amount nennt cashDiscountReference und reminderCharges, get_match erklärt ein von bimetrics selbst ausgeglichenes Skonto, delete_match nennt, was das Aufheben zurücknimmt.
  • extend_match und search_bookings sagen: Ändert sich bei einer festgeschriebenen Buchung nur die Zuordnung, bleibt die Buchung stehen. Storno und Neubuchung gibt es nur, wo sich für DATEV etwas ändert.

Belege

  • Belegtyp prüfen: get_document und search_documents nennen kindReview, solange der Belegtyp offen ist. Bis zur Wahl wird der Beleg nicht gebucht, nicht exportiert und nicht zugeordnet. update_document mit kind beendet die Prüfung, preview_bulk_document_change und apply_bulk_document_change setzen den Belegtyp mit der Aktion kind für bis zu 50 Belege.
  • Fremdwährung: get_document und search_documents nennen Belegwährung, Betrag vom Beleg und „Euro-Betrag fehlt“ (currencyReview). update_document und preview_document_change tragen den Euro-Betrag ein, rechnen zum Monatskurs des BMF um (euroAtMonthlyRate) oder übernehmen die Steuer in Euro laut Rechnung (euroTaxAmounts). Die Sammelaktion monthly_rate rechnet bis zu 50 Belege zum Monatskurs um. record_document_payment nimmt eine Zahlung in Belegwährung; get_document_payment nennt dann, was in der Belegwährung noch offen ist (amountOpenOriginalMinor), und je Zahlung Kurs und Kursdifferenz. search_transactions und get_transaction nennen bei Umsätzen aus einem Fremdwährungskonto den Betrag laut Bank mit Währung und Kurs; mit originalCurrency sucht search_transactions nach diesem Betrag.
  • Leistungszeitraum je Position: get_document nennt positionPeriods, update_document und preview_document_change setzen sie.
  • Summe weicht ab: get_document nennt totalMismatch, wenn die Positionen nicht den Gesamtbetrag laut Beleg ergeben. statedTotalMinor 0 in update_document beendet den Hinweis wie „Summe passt so“.
  • Lange Dateien und Erneut lesen: get_document nennt partlyRead, wenn bimetrics nur die ersten 60 Seiten gelesen hat. retry_document_reading startet das Lesen eines fehlgeschlagenen Belegs neu; das zählt wie in der App als weiterer Beleg ins Kontingent.
  • Bezahlte Belege: update_document ändert Rechnungsnummer und Fälligkeit auch an bezahlten Belegen.
  • Nach dem DATEV-Export: update_document berichtigt auch Belege, deren Buchungen schon an DATEV gingen. bimetrics storniert die Buchung in ihrem Monat und bucht neu; addendaMonths nennt die Monate, die du dafür noch einmal mit „Nur noch nicht exportierte“ exportierst. create_match und delete_match tun das mit confirmExported erst, nachdem du die betroffenen Monate gesehen und bestätigt hast.

Rechnungen, Angebote und Mahnungen

  • Optionale Positionen und Titel: create_sales_draft und update_sales_draft nehmen je Position option, title und subtitle, get_sales_document und preview_sales_document nennen sie. derive_sales_document nimmt mit selectedLines die beauftragten Positionen.
  • Abschlags- und Schlussrechnung: derive_sales_document erstellt aus einem Auftrag eine Abschlagsrechnung (invoiceRole down_payment, Betrag in Prozent oder Cent) oder die Schlussrechnung (final). update_sales_draft ändert den Betrag eines Abschlags. Prüfung und Vorschau der Schlussrechnung nennen die Abzüge der bezahlten Abschläge. Sie zeigen auch, welche Abschläge das Ausstellen storniert (unbezahlt) oder auf den gezahlten Betrag korrigiert (teilweise bezahlt). Ist dabei ein offener Betrag betroffen, braucht finalize_sales_draft dein ausdrückliches Ja (acceptCancelOpenDownPayments).
  • Steuersätze und Steuerfall: check_sales_draft nennt die Sätze, die der Steuerfall je Position erlaubt, und je Problem den Parameter, der es behebt. Für Rechnungen kommen dazu: der Pflichthinweis (taxHintText), die Bestätigung deutscher Umsatzsteuer ohne USt-IdNr. (acceptStandardVatWithoutVatId, nur nach deinem ausdrücklichen Ja) sowie Lieferdatum und Lieferadresse (delivery). Für Positionen gibt es die Art property_service für Leistungen an einem Grundstück.
  • Sicherheitseinbehalt: Rechnungen können einen Sicherheitseinbehalt tragen (retention). preview_retention_release und release_retention stellen den Einbehalt ab heute fällig; das lässt sich nicht zurücknehmen. get_open_tasks nennt die Zeile „Einbehalt fällig“.
  • Zahlstand: search_sales_documents filtert Rechnungen nach Zahlstand, Mahnstufe und Fälligkeit und liefert mit includeCounts die Zahlen für die Reiter der Rechnungsliste. get_sales_document nennt payment.
  • Ergebnis von Angeboten: set_proposal_outcome hält fest, ob der Kunde ein ausgestelltes Angebot angenommen oder abgelehnt hat, oder nimmt das zurück, nur auf deinen Wunsch. search_sales_documents filtert und zählt Angebote nach Ergebnis.
  • Mahnsperre: set_reminder_hold setzt die Mahnsperre einer Rechnung oder hebt sie auf, nur auf deinen Wunsch. update_contact nimmt „Nicht mahnen“ (noReminders).
  • Mahnlauf: preview_reminder_run zeigt für bis zu 25 Rechnungen die Mahnung der nächsten Stufe mit Frist, Gebühr, Zinsen und Text. apply_reminder_run stellt genau das nach deinem Ja aus. Gesendet wird nichts; Mails gehen weiter einzeln über send_document_mail.
  • Weitere Mail-Anhänge: preview_document_mail und send_document_mail nehmen bis zu 10 weitere Dateien, zusammen höchstens 10 MiB. Für eigene Dateien gibt prepare_mail_attachment_upload einen Upload-Link; ein Beleg wird daraus nicht.
  • Versandstand: get_sales_document und get_payment_reminder nennen die neueste Mail mit dem Dokument und ob sie ankam.
  • Gesperrte Gutschrift und gesperrtes Storno: get_receivable und search_receivables nennen den Grund und mit correctableMinor, um wie viel eine weitere Gutschrift die Rechnung noch mindern kann.
  • Texte neuer Entwürfe: create_sales_draft nennt als Vorgabe die Textvorlage der Firma.

Kontakte

WerkzeugWas es tut
list_similar_contactsLesend. Andere Kontakte, die dieselbe Firma sein könnten, und welcher beim Zusammenführen bleiben würde.
preview_contact_merge, merge_contactsZeigt, welche Belege zu einem anderen Kontakt wandern, und verschiebt sie nach deinem Ja. Festgeschriebene Buchungen werden storniert und neu gebucht. Exportierte Belege und ausgestellte Rechnungen bleiben beim bisherigen Kontakt.
dismiss_similar_contactFragt vorher nach. Hält fest, dass zwei ähnliche Kontakte verschiedene Firmen sind. Das lässt sich nicht zurücknehmen.
lookup_addressLesend. Orte zu einer PLZ, PLZ zu einem Ort und Straßen in Deutschland, aus Listen von OpenStreetMap und, für Österreich, der RTR-GmbH.
  • get_contact und search_contacts lesen die Notiz am Kontakt, create_contacts und update_contact schreiben sie, höchstens 2.000 Zeichen und ohne E-Mail-Adressen, Links oder IBANs. Eine Notiz mit solchen Angaben änderst du nur in der App.
  • get_contact nennt das Debitoren- bzw. Kreditorenkonto (datevAccounts) und eigene Zahlungsbedingungen des Kunden (paymentTerms), update_contact und create_contacts nehmen sie.

Firma

get_company_context nennt bei Ist-Versteuerung vatCashBasis und mit learnRules, ob bimetrics aus Zuordnungen lernt. Die Versteuerung änderst du nur in der App.

Auf dieser Seite