Kasse zählen
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/cash-books/{id}/countsKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Speichert eine Zählung der Kasse (Kassensturz) mit heutigem Datum: das gezählte Geld je Schein und Münze (denominations) oder nur die Summe (totalMinor), den Bestand laut Kassenbuch und die Differenz. Stimmt beides überein, bucht die Zählung nichts. Bei einer Differenz sind resolution und reason Pflicht: later, wenn eine fehlende Buchung sie erklärt, etwa ein Beleg, der noch kommt; die Zählung bucht dann nichts und die Buchung folgt wie jede andere. booked bucht die Differenz als Kassenfehlbetrag oder Kassenüberschuss mit eigener Nummer am heutigen Tag, ohne Umsatzsteuer, gegen Sonstige betriebliche Aufwendungen bzw. Erträge (SKR03 4900 bzw. 8603, SKR04 6300 bzw. 4830). Ein Überschuss aus einer bar bezahlten Rechnung, die noch nicht erfasst ist, ist eine Einnahme mit Umsatzsteuer und kein Überschuss: Dann gilt later, und die Zahlung wird am Beleg gebucht. Zählungen werden nie geändert oder gelöscht. expectedBalanceMinor schützt vor einer Änderung dazwischen. Zählen dürfen Inhaber und Nutzer, nicht die Steuerberatung (403 CashBookOwnerOnly). Bei einer Wiederholung schickst du denselben Idempotency-Key.
Benötigt einen Schlüssel mit der Berechtigung matching:write.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID des Kassenbuchs (UUID).
uuidIdempotency-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 <= 128the count; expectedBalanceMinor from the last read
application/json- body
Zählung der Kasse.
denominations?Stück je Schein und Münze, nie zusammen mit totalMinor. Der Schlüssel ist der Wert in Cent: 50000, 20000, 10000, 5000, 2000, 1000, 500 für Scheine, 200, 100, 50, 20, 10, 5, 2, 1 für Münzen; je höchstens 100000 Stück. Fehlt es, gilt totalMinor.
expectedBalanceMinor?integerDer zuletzt gelesene Bestand in Cent, etwa count.expectedMinor der Vorschau; bei booked Pflicht. Weicht der Bestand ab, antwortet die Route mit 409 CashBookRejected und speichert nichts.
reason?stringBei einer Differenz Pflicht: woher sie kommt, höchstens 120 Zeichen; steht im Buchungstext.
resolution?stringBei einer Differenz Pflicht: booked bucht sie als Kassenfehlbetrag oder Kassenüberschuss, later lässt sie offen, weil eine fehlende Buchung sie erklärt.
"booked""later"totalMinor?integerOhne denominations Pflicht: das gezählte Geld in Cent, höchstens 100000000.
Erfolg.
application/json- response
Gespeicherte oder geprüfte Zählung.
balanceMinor?integerBestand laut Kassenbuch danach, in Cent. Bei later bleibt er, bis die fehlende Buchung erfasst ist.
bookings?array<>|Die Buchungszeile der Differenz; leer ohne Buchung.
count?Die Zählung.
entry?Bei booked der Eintrag der Differenzbuchung; in der Vorschau mit Nummer neu.
curl --fail-with-body "https://app.bimetrics.de/api/cash-books/497f6eca-6276-4993-bfeb-53cbbbba6f08/counts" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "balanceMinor": 15000, "bookings": [], "count": { "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-11-14T17:30:00Z", "day": { "day": 14, "month": 11, "year": 2026 }, "denominations": { "50": 3, "200": 1, "500": 1, "2000": 2, "5000": 2 }, "differenceMinor": -150, "expectedMinor": 15000, "id": "5b8e1f3a-2c4d-4e6f-9a1b-7d3c5e9f2a48", "origin": "api", "reason": "Wechselgeld falsch herausgegeben", "resolution": "later", "totalMinor": 14850, "updatedAt": "2026-11-14T17:30:00Z" }}Prüfungsexport eines Kassenbuchs GET
Liefert den Prüfungsexport eines Kassenbuchs für ein Kalenderjahr als ZIP, gedacht für die Betriebsprüfung. `buchungen.csv` enthält jeden Eintrag mit Erfassungszeit, Storno-Verweisen, Angaben zum Eigenbeleg, Herkunft und Bestand danach (UTF-8 mit BOM, Semikolon). Dazu kommen je Monat ein PDF, dasselbe wie von `GET /api/cash-books/{id}/pdf`, und `aenderungsprotokoll.csv` mit jedem protokollierten Vorgang am Kassenbuch und an diesen Einträgen, im selben Format. Das Protokoll nennt zu jedem Vorgang das Teammitglied mit Vor- und Nachname und Mitglieds-ID. Lief der Vorgang über API oder MCP, steht in der Spalte `via` zusätzlich der API-Schlüssel oder die verbundene Anwendung, jeweils mit Name und ID. `LIESMICH.txt` nennt den Bestand am Anfang und am Ende des Zeitraums, beschreibt die Spalten beider CSV-Dateien und nennt die SHA-256-Prüfsumme jeder weiteren Datei. Die ZIP-Datei wird bei jedem Aufruf neu erzeugt und nicht gespeichert. Ein Jahr, in dem das Kassenbuch nicht geführt wurde, ergibt `400 CashBookRejected` mit Feld `year`. Alle Rollen dürfen den Export abrufen. Benötigt einen Schlüssel mit der Berechtigung `read`.
Kassenzählung prüfen POST
Vergleicht eine Zählung wie `POST /api/cash-books/{id}/counts` mit dem Bestand und sagt, was das Speichern buchen würde, ohne etwas zu schreiben. Die Nummer einer Differenzbuchung heißt in der Vorschau `neu`. Benötigt einen Schlüssel mit der Berechtigung `read`.