Open Source · Apache-Lizenz 2.0 · selbst gehostet
OpenBuchhaltung ist eine webbasierte Buchhaltung für GmbH, UG und gGmbH: doppelte Buchführung nach HGB, Umsatzsteuer mit ELSTER-Anbindung, DATEV-Export und Bankabruf, dazu eine offene API und ein MCP-Server für KI-Assistenten. Jede Änderung wird protokolliert, festgeschriebene Buchungen werden versiegelt, und der Quellcode liegt offen auf GitHub.
AR 2026-124 Beratungskunde Nord GmbH, Beratung August
Leistungsdatum 31.08.2026
| Konto | Bezeichnung | Soll | Haben |
|---|---|---|---|
| 1400 | Forderungen aLuLDebitor 10000 · Beratungskunde Nord GmbH | 3.808,00 | |
| 8400 | Erlöse 19 % UStSteuercode USt19 | 3.200,00 | |
| 1776 | Umsatzsteuer 19 %automatisch aus USt19 | 608,00 | |
| Summe | 3.808,00 | 3.808,00 | |
bd2dfb2c f6b8cab4 296e6ea9 801215be 5e52876c d7fa81c1 e04e2386 9d1f4b60
Zielgruppen
Für alle, die ihre Finanzdaten nachvollziehbar und automatisierbar verwalten wollen, ohne sich an eine geschlossene Plattform zu binden.
GmbH, UG und gGmbH, die ihre Buchhaltung selbst führen oder genau verstehen wollen, mit Bilanz und GuV statt Einnahmen-Überschuss-Rechnung.
Mandantentrennung, Rollen, ein DATEV-kompatibler Buchungsstapel je Wirtschaftsjahr und ein Prüferexport mit Manifest und Hashes.
Jede Fachfunktion gibt es in der Oberfläche, als REST-Endpunkt und als MCP-Tool. Buchen, Abgleichen und Auswerten lassen sich in eigene Abläufe einbinden.
Deutsche Buchhaltungspraxis als lesbarer Python-Code, mit über 700 automatisierten Tests, Architekturentscheidungen und Compliance-Dokumentation im Repository.
Funktionen
Der Funktionsumfang wächst in Sprints. Alles auf dieser Seite ist umgesetzt und automatisiert getestet; was noch fehlt, steht im Projektstand.
Mehrzeilige Journalbuchungen mit Soll/Haben-Prüfung, Steuercodes mit automatischer Steuerzeile, Storno als Gegenbuchung und Festschreibung.
SKR03 und SKR04 mitgeliefert oder als eigene CSV importiert. Die Kontenrahmen-Prüfung findet Altlasten und beschreibt die Bereinigung.
Belege als PDF, JPG oder PNG mit SHA-256-Hash und Versionierung. Eingangsrechnungen als XRechnung oder ZUGFeRD direkt verbuchen, Ausgangsrechnungen als E-Rechnung erzeugen.
Betrag, Datum, Lieferant und Rechnungsnummer werden regelbasiert erkannt, ein Sprachmodell ergänzt und kontrolliert auf Wunsch. Gebucht wird erst nach Freigabe.
Kontoauszüge als CSV, CAMT.053 oder MT940 importieren oder per FinTS/HBCI und Open Banking (PSD2) abrufen. Regeln kontieren wiederkehrende Umsätze vor.
Debitorische und kreditorische Posten mit Teilausgleich, Verknüpfung zu Bankumsatz oder Zahlungsbuchung und drei Mahnstufen mit druckbarem Mahnschreiben.
UStVA, Zusammenfassende Meldung und USt-Jahreserklärung aus den Buchungen, einschließlich Reverse Charge nach § 13b und innergemeinschaftlichem Erwerb.
Anlagenverzeichnis mit Abschreibungsplan: linear, degressiv, nach Leistung, GWG bis 800 € und Sammelposten über fünf Jahre.
Mitarbeiterstamm, Lohnläufe und die automatische Buchung von Brutto, Netto, Lohnsteuer und Sozialversicherung. Ein externer PAP-Runner kann die Lohnsteuer berechnen.
Hierarchische Kostenstellen und Profitcenter mit Gültigkeit und Historie. Bank-, OCR- und E-Rechnungsbuchungen lassen sich direkt kontieren.
Perioden sperren und den Jahresabschluss mit Ergebnis- und Saldovortrag in einer Transaktion buchen. Summen- und Saldenliste, GuV und Bilanz für beliebige Zeiträume.
DATEV-Buchungsstapel je Wirtschaftsjahr nach dem Brutto-Prinzip, Journal und Salden als CSV und ein Prüferexport mit Manifest, Feldkatalog und Hashes.
Ablauf
So greifen die Module im Monatsablauf ineinander.
PDF hochladen, E-Rechnung einlesen oder per OCR auslesen. Der Beleg wird mit Hash unverändert gespeichert.
Vorschlag prüfen und freigeben. Die Steuerzeile entsteht aus dem Steuercode, der Partner hängt am Sammelkonto.
Umsätze abrufen oder importieren, Regeln anwenden und Zahlungen ihren Buchungen und Posten zuordnen.
UStVA und ZM für den Zeitraum prüfen, als Stand festhalten und über ELSTER übermitteln.
Buchungen festschreiben, Perioden sperren und zum Jahresende Ergebnis- und Saldovortrag buchen.
DATEV-Stapel an die Kanzlei, Prüferexport an die Betriebsprüfung, Berichte an die Geschäftsführung.
Einblick
Aufnahmen einer lokalen Demo-Instanz mit Beispieldaten der Demo GmbH für das dritte Quartal 2026.
Umsatzsteuer und DATEV
Die Umsatzsteuer ergibt sich direkt aus den Buchungen. Steuercodes, Steuerkonten und die DATEV-Kontenfunktion des Erlöskontos bestimmen, in welche Kennzahl ein Betrag fällt.
Nachvollziehbarkeit
Die technischen Grundlagen der GoBD sind umgesetzt: Unveränderbarkeit, Protokollierung und maschinelle Prüfbarkeit. Eine formale Zertifizierung ist das nicht.
verify-audit-package prüfbar.$ flask --app run.py verify-integrity Geprüft: 26 festgeschriebene Buchungen, 0 Belege, 131 Audit-Einträge. Integritätsnachweise sind intakt.
Schnittstellen und KI
Die Oberfläche ist eine von drei Schichten. Jede Fachfunktion gibt es zusätzlich als REST-Endpunkt und als MCP-Tool, mit denselben Rechten und derselben Protokollierung.
API-first mit Token-Authentifizierung, Mandanten-Scope und Rollen. Validierungsfehler kommen als 422 mit feldbezogenen Details.
Rund 150 Tools für Buchungen, Berichte, Bank, Belege, Anlagen, Lohn und Umsatzsteuer, per stdio oder Streamable HTTP. ChatGPT- und Claude-Connectoren melden sich über OAuth 2.1 an.
Der Assistent liest Konten, Buchungen und Berichte. Schreibende Aktionen schlägt er nur vor, ausgeführt wird erst nach Bestätigung. Bankzugänge, SEPA, ELSTER und die Benutzerverwaltung bleiben gesperrt.
OpenAI, Azure OpenAI, OpenRouter oder ein lokales Modell über Ollama oder vLLM, je Benutzer. API-Schlüssel liegen verschlüsselt in der Datenbank.
curl -X POST https://buchhaltung.example.de/api/v1/journal-entries \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"company_id": 1,
"entry_date": "2026-09-10",
"service_date": "2026-08-31",
"description": "AR 2026-124 Beratung August",
"status": "posted",
"lines": [
{"account_code": "1400", "debit_amount": "3808.00",
"partner_number": "10000"},
{"account_code": "8400", "credit_amount": "3200.00",
"tax_code_id": 1}
]
}'
# Die Umsatzsteuerzeile (1776, 608,00) ergänzt der Steuercode.curl -X POST https://buchhaltung.example.de/mcp \
-H "Authorization: Bearer $MCP_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": {"name": "get_vat_return",
"arguments": {"company_id": 1, "period": "2026-Q3"}}}'
# Antwort: Kennzahlen 81, 21, 46/47, 66, 67 und 83 wie in der Oberfläche.{
"mcpServers": {
"openbuchhaltung": {
"command": "python",
"args": ["-m", "app.services.mcp_server"],
"env": {
"OPENBUCHHALTUNG_API_URL": "http://localhost:8000/api/v1",
"OPENBUCHHALTUNG_API_TOKEN": "obk_..."
}
}
}
}Oberfläche, REST-API und MCP-Server bleiben deckungsgleich. Ein Benutzer-Token sieht und ändert genau das, was der Benutzer auch in der Oberfläche darf.
| Aufgabe | REST-API (/api/v1) und MCP-Tool |
|---|---|
| Buchung erfassen | POST /journal-entriescreate_journal_entry |
| Kontoauszug importieren | POST /bank-transactions/importimport_bank_transactions |
| UStVA berechnen | GET /vat-returnget_vat_return |
| Beleg abgleichen | POST /receipt-matching/suggestionscreate_receipt_match_suggestion |
| DATEV-Export | GET /exports/datev.csvexport_datev_csv |
| Integrität prüfen | GET /integrityverify_compliance_integrity |
Betrieb und Sicherheit
OpenBuchhaltung läuft auf dem eigenen Server oder in der eigenen Cloud. Es gibt keinen zentralen Dienst und keine Telemetrie; externe Dienste kommen nur ins Spiel, wenn Sie sie selbst einrichten.
Installation
Für einen ersten Eindruck genügt Docker. Die Demo legt eine Beispiel-GmbH mit SKR03, Steuercodes, Geschäftspartnern und ersten Buchungen an.
Danach läuft die Anwendung unter http://localhost:8000. Anmeldung mit
admin und Passwort admin123; diese Demo-Zugänge legt
seed-demo in Produktion nicht an.
Für den Produktivbetrieb: .env aus der Vorlage anlegen und
./redeploy.sh ausführen. Konfiguration, Backup und Updates beschreibt
das README.
git clone https://github.com/unikinCK/OpenBuchhaltung.git
cd OpenBuchhaltung
docker compose up --build -d
docker compose exec app flask --app run.py seed-demogit clone https://github.com/unikinCK/OpenBuchhaltung.git
cd OpenBuchhaltung
python3.12 -m venv .venv && source .venv/bin/activate
pip install -r requirements-dev.txt
export APP_ENV=development
flask --app run.py seed-demo
python run.pygit clone https://github.com/unikinCK/OpenBuchhaltung.git
cd OpenBuchhaltung
cp .env.example .env
# SECRET_KEY, POSTGRES_PASSWORD und API_AUTH_TOKEN in .env setzen
./redeploy.sh
# Backup, Build, Migration, Start und Health-CheckProjektstand
Viele Kernabläufe sind umgesetzt und automatisiert getestet. Eine fachliche Prüfung durch Steuerberatung oder Wirtschaftsprüfung ersetzt das Projekt nicht.
FAQ
Nichts. Der Quellcode steht unter der Apache-Lizenz 2.0 und darf kostenlos genutzt, verändert und weitergegeben werden. Kosten entstehen nur für den eigenen Betrieb, etwa für den Server oder einen KI-Anbieter.
Nein. Die Software unterstützt die laufende Buchhaltung und erzeugt Auswertungen und Meldungen. Jahresabschluss, Steuererklärungen und die fachliche Prüfung gehören weiterhin in die Hände von Steuerberatung oder Wirtschaftsprüfung; der DATEV-Export erleichtert die Zusammenarbeit.
Nein. Festschreibung, Inhaltshashes, das verkettete Audit-Log und der Prüferexport bilden eine technische Grundlage. Ordnungsmäßigkeit hängt aber auch von Verfahrensdokumentation, internen Kontrollen und dem Betrieb ab. Vorlagen dafür liegen im Repository unter docs/compliance.
Für Kapitalgesellschaften mit doppelter Buchführung, also GmbH, UG und gGmbH. Eine Einnahmen-Überschuss-Rechnung gehört nicht zum Funktionsumfang, die Istversteuerung wird derzeit nicht abgebildet.
Auf dem Server, auf dem Sie OpenBuchhaltung betreiben. Externe Dienste kommen nur zum Einsatz, wenn Sie sie selbst einrichten: Ihre Bank, ELSTER, Enable Banking für den PSD2-Abruf oder ein KI-Anbieter.
Nein. Buchen, Bankabgleich, Umsatzsteuer und Exporte funktionieren ohne Sprachmodell, die Beleg-OCR arbeitet für PDFs mit Textebene regelbasiert. Wer KI nutzen möchte, kann auch ein lokales Modell anbinden, sodass keine Daten das Haus verlassen.
Als DATEV-Buchungsstapel je Wirtschaftsjahr, der sich in DATEV importieren lässt. Den Einsatz des Leistungsdatums sollten Sie mit der Kanzlei abstimmen.
Jede Bank, deren Kontoauszug sich als CSV, CAMT.053 oder MT940 exportieren lässt. Direkt abrufen lassen sich Banken mit FinTS-Zugang, wofür eine Registrierung bei der Deutschen Kreditwirtschaft nötig ist, sowie Banken mit PSD2-Schnittstelle über Enable Banking, zum Beispiel Finom.
Issues und Pull Requests auf GitHub sind willkommen. Einen guten Einstieg bieten das README, der Umsetzungsplan, die Coding-Guidelines und die Architekturentscheidungen unter docs/.
Open Source
OpenBuchhaltung entsteht offen auf GitHub. Änderungen werden im Changelog festgehalten und als Versionen getaggt.