„Aus Zuordnungen lernen“ ein- oder ausschalten
Benötigte Berechtigung:company:write(Firmendaten ändern)
Echte Wirkung
/api/settings/matchingKein 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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
Idempotency-Key*stringStabiler 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.
^[!-~]+$1 <= length <= 128on or off
application/json- body
Schaltet „Aus Zuordnungen lernen“.
learnRules?|Pflicht: true schaltet das Lernen ein, false aus.
Erfolg.
application/json- response
Die Einstellung „Aus Zuordnungen lernen“.
learnRules?booleantrue: 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.
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 '{}'{ "learnRules": false}