Eröffnungsbilanzwerte (EB-Werte) buchen

Bucht Saldenvorträge aus einer Saldenliste als Eröffnungsbilanzwerte ins Hauptbuch. Jeder Saldenvortrag wird gegen Konto 9000 (Saldenvorträge Sachkonten) gebucht. Nur Bilanzkonten (Aktiva, Passiva, Eigenkapital) sind zulässig — keine GuV-Konten (Aufwand/Ertrag). Die Summe aller Soll-Salden muss gleich der Summe aller Haben-Salden sein. Alle Einträge werden unter einer gemeinsamen Intent-ID gebucht und können gemeinsam storniert werden. Pro Datum kann nur ein Satz EB-Werte existieren; bei Korrektur muss zuerst storniert werden.

POST /v1/bookings/opening-balances

Authorization

Authorization string header erforderlich API-Key im Format ll_.... Übergabe als Bearer Token.

Request Body

booking_date string erforderlich Buchungsdatum der EB-Werte (YYYY-MM-DD), typischerweise der erste Tag des neuen Geschäftsjahres

balances array erforderlich Saldenvorträge. Jeder Eintrag hat genau einen Betrag > 0 (entweder Soll oder Haben). Einträge mit Soll = Haben = 0 werden ignoriert.

Saldenvortrag (`balances`)

account_number string erforderlich SKR04-Kontonummer

account_name string erforderlich Kontobezeichnung

debit number erforderlich Soll-Saldo. 0 wenn Haben-Saldo.

credit number erforderlich Haben-Saldo. 0 wenn Soll-Saldo.

Antworten

200

Erfolgreich

400

BALANCE_MISMATCH

400

INVALID_BALANCE_ENTRY

400

ACCOUNT_TYPE_NOT_ALLOWED

400

ACCOUNTS_NOT_FOUND

400

ACCOUNT_9000_MISSING

409

OPENING_BALANCES_EXIST

400

PERIOD_LOCKED Die betroffene Periode ist gesperrt und akzeptiert keine neuen Buchungen.

400

INVALID_INPUT Pflichtfelder fehlen oder Werte entsprechen nicht dem erwarteten Format.

POST /v1/bookings/opening-balances

cURL

-cmd">curl --request -method">POST -punct">\
  --url 'https://api.ledgerlou.de/v1/bookings/opening-balances' -punct">\
  --header 'Authorization: Bearer ll_your_key' -punct">\
  --header 'Content-Type: application/json' -punct">\
  --data '{
  "booking_date": "2025-01-01",
  "balances": [
    {
      "account_number": "0400",
      "account_name": "Technische Anlagen und Maschinen",
      "debit": 50000,
      "credit": 0
    },
    {
      "account_number": "1200",
      "account_name": "Forderungen aus Lieferungen und Leistungen",
      "debit": 10000,
      "credit": 0
    },
    {
      "account_number": "2000",
      "account_name": "Gezeichnetes Kapital",
      "debit": 0,
      "credit": 25000
    },
    {
      "account_number": "2900",
      "account_name": "Jahresüberschuss/-fehlbetrag",
      "debit": 0,
      "credit": 35000
    }
  ]
}'

200 Response

JSON

{
  "intent_id": "<string>",
  "event_count": 1,
  "total_debit": 1,
  "total_credit": 1
}