KAI Finance Engine

Die All-in-One Lösung für automatisierte Buchhaltung, KI-Assistenz & Daten-Extraktion

1. Multidimensionale Daten-Extraktion & Funktions-Spektrum

Das System agiert als zentrales Nervensystem für Unternehmensdaten. Es verbindet modernste KI-Modelle mit klassischen Schnittstellen, um Datenflüsse zu automatisieren.

🤖 KAI Chatbot & KI-Core Integrierter Chatbot mit Zugriff auf über 50 KI-Modelle (Llama 3, Mistral, GPT-4o) via OpenRouter & Puter.

Besonderheit: Der model_manager.py abstrahiert alle Anbieter, sodass Modelle flexibel und oft kostenlos genutzt werden können.

💰 Intelligente Kosteneffizienz Das System nutzt primär interne, kostenlose OCR-Technik (Tesseract) und Regex für die Standard-Verarbeitung.

Vorteil: Teure KI-Modelle werden nur als Fallback bei komplexen Fällen (Handschrift, unbekannte Layouts) hinzugezogen. Das hält die Betriebskosten minimal.

📊 Finanz-Analytik & Steuer Erstellt automatische Monatsauswertungen (CSV).

Extrahiert und trennt präzise MwSt-Sätze (7%/19%) sowie Länderkennzeichen. Ergebnis: Perfekte Vorbereitung für die Steuerformulare (USt-VA) und Jahresabschlüsse.

✉️ E-Mail & SMTP Hub Vollständige Verwaltung von IMAP-Postfächern (Sortieren, Verschieben, Flaggen).

Integrierter SMTP-Support: Senden von E-Mails über beliebige Provider oder die Gmail API direkt aus dem System heraus.

📅 Termin & Meeting Management Verwaltung von Google & Outlook Kalendern.

Highlight: Automatische Generierung von Web-Meeting URLs (Google Meet / MS Teams) bei der Terminerstellung.

🛒 SQL & E-Commerce Direkter Lesezugriff auf Shop-Datenbanken (z.B. Shopware 6). Umgeht langsame APIs und exportiert tausende Bestellungen in Sekunden.

🏦 Bankwesen Intelligentes Parsing von Kontoauszügen (PDF). Extrahiert Transaktionen und ordnet sie automatisch Zahlungen zu.

📱 WhatsApp Business Verarbeitet Fotos von Quittungen oder PDFs, die per WhatsApp gesendet werden. Wandelt Bilder per OCR direkt in durchsuchbare PDFs um.

2. Das "Profile Parsing": Automatisierte Buchungslogik

🧠 Das Gehirn der Buchhaltung

KAI sammelt nicht nur Daten, es versteht sie. Das integrierte Profile Parsing analysiert vollautomatisch die Historie aller Quellen, um Profile für Einnahmen und Ausgaben zu erstellen.

Aktiva & Passiva Erkennung: Das System lernt, welche Absender (z.B. "Lieferant XY") zu Ausgaben und welche (z.B. "Shop-Bestellung") zu Einnahmen gehören.
Kontakt-Analyse: Es durchsucht tausende E-Mails, extrahiert Geschäftspartner und hinterlegt diese in Profilen für zukünftige automatische Zuordnungen.
Regel-Lernen: Basierend auf Keywords im Betreff oder PDF-Inhalt ("Gutschrift", "Storno", "Rechnung") entscheidet das System selbstständig über den Buchungstyp.

3. Individuelle Firmen-Intelligenz & Profiling

Ein entscheidender Vorteil von KAI ist die **Mandantenfähigkeit**. Das System ist nicht auf eine einzige Logik beschränkt, sondern passt sich jeder Firma individuell an. Jede Einnahme und jede Ausgabe wird anhand eines spezifischen Firmenprofils bewertet.

🧩 Maßgeschneiderte Parsing-Profile

Das System nutzt die Datei parsing_profile.py und den Redis-Speicher, um für jedes Unternehmen ("Mandant") eigene Regeln zu laden.

Dynamische Regelsätze: Firma A klassifiziert "Adobe" als Ausgabe, Firma B vielleicht als Weiterverrechnung. Das System lädt zur Laufzeit die korrekte Logik.
Individuelle Absender-Listen: Jedes Profil speichert eigene Listen von "sicheren" Lieferanten und Kunden, die automatisch korrekt verbucht werden.
Spezifische Ausschluss-Kriterien: Was für die eine Firma "Werbung" ist, ist für die andere "Marktforschung". KAI lernt diese Unterschiede und wendet sie pro Profil an.

4. Der Master-Output: Lexoffice Konformität

Das Ziel ist nicht nur das Sammeln, sondern die perfekte Übergabe an die Buchhaltung. Das System liefert keine rohen Daten, sondern fertige Buchungssätze.

Die perfekte CSV & Beleg-Zuordnung

Alle extrahierten Daten – egal ob aus einer SQL-Datenbank, einer WhatsApp-Nachricht oder einer E-Mail – werden normiert und kombiniert.

Format-Garantie: Erstellung von CSV-Dateien, die exakt dem Import-Standard von Lexoffice entsprechen.
Vollständigkeit: Zusammenführung von Monats-CSVs mit Shop-Exporten. Duplikate werden automatisch erkannt und bereinigt.
Belegbild-Upload: Zu jedem Datensatz wird das passende Belegbild (PDF) revisionssicher hochgeladen und verknüpft.
Umsatzsteuer-Voranmeldung (USt-VA): Durch die präzise Trennung von Steuersätzen (7%/19%) und die Erkennung von EU-Reverse-Charge ist die USt-VA quasi "auf Knopfdruck" fertig.

5. Betriebsmodus für die Zukunft: Der "No-Code" Wartungszyklus

Ein entscheidender Vorteil dieses Systems ist seine Wartbarkeit. Die gesamte "Intelligenz" wurde aus dem Programmcode in Konfigurationsdateien verlagert. Künftige Anpassungen (neue Lieferanten, geänderte Rechnungsformate) erfordern keine Programmierung.

Schritt 1: Diagnose (Das "Warum") Wenn eine Rechnung falsch erkannt wird, bietet das Dashboard eine "Live-Diagnose". Die Logs zeigen nicht nur den extrahierten Wert, sondern auch den Kontext.
Beispiel: [REGEX MATCH] Betrag: '1' | Kontext: '...Seite 1 von 3...'.
Erkenntnis: Das System hat die Seitenzahl statt des Preises gelesen.

Schritt 2: Lösung per Konfiguration (Das "Wie") Es gibt zwei Wege zur Korrektur, ohne den Code anzufassen:

Parsing-Profil Manager (Dashboard): Einfaches Hinzufügen von neuen E-Mail-Adressen oder Keywords, um Einnahmen von Ausgaben zu unterscheiden.
Config.json (Server): Anpassung der Regex-Muster für exotische Rechnungsformate. (z.B. Hinzufügen von "Zahlbetrag" als Synonym für "Gesamtsumme").

Schritt 3: Die Sicherheitsnetze Das System ist "Fail-Safe" gebaut:

Regex-Engine: Lädt alle Regeln dynamisch.
KI-Fallback: Wenn Regex versagt, übernimmt automatisch das LLM (z.B. Llama 3) die Analyse. Dies dient als Sicherheitsnetz für unbekannte Formate.
Logging-Transparenz: Jede Entscheidung des Systems ist im Log nachvollziehbar dokumentiert.

6. Architektur-Validierung: Der "No-Code" Status

Das System wurde erfolgreich von einer statischen Programmierung zu einer konfigurationsgesteuerten Engine transformiert.

Anforderung / Änderung	Ort der Anpassung	Code-Eingriff nötig?
Neues Rechnungsformat (Regex ändern)	`config.json` (Server)	NEIN
Neuen Lieferanten zuordnen (Einnahme/Ausgabe)	Dashboard (Parsing Profil Manager)	NEIN
KI-Modell wechseln (z.B. auf GPT-4 oder Llama 3)	Dashboard (Dropdown-Menü)	NEIN
Neue Datenquelle (E-Mail, FTP) anbinden	Dashboard (Account Manager)	NEIN
E-Mails filtern (Spam-Schutz)	Dashboard (Rejection Keywords)	NEIN

7. Der "Digitale Buchungsstempel" & Vollständigkeits-Garantie

Ein einzigartiges Merkmal von KAI ist die Fähigkeit, absolut jedes Dokument – egal aus welcher Quelle – zu einem validen Buchungsbeleg zu veredeln. Nichts geht verloren, alles wird erfasst.

📥 Eingang
WhatsApp-Foto, E-Mail-PDF, Scan

🧠 Identifikation
KI prüft: Ist das eine Rechnung?

📝 Veredelung
Extraktion (Nr, Datum, Summen)

✅ Stempelung
Daten werden ins PDF "eingebrannt"

📤 Buchung
Upload & Verknüpfung in Lexoffice

8. Fazit

KAI ist nicht nur ein "Skript", sondern ein digitaler Mitarbeiter für die Buchhaltung und Unternehmensverwaltung. Es verwandelt unstrukturierte Datenströme (E-Mails, Chats, Dateien) in strukturierte, buchhaltungsreife Finanzdaten.

Das System verbindet technische Schnittstellen mit buchhalterischer Intelligenz und ist so konstruiert, dass es langfristig ohne Eingriff in den Quellcode betrieben, gewartet und angepasst werden kann.