Monat eines Kassenbuchs als PDF
Benötigte Berechtigung:read(Daten lesen)
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.
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-11.
download?string1 liefert das PDF als Download mit Dateinamen; ohne den Parameter wird es im Browser angezeigt.
Der Monat des Kassenbuchs als PDF, frisch aus den Einträgen erstellt.
response?unknownapplication/pdfcurl --fail-with-body "https://app.bimetrics.de/api/cash-books/497f6eca-6276-4993-bfeb-53cbbbba6f08/pdf?month=string" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"nullMonatsabschluss prüfen POST
Prüft, ob sich ein Monat des Kassenbuchs abschließen lässt, ohne etwas zu schreiben. `items` nennt jede Prüfung mit `ok`: `ended` (der Monat ist vorbei, in deutscher Zeit), `previous` (alle früheren Monate seit dem Beginn sind abgeschlossen), `counted` (seit dem Monatsersten wurde gezählt, auch nach Monatsende; ohne Zählung erfüllt die Stilllegung des Kassenbuchs ab dem Monatsersten den Punkt, dann steht ihr Zeitpunkt in `archivedAt`), `countAgrees` (eine maßgebliche Zählung trägt den Monat: Die Prüfung beginnt bei der letzten Zählung im Monat, ohne sie bei der ersten danach, und geht zur nächsten Zählung weiter, solange eine veraltet ist oder eine Differenz offen ließ; veraltet ist eine Zählung, wenn nach ihr ein Eintrag mit einem Kassentag bis zu ihrem Tag erfasst wurde, auch ein Storno, `lateEntryDate` nennt seinen Kassentag. Die erste gültige Zählung, die stimmte oder ihre Differenz gebucht hat, ist maßgeblich und steht in `count`; eine offene Differenz einer späteren Zählung hält den Monat dann nicht auf. Wurde das Kassenbuch nach der letzten Zählung dieser Kette stillgelegt, erfüllt die Stilllegung den Punkt bis zu ihrem Monat, mit `archivedAt`), `neverNegative` (der Bestand lag nach keiner Buchung des Monats unter 0 €) und `gapless` (die Nummern des Jahres sind bis zur letzten Buchung des Monats lückenlos). Dazu kommen Anfangs- und Endbestand, die Zahl der Einträge und der Buchungen, die der Abschluss festschreibt, und mit `bankMissing` die Einträge Bank ↔ Kasse ohne Bankumsatz, die den Abschluss nicht aufhalten. `ready` heißt: alles erfüllt und noch nicht abgeschlossen. `canClose` sagt, ob der Aufrufer abschließen darf (Inhaber und Steuerberatung). Ist der Monat schon abgeschlossen, steht der Abschluss in `closed`. Ist das Kassenbuch ausgeschaltet, steht `disabled` auf `true` und kein Monat lässt sich abschließen, bis es wieder eingeschaltet ist. Ein Monat vor dem Beginn des Kassenbuchs oder nach dem laufenden Monat ergibt `400 CashBookRejected` mit Feld `month`. Lesen dürfen alle Rollen. Benötigt einen Schlüssel mit der Berechtigung `read`.
Monat eines Kassenbuchs als Seitenbilder GET
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`.