bimetricsEntwickler
Kassenbuch

Monat eines Kassenbuchs als Seitenbilder

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/cash-books/{id}/pdf/pages

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.

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

month*string

Monat als JJJJ-MM, etwa 2026-10.

Antworten

Erfolg.

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

Beispielanfrage
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"
Beispielantwort
{  "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`.