# Monatsabschluss prüfen (https://developer.bimetrics.de/reference/cash-book/preview-cash-month-close)

`POST https://app.bimetrics.de/api/cash-books/{id}/months/{month}/close/preview`

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

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

### 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` | path | ja | string | Monat als `JJJJ-MM`, etwa `2026-10`. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/cash-books/{id}/months/{month}/close/preview" -X POST \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: CashMonthCloseCheck |
| 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 |

#### Felder der Antwort 200 (`CashMonthCloseCheck`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `bankMissing` | integer | Zahl der Einträge Bank ↔ Kasse des Monats, denen der Bankumsatz noch fehlt. Sie halten den Abschluss nicht auf, zuordnen lässt er sich auch danach. Fehlt bei 0 und bei einem abgeschlossenen Monat. |
| `canClose` | boolean | `true` für Inhaber und Steuerberatung: Sie dürfen abschließen. |
| `closed` | CashBookPeriod | Der Abschluss, wenn der Monat schon abgeschlossen ist; die Prüfungen zeigen dann den Stand beim Abschluss. |
| `closingMinor` | integer | Bestand nach dem Monat, in Cent; als `expectedClosingMinor` beim Abschließen mitschicken. |
| `disabled` | boolean | `true`, wenn das Kassenbuch ausgeschaltet ist: Dann lässt sich kein Monat abschließen, `ready` ist `false`. Fehlt sonst. |
| `entries` | integer | Zahl der Einträge des Monats, Stornos eingeschlossen; als `expectedEntries` beim Abschließen mitschicken. |
| `finalize` | integer | Zahl der noch offenen Buchungen, die der Abschluss festschreibt. |
| `items` | Array<CashMonthCloseCheckItem>, kann null sein | Die Prüfungen in fester Reihenfolge. |
| `month` | string | Der Monat als `JJJJ-MM`. |
| `openingMinor` | integer | Bestand vor dem Monat, in Cent. |
| `ready` | boolean | `true`, wenn alle Prüfungen erfüllt sind und der Monat noch offen ist. |

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