bimetricsEntwickler
Kostenstellen

Auswertung der Kostenstellen lesen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/cost-centers/report

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

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Query-Parameter

from*string

Erster Tag eines Monats, Quartals oder Jahres, YYYY-MM-DD.

to*string

Letzter Tag desselben Monats, Quartals oder Jahres, YYYY-MM-DD.

compare?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.

Antworten

Erfolg.

application/json
  1. response

Auswertung der Kostenstellen für einen Zeitraum und den Vergleichszeitraum.

compare?string

previous oder previous_year.

compareFrom?string

Erster Tag des Vergleichszeitraums.

compareTo?string

Letzter Tag des Vergleichszeitraums.

costCenters?array<>|

Jede nicht archivierte Kostenstelle nach Nummer, mit oder ohne Betrag, dazu archivierte mit Betrag in einem der beiden Zeiträume.

distributions?array<>|

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?

„Firma gesamt“: die Summe der Zeilen.

withoutCostCenter?

Zeile „Ohne Kostenstelle“.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/cost-centers/report?from=string&to=string" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "compare": "previous",  "compareFrom": "2026-09-01",  "compareTo": "2026-09-30",  "costCenters": [    {      "accounts": [        {          "account": 8400,          "amountMinor": 1480000,          "documents": 6,          "kind": "revenue",          "name": "Erlöse 19 % USt"        },        {          "account": 4955,          "amountMinor": 25000,          "documents": 1,          "kind": "expense",          "name": "Buchführungskosten",          "parts": [            {              "amountMinor": 25000,              "basisPoints": 5000,              "distributionId": "0e7d4b29-81c5-4f3a-9b6e-d2a8f5c17e94",              "name": "Gemeinsam",              "totalMinor": 50000            }          ]        }      ],      "archived": false,      "code": "100",      "costCenterId": "5b0f8c3e-2a71-4d9e-8f16-7c4a9e2d3b58",      "current": {        "expensesMinor": 887820,        "payrollPaidMinor": 0,        "resultMinor": 592180,        "revenueMinor": 1480000      },      "name": "Standort Nord",      "previous": {        "expensesMinor": 849000,        "payrollPaidMinor": 0,        "resultMinor": 541000,        "revenueMinor": 1390000      }    },    {      "accounts": [],      "archived": false,      "code": "200",      "costCenterId": "c93e1a47-6d02-4b8f-a5e3-1f7b2c9d4e60",      "current": {        "expensesMinor": 498620,        "payrollPaidMinor": 0,        "resultMinor": 121380,        "revenueMinor": 620000      },      "name": "Standort Süd",      "previous": {        "expensesMinor": 492000,        "payrollPaidMinor": 0,        "resultMinor": 148000,        "revenueMinor": 640000      }    }  ],  "distributions": [    {      "id": "0e7d4b29-81c5-4f3a-9b6e-d2a8f5c17e94",      "name": "Gemeinsam",      "parts": [        {          "costCenterId": "5b0f8c3e-2a71-4d9e-8f16-7c4a9e2d3b58",          "expensesMinor": 40620,          "payrollPaidMinor": 0,          "revenueMinor": 0        },        {          "costCenterId": "c93e1a47-6d02-4b8f-a5e3-1f7b2c9d4e60",          "expensesMinor": 40620,          "payrollPaidMinor": 0,          "revenueMinor": 0        }      ]    }  ],  "from": "2026-10-01",  "period": "month",  "to": "2026-10-31",  "total": {    "current": {      "expensesMinor": 1441440,      "payrollPaidMinor": 0,      "resultMinor": 748560,      "revenueMinor": 2190000    },    "previous": {      "expensesMinor": 1359600,      "payrollPaidMinor": 0,      "resultMinor": 670400,      "revenueMinor": 2030000    }  },  "withoutCostCenter": {    "bookings": [],    "bookingsWithoutDocument": 0,    "current": {      "expensesMinor": 55000,      "payrollPaidMinor": 0,      "resultMinor": 35000,      "revenueMinor": 90000    },    "documents": 3,    "invoices": 1,    "items": [      {        "account": 4930,        "accountName": "Bürobedarf",        "customerNumber": 1004,        "date": "2026-10-30",        "expensesMinor": 10000,        "id": "a129ef0a-da5d-4204-804c-764d751bca95",        "invoiceNumber": "RE-2026-0142",        "kind": "receipt",        "name": "Beispiel Bürobedarf GmbH",        "payrollPaidMinor": 0,        "revenueMinor": 0,        "suggestedCostCenterIds": [          "5b0f8c3e-2a71-4d9e-8f16-7c4a9e2d3b58"        ]      }    ],    "otherDocumentCount": 0,    "otherDocuments": [],    "payrollDocuments": 0,    "previous": {      "expensesMinor": 18600,      "payrollPaidMinor": 0,      "resultMinor": -18600,      "revenueMinor": 0    },    "recurringDocuments": 0  }}

Belege für die Wahl einer Kostenstelle lesen GET

Beschreibt bis zu 20 Belege so, wie die Prüfung vor dem DATEV-Export in der App sie zum Wählen einer Kostenstelle zeigt: Name, Rechnungsdatum, Bruttobetrag (`totalMinor`, in Cent), das Aufwands- oder Erlöskonto mit dem größten Betrag und die Kostenstellen, die der Kontakt schon hatte, seine Vorgabe zuerst (`suggestedCostCenterIds`). `locked` sagt, warum sich die Kostenstelle dort nicht wählen lässt: `exported` und `finalized` ändert man am Beleg mit Storno und Neubuchung, `contract` folgt seiner Dauerbuchung. Gesetzt wird die Kostenstelle mit `costCenterId` in `PATCH /api/document/{id}`. Die Belege stehen in der Reihenfolge der IDs, unbekannte, fremde und gelöschte fehlen. Mehr als 20 IDs lehnt die Route mit `400 CostCenterRejected` ab. Benötigt einen Schlüssel mit der Berechtigung `read`.

Kostenstelle oder Verteilung ändern PUT

Ersetzt Name und Nummer einer Kostenstelle bzw. Name und Anteile einer Verteilung; `kind` bleibt, wie es ist. Schick deshalb immer alle Werte, auch die unveränderten. Den Namen kannst du jederzeit ändern. Nummer und Anteile stehen fest, sobald ein Beleg oder eine Buchung die Kostenstelle oder Verteilung trägt (`used`), damit ein erneuter Export alter Monate dieselben Zeilen ergibt. Eine Änderung daran lehnt die Route mit `409 CostCenterRejected` ab. Für andere Anteile legst du eine neue Verteilung an und archivierst die alte. `expectedUpdatedAt` ist das gelesene `updatedAt`; hat sich der Eintrag seitdem geändert, antwortet die Route mit `409 VersionConflict` und ändert nichts. Eine ID einer anderen Firma ergibt `404 CostCenterNotFound`. Benötigt einen Schlüssel mit der Berechtigung `company:write`.