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\ |
LibreOffice auf dem Server (soffice.com/.exe, headless, eigenes Temp-Profil) |
|
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 werdenm1-undm01-. Mandanten 1–30, Mandant 1 = OGV. - Das Vorjahr
mXX-(JJJJ-1).mdbwird 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 mitX-Unsent: 1im OrdnerMailsan. 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
- Anfang des Monats
Start-Pruefung.bat→ Befunde in den Prüfberichten bearbeiten (Optigem korrigieren). - Erneut prüfen, bis keine Fehler mehr offen sind.
Start-Berichte.bat→ OrdnerJJJJ-MM-DD berichtprüfen, PDFs liegen in der Ablage.Berichte-Versenden.bat→ Rückfrage mitjbestätigen → Status inVersandliste.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.xlsxwerden angekündigt und in die aktuelle Datei eingebaut. Optionale Spalten fehlen ohne Fehler. - Neues Jahr: nichts umstellen. Das Jahr folgt dem Stichtag,
mXX-JJJJ.mdbwird 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.