# Nachträge in schon exportierten Monaten (https://developer.bimetrics.de/reference/accounting/check-datev-addenda)

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

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

Zählt je Monat die Nachträge außerhalb des Zeitraums `from` bis `to`, also Buchungen, die in den Zeitraum eines schon zugestellten Exports fallen und in DATEV trotzdem noch fehlen, etwa die Buchung eines Belegs vom 31.10., der erst nach dem Export des Oktobers kam. Maßgeblich ist der Zeitraum, für den exportiert wurde. Ein Export ohne gespeicherten Zeitraum (vor dem 04.11.2026) gilt für die ganzen Monate seiner Buchungen. Ein Export von `from` bis `to` nimmt diese Nachträge nicht mit, nur ein erneuter Export ihrer Monate mit „Nur noch nicht exportierte“. `export.addendum` an der einzelnen Buchung folgt derselben Regel.

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 |
| --- | --- | --- | --- | --- |
| `from` | query | ja | string | Erster Buchungstag des geplanten Exports, `YYYY-MM-DD`. |
| `to` | query | ja | string | Letzter Buchungstag, `YYYY-MM-DD`. |

### Beispiel

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

### Antworten

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

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `count` | integer | Anzahl der Buchungen. |
| `months` | Array<DatevAddendaMonth>, kann null sein | Ihre Monate, der älteste zuerst. Leer, wenn es keine gibt. |

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