bimetricsEntwickler
Kassenbuch

Kassenzählung prüfen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

POST
/api/cash-books/{id}/counts/preview

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.

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

Request-Body

the count: pieces per denomination in cents, or the total

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/preview" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "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`.