# DATEV-Export zusammenfassen (https://developer.bimetrics.de/reference/accounting/get-datev-export-summary)

`GET https://app.bimetrics.de/api/export/datev/summary`

operationId: `getDatevExportSummary` · Berechtigung (Scope): `read` · Bereich: Buchhaltung

Fasst zusammen, was ein DATEV-Export des Jahres jetzt enthielte, je Monat: wie viele Buchungen es gibt, wie viele davon noch nicht in DATEV sind, wie viele der Export enthält und festschreibt, die Belege und die ungeklärten Bankumsätze. Die Zusammenfassung bucht nichts und schreibt nichts fest. Sie wählt aus wie der Export: Anlagenbuchungen, die er zurückhält, Buchungen, die auf einen Euro-Betrag warten, und mit `onlyNew` Belege und Umsätze, die DATEV schon mit einem früheren Kontenrahmen oder Steuerstatus hat, zählen nicht mit. Buchungen eines nicht zugestellten Exports gelten als noch nicht exportiert. `totals` nennt, was ein Export des ganzen Zeitraums enthält und festschreibt. Für einen Export einzelner Monate summierst du deren `inExport` und `open`. Das stimmt, solange ein Paar aus Buchung und Storno auf einem Konto, das DATEV nicht mehr annimmt, im selben Monat liegt; liegt es über eine Monatsgrenze, nimmt der Export nur eines Monats seine Hälfte in den Stapel. `documents` der Monate summierst du nicht, denn ein Beleg mit Buchungen in mehreren Monaten zählt in jedem. Die Belege einzelner Monate ergeben sich aus `totals.documentMonths`: die Summe der `count`, deren `months` einen der Monate enthalten. Was noch nicht gebucht ist, bucht erst `countDatevOpenBookings`; dessen Zahl kann deshalb etwas höher liegen.

Ohne `from` und `to` steht in `previousYear`, wie viele Nachträge es im Vorjahr seit dessen letztem Export gibt. Welche das sind, liefert dieselbe Route für das Vorjahr mit `since`: Dann zählen nur Buchungen, deren Tag im Zeitraum eines zugestellten Exports liegt und die nach `since` erfasst wurden. Was in einem nie exportierten Monat liegt, zählt nicht, auch wenn es später erfasst wurde. Die `addenda` der Monate ergeben zusammen `previousYear.addenda`; `previousYear` selbst ist `null`.

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 |
| --- | --- | --- | --- | --- |
| `year` | query | ja | integer | Kalenderjahr, Pflicht. |
| `from` | query | nein | string | Optional mit `to`: erster Buchungstag im Jahr, `YYYY-MM-DD`. Dann zählen nur die Tage von `from` bis `to`. |
| `to` | query | nein | string | Optional mit `from`: letzter Buchungstag im Jahr, `YYYY-MM-DD`. |
| `onlyNew` | query | nein | boolean | Umfang wie beim Export: `true` heißt „Nur was noch nicht exportiert ist“. Fehlt der Wert, zählt alles im Zeitraum, wie beim Export per API. |
| `parts` | query | nein | string | Teile des Exports, durch Komma getrennt: `bookings`, `documents`, `protocol`. Ohne Angabe Buchungen und Belege. |
| `offset` | query | nein | integer | Erste Buchung je Monat in `items`, ab 0. |
| `limit` | query | nein | integer | Höchstens so viele Buchungen je Monat in `items`, 0 bis 100, Standard 6. |
| `since` | query | nein | string | Optional, Zeitpunkt nach RFC 3339, URL-kodiert: Dann zählen nur Nachträge, die danach erfasst wurden, zusammen mit `onlyNew=true`; ohne zählen auch Buchungen, die DATEV aus einem früheren Kontenrahmen oder Steuerstatus schon hat. Mit `previousYear.exportedAt` und `year` des Vorjahrs sind das genau die Buchungen, die `previousYear.addenda` zählt. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/export/datev/summary" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: DatevExportSummary |
| 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 |
| 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 (`DatevExportSummary`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `months` | Array<DatevExportSummaryMonth>, kann null sein | Die Monate des Zeitraums, der älteste zuerst; ohne `from` und `to` alle zwölf. |
| `onlyNew` | boolean | Umfang der Zahlen, wie angefragt. |
| `previousYear` | DatevExportSummaryPreviousYear | Nur ohne `from`, `to` und `since`: die Nachträge des Vorjahrs. `null`, wenn es dort keinen zugestellten Export gibt. |
| `totals` | DatevExportSummaryTotals | Die Zahlen eines Exports des ganzen Zeitraums. |
| `year` | integer | Kalenderjahr. |

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