bimetricsEntwickler
Kassenbuch

Prüfungsexport eines Kassenbuchs

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/cash-books/{id}/audit-export

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.

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

Query-Parameter

year*integer

Kalenderjahr, etwa 2026. Enthalten sind die Monate, in denen das Kassenbuch in diesem Jahr geführt wurde, im laufenden Jahr bis zum aktuellen Monat.

download?string

1 liefert die Datei als Download mit Dateinamen.

Antworten

Eine ZIP-Datei mit buchungen.csv, je Monat Kassenbuch-JJJJ-MM.pdf, aenderungsprotokoll.csv und LIESMICH.txt.

response?unknownapplication/zip
Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/cash-books/497f6eca-6276-4993-bfeb-53cbbbba6f08/audit-export?year=0" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
null

Kassenbuch stilllegen POST

Legt ein Kassenbuch still. Das geht nur, wenn kein Geld mehr darin ist (`balanceMinor` 0), sonst `409 CashBookRejected`. Es bleibt lesbar, sein Kassenkonto wird frei für ein neues Kassenbuch. Zurückholen lässt es sich nicht. Ist es schon stillgelegt, ändert sich nichts. Benötigt einen Schlüssel mit der Berechtigung `company:write`.

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