# Korrektur eines Kassenbuch-Eintrags prüfen (https://developer.bimetrics.de/reference/cash-book/preview-cash-book-correction)

`POST https://app.bimetrics.de/api/cash-book-entries/{id}/correct/preview`

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

Prüft eine Korrektur wie `correctCashBookEntry` und zeigt das Storno und den richtigen Eintrag mit ihren Buchungen und dem Bestand danach, ohne etwas zu schreiben. Eine Nummer haben beide erst beim Buchen. Korrigieren lässt sich ein eigener Eintrag ohne Beleg: Ausgabe, Privateinlage, Privatentnahme und Geld von oder zur Bank. Eine Barzahlung zu einem Beleg (auch jede Einnahme), eine Zeile eines Tagesabschlusses, ein Anfangsbestand, eine Kassendifferenz und ein Storno nicht (`409 CashBookRejected`); dort bleibt das Storno. Das Storno trägt den Kassentag des Eintrags, nach dem Monatsabschluss den heutigen Tag. Der richtige Eintrag nimmt den Tag aus `entry`, nur in einem offenen Monat. Auch nach beiden darf der Bestand nirgends unter 0 € fallen. 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 Eintrags (UUID). |

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

the right values and the reason

Schema `CashBookCorrectEntryRequest`.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `entry` | CashBookEntryRequest | Der richtige Eintrag, wie bei `createCashBookEntries`, ohne Beleg. |
| `expectedBalanceMinor` | integer | Der zuletzt gelesene Bestand vor der Korrektur in Cent, aus der Monatsansicht oder `listCashBooks`, nicht `balanceMinor` der Vorschau. Hat er sich seitdem geändert, antwortet die Route mit `409 CashBookRejected`. |
| `reason` | string | Pflicht: was am Eintrag falsch war, höchstens 120 Zeichen. Er steht am Storno. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/cash-book-entries/{id}/correct/preview" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"and","children":[],"limit":50,"offset":0}'
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: CashBookEntriesResult |
| 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 diesen Endpunkt (`APIKeyPermissionDenied`, `context.scope` nennt sie; Berechtigungen sind fest: neuen Schlüssel anlegen, austauschen, alten widerrufen), der Endpunkt ist für API-Schlüssel nicht freigegeben (`APIKeyPermissionDenied` ohne `context.scope`), 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 (`CashBookEntriesResult`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `balanceMinor` | integer | Geld in der Kasse danach, in Cent. |
| `bookings` | Array<CashBookEntryBooking> | Nur in der Vorschau: die Buchungszeilen der Einträge ohne Beleg. |
| `entries` | Array<CashBookEntry>, kann null sein | Die Einträge; bei einer Wiederholung mit demselben Idempotency-Key leer. |
| `exported` | boolean | Nur in der Vorschau: `true`, wenn ein Eintrag in einem Zeitraum liegt, der schon an DATEV exportiert ist. Er kommt dann erst mit, wenn die Firma den Monat noch einmal exportiert. |
| `exportedMonths` | Array<string> | Nur in der Vorschau einer Korrektur: die schon an DATEV exportierten Monate (JJJJ-MM), in die Storno oder richtige Buchung fallen. |
| `replayed` | boolean | `true` bei einer Wiederholung. |

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