bimetricsEntwickler
Buchhaltung

Buchung lesen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/accounting/booking/{id}

Liefert eine Buchung mit Buchungsart, Stand gegenüber DATEV und Herkunft.

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.

Pfadparameter

id*string

ID der Buchung (UUID).

Formatuuid

Antworten

Erfolg.

application/json
  1. response

Eine Buchung im DATEV-Kontenrahmen der Firma.

account?integer

Konto im Kontenrahmen: Sachkonto, Bankkonto, Debitor oder Kreditor. amount bezieht sich auf dieses Konto.

accountContra?integer

Gegenkonto.

accountContraIsIncomeStatement?boolean

True, wenn accountContra ein Aufwands- oder Erlöskonto ist. Fehlt sonst.

accountIsIncomeStatement?boolean

True, wenn account ein Aufwands- oder Erlöskonto ist. Fehlt sonst.

accountingModel?string

Kontenrahmen 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?string

Betrag als Dezimalzahl (String), bezogen auf account: größer 0 Soll, kleiner 0 Haben.

Muster^-?[0-9]+(\.[0-9]+)?$
Formatdecimal
bookingDate?

Buchungsdatum.

bookingFlags?string

Steuerkennzeichen, 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?string

BU-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?string

ID der Firma.

Formatuuid
costCenterId?string

Kostenstelle oder Verteilung der Buchung als ID. Nur Buchungen mit Aufwands- oder Erlöskonto tragen sie, Zahlungen nie. Fehlt ohne.

Formatuuid
costCenterParts?array<>

Nur bei einer Verteilung: der Betrag je Kostenstelle, centgenau wie die Zeilen im DATEV-Export.

costCenterRelevant?boolean

True bei einer Buchung auf ein Aufwands- oder Erlöskonto: Sie trägt die Kostenstelle ihres Belegs. Fehlt sonst.

createdAt?string

Anlage in bimetrics.

Formatdate-time
deletedAt?|

Gilt als gelöscht seit diesem Zeitpunkt; null, solange nicht gelöscht. Gelöschte Einträge liefern nur die Suchrouten mit includeDeleted.

Formatdate-time
export?

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.

Formatdate-time
finalizedBy?string

Auslö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.

Wert in"export""auto"
id?string

ID der Buchung.

Formatuuid
kind?string

Buchungsart, 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.

Wert in"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?string

Buchungstext.

netAmount?string

Nettoanteil 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.

Muster^-?[0-9]+(\.[0-9]+)?$
Formatdecimal
origin?

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.

Formatuuid
refDocumentId?|

ID des gebuchten Belegs.

Formatuuid
refMatch?|

ID der Zuordnung, aus der die Buchung entstand.

Formatuuid
refRecordedPaymentId?string

ID der dokumentierten Bar-, Verrechnungs- oder Privatzahlung; sonst null.

Formatuuid
revertsAccountBookingId?|

Diese Buchung storniert die Buchung mit dieser ID.

Formatuuid
status?string

Stand 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.

Wert in"open""finalized""changed_after_export"
taxAmount?string

Steueranteil 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.

Muster^-?[0-9]+(\.[0-9]+)?$
Formatdecimal
taxRate?string

Steuersatz 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.

Muster^-?[0-9]+(\.[0-9]+)?$
Formatdecimal
updatedAt?string

Letzte Änderung.

Formatdate-time
Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/accounting/booking/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "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"}