Skip to main content

OGV Buchhaltungsprüfung – technische Beschreibung

Stand: 16.10.2026 · Verantwortlich: TCG (M. Boeddinghaus) · Version 1.0

1. Zweck

Werkzeug für die Buchhaltung des OGV e.V. Es liest die laufende Optigem-Buchhaltung aller Mandanten direkt aus den Jahresdatenbanken und erledigt vier Aufgaben:

  • Prüfung: je Mandant ein Prüfbericht mit Befunden direkt an der Buchung, also falsche Projekte, fehlende Belege, offene Posten, Salden ≠ 0 usw.
  • Berichte: Auswertungen je Empfänger. Das sind der Finanzbericht im Optigem-Layout, gefiltert auf Projekte, die Kassenbücher und die offenen Posten (Mahnliste).
  • Ablage und Versand: Die Berichte werden als PDF abgelegt, z. B. in D:\ogv-data\01-OGV\2026\09\…, und per Mail versendet.
  • Kita-Planung: Budget Kita Bleiche (Anlage 10 Stadt Gifhorn).

Optigem wird nur gelesen, nie verändert oder gesperrt.

2. Systemumgebung

Punkt Wert
Server OGV2051 (Windows Server, RDS), Zugriff per RDP/Guacamole
Programmordner D:\ogv-data\01-OGV\Test-ONE (frei wählbar)
Laufzeit Python 3.12.10 32-bit embedded, im Ordner python enthalten – keine Installation, keine Adminrechte
Bibliotheken openpyxl 3.1.5, et_xmlfile 2.0.0, xlrd 2.0.1, pyodbc 5.2.0, construct 2.10.70, tabulate 0.10.0; access_parser (Apache-2.0, angepasst) in app\
PDF LibreOffice auf dem Server (soffice.com/.exe, headless, eigenes Temp-Profil)
Mail SMTP (Exchange Online smtp.office365.com:587, STARTTLS) oder Outlook-Entwurf (.eml)
Rechte Lesen: D:\ogv-data · Schreiben: Ausgabe, Eingang, Ablageordner

python\python312._pth enthält python312.zip, ., Lib\site-packages, ..\app und import site.

3. Verzeichnisstruktur

Test-ONE\
├─ Start-Pruefung.bat          Prüfung aller Mandanten direkt aus Optigem
├─ Start-Pruefung-Exporte.bat  Prüfung aus Optigem-Exporten im Ordner Eingang (Rückfall)
├─ Start-Berichte.bat          Berichte erzeugen, ablegen, ggf. versenden
├─ Berichte-Versenden.bat      neuesten Berichtsordner versenden (mit Rückfrage)
├─ Start-Kita-Planung.bat      Kita Bleiche, Anlage 10
├─ Verbindungstest.bat         Datenbanken finden, Mandant testweise lesen
├─ regeln.xlsx                 Konfiguration (wird bei Updates nie überschrieben)
├─ regeln_Vorlage.xlsx         Vorlage – wird kopiert, wenn regeln.xlsx fehlt
├─ LIESMICH.txt
├─ app\                        Programmcode (siehe 4.)
├─ python\                     Python embedded 32-bit
├─ Vorlagen\                   Kita-Anlage 10, Mail\Standard.txt (Mailtexte)
├─ Eingang\                    nur Export-Modus: Optigem-Exporte (.xls/.xlsx)
└─ Ausgabe\
   ├─ 2026\                    Prüfberichte je Mandant, Übersicht, Projektliste
   └─ 2026-10-16 bericht\      Berichtslauf je Tag (siehe 9.2)

4. Komponenten

Modul Aufgabe
pruefung.py Hauptprogramm Prüfung: Laden der Regeln, Loader (Optigem/Exporte), alle Prüfungen (analyse), Prüfbericht (write_report), Übersicht
optigem.py Lesen der .mdb: Kopie nach %TEMP%\ogvpruef_*, direkt mit access_parser; Rückfall ODBC (Jet), unter Linux mdbtools. mandant_laden() liefert Buchungen, Konten, Projekte, Finanzberichtsdefinition. __main__ = Verbindungstest
finanzbericht.py Finanzbericht im Optigem-Layout aus den Optigem-Tabellen; Summen mit Projektfilter; PDF über LibreOffice (ein Aufruf für alle Dateien, Zeitgrenze, Prozessabbruch)
berichte.py Berichte je Empfänger (Blatt Berichte), Kassenbuch, Ablage, Versandliste, Mailversand (SMTP / .eml)
offeneposten.py Offene Posten / Mahnliste je Personen-Unterkonto über das Feld Rechnungs-Nr, inkl. Vorjahr
kita_planung.py Anlage 10 + Planungshilfe, Hochrechnung nach Stichtagsmonat
access_parser\ Reiner Python-Leser für Access-Dateien. Angepasst: TYPE_MONEY = int64 / 10000 (korrigiert „164,390.37“ / „.-700“)

5. Datenquellen

5.1 Optigem-Jahresdatenbanken

  • Pfad: D:\ogv-data\mXX-JJJJ.mdb, z. B. m01-2026.mdb; gesucht werden m1- und m01-. Mandanten 1–30, Mandant 1 = OGV.
  • Das Vorjahr mXX-(JJJJ-1).mdb wird automatisch mitgelesen, wenn es vorhanden ist (Vergleichsspalte, OP-Vortrag).
  • Lesen: Datei → Temp-Kopie → direkt lesen → Kopie löschen. Damit wird die Jet-Arbeitsgruppensicherheit (.mdw) umgangen; ODBC brach mit Fehler -1907 ab.
  • Gelesene Tabellen:
Tabelle Verwendete Felder
Buchungen Nummer, Datum, Soll-/Haben-Hauptkonto, -Unterkonto, -AB (=Projekt), Buchungsbetrag, Buchungstext, Belegnummer, Rechnungs-Nr, Storniert
Sachkonten Hauptkonto-Nr, Unterkonto-Nr, Kontoname
Arbeitsbereiche / Projektbereich Projekte (Nr, AB-Name) und Projektbereich
Finanzberichte, Finanzbericht Berichtsteil, Finanzbericht Positionen, Sachkonten-Finanzberichtspositions-Zuordnung Aufbau der Finanzberichte je Mandant (= „Vorlagen“)

Personennamen sind nicht in der Jahresdatenbank. Die Mahnliste nimmt sie aus dem Buchungstext („Kd. 1310, Lokaj, …“).

5.2 Belegablage

Pfad: D:\ogv-data\BuchungsbelegAblage\M01\2026\$_06000001_1.pdf. Die Belegnummer ist 8-stellig. Im Prüfbericht wird die Belegnummer als Link auf die Datei gesetzt.

5.3 Export-Modus (Rückfall)

Im Ordner Eingang liegen drei Optigem-Exporte: Buchungsliste, Sachkonten-Saldenliste und AB-Saldenliste (.xls). Das Programm erkennt sie an den Spalten. Fehlt das Jahr, nimmt es dieses aus „Anf.-Bestand 01.01.JJJJ“. Der Finanzbericht ist in diesem Modus nicht möglich, die Kassenbücher und die OP-Liste schon.

6. Rechenlogik

  • Stichtag: letzter Tag des Vormonats, z. B. am 03.01.2027 der 31.12.2026; ein fester Wert kann eingestellt werden. Das Geschäftsjahr ist das Jahr des Stichtags. Buchungen nach dem Stichtag (vorerfasst) zählen nicht in die Summen und sind kein Befund; die Übersicht nennt ihre Anzahl.
  • Ist-Umsatz: Haben − Soll (Einnahmen +, Ausgaben −), ohne Saldovortrag 9000, außer der Finanzbericht hat in Optigem „MitSaldovorträgen“. Das Vorjahr umfasst denselben Zeitraum. Geprüft gegen die Optigem-PDFs (OGV gesamt, Tiddische): Werte centgenau.
  • Projektfilter Finanzbericht: Es zählen nur Buchungsseiten, deren Projekt in der Kontierung steht (Soll-AB bzw. Haben-AB). Der Kopf lautet dann „Erstellung für: Projekt 707: …“.
  • Kassenbuch: alle Buchungen auf dem Geldkonto mit laufendem Bestand. Soll auf dem Konto = Einnahme, Haben = Ausgabe. Gegenkonto, UK und Projekt kommen von der Gegenseite. Stornos erscheinen mit negativem Betrag.
  • Stornos: Das Original ist in Optigem als „storniert“ markiert, die Gegenbuchung hat den negativen Betrag mit gleichen Konten und Projekten. Solche Paare werden erkannt und unauffällig grau dargestellt. Ein ungepaarter Storno ist Befund E19.
  • Kontenklassen OGV:
    • 300–399 Saldovortrag der Bereiche zum 1.1.
    • 800–899 Umbuchungskonten, Saldo 0 Pflicht
    • 2000–2999 Erträge
    • 3000–3999 Aufwand
    • 9000–9999 Saldokonten
  • Projektkreise OGV:
    • 2xx Gehälter: über 801/31xx gebucht, über 2xxx erstattet
    • 5xx Gemeindebeiträge: über 800 gefordert, über 2xxx bezahlt
    • 7xx Gemeinden
    • 9xx Verrechnung: Saldo 0
  • Offene Posten: Abgleich nach FIFO, d. h. Zahlungen tilgen die ältesten Forderungen. Überfällig ab „Offene Posten: Fehler ab Tagen“ (Standard 60). Ein negativer Saldo wird als Guthaben ausgewiesen.

7. Prüfungen

Code Schwere Prüfung
E01 Fehler Erfolgskonto ohne Projekt (Projektpflicht je Mandant ja/nein/auto)
E02 Fehler Projekt nicht in Projektliste
E03 Fehler Konto-Kürzel passt nicht zum Projektbereich, z. B. „Personal (Z)“ auf Kita-Projekt
E04 Warnung Konto nicht im Kontenplan
E05 Warnung Erfolgskonto keinem Finanzbericht zugeordnet
E06/E07 Fehler Abstimmung Konto/Projekt gegen Saldenliste (Export-Modus)
E09 Hinweis mögliche Doppelbuchung (ab Betrag aus Einstellungen)
E10 Hinweis Betrag 0,00
E11 Warnung Datum außerhalb Geschäftsjahr
E12 Hinweis Kürzel ohne Regel / Zielbereich existiert nicht
E13 Warnung Projekt ohne Projektbereich
E14 Fehler Konto für dieses Projekt nicht erlaubt (Projektbereiche → Erlaubte Konten)
E15 Fehler Kontenklasse mit Saldo-0-Pflicht nicht 0 (z. B. 800–899)
E16/E17/E18 F/W/H Beleg: Datei fehlt / Belegnummer fehlt / Datei ohne Buchung
E19 Fehler Storno ohne Gegenbuchung
R01 … lt. Regel eigene Regeln aus Blatt Regeln (siehe unten)

Regeltypen (Blatt Regeln):

  • Saldo 0: Das Projekt muss zum Stichtag 0 sein, z. B. 9xx.
  • Gegenkonto nur: Für dieses Projekt sind nur bestimmte Geldkonten erlaubt, z. B. Projekt 701 nur über 515–517.
  • Erfolgskonto nur: Auf diese Projekte dürfen nur bestimmte Erfolgskonten gebucht werden.
  • Unterkonto Pflicht: Buchungen auf diesen Konten brauchen ein Personen-Unterkonto, z. B. Zuwendungen 2050–2069; 2087.
  • Rechnung über Konto: Rechnungen laufen über ein Konto (z. B. 851) mit Rechnungs-Nr und gleichem Unterkonto.
  • Ausgleich je Projekt / je Unterkonto: Forderung und Zahlung müssen sich auflösen, z. B. 5xx über 800 und 2000–2999, 2xx über 3100–3199 und 2000–2999.

Gewollte Sonderfälle stehen im Blatt Ausnahmen (Konto/Projekt + Prüfcode), z. B. 3393 E01, 7xx E16;E17.

8. Konfiguration regeln.xlsx

Blatt Inhalt
Einstellungen Optigem-Datenordner, Mandanten (1-30), OGV-Mandant, Stichtag, Geschäftsjahr, Finanzbericht-Standard, Toleranz, Doppelbuchung ab, OP-Tage, PDF ja/nein, DB-Passwort
Mandanten je Mandant Name, Projektpflicht, Aktiv (sobald einmal „ja“ steht → nur „ja“-Mandanten), Finanzbericht (Optigem-Name/Nr.)
Regeln eigene Prüfregeln (Abschnitt 7)
Kontenklassen von–bis, Bezeichnung, Saldo-0-Pflicht
Kuerzel Kontokürzel → Projektbereich
Ausnahmen Konto/Projekt + Prüfcode(s) ohne Befund
Orte Ort, Suchbegriff im Projektnamen, Bank-/Kassenkonten → Blatt Orte im Prüfbericht
Bereichsvortrag Projektbereich → Vortragskonten 35x
Projektbereiche je Mandant Projekt, Name, Bereich, erlaubte Konten (Vorrang vor Optigem)
Berichtsaufbau alter Berichtsaufbau (nur noch Rückfall)
Berichte je Zeile ein Bericht – siehe 9.2
Mailversand Versand nein/test/ja, Methode, SMTP, Absender, Testempfänger, Betreff, Mailtext, Anhänge, Ablage (Standard), optional „xlsx-Dateien behalten“
Kita_* Einstellungen, Zuordnung, Vorjahr, Projekte für die Kita-Planung

Eingabehinweise:

  • Mehrere Nummern trennst du mit ;. Ein Komma wandelt LibreOffice in eine Dezimalzahl um; das Programm zerlegt „501,201“ trotzdem richtig in die Projekte 501 und 201.
  • Ein Hochkomma ('706) markiert nur Text und ist unschädlich.

9. Ausgaben

9.1 Prüfung (Start-Pruefung.bat)

Ausgabe\JJJJ\Pruefung_mXX_<Name>_<Datum>.xlsx je Mandant, dazu _Uebersicht_Mandanten_…xlsx und _Projektliste_fuer_regeln_JJJJ.xlsx.

Blätter des Prüfberichts:

  • Übersicht
  • Buchungen: die Arbeitsliste mit den Spalten Datum, Nr, Soll, Soll U., Soll P., Haben, Haben U., Haben P., Betrag, Buchungstext, Rg.-Nr, Beleg (Link), Storno-Paar und Befund. Der Befund ist nur an Datum/Nr farbig markiert; Kontobefunde stehen oben.
  • Finanzbericht
  • Projekte: Saldovortrag, Forderung (−), Zahlung (+), Saldo (negativ rot) und Befund.
  • Bereiche
  • Orte: je Ort die Projekte und der Kontostand.
  • Monate
  • Abstimmung

9.2 Berichte (Start-Berichte.bat)

Blatt Berichte, eine Zeile je Bericht:

Spalte Bedeutung
Aktiv · Mandant · Bericht Bericht = Name (Ordner, Dateiname, Betreff); je Mandant eindeutig
Finanzbericht Optigem-Name/Nr.; leer = wie Blatt Mandanten; - = keiner
Projekte (Kontierung) Filter für den Finanzbericht, z. B. 707 oder 501; 201; leer = gesamter Mandant
Kassenbücher (Konten) je Konto ein Kassenbuch, z. B. 545-547
Empfänger · Kopie an Mailadressen, mit ; getrennt
Mailtext Datei in Vorlagen\Mail (leer = <Bericht>.txt, mXX.txt, Standard.txt)
Ablage (Ordner) z. B. D:\ogv-data\01-OGV\{JJJJ}\{MM}\00 OGV Zentral; ohne Platzhalter wird \JJJJ\MM\<Bericht> angehängt; Ordner wird angelegt
Offene Posten (Konto) z. B. 851 → Mahnliste

Ergebnis eines Laufs, je Tag ein Ordner:

Ausgabe\2026-10-16 bericht\
├─ m01 Tiddische\  2026-09_Tiddische_Auswertung.pdf · 2026-09-30_Giro_545.pdf · 2026-09-30_Bar_546.pdf
├─ m01 Offene Posten\  2026-09-30_Offene_Posten_851.pdf
├─ Mails\           (nur Methode Outlook-Entwurf: .eml)
├─ Versandliste.xlsx  Blatt Versand (Empfänger, Anlagen, Status, Ablage) + Blatt Vorlagen (Finanzberichte je Mandant)
└─ versand.json       Steuerdatei für den Versand (Status je Mail)
  • Die xlsx-Dateien werden nach erfolgreicher PDF-Erzeugung gelöscht; ohne PDF bleiben sie stehen.
  • Alle PDFs entstehen in einem LibreOffice-Aufruf, bei 58 PDFs ca. 45 s auf OGV2051.
  • Vorlagen: Die Finanzberichte jedes Mandanten werden direkt aus Optigem gelesen. Ein Bericht wird über den Namen in der Spalte Finanzbericht gewählt. Welche es gibt, steht im Blatt Vorlagen der Versandliste.

9.3 Mahnliste (Offene Posten)

  • Sie ist je Personen-Unterkonto (Kd.-Nr.) sortiert und zeigt je Rechnungs-Nr Datum, Forderung, Zahlung, offenen Betrag, Tage und Status (offen / überfällig / Guthaben, „(Vorjahr)“).
  • Vortrag: Er kommt aus den 9000-Buchungen auf das Konto. Zahlungen auf Vorjahresrechnungen werden mit dem Vortrag verrechnet. Liegt die Vorjahres-DB vor und stimmen die Summen, zeigt die Liste die alten Rechnungen einzeln.
  • Buchungen ohne Unterkonto stehen am Ende unter „bitte klären“.

9.4 Kita-Planung (Start-Kita-Planung.bat)

Liest den OGV-Mandanten und füllt die Anlage 10 mit Planungshilfe. Ergebnis: Ausgabe\Kita-Planung_<Planjahr>_<Datum>.xlsx.

10. Mailversand

  • Versand (Blatt Mailversand):
    • nein: nur erzeugen.
    • test: Alle Mails gehen an den Testempfänger, der Betreff beginnt mit „[TEST an …]“.
    • ja: an die Empfänger.
    • Vor jedem Versand fragt das Programm (j/n).
  • Methode SMTP: Exchange Online, Port 587, STARTTLS. Das Passwort bleibt in der Datei leer und wird beim Versand abgefragt. Für das Absenderpostfach muss Authentifiziertes SMTP aktiviert sein: M365 Admin Center → Benutzer → E-Mail → E-Mail-Apps verwalten.
  • Methode Outlook-Entwurf: Das Programm legt .eml-Dateien mit X-Unsent: 1 im Ordner Mails an. Ein Doppelklick öffnet sie in Outlook, dort auf Senden klicken.
  • Doppelversand: Bereits gesendete Mails (Status in versand.json) werden nicht erneut verschickt. Ein Fehler wird je Mail in der Versandliste vermerkt.
  • Betreff und Text: Platzhalter {Bericht} {Mandant} {Monat} {Stichtag} {Jahr} {Zeitraum} {Anlagen} {Absendername}. Optional geht eine BCC an den Absender als Ablage.

11. Betrieb – typischer Monatsablauf

  1. Anfang des Monats Start-Pruefung.bat → Befunde in den Prüfberichten bearbeiten (Optigem korrigieren).
  2. Erneut prüfen, bis keine Fehler mehr offen sind.
  3. Start-Berichte.bat → Ordner JJJJ-MM-DD bericht prüfen, PDFs liegen in der Ablage.
  4. Berichte-Versenden.bat → Rückfrage mit j bestätigen → Status in Versandliste.xlsx.

12. Update und Wartung

  • Ein Update-ZIP enthält keine regeln.xlsx. Du kopierst es einfach über den Programmordner; die Konfiguration bleibt erhalten.
  • Neue Blätter oder Spalten in regeln.xlsx werden angekündigt und in die aktuelle Datei eingebaut. Optionale Spalten fehlen ohne Fehler.
  • Neues Jahr: nichts umstellen. Das Jahr folgt dem Stichtag, mXX-JJJJ.mdb wird automatisch gefunden.
  • Neuer Mandant: Zeile im Blatt Mandanten (Aktiv ja) und bei Bedarf im Blatt Berichte anlegen.

13. Fehlerbehebung

Symptom Ursache / Lösung
No module named optigem python312._pth ohne ..\app – Paket vollständig neu kopieren
ODBC -1907 Jet-Arbeitsgruppe; irrelevant, Direktlesen ist Standard
Fenster steht bei „PDF: …“ LibreOffice hängt: im Task-Manager soffice.exe/soffice.bin beenden, neu starten; nach der Zeitgrenze bricht das Programm selbst ab
keine PDFs LibreOffice nicht gefunden → xlsx bleiben, Mails hängen xlsx an
„Kein Absender eingetragen“ Blatt Mailversand → Absender (E-Mail)
SMTP-Anmeldung fehlgeschlagen SMTP AUTH im M365-Postfach aktivieren oder Methode „Outlook-Entwurf“
Berichte überschreiben sich gleicher Berichtsname im selben Mandanten – Programm hängt „2“ an und meldet die Zeile
Projektliste „501,201“ falsch mit ; trennen
E03-Flut Kürzel-Ziel (Blatt Kuerzel) existiert nicht als Projektbereich → E12-Hinweis beachten

14. Datenschutz und Sicherheit

  • Es wird nur gelesen, und zwar aus einer Temp-Kopie, die danach gelöscht wird. Optigem wird nie gesperrt oder verändert.
  • Die Berichte enthalten personenbezogene Daten (Zuwendungen, Namen, Rechnungen). Die Ablage- und Ausgabeordner sind nur für die Buchhaltung freizugeben. Versandt wird nur an eingetragene Empfänger der jeweiligen Gemeinde (AVV).
  • Das SMTP-Passwort wird nicht gespeichert, wenn das Feld leer bleibt (empfohlen).

15. Offene Punkte

  • Konto 851: Saldovortrag 2026 enthält 32 Vortragsbuchungen ohne Personen-Unterkonto (−9.111,18 €). 28 ihrer Rechnungsnummern kommen zusätzlich mit Unterkonto vor; vermutlich ein doppelter Vortrag. In Optigem prüfen.
  • Personennamen kommen nur aus dem Buchungstext; eine Anbindung der Optigem-Adressdatenbank ist möglich.
  • Finanzbericht für Projekt 707 (Tiddische): erster Lauf auf OGV2051 gegen das Optigem-PDF abgleichen.