# Tagesabschluss übernehmen (https://developer.bimetrics.de/reference/cash-book/apply-cash-import)

`POST https://app.bimetrics.de/api/cash-imports/{id}/apply`

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

Bucht den Tagesabschluss so, wie `previewCashImport` ihn gezeigt hat, in einem Schritt. Ins Kassenbuch kommt nur Bargeld: der Baranteil des Umsatzes, bares Trinkgeld fürs Team und seine Auszahlung, Auszahlungen, Lohn, Geld von und zur Bank, Privatentnahmen und -einlagen, die Kassendifferenz. Kartenzahlungen buchen auf Geldtransit (SKR03 1360, SKR04 1460), als Zahlart eingelöste Mehrzweck-Gutscheine auf „Ausgegebene Geschenkgutscheine“ (1796, 3786), Trinkgeld fürs Team auf durchlaufende Posten (1590, 1370), Lohn auf „Verbindlichkeiten aus Lohn und Gehalt“ (1740, 3720). Jede Zeile bucht am Kassentag, ohne Debitor oder Kreditor und mit eigenem Buchungstext. Eine Auszahlung wartet ohne Buchung auf ihren Beleg. Die Route lehnt ab, solange eine Prüfung anhält oder fragt, wenn sich Werte oder Bestand seit der Prüfung geändert haben (`valuesHash`, `expectedBalanceMinor`), und für die Steuerberatung (`403 CashBookOwnerOnly`). Danach lässt sich der Tagesabschluss nur noch als Ganzes stornieren. Bei einer Wiederholung schickst du denselben Idempotency-Key.

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 Tagesabschlusses (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`)

values and confirmedFields of the preview with its valuesHash; expectedBalanceMinor from the preview

Schema `CashImportApplyRequest`.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `confirmedFields` | Array<string> | Die bestätigten Werte wie bei der Prüfung. |
| `expectedBalanceMinor` | integer | Pflicht: `balanceBeforeMinor` aus der Prüfung; kam inzwischen eine Buchung dazu, lehnt die Route ab. |
| `values` | ZBonConfirmed | Die Werte wie bei der Prüfung. |
| `valuesHash` | string | Pflicht: `valuesHash` aus `previewCashImport` mit denselben Werten. |

### Beispiel

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

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `balanceAfterMinor` | integer | Bestand nach der Übernahme in Cent. |
| `balanceBeforeMinor` | integer | Bestand der Kasse jetzt in Cent. |
| `checks` | Array<CashImportCheck>, kann null sein | Die Prüfungen in ihrer Reihenfolge. |
| `entries` | Array<CashImportEntry>, kann null sein | Die Einträge, die die Übernahme bucht, mit Nummer `neu`; nach der Übernahme die gebuchten. |
| `fields` | Array<CashImportField>, kann null sein | Jeder Wert mit seiner Quelle. |
| `import` | CashImport | Der Tagesabschluss. |
| `lastTipsFor` | string: `team`, `owner` | Wem das Trinkgeld beim letzten Tagesabschluss der Kasse gehörte: `team` oder `owner`; der einzige Vorschlag aus einem früheren Abschluss. |
| `ready` | boolean | `true`, wenn keine Prüfung mehr anhält oder fragt. |
| `replayed` | boolean | `true` bei einer Wiederholung mit demselben Idempotency-Key. |
| `values` | ZBonConfirmed | Die geprüften Werte; mit Änderungen an `previewCashImport` zurück oder an `applyCashImport`. |
| `valuesHash` | string | Prüfwert dieser Werte für `applyCashImport`. |

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