Kontenplan

Der Kontenplan ist die fachliche Struktur, in der alle Buchungen eingeordnet werden. LedgerLou liefert SKR04 als Standard — jeder Tenant kann den Plan an die eigene Praxis anpassen.

SKR04 StandardVollständiger SKR04-Kontenrahmen vorinstalliert

Tenant-spezifischKonten ergänzen, umbenennen oder deaktivieren

Suche & FilterKonten nach Nummer, Name und Kategorie durchsuchen

KontoeinzelnachweisAlle Buchungszeilen und Salden je Konto abrufbar

API-ZugriffKonten per REST lesen und anlegen

Wie der Kontenplan funktioniert

Jede Buchung referenziert zwei oder mehr Konten aus dem tenant-spezifischen Kontenplan — Soll und Haben müssen immer ausgeglichen sein. Der Account Resolver nutzt diesen Plan, um Sachverhalte deterministisch zuzuordnen: kein LLM-Raten bei der Kontonummer, sondern regelbasiertes Mapping auf SKR04.

Wird ein Konto im Kontenplan nicht gefunden, schlägt die Buchung fehl. Das stellt sicher, dass Reports und Salden immer konsistent zur konfigurierten Kontenbasis sind.

Kein Scope-Check auf GET

GET /v1/accounts und GET /v1/accounts/search erfordern nur einen gültigen Auth-Token — kein Modul-Scope nötig. Der Kontenplan ist für alle authentifizierten Nutzer lesbar.

Zugangswege

Dashboard (UI)Kontenplan einsehen, Konten suchen und bei Bedarf eigene Konten ergänzen.

REST APIKonten programmatisch suchen und lesen — z. B. für Integrationen, die Kontonummern validieren müssen.

Wichtige Endpunkte

Methode	Endpoint	Zweck
GET	/v1/accounts	Kontenplan abrufen (Filter: Kategorie, Suche)
POST	/v1/accounts	Eigenes Konto zum Plan hinzufügen
GET	/v1/accounts/search	Konten nach Name oder Nummer suchen
GET	/v1/accounts/:number/entries	Alle Buchungszeilen und Saldo eines Kontos

Scopes

Der Kontenplan hat kein eigenes Modul-Scope — Lesezugriff erfordert nur Authentifizierung. Schreibende Operationen (Konto anlegen) erfordern den admin-Scope.