Eigene Sachkonten lesen
Benötigte Berechtigung:read(Daten lesen)
Liefert alle eigenen Sachkonten der Firma nach Nummer, auch archivierte. number ist das Konto, wie DATEV es bekommt, display dieselbe Nummer mit den führenden Nullen der Sachkontenlänge. Dazu kommen das Konto der Kategorie im selben Bereich (baseAccount), der Name und die Grenzen des Bereichs im DATEV-Kontenrahmen (rangeLabel, rangeFrom, rangeTo), die Kontenklasse und bei einem Automatikkonto dessen Umsatzsteuer (tax).
Benötigt einen Schlüssel mit der Berechtigung read.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
Erfolg.
application/json- response
[index: integer]?Eigenes Sachkonto der Firma mit dem, was es von seinem Bereich im DATEV-Kontenrahmen übernimmt.
curl --fail-with-body "https://app.bimetrics.de/api/ledger-accounts" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"[ { "accountClass": 4, "baseAccount": 4400, "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-11-21T08:00:00Z", "display": "44001", "id": "7c2e9a41-5b3d-4f18-a6e0-3d8b1f4c9e27", "name": "Erlöse Wartungsverträge", "number": 44001, "rangeFrom": 4400, "rangeLabel": "Erlöse zum allgemeinen Umsatzsteuersatz", "rangeTo": 4409, "tax": "ust19%", "updatedAt": "2026-11-21T08:00:00Z" }, { "accountClass": 6, "baseAccount": 6310, "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-11-21T08:00:00Z", "display": "63101", "id": "e4a17b9c-0d62-4c35-8f9a-2b6e5d1c7a83", "name": "Miete Lager Nord", "number": 63101, "rangeFrom": 6310, "rangeLabel": "Miete (unbewegliche Wirtschaftsgüter)", "rangeTo": 6311, "updatedAt": "2026-11-21T08:00:00Z" }]Feedback an bimetrics senden POST
Sendet Feedback zu bimetrics an das bimetrics-Team, wie `send_feedback` per MCP: was du vorhattest, was geklappt hat, was nicht und was besser werden soll. In deiner Firma ändert sich nichts. Pflicht sind `outcome` und `intent` mit 3 bis 300 Zeichen, dazu mindestens eines von `wentWell`, `wentWrong` und `improve` mit je höchstens 2000 Zeichen. Fehlt ein Text oder steht nur ein Fülltext wie „test“ darin, antwortet die Route mit `400 FeedbackEmpty`. Ein ungültiges Feld ergibt `400 BadRequest`, `context.field` nennt es. `refs` nennt höchstens 10 betroffene Pfade oder Werkzeuge, etwa `/api/document/filter` oder `search_documents`. Texte mit E-Mail-Adressen, Links, IBANs oder unsichtbaren Steuerzeichen lehnt die Route mit `400 UnsafeMCPText` ab, `context.reason` nennt den Grund: `mail`, `link`, `iban` oder `control`. Bitte keine Namen von Kunden, Lieferanten oder Mitarbeitenden, keine Beträge und keine Beleginhalte. Je Firma gehen höchstens 10 Meldungen in 24 Stunden (API und MCP zusammen), je Schlüssel 3 in einer Stunde. Danach antwortet die Route mit `429 FeedbackLimit` und speichert nichts; der Header `Retry-After` nennt die Sekunden, bis wieder eine Meldung geht. Kommt dasselbe Feedback innerhalb von 10 Minuten noch einmal, speichert bimetrics es nicht doppelt und antwortet mit der gespeicherten `id` und `replayed: true`. Einen Idempotency-Key braucht die Route nicht. bimetrics löscht Feedback nach 180 Tagen, mit der Firma auch früher. Benötigt einen Schlüssel mit der Berechtigung `read`.
Eigenes Sachkonto anlegen POST
Legt ein eigenes Sachkonto mit Nummer und Bezeichnung an. Die Nummer hat genau so viele Stellen wie die Sachkontenlänge der Firma (4 bis 8, in den DATEV-Einstellungen der App). Ihre ersten vier Stellen sind ein Erlös- oder Aufwandskonto im Bereich eines Kontos, auf das eine Kategorie bucht. Über vier Stellen sind die angehängten Stellen nie alle 0, denn dann wäre es das Standardkonto selbst: Bei Länge 5 ist 44000 das Konto 4400, 44001 ein eigenes. Bei Länge 4 ist es ein freies Konto des Bereichs, auf das keine Kategorie bucht. Die Nummer steht danach fest, sie ist je Firma eindeutig, auch gegenüber archivierten. Die Bezeichnung geht mit dem nächsten DATEV-Export an DATEV. Verstößt die Anfrage gegen eine Regel, antwortet die Route mit `400 LedgerAccountRejected`, `context.field` nennt das Feld und `context.message` den Satz der App; eine vergebene Nummer ergibt `409 LedgerAccountRejected`. Bei einer Wiederholung schickst du denselben Idempotency-Key. Benötigt einen Schlüssel mit der Berechtigung `company:write`.