# Monat abschließen (https://developer.bimetrics.de/reference/cash-book/close-cash-month)

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

operationId: `closeCashMonth` · Berechtigung (Scope): `matching:write` · Bereich: Kassenbuch

Schließt einen Monat des Kassenbuchs endgültig ab, wenn alle Prüfungen von `POST /api/cash-books/{id}/months/{month}/close/preview` erfüllt sind; sonst `409 CashBookRejected`. Monate schließen streng nacheinander, nie der laufende. Der Abschluss merkt sich die maßgebliche Zählung (`countId`). `expectedClosingMinor` und `expectedEntries` sind Pflicht: Endbestand und Zahl der Einträge aus der Prüfung. Hat sich der Monat seitdem geändert, antwortet die Route mit `409 CashBookRejected` und schließt nichts ab. Auch ein stillgelegtes Kassenbuch schließt seine Monate ab, denn der Abschluss bewegt kein Geld. Danach geht keine Buchung und keine Barzahlung am Beleg mehr in diesen Monat (`400 CashBookRejected`, Feld `entryDate`). Ein Storno einer Buchung aus dem Monat kommt mit heutigem Datum und einer Nummer seines Jahres in den laufenden Monat und verweist auf das Original. Alle noch offenen Buchungen der Einträge des Monats werden festgeschrieben (`finalizedBy` `cashbook`), auch die der Barzahlungen an Belegen. Zurücknehmen lässt sich der Abschluss nicht. Abschließen dürfen Inhaber und Steuerberatung, nicht der Nutzer (`403 CashBookOwnerOnly`). Bei einer Wiederholung schickst du denselben Idempotency-Key und bekommst den geschriebenen Abschluss.

Benötigt einen Schlüssel mit der Berechtigung `matching:write`.

> **Achtung:** Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
>
> KI-Agenten fragen vor diesem Aufruf beim Nutzer nach.

### 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`. |
| `Idempotency-Key` | header | ja | string | Stabiler Schlüssel für genau diese Änderung: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Bei Wiederholungen denselben Schlüssel und unveränderten Inhalt senden; das Ergebnis wird nicht nochmals erzeugt. |

### Request-Body (`application/json`)

expectedClosingMinor from the preview

Schema `CashMonthCloseRequest`.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `expectedClosingMinor` | integer | Pflicht: `closingMinor` der Prüfung, in Cent. Weicht der Endbestand ab, antwortet die Route mit `409 CashBookRejected` und schließt nichts ab. |
| `expectedEntries` | integer | Pflicht: `entries` der Prüfung. Weicht die Zahl der Einträge ab, etwa nach einem Storno, antwortet die Route mit `409 CashBookRejected` und schließt nichts ab. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/cash-books/{id}/months/{month}/close" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY" \
  -H "Idempotency-Key: rechnung-2026-001" \
  -H "Content-Type: application/json" \
  -d '{"kind":"and","children":[],"limit":50,"offset":0}'
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: CashMonthCloseResult |
| 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 |
| 409 | Versionskonflikt (`VersionConflict`), abweichender Inhalt für denselben Idempotency-Key (`IdempotencyConflict`), Dublette (`ContactDuplicate`) oder fachlich gesperrte Änderung. Aktuellen Zustand laden und prüfen; keinen anderen Schlüssel verwenden, um einen Konflikt zu umgehen. | `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 (`CashMonthCloseResult`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `finalized` | integer | Zahl der Buchungen, die der Abschluss festgeschrieben hat. |
| `period` | CashBookPeriod | Der Abschluss. |

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