Buchung lesen
Benötigte Berechtigung:read(Daten lesen)
Liefert eine Buchung mit Buchungsart, Stand gegenüber DATEV und Herkunft.
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.
id*stringID der Buchung (UUID).
uuidErfolg.
application/json- response
Eine Buchung im DATEV-Kontenrahmen der Firma.
account?integerKonto im Kontenrahmen: Sachkonto, Bankkonto, Debitor oder Kreditor. amount bezieht sich auf dieses Konto.
accountContra?integerGegenkonto.
accountContraIsIncomeStatement?booleanTrue, wenn accountContra ein Aufwands- oder Erlöskonto ist. Fehlt sonst.
accountIsIncomeStatement?booleanTrue, wenn account ein Aufwands- oder Erlöskonto ist. Fehlt sonst.
accountingModel?stringKontenrahmen und der Status, der für diese Buchung galt: SKR03 oder SKR04, mit Zusatz -v ohne Umsatzsteuerpflicht und -v-k als Kleinunternehmer. Nach einem Wechsel der Versteuerung behält jede Buchung den Status ihres Datums.
amount?stringBetrag als Dezimalzahl (String), bezogen auf account: größer 0 Soll, kleiner 0 Haben.
^-?[0-9]+(\.[0-9]+)?$decimalbookingDate?Buchungsdatum.
bookingFlags?stringSteuerkennzeichen, z. B. v19% (Vorsteuer 19 %), ust19% (Umsatzsteuer 19 %), v-none bzw. ust-none (keine Steuer im Betrag, etwa bei steuerfreien Positionen oder Positionen zu 0 %), v-reverse-charge bzw. ust-reverse-charge (Reverse Charge) oder ust-none-kleinunternehmer (Kleinunternehmer, § 19 UStG). Bei Kennzeichen mit Steuersatz enthält amount die Steuer. Leer nur bei Buchungen von Bankumsätzen ohne steuerliche Behandlung, etwa Zahlungen und Geldtransfers zwischen eigenen Konten. Auch Belegpositionen ohne Steuer tragen ein Kennzeichen, etwa v-none oder ust-none.
buKey?stringBU-Schlüssel, den der DATEV-Export für die Buchung schreibt, etwa 0401 für Vorsteuer 19 %; fehlt ohne Schlüssel. Bei Ist-Versteuerung tragen Zahlungen auf Ausgangsrechnungen den Schlüssel der Rechnung (0101, 0102 oder 0040), schon exportierte den, mit dem sie an DATEV gingen; teilt der Export die Zahlung auf mehrere Sätze oder nennt er keine einzelne Rechnung, fehlt er. Nur in filterBookings und getBooking; fehlt in den Buchungen eines Belegs oder Umsatzes.
companyId?stringID der Firma.
uuidcostCenterId?stringKostenstelle oder Verteilung der Buchung als ID. Nur Buchungen mit Aufwands- oder Erlöskonto tragen sie, Zahlungen nie. Fehlt ohne.
uuidcostCenterParts?array<>Nur bei einer Verteilung: der Betrag je Kostenstelle, centgenau wie die Zeilen im DATEV-Export.
costCenterRelevant?booleanTrue bei einer Buchung auf ein Aufwands- oder Erlöskonto: Sie trägt die Kostenstelle ihres Belegs. Fehlt sonst.
createdAt?stringAnlage in bimetrics.
date-timedeletedAt?|Gilt als gelöscht seit diesem Zeitpunkt; null, solange nicht gelöscht. Gelöschte Einträge liefern nur die Suchrouten mit includeDeleted.
date-timeexport?DATEV-Export der Buchung. Nur in filterBookings und getBooking; fehlt in den Buchungen eines Belegs oder Umsatzes.
finalized?|Zeitpunkt der Festschreibung; null, solange nicht festgeschrieben.
date-timefinalizedBy?stringAuslöser der Festschreibung: export der DATEV-Export, auto die nächtliche Festschreibung aller offenen Buchungen bis zum Ende des vorvorigen Monats. Fehlt, solange die Buchung nicht festgeschrieben ist. Ob eine Buchung exportiert ist, steht in export.
"export""auto"id?stringID der Buchung.
uuidkind?stringBuchungsart, abgeleitet aus Verweisen und Konten: purchase_invoice Eingangsbeleg, sales_invoice Ausgangsrechnung, sales_correction Stornorechnung oder Rechnungskorrektur, accrual_open Einbuchung einer Rechnungsabgrenzung, accrual_release ihre monatliche Auflösung, partial_period Monatsanteil einer nachträglich berechneten Leistung, entertainment_extra nicht abzugsfähiger Anteil einer Bewirtung, pass_through durchlaufender Posten, recurring Dauerbuchung, payment Zahlung, money_transfer Geldtransfer zwischen eigenen Konten, unmatched Umsatz ohne Zuordnung, direct_template Direktbuchung aus einer Buchungsvorlage, cash_discount Skonto, reminder_charges Mahnkosten und Zinsen, recorded_payment erfasste Bar- oder Verrechnungszahlung, settlement Erstattung oder Verrechnung einer Gutschrift, recorded_payment_reversal Storno einer erfassten Zahlung, reversal Storno einer festgeschriebenen Buchung, down_payment Zahlung auf einen Abschlag (Anzahlung), down_payment_clearing Auflösung der Anzahlung in der Schlussrechnung, other nicht sicher bestimmbar. Nur in filterBookings und getBooking; fehlt in den Buchungen eines Belegs oder Umsatzes.
"purchase_invoice""sales_invoice""sales_correction""accrual_open""accrual_release""partial_period""entertainment_extra""pass_through""recurring""payment""money_transfer""unmatched""direct_template""cash_discount""reminder_charges""recorded_payment""settlement""recorded_payment_reversal""reversal""down_payment""down_payment_clearing""other"label?stringBuchungstext.
netAmount?stringNettoanteil von amount als Dezimalzahl (String), mit demselben Vorzeichen: amount geteilt durch (1 + taxRate/100), auf Cent gerundet, wie in den Salden. Ohne Steuersatz gleich amount, auf Cent gerundet. Fehlt in einem unbekannten Kontenrahmen. Nur in filterBookings und getBooking; fehlt in den Buchungen eines Belegs oder Umsatzes.
^-?[0-9]+(\.[0-9]+)?$decimalorigin?Herkunft der Buchung. Nur in filterBookings und getBooking; fehlt in den Buchungen eines Belegs oder Umsatzes.
performanceFrom?|Beginn des Leistungszeitraums.
performanceTo?|Ende des Leistungszeitraums.
refBankTransactionId?|ID des gebuchten Umsatzes.
uuidrefDocumentId?|ID des gebuchten Belegs.
uuidrefMatch?|ID der Zuordnung, aus der die Buchung entstand.
uuidrefRecordedPaymentId?stringID der dokumentierten Bar-, Verrechnungs- oder Privatzahlung; sonst null.
uuidrevertsAccountBookingId?|Diese Buchung storniert die Buchung mit dieser ID.
uuidstatus?stringStand gegenüber DATEV: open nicht festgeschrieben, finalized festgeschrieben, changed_after_export exportiert, aber ihr Storno ist noch nicht exportiert. Eine Korrektur, die die Buchung nicht storniert, etwa der Rechnungsnummer oder USt-IdNr. des Belegs, ändert den Stand nicht. Nur in filterBookings und getBooking; fehlt in den Buchungen eines Belegs oder Umsatzes.
"open""finalized""changed_after_export"taxAmount?stringSteueranteil von amount als Dezimalzahl (String): amount, auf Cent gerundet, minus netAmount. Bei Reverse Charge 0, denn dort bucht DATEV die Steuer über den BU-Schlüssel. Nur in filterBookings und getBooking; fehlt in den Buchungen eines Belegs oder Umsatzes.
^-?[0-9]+(\.[0-9]+)?$decimaltaxRate?stringSteuersatz in Prozent aus bookingFlags als Dezimalzahl (String), etwa 19, 7 oder 5.5; 0 ohne Steuer. Nur in filterBookings und getBooking; fehlt in den Buchungen eines Belegs oder Umsatzes.
^-?[0-9]+(\.[0-9]+)?$decimalupdatedAt?stringLetzte Änderung.
date-timecurl --fail-with-body "https://app.bimetrics.de/api/accounting/booking/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "account": 8400, "accountContra": 11004, "accountingModel": "SKR03", "amount": "-1785", "bookingDate": { "day": 1, "month": 9, "year": 2026 }, "bookingFlags": "ust19%", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-12T07:30:19Z", "deletedAt": null, "export": { "addendum": false, "exported": false }, "finalized": null, "id": "743f74e5-29fb-46ba-b919-21e48af483be", "kind": "sales_invoice", "label": "Brauhaus Elbwiese GmbH, Fassadenbeschriftung Entwurf und Montage", "origin": { "documentId": "3026096b-614f-40d3-8749-8acf9b529480", "documentNumber": "RE-2026-0142", "matchId": "e21b3d18-17ea-4318-810c-919ec0a94dcb" }, "performanceFrom": { "day": 1, "month": 9, "year": 2026 }, "performanceTo": { "day": 1, "month": 9, "year": 2026 }, "refBankTransactionId": null, "refDocumentId": "3026096b-614f-40d3-8749-8acf9b529480", "refMatch": "e21b3d18-17ea-4318-810c-919ec0a94dcb", "revertsAccountBookingId": null, "status": "open", "updatedAt": "2026-09-12T07:30:19Z"}Buchungen suchen POST
Sucht Buchungen der Firma mit einem Filter und liefert eine Seite der Treffer, je Buchung mit Buchungsart, Stand gegenüber DATEV und Herkunft. Benötigt einen Schlüssel mit der Berechtigung `read`.
Kategorien auflisten GET
Liefert die Kategorien, die die App der Firma zur Auswahl anbietet. Der Schlüssel (`key`) ist der Wert von `category` in Belegpositionen, Buchungsvorlagen und Zuordnungen; die Kategorie einer Position bestimmt das Konto ihrer Buchung. `attributes` sagt, wofür eine Kategorie taugt. Benötigt einen Schlüssel mit der Berechtigung `read`.