Belege ohne Kostenstelle vor dem DATEV-Export
Benötigte Berechtigung:read(Daten lesen)
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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
from*stringErster Buchungstag des geplanten DATEV-Exports, YYYY-MM-DD.
to*stringLetzter Buchungstag, YYYY-MM-DD, nicht vor from.
Erfolg.
application/json- response
Belege ohne Kostenstelle im Zeitraum, wie die Prüfung vor dem DATEV-Export sie zählt.
documentIds?array<>|IDs der Belege, sortiert nach ihrer neuesten Buchung im Zeitraum, die neueste zuerst.
exportedIds?array<>|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<>|Davon die Belege aus einer laufenden Dauerbuchung oder einer Buchungsvorlage. Die Belegliste zeigt sie nicht; bei einer Dauerbuchung kommt die Kostenstelle von dort.
curl --fail-with-body "https://app.bimetrics.de/api/cost-centers/missing?from=string&to=string" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "documentIds": [ "a129ef0a-da5d-4204-804c-764d751bca95", "a2543540-c7ca-413d-8bcc-1ef3427e8aa4" ], "exportedIds": [ "a2543540-c7ca-413d-8bcc-1ef3427e8aa4" ], "recurringIds": []}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`.
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 Startseite der App zeigt dieselben Werte: „Einnahmen“ sind `revenueMinor`, „Ausgaben“ sind `expensesMinor` und `payrollPaidMinor` zusammen, „Ergebnis“ ist `resultMinor`. 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`.