# Einzahlung aus der Kasse buchen (https://developer.bimetrics.de/reference/cash-book/book-cash-deposit)

`POST https://app.bimetrics.de/api/banktransaction/{id}/cash-deposit`

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

Eine Bareinzahlung kommt in einem Schritt aus dem Kassenbuch: Ein Eintrag `transit_out` bucht Geldtransit an Kasse, und der Bankumsatz wird ihm als `cash_transit` zugeordnet, also Bank an Geldtransit. Beides gelingt zusammen oder gar nicht. Es geht nur ein gebuchter, noch nicht zugeordneter Eingang in Euro, und nur, wenn der Bestand der Kasse am Kassentag und danach nicht unter null fällt. Für Kassentag, Kassensystem, Rechte und Storno gilt dasselbe wie bei `cash-in`. Sende `cashBookId`, `entryDate`, `expectedBalanceMinor` und `planHash` aus der bestätigten Vorschau, mit Header `Idempotency-Key`. Hat sich seitdem etwas geändert, antwortet die Route mit `409 CashBookRejected`.

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 Bankumsatzes der Einzahlung (UUID). |
| `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`)

cash book, cash day, balance and planHash of the preview

Schema `CashBookCashInRequest`.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `cashBookId` | string (uuid) | ID des Kassenbuchs (UUID). |
| `entryDate` | NaiveDate | Kassentag der Vorschau. |
| `expectedBalanceMinor` | integer | `balanceBeforeMinor` der Vorschau. |
| `planHash` | string | `planHash` der Vorschau. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/banktransaction/{id}/cash-deposit" \
  -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`: CashBookCashIn |
| 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 |
| 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 (`CashBookCashIn`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `balanceAfterMinor` | integer | Bestand der Kasse danach in Cent. |
| `balanceBeforeMinor` | integer | Bestand der Kasse vorher in Cent; bei `replayed` der von jetzt abzüglich des Betrags. |
| `bookings` | Array<CashBookCashInBooking>, kann null sein | Geldtransit an Bank am Tag der Wertstellung, Kasse an Geldtransit am Kassentag. |
| `cashBookId` | string (uuid) | ID des Kassenbuchs (UUID). |
| `cashBookName` | string | Name des Kassenbuchs. |
| `entry` | CashBookEntry | Der Eintrag `transit_in`; in der Vorschau heißt seine Nummer `neu`. |
| `entryDate` | NaiveDate | Der Kassentag. |
| `exportedMonths` | Array<string>, kann null sein | Monate (`JJJJ-MM`) dieser Buchungen, die DATEV schon hat. |
| `firstDate` | NaiveDate | Erster passender Kassentag. |
| `lastDate` | NaiveDate | Letzter passender Kassentag, höchstens heute. |
| `matchId` | string (uuid) | Nach dem Buchen: die Zuordnung `cash_transit`. |
| `planHash` | string | SHA-256 der Vorschau. |
| `replayed` | boolean | Wiederholung mit demselben Idempotency-Key. |
| `transaction` | CashBookCashInTransaction | Die Abhebung. |
| `waiting` | Array<CashBookCashInWaiting>, kann null sein | Offene Einträge mit diesem Betrag, die schon auf den Umsatz warten. |

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