# Offene Buchungen vor dem DATEV-Export zählen (https://developer.bimetrics.de/reference/accounting/count-datev-open-bookings)

`POST https://app.bimetrics.de/api/export/datev/open`

operationId: `countDatevOpenBookings` · Berechtigung (Scope): `datev:export` · Bereich: Buchhaltung

Zählt die offenen, also noch nicht festgeschriebenen Buchungen, die ein DATEV-Export dieses Zeitraums festschreiben würde. Das Zählen selbst schreibt nichts fest. Vorher bucht bimetrics, was noch nicht gebucht ist, so wie der Export selbst. Die Zahl gibst du beim Start als `open` mit. Ändert sich bis dahin etwas, schreibt `startDatevExport` nichts fest und antwortet mit der neuen Zahl. Gezählt wird immer für den Buchungsstapel; `documents`, `protocol`, `open` und `all` sind beim Zählen ohne Bedeutung. Beide Tage liegen im selben Kalenderjahr (sonst `400 DatevExportYears`).

Benötigt einen Schlüssel mit der Berechtigung `datev:export`.

> **Achtung:** Dieser Aufruf ist nicht als rein lesend gekennzeichnet und kann echte Daten in der Firma anlegen oder ändern. Es gibt keine Testumgebung.
>
> KI-Agenten fragen vor diesem Aufruf beim Nutzer nach.

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

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

Period and parts

Schema `DatevExportRequest`.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `all` | boolean | Statt `open`: festschreiben, was beim Lauf des Exports offen ist, ohne Vergleich mit einer gezählten Zahl. Nur bewusst einsetzen. |
| `bookings` | boolean | Buchungsstapel (EXTF): schreibt die offenen Buchungen des Zeitraums fest. Das lässt sich nicht rückgängig machen. |
| `documents` | boolean | Belege des Zeitraums als Dateien. |
| `from` | string | Erster Tag, `YYYY-MM-DD`. |
| `onlyNew` | boolean | Nur, was DATEV noch nicht bekommen hat, wie „Nur noch nicht exportierte“ in der App, dort vorgewählt. Fehlt `onlyNew` oder ist es `false`, enthält der Export alle Buchungen des Zeitraums, auch schon exportierte. Importiert die Kanzlei beide Dateien, stehen sie in DATEV doppelt. Nimm `false` nur, wenn die Kanzlei den alten Stapel verworfen hat. |
| `open` | integer, kann null sein | Mit `bookings` Pflicht beim Start, außer mit `all`: die Zahl offener Buchungen aus `countDatevOpenBookings`. Beim Zählen ohne Bedeutung. |
| `protocol` | boolean | Änderungsprotokoll als CSV (`Aenderungsprotokoll.csv`): alle Änderungen an den exportierten Belegen, Umsätzen und Zuordnungen. |
| `to` | string | Letzter Tag, `YYYY-MM-DD`, nicht vor `from` und im selben Kalenderjahr. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/export/datev/open" \
  -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`: DatevOpenBookings |
| 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 |
| 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 (`DatevOpenBookings`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `assetDepreciation` | string | Nur mit Anlagen und Buchungen, solange offen ist, ob die Kanzlei die Abschreibungen selbst in DATEV rechnet: der Satz dazu. Bis zur Antwort (`PUT /api/settings/datev`) gehen laufende Abschreibungen, GWG und Restwerte beim Abgang nicht an DATEV. |
| `open` | integer | Anzahl; beim Start als `open` mitgeben. |

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