Feedback an bimetrics senden
Benötigte Berechtigung:read(Daten lesen)
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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
feedback
application/json- body
Das Feedback.
improve?stringWas besser werden soll, höchstens 2000 Zeichen.
intent?stringPflicht: was du mit bimetrics tun wolltest, in wenigen Worten, 3 bis 300 Zeichen.
outcome?stringPflicht: worked (hat zuverlässig geklappt), improvable (hat geklappt, sollte aber besser werden), failed (hat nicht geklappt) oder missing (bimetrics hat dafür keine Funktion).
"worked""improvable""failed""missing"refs?array<string>Betroffene Pfade oder Werkzeuge, höchstens 10 mit je höchstens 80 Zeichen aus Buchstaben, Ziffern und _/:.{}-.
wentWell?stringWas gut und zuverlässig geklappt hat, höchstens 2000 Zeichen.
wentWrong?stringWas nicht geklappt hat oder fehlt: die Route und der Fehlercode, ohne die Daten, um die es ging. Höchstens 2000 Zeichen.
Erfolg.
application/json- response
Das gespeicherte Feedback.
id?stringID des Feedbacks.
uuidreplayed?booleantrue, wenn dasselbe Feedback innerhalb von 10 Minuten schon kam und nichts neu gespeichert wurde.
curl --fail-with-body "https://app.bimetrics.de/api/feedback" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "5d2f8a17-3c4e-4b9a-8e61-0f7a2c9d4b38", "replayed": false}Automatisierung auf vorhandene Belege anwenden POST
Wendet die festen Regeln einer Automatisierung auf Belege an, die es schon gibt, wie „Auf vorhandene Belege anwenden“ in der App. Die Automatisierung muss aktiv sein und eine aktive feste Regel haben, sonst `400` mit `context.field` `id`. Es entscheiden alle aktiven festen Regeln der Firma zusammen, wie beim Upload: Eine andere Automatisierung kann den Belegtyp setzen, und wollen zwei Regeln Verschiedenes, bleibt der Beleg (`ruleConflict`). Eine Regel dieser Automatisierung muss treffen (`noMatch`). Anders als beim Upload kann sie auch einen Belegtyp ändern, den jemand selbst gewählt hat; die Vorschau zeigt jeden Wechsel, und geändert wird nur, was bestätigt ist. Jede Position bekommt die Kategorie, mit dem Steuersatz, den die Kategorie erlaubt, sonst ihren Vorgaben. Ohne `documentIds` sucht der `dryRun` selbst: Belege der letzten 12 Monate, nicht gelöscht, neueste zuerst. Bis zu 50, die sich ändern, stehen in `change`, mit Belegtyp und Kategorie vorher und nachher und `taxChanges`; was bleibt, zählt `skippedCounts` je Grund. `more` zählt weitere Belege, die sich ändern würden, ein `dryRun` mit `cursor` prüft sie. Gründe: festgeschriebene Belege und solche, deren Änderung einen festgeschriebenen Monat stornieren würde (`finalized`), ausgestellte Rechnungen (`issued`), an DATEV exportierte (`exported`), aus Dauerbuchungen oder Vorlagen (`linked`), mit erfasster Zahlung (`paid`), einer Zahlung oder anderen Belegen zugeordnete, deren Belegtyp die Regel wechseln würde (`matched`), noch nicht gelesene (`unread`), Reverse Charge neben der Steuerbehandlung der Kategorie (`reverseCharge`), Belege, die schon so stehen (`unchanged`), mit offenem Belegtyp (`kindReview`), zu deren Typ die Kategorie nicht passt (`otherKind`), ohne Positionen (`other`), stornierte (`deleted`), die `PATCH /api/document/{id}` ablehnen würde (`refused`, nur beim Suchen), dazu `noMatch`, `ruleConflict`, `notFound` und `notPreviewed`. Zum Übernehmen schickst du die bestätigten `documentIds` aus `change` mit ihren `expectedVersions`, ohne `documentIds` antwortet die Route mit `400` und `context.field` `documentIds`. Die Version deckt auch die Wirkung der Regeln ab: Hat sich eine Regel seitdem geändert, kommt der Beleg mit `VersionConflict` in `failed`. Jeder Beleg ändert sich mit `PATCH /api/document/{id}`, das Protokoll nennt den Schlüssel. Ein API-Schlüssel braucht `documents:write` und zusätzlich `automations:read`, sonst `403 APIKeyPermissionDenied`. Der Aufruf zählt zum Budget der Pool-Lesungen wie `POST /api/agent-rule-group/preview`. Höchstens 50 Belege je Aufruf (`400 BulkLimitExceeded`). Die Antwort nennt je Beleg, was geschah: `change` geändert, `skipped` mit Grund übersprungen, `failed` mit Code abgelehnt. Das ist ein Teilerfolg wie in der App: Ein abgelehnter Beleg hält die anderen nicht auf, und die Route antwortet mit `200`. Mit `dryRun` ändert sie nichts und zeigt, was geschähe, mit einer `version` je Beleg. Zum Ausführen gibst du diese als `expectedVersions` zurück, sonst antwortet die Route mit `400 ExpectedVersionRequired`. Es ändert sich nur, was unter `change` stand und seitdem unverändert ist: Ein geänderter Beleg kommt mit `VersionConflict` in `failed`, die übrigen laufen, und ein Beleg ohne Eintrag bleibt mit `notPreviewed` in `skipped`. Jeder Beleg läuft als eigener Befehl mit eigenem Eintrag im Protokoll und zählt einzeln auf die Tagesgrenzen der Firma und der Testphase. Der ganze Aufruf zählt einmal auf die Grenzen je Minute. Eine Wiederholung mit gleichem Idempotency-Key ändert nichts doppelt und erledigt, was noch offen ist. Sie klärt auch den Stand, wenn ein Aufruf abbricht: `OutcomeUnknown` heißt, der Beleg kann schon gebucht sein. Benötigt einen Schlüssel mit der Berechtigung `documents:write`.
Eigene Sachkonten lesen GET
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`.