# Monat eines Kassenbuchs als PDF (https://developer.bimetrics.de/reference/cash-book/download-cash-book-pdf)

`GET https://app.bimetrics.de/api/cash-books/{id}/pdf`

operationId: `downloadCashBookPDF` · Berechtigung (Scope): `read` · Bereich: Kassenbuch

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

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

### Parameter

| Name | Ort | Pflicht | Typ | Beschreibung |
| --- | --- | --- | --- | --- |
| `id` | path | ja | string (uuid) | ID des Kassenbuchs (UUID). |
| `month` | query | ja | string | Monat als `JJJJ-MM`, etwa `2026-11`. |
| `download` | query | nein | string | `1` liefert das PDF als Download mit Dateinamen; ohne den Parameter wird es im Browser angezeigt. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/cash-books/{id}/pdf" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Der Monat des Kassenbuchs als PDF, frisch aus den Einträgen erstellt. | `application/pdf`: string (binary) |
| 400 | Ungültige Anfrage, z. B. ein Parameter mit ungültigem Wert wie eine ID, die keine UUID ist; korrigieren statt wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |
| 401 | Kein gültiger Schlüssel: fehlt (`Unauthorized`), ist unbekannt, abgelaufen oder widerrufen oder wurde nicht in genau einem Header gesendet (`InvalidAPIKey`). Schlüssel prüfen, nicht wiederholen. Auch eine ID, die zu einer anderen Firma gehört, ergibt `401 Unauthorized`. | `application/json`: Error |
| 403 | Dem Schlüssel fehlt die Berechtigung für diese Route (`APIKeyPermissionDenied`), oder die Firma hat keinen API-Zugang (mehr), etwa nach Ende der Testphase oder des Abos (`APIUnavailable`). | `application/json`: Error |
| 404 | Nicht gefunden (`NotFound`). | `application/json`: Error |
| 413 | Die Anfrage ist zu groß (`APIRequestTooLarge`), siehe `x-bimetrics-limits`. | `application/json`: Error |
| 429 | Zu viele Anfragen; nach `Retry-After` Sekunden erneut senden. Mehr unter [Fehler](https://developer.bimetrics.de/errors). (Header: Retry-After) | `application/json`: Error |
| 500 | Serverfehler; die Anfrage später wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |

Verschachtelte Schemas stehen vollständig in der OpenAPI-Beschreibung: https://app.bimetrics.de/api/openapi.json
