Kassenzählung prüfen
Benötigte Berechtigung:read(Daten lesen)
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.
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).
uuidthe count: pieces per denomination in cents, or the total
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/preview" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'{ "balanceMinor": 14850, "bookings": [ { "account": 1600, "accountContra": 6300, "amountMinor": -150, "text": "Kassenfehlbetrag laut Zählung: Wechselgeld falsch herausgegeben" } ], "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": "booked", "totalMinor": 14850, "updatedAt": "2026-11-14T17:30:00Z" }, "entry": { "amountMinor": -150, "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-11-13T09:05:00Z", "entryDate": { "day": 12, "month": 11, "year": 2026 }, "id": "3f1d2c7a-8b9e-4a51-b6c2-0e4f8a9d7b13", "kind": "difference", "number": "neu", "origin": "api", "text": "Kassenfehlbetrag laut Zählung: Wechselgeld falsch herausgegeben", "updatedAt": "2026-11-13T09:05:00Z", "year": 2026 }}Kasse zählen POST
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`.
Monat eines Kassenbuchs lesen GET
Liefert einen Monat des Kassenbuchs: den Bestand davor (`openingMinor`) und danach (`closingMinor`) und die Tage mit Einträgen, je mit Anfangs- und Endbestand. Die Einträge eines Tages stehen in der Reihenfolge ihrer Erfassung. Jeder Eintrag hat eine Nummer, die je Kassenbuch und Jahr lückenlos zählt (`KB-2026-0001`, bei weiteren Kassenbüchern `KB-A-2026-0001`). Einträge werden nie geändert oder gelöscht; ein Fehler wird storniert. Benötigt einen Schlüssel mit der Berechtigung `read`.