Skip to main content

OGV Buchhaltungsprüfung – technische Beschreibung

Stand: 06.08.11.2026 · Verantwortlich: TCG (M. Boeddinghaus) · Version 1.12

Neu in 1.2: Projektkonto je Bericht – jede Buchung der Projekte mit laufendem Saldo und Status „abgerechnet/offen“.

Neu in 1.1: Buchungsliste je Bericht (xlsx) · Prüfbericht als Anlage für eigene Mandanten · Passwortschutz der Mail-Anlagen · Prüfung wird direkt in ogv-data abgelegt · keine doppelten Finanzbericht-Dateien mehr · Blatt „Buchungen“ beginnt am 01.01.

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. Er wird im Monatsordner unter D:\ogv-data\01-OGV\JJJJ\MM\00 Prüfung abgelegt.
  • Berichte: Auswertungen je Empfänger. Das sind der Finanzbericht im Optigem-Layout (gefiltert auf Projekte), die Kassenbücher, die offenen Posten (Mahnliste), optional die Buchungsliste und bei eigenen Mandanten der Prüfbericht.
  • Ablage und Versand: Die Berichte werden abgelegt, z. B. in D:\ogv-data\01-OGV\2026\10\…, und per Mail versendet. Die Anlagen sind mit Passwort verschlüsselt.
  • 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-prüfen (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\
Bibliotheken Verschlüsselung (neu) pypdf 6.21.4, msoffcrypto-tool 6.1.0, olefile 0.47, cryptography 48.0.1 (win32), cffi 2.1.1, pycparser 3.12
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, Ablageordner in D:\ogv-data (Berichte und 00 Prüfung)

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

3. Verzeichnisstruktur

D:\ogv-prüfen\
├─ app\                       Programm (pruefung.py, berichte.py, optigem.py, finanzbericht.py,
│                             offeneposten.py, kita_planung.py, access_parser\)
├─ python\                    Python 3.12 embedded + Lib\site-packages
├─ Vorlagen\                  Kita-Vorlage (Anlage 10)
│  └─ Mail\                   Mailtexte (Standard.txt, <Bericht>.txt, mXX.txt)
├─ Ausgabe\                   Arbeitsordner
│  ├─ JJJJ-MM-DD bericht\     je Berichtslauf: mXX <Bericht>\…, Versandliste.xlsx, versand.json, Mails\
│  └─ JJJJ\                   nur noch _Projektliste_fuer_regeln_JJJJ.xlsx
├─ Eingang\                   nur für den Export-Modus – kann entfallen
├─ regeln.xlsx                Konfiguration (wird bei Updates nie überschrieben)
├─ regeln_Vorlage.xlsx
├─ Start-Pruefung.bat · Start-Pruefung-Exporte.bat · Start-Berichte.bat
├─ Berichte-Versenden.bat · Start-Kita-Planung.bat · Verbindungstest.bat
└─ LIESMICH.txt

D:\ogv-data\
├─ mXX-JJJJ.mdb               Optigem-Jahresdatenbanken (nur gelesen)
├─ BuchungsbelegAblage\MXX\JJJJ\
├─ 01-OGV\JJJJ\MM\
│  ├─ 00 Prüfung\             Prüfberichte aller Mandanten + Übersicht (neu)
│  ├─ 00 OGV Zentral\ · 00 Gifhorn – Kita\ · 01 <Ort> 7xx\ · 02 Projekte\
└─ 01-Bramfeld\JJJJ\MM\ · 01-Südharz\… · 01-Gifhorn\… · 01-Müden\… · 01-Helmstedt\…

4. Komponenten

Modul Aufgabe
pruefung.py Hauptprogramm Prüfung: Laden der Regeln, Loader (Optigem/Exporte), alle Prüfungen (analyse), Prüfbericht (write_report), Übersicht, Ablageordner der Prüfung (pruef_ordner)
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 und die Finanzberichtsdefinition. __main__ = Verbindungstest, prüft auch die Verschlüsselung
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, Buchungsliste, Prüfbericht als Anlage, Ablage, Versandliste, Passwort je Bericht, Verschlüsselung der Anlagen, 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)

Nur mit Start-Pruefung-Exporte.bat oder wenn der Optigem-Datenordner nicht erreichbar ist. Dann liegen im Ordner Eingang 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.

Im Normalbetrieb (direkt aus Optigem) wird Eingang nicht gebraucht und kann gelöscht werden.

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. Der Stichtag bestimmt auch den Ablagemonat (JJJJ\MM), die Dateinamen und das Passwort.
  • 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.
Projektkonto (Bericht): jede Buchungsseite, deren Projekt (Soll-AB oder Haben-AB) in der Kontierung steht. Projekt im Soll = Forderung / Ausgabe (−), Projekt im Haben = Zahlung / Einnahme (+). Saldovortrag = Buchungen gegen 9000. Trägt eine Umbuchung das Projekt auf beiden Seiten, erscheint sie zweimal und hebt sich auf. Saldo 0,00 zum Stichtag = abgerechnet. Buchungsliste (Bericht): alle Buchungen vom 01.01. bis zum Stichtag, bei denen Soll- oder Haben-Projekt in „Projekte (Kontierung)“ steht oder Soll- oder Haben-Konto in „Kassenbücher (Konten)“. Sind beide Spalten leer, kommen alle Buchungen des Mandanten. Die Anfangsbestände zum 01.01. sind enthalten. 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:

Konten Bedeutung
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:

Projekte Bedeutung
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, Finanzbericht als PDF, Ablage Prüfung, 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; auch Rückfall für den Ort im Passwort
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“, Anhänge verschlüsseln, Passwort-Muster, Passwort-Hinweis – siehe 10
Kita_* Einstellungen, Zuordnung, Vorjahr, Projekte für die Kita-Planung

Wichtige Einstellungen (Blatt Einstellungen):

Einstellung Wert / Wirkung
Finanzbericht als PDF nein (empfohlen): Die Prüfung erzeugt keine eigenen Finanzbericht-Dateien, der Finanzbericht steht als Blatt im Prüfbericht. ja: zusätzlich Finanzbericht_mXX_JJJJ-MM_….pdf im Prüfungsordner. Hat keine Wirkung auf die PDFs der Mail-Berichte, die steuert „Anhänge“ im Blatt Mailversand.
Ablage Prüfung (optional) Ordner der Prüfberichte mit {JJJJ} und {MM} des Stichtags. Fehlt die Zeile, gilt D:\ogv-data\01-OGV\{JJJJ}\{MM}\00 Prüfung. Zeile vorhanden, aber leer → Ausgabe\JJJJ.

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.
  • Ja/nein-Spalten: ja (auch j, x, 1) schaltet ein; leer gilt als nein.

9. Ausgaben

9.1 Prüfung (Start-Pruefung.bat)

Ablage: D:\ogv-data\01-OGV\JJJJ\MM\00 Prüfung\ (Monat des Stichtags, Ordner wird angelegt):

  • Pruefung_mXX_<Name>_JJJJ-MM.xlsx je Mandant
  • _Uebersicht_Mandanten_JJJJ-MM.xlsx mit allen Mandanten, Anzahl der Befunde und Link auf den Prüfbericht
  • nur bei „Finanzbericht als PDF“ = ja: Finanzbericht_mXX_JJJJ-MM_….pdf

Ein erneuter Lauf im selben Stichtagsmonat überschreibt die Dateien. Ist eine Datei gerade geöffnet, wird der neue Stand als …_HHMM.xlsx daneben gespeichert (Meldung im Fenster). _Projektliste_fuer_regeln_JJJJ.xlsx bleibt als Hilfsliste in Ausgabe\JJJJ.

Blätter des Prüfberichts:

  • Übersicht
  • Fehlerliste: jeder Befund mit Datum, Buch.-Nr, Konto, Projekt, Betrag, Text (filterbar), auch die Konto- und Projektbefunde ohne Buchung (z. B. E15 Umbuchungskonten 800–861).
  • Buchungen: die Arbeitsliste. Sie beginnt direkt mit der ersten Buchung am 01.01. und hat die 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 ohne Buchung stehen nicht mehr oben, sondern nur in der Fehlerliste.
  • 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 Finanzbericht und Buchungsliste, z. B. 707 oder 501; 201; leer = gesamter Mandant
Kassenbücher (Konten) je Konto ein Kassenbuch, z. B. 545-547; auch Filter der Buchungsliste
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
Projektkonto (neu 1.2) ja (nur mit Projekte (Kontierung)) → JJJJ-MM_<Bericht>_Projektkonto als PDF wie der Finanzbericht: oben je Projekt Saldovortrag, Forderung / Ausgabe (−), Zahlung / Einnahme (+), Saldo und Status (abgerechnet / offen / Guthaben); darunter je Projekt jede Buchung mit Datum, Nr, Konto, Kontoname, Gegenkonto, UK, Buchungstext, Rg.-Nr, Beleg und laufendem Saldo. Für die Projektverantwortlichen zur Kontrolle, ob alles abgerechnet ist. Buchungsliste (neu) ja → zusätzlich JJJJ-MM_<Bericht>_Buchungsliste.xlsx (Aufbau wie Blatt Buchungen der Prüfung, ohne Befund und Storno-Paar) Ort (Passwort) (neu) Ort für das Anlagen-Passwort, z. B. Peine → pein. Leer = Ort aus Blatt Orte, dessen Name oder Suchbegriff im Berichtsnamen steht, sonst Berichtsname ohne „OGV-Projekt -“ Prüfung (neu) ja → der neueste Prüfbericht des Mandanten aus dem Prüfungsordner wird als JJJJ-MM_<Bericht>_Pruefung.xlsx angehängt. Nur für eigene Mandanten (m20, m21, m23, m24, m26) oder interne Empfänger – der Prüfbericht enthält den ganzen Mandanten.

Ergebnis eines Laufs:

  • Arbeitsordner Ausgabe\JJJJ-MM-DD bericht\ (je Tag ein Ordner): mXX <Bericht>\ mit den Dateien, Versandliste.xlsx (Empfänger, Anlagen, Status, Ablage, Passwort) und versand.json (Versandstatus). Dieser Ordner muss bis zum Versand bleiben; ältere Ordner können danach gelöscht werden.
  • Ablage in D:\ogv-data\…\JJJJ\MM\…: Finanzbericht und Kassenbücher als PDF, Buchungsliste und Prüfbericht als xlsx, alle unverschlüsselt. Die Dateinamen richten sich nach dem Stichtag (2026-10_Peine_Auswertung.pdf, 2026-10-31_Peine_540.pdf, 2026-10_Peine_Buchungsliste.xlsx). Ein weiterer Lauf mit demselben Stichtag überschreibt sie. Dateien, die ein späterer Lauf nicht mehr erzeugt, bleiben liegen. Geöffnete Dateien werden nicht ersetzt (Meldung „! Ablage …“).
  • Die xlsx-Dateien von Finanzbericht und Kassenbuch werden nach erfolgreicher PDF-Erzeugung gelöscht; ohne PDF bleiben sie stehen. Buchungsliste und Prüfbericht bleiben immer xlsx.
  • Alle PDFs entstehen in einem LibreOffice-Aufruf, bei 58 PDFs ca. 45 s auf OGV2051, bei 80 PDFs einige Minuten.
  • 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 …]“. Die Anlagen sind wie im Echtbetrieb verschlüsselt.
  • ja: an die Empfänger.
  • Vor jedem Versand fragt das Programm (j/n) und listet je Mail Empfänger, Anzahl der Anlagen und Passwort.

Methode SMTP: Exchange Online, Port 587, STARTTLS. Das Passwort bleibt in der Datei am besten 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. Mit SMTP erscheinen die Mails nicht im eigenen Postfach, außer „Kopie an Absender (BCC)“ = ja (derzeit nein).

Methode Outlook-Entwurf: Das Programm legt .eml-Dateien mit X-Unsent: 1 im Ordner Mails des Berichtsordners an. Ein Doppelklick öffnet sie in Outlook, dort auf Senden klicken.

Doppelversand: Bereits gesendete Mails (Status in versand.json) werden nicht erneut verschickt. Das gilt nur innerhalb desselben Tagesordners: Ein Lauf an einem anderen Tag legt einen neuen Ordner an und würde bei Versand = ja erneut senden. Für einen reinen Ablage-Lauf vorher Versand = nein setzen. Ein Fehler wird je Mail in der Versandliste vermerkt.

Anlagen: „Anhänge“ = PDF (Standard) · xlsx · beides. Buchungsliste und Prüfbericht gehen immer als xlsx mit.

Passwortschutz der Anlagen (neu):

Einstellung Wert Wirkung
Anhänge verschlüsseln ja jede Mail-Anlage wird mit Passwort verschlüsselt: PDF mit AES-256 (pypdf), xlsx mit der Office-Verschlüsselung AES-256 (msoffcrypto). Öffnet in Acrobat, Excel und LibreOffice mit Passwortabfrage.
Passwort-Muster {JJJJ}{Ort4}{MM} {JJJJ} Jahr und {MM} Monat des Stichtags, {Ort4} erste 4 Buchstaben des Ortes (klein, ä→ae, ö→oe, ü→ue, ß→ss, nur a–z/0–9), {Ort} ganzer Ort
Passwort-Hinweis „Die Anlagen sind mit dem vereinbarten Passwort geschützt.“ Satz in der Mail (Platzhalter {Passworthinweis}; fehlt er im Mailtext, steht der Satz unter den Anlagen)

Beispiele zum Stichtag 31.10.2026: Peine → 2026pein10 · Tiddische → 2026tidd10 · Hankensbüttel → 2026hank10 · Müden → 2026mued10 · Bramfeld → 2026bram10 · Göttingen → 2026goet10.

  • Verschlüsselt wird nur die Anlage in der Mail. Berichtsordner und Ablage bleiben unverschlüsselt.
  • Das Passwort steht nicht in der Mail. Je Bericht steht es in der Versandliste (Spalte „Passwort Anlagen“).
  • Klappt die Verschlüsselung nicht, wird die Mail nicht gesendet (Status „Fehler“), nie unverschlüsselt.

Betreff und Text: Platzhalter {Bericht} {Mandant} {Monat} (z. B. „Oktober 2026“) {Stichtag} (z. B. „31.10.2026“) {Jahr} {Zeitraum} {Anlagen} {Absendername} {Passworthinweis}. Betreff z. B. {Bericht}: Auswertung {Stichtag} → „Peine: Auswertung 31.10.2026“.

11. Betrieb – typischer Monatsablauf

  1. Anfang des Monats Start-Pruefung.bat → Prüfberichte in …\JJJJ\MM\00 Prüfung öffnen, Befunde bearbeiten (Optigem korrigieren).
  2. Erneut prüfen, bis keine Fehler mehr offen sind. Die Dateien des Monats werden dabei überschrieben.
  3. Start-Berichte.bat → Arbeitsordner Ausgabe\JJJJ-MM-DD bericht und Versandliste prüfen; die Dateien liegen bereits in der Ablage.
  4. Versand bestätigen (direkt im Anschluss oder später mit Berichte-Versenden.bat) → Rückfrage mit j bestätigen → Status in Versandliste.xlsx.
  5. Nach Änderungen an regeln.xlsx oder am Programm zuerst mit Versand = test laufen lassen.

12. Update und Wartung

  • Ein Update-ZIP enthält keine regeln.xlsx. Du kopierst es einfach über den Programmordner; die Konfiguration bleibt erhalten. Einzelne Programmdateien kommen nach D:\ogv-prüfen\app\.
  • Vor dem Update den Programmordner sichern (z. B. Unterordner alt 01).
  • Nach dem Update Verbindungstest.bat starten: Es muss „Verschlüsselung der Anlagen (PDF/xlsx, AES-256): OK“ erscheinen.
  • Neue Blätter oder Spalten in regeln.xlsx werden angekündigt und in die aktuelle Datei eingebaut. Optionale Spalten (Buchungsliste, Ort (Passwort), Prüfung, Ablage Prüfung …) fehlen ohne Fehler.
  • Neues Jahr: nichts umstellen. Das Jahr folgt dem Stichtag, mXX-JJJJ.mdb wird automatisch gefunden; Ablage- und Prüfungsordner werden angelegt.
  • Neuer Mandant: Zeile im Blatt Mandanten (Aktiv ja) und bei Bedarf im Blatt Berichte anlegen, Ort (Passwort) eintragen.

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“
Verbindungstest: „Verschlüsselung der Anlagen: FEHLER“ / Versandstatus „Verschlüsselung nicht möglich“ Bibliotheken in python\Lib\site-packages fehlen → Ordner python aus dem Paket vollständig neu kopieren
Hinweis „cryptography on a 32-bit Python …“ harmlos (nur Geschwindigkeit); ab Version 1.1 ausgeblendet
Empfänger kann Anlage nicht öffnen Passwort aus der Versandliste prüfen; Ort in Spalte „Ort (Passwort)“ korrigieren
„… ist geöffnet – gespeichert als …_HHMM.xlsx“ Prüfdatei war beim Lauf offen; Datei schließen und erneut prüfen, die _HHMM-Datei löschen
„! Ablage … – Fehler“ Datei in der Ablage ist geöffnet oder keine Schreibrechte
„Prüfung ist vom … – vor/am Stichtag“ / „keine Prüfung gefunden“ vor Start-Berichte.bat erst Start-Pruefung.bat laufen lassen
Buchungsliste fehlt Spalte „Buchungsliste“ im Blatt Berichte = ja? Überschrift exakt „Buchungsliste“
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).
  • Mail-Anlagen werden mit AES-256 verschlüsselt. Das Passwort-Muster ist für Eingeweihte ableitbar: Es schützt vor Fehlversand und vor Mitlesen, ersetzt aber kein individuelles Passwort. Das Passwort wird nie in derselben Mail genannt.
  • Die Versandliste in Ausgabe enthält die Passwörter → Ausgabe-Ordner nur für die Buchhaltung freigeben.
  • Prüfberichte und Buchungslisten „gesamter Mandant“ nur an den jeweiligen Mandanten oder intern senden – nie an einzelne OGV-Orte (m01).
  • Das SMTP-Passwort wird nicht gespeichert, wenn das Feld leer bleibt (empfohlen; derzeit ist es eingetragen).

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.
  • Spalte „Buchungsliste“ im Blatt Berichte: festlegen, welche Orte und Projekte die Buchungsliste bekommen (derzeit nur Bramfeld).
  • SMTP-Passwort aus regeln.xlsx entfernen (wird dann beim Versand abgefragt).
  • Optional: individuelle Passwörter je Empfänger statt Muster.

Änderungen

Version Datum Änderung
1.0 16.10.2026 erste Fassung
1.2
08.11.2026 Projektkonto je Bericht (Spalte „Projektkonto“) 1.1 06.11.2026 Blatt Buchungen ab 01.01. ohne Kontobefunde · Buchungsliste je Bericht · Prüfbericht als Anlage · Passwortschutz der Anlagen (AES-256, Muster {JJJJ}{Ort4}{MM}) · Prüfung direkt in D:\ogv-data\01-OGV\JJJJ\MM\00 Prüfung mit Überschreiben im Monat · Finanzbericht-Dateien nur noch bei PDF = ja · Eingang nur für Export-Modus · Verbindungstest prüft Verschlüsselung