Kassenbuch ein- oder ausschalten
Benötigte Berechtigung:company:write(Firmendaten ändern)
Echte Wirkung
/api/settings/cash-bookKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Schaltet das Kassenbuch für die Firma ein oder aus, wie der Schalter „Kassenbuch verwenden“ in den Einstellungen. Eingeschaltet sieht das ganze Team den Menüpunkt Kassenbuch. Ausschalten geht erst, wenn kein Kassenbuch mehr in Gebrauch ist, sonst 409 CashBookRejected. Nur ein Inhaber darf schalten, sonst 403 CashBookOwnerOnly. Bei einer 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
Kassenbuch ein- oder ausschalten.
enabled?booleantrue schaltet das Kassenbuch ein, false aus.
Erfolg.
application/json- response
Ob die Firma das Kassenbuch verwendet und was der Aufrufer damit darf.
accounts?array<integer>|Kassenkonten, die ein neues Kassenbuch nehmen kann, das nächste freie zuerst; leer, wenn drei Kassenbücher in Gebrauch sind.
ask?booleantrue, solange die App den Inhaber in „Erste Schritte“ fragt, ob die Firma eine Kasse mit Bargeld hat. Gefragt werden nur Firmen, die sich registriert haben, seit es das Kassenbuch gibt; bei älteren bleibt das Feld false. Die Frage entfällt, sobald ein Inhaber das Kassenbuch ein- oder ausschaltet.
canBook?booleantrue für Inhaber und Nutzer: Sie dürfen buchen und stornieren, im Kassenbuch und mit „Bar“ am Beleg. Die Steuerberatung liest nur.
canChange?booleantrue für Inhaber: Sie dürfen das Kassenbuch ein- und ausschalten und Kassenbücher anlegen, umbenennen und stilllegen.
deposit?stringWie eine Einlage in die Kasse gebucht wird: owner als Privateinlage, shareholder über das Gesellschafter-Verrechnungskonto. Leer, wenn die Rechtsform fehlt oder keine Einlage kennt.
enabled?booleantrue, wenn die Firma das Kassenbuch verwendet; die App zeigt dann den Menüpunkt Kassenbuch.
inUse?integerZahl der Kassenbücher, die nicht stillgelegt sind. Solange es eins gibt, lässt sich das Kassenbuch nicht ausschalten.
curl --fail-with-body "https://app.bimetrics.de/api/settings/cash-book" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "accounts": [ 1600, 1610, 1620 ], "ask": false, "canBook": true, "canChange": true, "deposit": "shareholder", "enabled": true, "inUse": 0}Kassenbuch-Einstellung lesen GET
Sagt, ob die Firma das Kassenbuch verwendet (`enabled`), ob der Schlüssel bzw. die Person es ändern darf (`canChange`, nur Inhaber) und darin buchen darf (`canBook`, nicht die Steuerberatung), wie viele Kassenbücher in Gebrauch sind (`inUse`) und welche Kassenkonten ein neues Kassenbuch nehmen kann (`accounts`, das nächste freie zuerst). `deposit` sagt, wie eine Einlage in die Kasse gebucht wird: `owner` als Privateinlage, `shareholder` über das Gesellschafter-Verrechnungskonto; leer, wenn die Rechtsform fehlt oder keine Einlage kennt. Benötigt einen Schlüssel mit der Berechtigung `read`.
Kostenstellen lesen GET
Liefert alle Kostenstellen und Verteilungen der Firma, auch archivierte, jeweils mit der Zahl der Belege (`documents`). `used` sagt, ob ein Beleg oder eine Buchung sie schon trägt, direkt oder über eine Verteilung: Dann stehen Nummer und Anteile fest. Benötigt einen Schlüssel mit der Berechtigung `read`.