bimetricsEntwickler
Zuordnungen

„Aus Zuordnungen lernen“ ein- oder ausschalten

Als Markdown ansehen

Benötigte Berechtigung:company:write(Firmendaten ändern)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
put/api/settings/matching

Kein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.

Schaltet für die Firma, ob bimetrics aus Zuordnungen lernt, wie der Schalter in Einstellungen › Buchhaltung der App. Der Schalter gilt für App, API und MCP. Schon gelernte Regeln bleiben aktiv. learnRules ist Pflicht, ohne das Feld kommt 400. Für eine Wiederholung schickst du denselben Idempotency-Key.

Benötigt einen Schlüssel mit der Berechtigung company:write.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Header-Parameter

Idempotency-Key*string

Stabiler Schlüssel für genau diese Änderung: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Bei Wiederholungen denselben Schlüssel und unveränderten Inhalt senden; das Ergebnis wird nicht nochmals erzeugt.

Muster^[!-~]+$
Länge1 <= length <= 128

Request-Body

on or off

application/json
  1. body

Schaltet „Aus Zuordnungen lernen“.

learnRules?|

Pflicht: true schaltet das Lernen ein, false aus.

Antworten

Erfolg.

application/json
  1. response

Die Einstellung „Aus Zuordnungen lernen“.

learnRules?boolean

true: Aus einer Zuordnung, die jemand in der App oder über MCP selbst anlegt, lernt bimetrics eine Regel und ordnet damit weitere offene Posten von allein zu. false: bimetrics lernt aus keiner Zuordnung; schon gelernte Regeln bleiben aktiv.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/settings/matching" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "learnRules": false}