Monat eines Kassenbuchs als Seitenbilder
Benötigte Berechtigung:read(Daten lesen)
Liefert dasselbe PDF wie GET /api/cash-books/{id}/pdf als Base64 (pdf) und seine Seiten als PNG-Bilder (pages), höchstens die ersten 20. So lässt sich ein Monat lesen, bevor man ihn abschließt, ohne PDF-Anzeige. Bei einem abgeschlossenen Monat steht im PDF die Zählung, auf die sich der Abschluss stützt, als „Zählung zum Abschluss“. Ein Monat vor dem Beginn des Kassenbuchs oder nach dem laufenden Monat ergibt 400 CashBookRejected mit Feld month. Abrufen dürfen es alle Rollen.
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).
uuidmonth*stringMonat als JJJJ-MM, etwa 2026-10.
Erfolg.
application/json- response
Ein Monat des Kassenbuchs als PDF und als Seitenbilder.
pages?array<>|Die Seiten des PDF als PNG-Bilder in ihrer Reihenfolge, höchstens die ersten 20.
pdf?Das PDF wie GET /api/cash-books/{id}/pdf.
curl --fail-with-body "https://app.bimetrics.de/api/cash-books/497f6eca-6276-4993-bfeb-53cbbbba6f08/pdf/pages?month=string" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "pages": [ { "content": "iVBORw0KGgo=", "mime": "image/png" } ], "pdf": { "dataBase64": "JVBERi0xLjcK", "filename": "Kassenbuch-Handkasse-Büro-2026-10.pdf", "mime": "application/pdf" }}Monat eines Kassenbuchs als PDF GET
Liefert einen Monat des Kassenbuchs als PDF, zum Ausdrucken oder Weitergeben, etwa an die Steuerberatung. Das PDF enthält Firma, Kasse, Kassenkonto und Monat, den Bestand am Monatsanfang und am Monatsende, Einnahmen und Ausgaben sowie jede Buchung mit Datum, Nummer, Text, Betrag und dem Bestand danach. Ein Storno steht mit eigener Nummer im PDF und verweist auf die stornierte Buchung; diese bleibt durchgestrichen sichtbar. Darunter stehen die Zählungen des Monats mit Zeitpunkt, Person, Stückelung und Ergebnis; bei einem abgeschlossenen Monat nennt das PDF Tag und Person des Abschlusses und vorweg die Zählung, auf die er sich stützt („Zählung zum Abschluss“), nach Monatsende mit Endbestand und den Buchungen bis zur Zählung. Das PDF wird bei jedem Aufruf neu aus den Einträgen erzeugt; sind Buchungen des Monats schon an DATEV übergeben, steht das im PDF. Ein Monat vor dem Beginn des Kassenbuchs oder nach dem laufenden Monat ergibt `400 CashBookRejected` mit Feld `month`. Abrufen dürfen es alle Rollen. Benötigt einen Schlüssel mit der Berechtigung `read`.
Kassenbuch-Einstellung lesen GET
Sagt, ob die Firma das Kassenbuch verwendet (`enabled`), ob der Schlüssel bzw. die Person es ändern darf (`canChange`, nur Inhaber) und darin buchen darf (`canBook`, nicht die Steuerberatung), wie viele Kassenbücher in Gebrauch sind (`inUse`) und welche Kassenkonten ein neues Kassenbuch nehmen kann (`accounts`, das nächste freie zuerst). `deposit` sagt, wie eine Einlage in die Kasse gebucht wird: `owner` als Privateinlage, `shareholder` über das Gesellschafter-Verrechnungskonto; leer, wenn die Rechtsform fehlt oder keine Einlage kennt. Benötigt einen Schlüssel mit der Berechtigung `read`.