bimetricsEntwickler
Buchhaltung

Summen- und Saldenliste lesen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/accounting/balances

Liefert die Summen- und Saldenliste (SuSa) wie in DATEV: je bebuchtem Konto den EB-Wert (Saldovortrag), Soll und Haben im Zeitraum, Soll und Haben vom 1. Januar bis zum Ende des Zeitraums und den Saldo. Das Wirtschaftsjahr ist in bimetrics das Kalenderjahr. Liegen from und to in verschiedenen Jahren oder from nach to, antwortet die Route mit 400. Den EB-Wert haben nur Bestandskonten: Er ist der Saldo aller Buchungen vor dem 1. Januar. Erfolgskonten beginnen jedes Jahr bei 0. Weil bimetrics keinen Jahresabschluss bucht, steht das Ergebnis der Erfolgskonten aus den Vorjahren in previousYearsResultMinor statt auf einem Konto; mit ihm gehen die EB-Werte auf. Gezählt wird jede Buchung in bimetrics, auch eine noch nicht exportierte. Bestände aus der Zeit vor bimetrics fehlen, solange sie nicht gebucht sind. Automatikkonten stehen netto da, die Steuer auf dem Steuerkonto, auf das DATEV sie für den Steuerschlüssel bucht, etwa 1776 (SKR04 3806). Eine Stornobuchung mindert die Seite der stornierten Buchung, wie die Generalumkehr in DATEV. Anders als DATEV zeigt die SuSa die Umsatzsteuer bei Ist-Versteuerung schon mit der Rechnung statt erst mit der Zahlung, und bei § 13b fehlen die Steuerzeilen, die DATEV über den Steuerschlüssel bildet. Alle Beträge sind in Cent; ein Saldo ist positiv im Soll und negativ im Haben.

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 des Zeitraums, YYYY-MM-DD.

to*string

Letzter Tag des Zeitraums, YYYY-MM-DD, im selben Kalenderjahr wie from.

Antworten

Erfolg.

application/json
  1. response

Summen- und Saldenliste eines Zeitraums in einem Kalenderjahr.

accounts?array<>|

Die bebuchten Konten: Sachkonten nach Nummer, dann Debitoren, dann Kreditoren.

fiscalYearStart?string

Beginn des Wirtschaftsjahres, in bimetrics der 1. Januar.

from?string

Erster Tag des Zeitraums, YYYY-MM-DD.

previousYearsResultMinor?integer

Ergebnis der Erfolgskonten vor dem Wirtschaftsjahr, das kein Konto trägt, weil bimetrics keinen Jahresabschluss bucht. In Cent, positiv ein Verlust, negativ ein Gewinn. Mit ihm gehen die EB-Werte auf.

to?string

Letzter Tag des Zeitraums, YYYY-MM-DD.

totals?

Summen über alle Konten.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/accounting/balances?from=string&to=string" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "accounts": [    {      "account": 1200,      "balanceSheet": true,      "closingMinor": 120000,      "creditCumulativeMinor": 0,      "creditMinor": 0,      "debitCumulativeMinor": 50000,      "debitMinor": 50000,      "kind": "ledger",      "label": "Geschäftskonto",      "openingMinor": 70000    },    {      "account": 8400,      "balanceSheet": false,      "closingMinor": -50000,      "creditCumulativeMinor": 50000,      "creditMinor": 0,      "debitCumulativeMinor": 0,      "debitMinor": 0,      "kind": "ledger",      "label": "Erlöse 19 % USt",      "openingMinor": 0    }  ],  "fiscalYearStart": "2026-01-01",  "from": "2026-03-01",  "previousYearsResultMinor": -70000,  "to": "2026-03-31",  "totals": {    "closingMinor": 70000,    "creditCumulativeMinor": 100000,    "creditMinor": 50000,    "debitCumulativeMinor": 100000,    "debitMinor": 50000,    "openingMinor": 70000  }}