# Belege ohne Kostenstelle vor dem DATEV-Export (https://developer.bimetrics.de/reference/cost-centers/list-documents-without-cost-center)

`GET https://app.bimetrics.de/api/cost-centers/missing`

operationId: `listDocumentsWithoutCostCenter` · Berechtigung (Scope): `read` · Bereich: Kostenstellen

Nennt die Belege ohne Kostenstelle, wie die Prüfung vor dem DATEV-Export in der App sie zählt: Belege, die von `from` bis `to` (Buchungsdatum) eine Buchung ohne Kostenstelle auf einem Aufwands- oder Erlöskonto haben. Diese Buchung ginge ohne KOST1 an DATEV, eine Kostenstelle am Beleg erreicht sie aber. Dazu gehören Belege aus Buchungsvorlagen, etwa für die Gewerbesteuer: Ihre Buchung steht am Bankumsatz und übernimmt die Kostenstelle des Belegs. Buchungen erfasster Zahlungen wie Ausbuchungen, Rundungs- oder Kursdifferenzen zählen nicht, denn eine Kostenstelle, die der Beleg später bekommt, erreicht sie nicht. Stornierte Buchungen und Stornos zählen nicht, und auch kein Beleg, der inzwischen eine Kostenstelle hat. Solange die Firma keine aktive Kostenstelle hat, sind `documentIds` und `recurringIds` leer. `GET /api/cost-centers/documents` beschreibt je Aufruf bis zu 20 der Belege, exportierte mit `locked: "exported"`, Belege einer Dauerbuchung mit `locked: "contract"`. Exportierte änderst du in der App, Belege einer Dauerbuchung an der Dauerbuchung, alle anderen mit `costCenterId` in `PATCH /api/document/{id}`. Liegt `to` vor `from`, antwortet die Route mit `400 CostCenterRejected`.

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 DATEV-Exports, `YYYY-MM-DD`. |
| `to` | query | ja | string | Letzter Buchungstag, `YYYY-MM-DD`, nicht vor `from`. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/cost-centers/missing" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

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

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `documentIds` | Array<string (uuid)>, kann null sein | IDs der Belege, sortiert nach ihrer neuesten Buchung im Zeitraum, die neueste zuerst. |
| `exportedIds` | Array<string (uuid)>, kann null sein | Davon die Belege, deren Buchungen ohne Kostenstelle im Zeitraum DATEV schon hat. Eine Kostenstelle erreicht die Kanzlei bei ihnen nur noch als Nachtrag (Storno und neue Buchung). Ein Export nur des noch nicht Exportierten betrifft die übrigen. |
| `recurringIds` | Array<string (uuid)>, kann null sein | Davon die Belege aus einer laufenden Dauerbuchung oder einer Buchungsvorlage. Die Belegliste zeigt sie nicht; bei einer Dauerbuchung kommt die Kostenstelle von dort. |

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