Skip to content

Buchungen & Journal

Das Journal-Modul ist das Herzstück von LedgerLou: alle Buchungen landen hier als unveränderliche Einträge im Hauptbuch. Ob manuell, per API oder via MCP — jede Buchung folgt denselben GoBD-Regeln und ist vollständig nachvollziehbar.

Manuelle BuchungenEinfache und Split-Buchungen direkt erfassen
Agentische BuchungenMCP Agent bucht mit Bestätigungsschleife
Review QueueVorschläge prüfen, anpassen und bestätigen
GoBD append-onlyKeine stille Änderung — je ein SHA256-Hash
Revisionssicheres StornoGegenbuchung statt Überschreiben
BelegverknüpfungDokument und Buchung in einem Schritt

Workflow

1
Sachverhalt buchenVia Dashboard, API oder MCP. Einfache Buchung oder Split mit mehreren Positionen. Optional direkter Belegupload in einem Request.
2
Review Queue bei niedrigem ConfidenceVorschläge mit Confidence < 0,85 landen automatisch in der Review Queue. Dort können sie geprüft, angepasst und bestätigt werden.
3
Buchung landet im JournalNach Bestätigung wird die Buchung unveränderlich ins Hauptbuch geschrieben — mit Intent-ID, Zeitstempel und SHA256-Hash.
4
Journal prüfenDas Journal ist filterbar nach Konto, Zeitraum und Suchbegriff. Jeder Intent zeigt alle zugehörigen Buchungszeilen und verknüpfte Intents.
5
Fehler korrigieren via StornoFalsche Buchungen werden durch POST /v1/journal/reverse mit einer Gegenbuchung storniert. Kein stilles Überschreiben — jede Korrektur ist im Audit-Trail sichtbar.

Zugangswege

Dashboard (UI)Buchungen manuell erfassen, Journal durchsuchen, Review Queue bearbeiten und Stornos auslösen.
REST APIBuchungen programmatisch erstellen und das Journal abfragen — z. B. für Integrationen, ETL-Pipelines oder automatisierte Monatsabschlüsse.
MCPMCP Agents klassifizieren Sachverhalte, erstellen Buchungsvorschläge und schreiben nach Bestätigung ins Journal.

Wichtige Endpunkte

MethodeEndpointZweck
POST/v1/bookingsBuchung direkt erstellen
POST/v1/bookings/with-documentBuchung + Belegupload in einem Schritt
GET/v1/journalJournal abfragen (Filter: Konto, Zeitraum, Suche)
GET/v1/journal/:intent_idEinzelnen Intent mit allen Buchungszeilen abrufen
POST/v1/journal/reverseBuchung stornieren (Gegenbuchung)
GET/v1/review-queueOffene Vorschläge auflisten
GET/v1/review-queue/nextNächsten offenen Review-Eintrag abrufen
POST/v1/review-queue/:id/confirmBuchungsvorschlag bestätigen
POST/v1/review-queue/:id/adjustVorschlag per Instruktion anpassen
POST/v1/review-queue/:id/overrideMit korrigiertem Draft buchen
GET/v1/documents/:id/fileOriginaldokument abrufen

Scopes

journal:read journal:write journal:review