bimetricsEntwickler
Kassenbuch

Kasse zählen

Als Markdown ansehen

Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
post/api/cash-books/{id}/counts

Kein 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.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Pfadparameter

id*string

ID des Kassenbuchs (UUID).

Formatuuid

Header-Parameter

Idempotency-Key*string

Stabiler 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.

Muster^[!-~]+$
Länge1 <= length <= 128

Request-Body

the count; expectedBalanceMinor from the last read

application/json
  1. 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?integer

Der 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?string

Bei einer Differenz Pflicht: woher sie kommt, höchstens 120 Zeichen; steht im Buchungstext.

resolution?string

Bei einer Differenz Pflicht: booked bucht sie als Kassenfehlbetrag oder Kassenüberschuss, later lässt sie offen, weil eine fehlende Buchung sie erklärt.

Wert in"booked""later"
totalMinor?integer

Ohne denominations Pflicht: das gezählte Geld in Cent, höchstens 100000000.

Antworten

Erfolg.

application/json
  1. response

Gespeicherte oder geprüfte Zählung.

balanceMinor?integer

Bestand 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.

Beispielanfrage
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 '{}'
Beispielantwort
{  "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"  }}