# Auswertung der Kostenstellen lesen (https://developer.bimetrics.de/reference/cost-centers/get-cost-center-report)

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

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

Liefert Erträge, Aufwand, Personalkosten und Ergebnis je Kostenstelle für einen Monat, ein Quartal oder ein Jahr und für den Vergleichszeitraum, wie „Auswertungen“ in der App. Gezählt wird jede Buchung in bimetrics auf einem Erfolgskonto, also auf den Konten, die eine Kostenstelle tragen. DATEV wertet davon je nach Einstellung der Kanzlei den neutralen Bereich (SKR03 Klasse 2, SKR04 Klasse 7) in der Kostenrechnung nicht aus. `revenueMinor` sind die Ertragskonten: Umsatzerlöse, sonstige Erträge, Zinserträge und Erstattungen wie U1/U2. `expensesMinor` sind alle übrigen Erfolgskonten, auch Wareneinkauf, Material, Reparaturen, Provisionen und Steuern wie die Gewerbesteuer. Skonti und Gutschriften mindern ihre Seite, eine Kontozeile kann deshalb negativ sein. Bestandskonten zählen nicht: Anlagen und geringwertige Wirtschaftsgüter, Privatentnahmen und Einfuhrumsatzsteuer. Daneben stehen in `payrollPaidMinor` die Personalkosten (gezahlt): was über die Gehaltsvorlagen auf die Lohnverbindlichkeiten gezahlt wurde, also Nettolohn, Lohn- und Kirchensteuer, Sozialversicherung, Einbehalte und vermögenswirksame Leistungen, gezählt am Tag der Zahlung, nicht im Lohnmonat. Eine Erstattung mindert sie. `expensesMinor` enthält sie nicht, `resultMinor` schon. Altersvorsorge, die direkt an den Versicherer geht, und Sachbezüge fehlen; genau ist die Lohnabrechnung in DATEV. Die Kostenstelle der Personalkosten ist die des Belegs der Vorlage, nie eine der Buchung: Die Zahlung bleibt auf einem Bestandskonto, im DATEV-Export steht dort keine KOST1, und die Buchungen einer Kostenstelle enthalten sie nicht. Alle Beträge sind in Cent und netto; bei einer Firma ohne Vorsteuerabzug (Kleinunternehmer, steuerbefreit) steht der Aufwand mit der gezahlten Umsatzsteuer da. `total` ist die Summe aller Zeilen samt `withoutCostCenter`. Die Kacheln der Startseite zählen andere Konten und zeigen deshalb andere Werte. Buchungen mit Verteilung gehen centgenau wie im DATEV-Export an ihre Kostenstellen; Verteilungen haben keine eigene Zeile, `accounts[].parts` nennt die Anteile. Eine archivierte Kostenstelle hat nur eine Zeile, solange einer der beiden Zeiträume dort einen Betrag hat. `withoutCostCenter` enthält die Beträge ohne Kostenstelle, dazu die neuesten Belege und Rechnungen, denen sie fehlt, auch Belege aus Buchungsvorlagen, und die neuesten Buchungen, die keine Kostenstelle bekommen können. Umfassen `from` und `to` nicht genau einen Monat, ein Quartal oder ein Jahr, 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 Tag eines Monats, Quartals oder Jahres, `YYYY-MM-DD`. |
| `to` | query | ja | string | Letzter Tag desselben Monats, Quartals oder Jahres, `YYYY-MM-DD`. |
| `compare` | query | nein | string | `previous` (Standard): der Monat, das Quartal oder das Jahr davor. `previous_year`: derselbe Zeitraum ein Jahr früher. Bei einem Jahr ist beides das Vorjahr. |

### Beispiel

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

### Antworten

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

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `compare` | string | `previous` oder `previous_year`. |
| `compareFrom` | string | Erster Tag des Vergleichszeitraums. |
| `compareTo` | string | Letzter Tag des Vergleichszeitraums. |
| `costCenters` | Array<CostCenterReportRow>, kann null sein | Jede nicht archivierte Kostenstelle nach Nummer, mit oder ohne Betrag, dazu archivierte mit Betrag in einem der beiden Zeiträume. |
| `distributions` | Array<CostCenterReportDistribution>, kann null sein | Verteilungen mit Beträgen im Zeitraum und was ihre Kostenstellen davon bekamen; das steckt schon in deren Zeilen. |
| `from` | string | Erster Tag des Zeitraums. |
| `period` | string | `month`, `quarter` oder `year`. |
| `to` | string | Letzter Tag des Zeitraums. |
| `total` | CostCenterReportTotal | „Firma gesamt“: die Summe der Zeilen. |
| `withoutCostCenter` | CostCenterReportWithout | Zeile „Ohne Kostenstelle“. |

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