# Tagesabschluss prüfen (https://developer.bimetrics.de/reference/cash-book/preview-cash-import)

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

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

Prüft einen gelesenen Tagesabschluss und zeigt, was die Übernahme buchen würde, ohne etwas zu schreiben: die Einträge mit ihren Buchungen am Kassentag, den Bestand danach, zu jedem Wert seine Quelle (`fields`) und die Prüfungen (`checks`). Ohne `values` nimmt die Prüfung die gelesenen Werte. Danach schickst du `values` aus der Antwort mit Änderungen zurück, wählst die Art jeder Bewegung, ergänzt Bewegungen, die der Z-Bon nicht druckt (`source: manual`), und nennst in `confirmedFields` die unsicheren Werte, die der Nutzer so bestätigt hat. `ready` ist `true`, wenn nichts mehr anhält oder fragt; `valuesHash` und `balanceBeforeMinor` gehen dann an `applyCashImport`. Steuersätze kommen nur aus dem Z-Bon, nie aus früheren Belegen. Ist der Tagesabschluss schon übernommen, liefert die Route seine Werte und Einträge.

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 Tagesabschlusses (UUID). |

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

values as the preview gave them, with changes, chosen kinds, added movements and answers; confirmedFields

Schema `CashImportRequest`.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `confirmedFields` | Array<string> | Pfade der unsicheren Werte, die der Nutzer so bestätigt hat, wie sie gelesen wurden, etwa `zNumber`, `payments.card` oder `movements.0.kind` (`path` in `fields`); `movements`, wenn er bei einem nicht lesbaren Z-Bon geantwortet hat, dass keine Ein- oder Auszahlungen darauf stehen. |
| `values` | ZBonConfirmed | Die Werte aus `previewCashImport` mit Änderungen, gewählten Arten, ergänzten Bewegungen und Antworten; ohne sie gelten die gelesenen Werte. |

### Beispiel

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