Belege für die Wahl einer Kostenstelle lesen
Benötigte Berechtigung:read(Daten lesen)
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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
ids*stringBis zu 20 Beleg-IDs, durch Komma getrennt, etwa aus POST /api/document/filter mit costCenterId gleich null.
Erfolg.
application/json- response
[index: integer]?Beleg, für den sich eine Kostenstelle wählen lässt, wie die Prüfung vor dem DATEV-Export ihn zeigt.
curl --fail-with-body "https://app.bimetrics.de/api/cost-centers/documents?ids=string" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"[ { "account": 4930, "accountName": "Bürobedarf", "customerNumber": 1004, "date": "2026-10-28", "id": "a129ef0a-da5d-4204-804c-764d751bca95", "invoiceNumber": "RE-2026-0142", "kind": "receipt", "name": "Beispiel Bürobedarf GmbH", "suggestedCostCenterIds": [ "5b0f8c3e-2a71-4d9e-8f16-7c4a9e2d3b58" ], "totalMinor": 11900 }, { "account": 4920, "accountName": "Telefon", "date": "2026-10-05", "id": "a2543540-c7ca-413d-8bcc-1ef3427e8aa4", "invoiceNumber": "MF-88123", "kind": "receipt", "locked": "exported", "name": "Beispiel Mobilfunk AG", "suggestedCostCenterIds": [], "totalMinor": 5950 }]Kostenstelle oder Verteilung anlegen POST
Legt eine Kostenstelle (`kind` `center`, mit `code` und `name`) oder eine Verteilung an (`kind` `distribution`, mit `name` und `shares`), wie in den Einstellungen der App. Die Nummer ist die KOST1 im DATEV-Export: 1 bis 8 Ziffern oder Buchstaben ohne Umlaute und Leerzeichen, auch gemischt wie `KST01`, nur aus Ziffern ohne führende Null. Sie ist je Firma eindeutig, auch gegenüber archivierten, ohne Unterschied zwischen Groß- und Kleinschreibung. Die Steuerberatung muss sie in DATEV genauso anlegen, sonst führt DATEV die Buchungen als „nicht berücksichtigt“. Eine Verteilung braucht mindestens zwei verschiedene Kostenstellen, die nicht archiviert sind, und ihre Anteile ergeben zusammen 10000 Basispunkte (100 %). Verstößt die Anfrage gegen eine Regel, antwortet die Route mit `400 CostCenterRejected`, `context.field` nennt das Feld und `context.message` den Satz der App; eine vergebene Nummer ergibt `409 CostCenterRejected`. Bei einer Wiederholung schickst du denselben Idempotency-Key. Benötigt einen Schlüssel mit der Berechtigung `company:write`.
Auswertung der Kostenstellen lesen GET
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`.