Kassenbücher lesen
Benötigte Berechtigung:read(Daten lesen)
Liefert alle Kassenbücher der Firma, auch stillgelegte, mit Art, Name, Kassenkonto, Beginn, Anfangsbestand samt Herkunft und dem Bestand jetzt (balanceMinor, in Cent). Ohne Kassenbuch ist die Liste leer.
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]?Kassenbuch der Firma.
curl --fail-with-body "https://app.bimetrics.de/api/cash-books" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"[ { "account": 1600, "balanceMinor": 20000, "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-11-13T09:00:00Z", "id": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39", "kind": "petty", "name": "Handkasse Büro", "numberPrefix": "", "openingBalanceMinor": 20000, "openingContraAccount": 1460, "openingSource": "bank", "startDate": { "day": 10, "month": 11, "year": 2026 }, "updatedAt": "2026-11-13T09:00:00Z" }]Kassenbuch-Eintrag stornieren POST
Storniert einen Eintrag mit Grund: Ein neuer Eintrag mit eigener Nummer am selben Tag gleicht ihn aus, seine Buchungen werden gespiegelt. Bei einem Eintrag mit Beleg nimmt das Storno die Barzahlung am Beleg zurück. Jeder Eintrag lässt sich einmal stornieren, ein Storno nie. Auch nach dem Storno darf der Bestand nirgends unter 0 € fallen. Ist dem Eintrag ein Bankumsatz zugeordnet, lehnt die Route ab, bis die Zuordnung gelöst ist. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.
Kassenbuch anlegen POST
Legt ein Kassenbuch an, wie das Formular in den Einstellungen. Das Kassenbuch muss eingeschaltet sein. Pflicht sind `kind`, `name` und `startDate`, das heute oder früher liegt; ohne `account` nimmt bimetrics das nächste freie Kassenkonto. Liegt `openingBalanceMinor` über 0, ist `openingSource` Pflicht; daraus und aus Kontenrahmen und Rechtsform folgt das Gegenkonto (`openingContraAccount`), das danach fest bleibt. Art, Kassenkonto, Beginn und Anfangsbestand lassen sich später nicht mehr ändern. Eine Firma hat höchstens drei Kassenbücher gleichzeitig in Gebrauch. Verstößt die Anfrage gegen eine Regel, antwortet die Route mit `400` oder `409 CashBookRejected`, `context.field` nennt das Feld und `context.message` den Satz der App. Nur ein Inhaber darf anlegen. Benötigt einen Schlüssel mit der Berechtigung `company:write`.