OGV Buchhaltungsprüfung – technische Beschreibung
Stand: 08.11.2026 · Verantwortlich: TCG (M. Boeddinghaus) · Version 1.2
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üfungabgelegt. - 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 |
| 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, 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 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)
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(auchj,x,1) schaltet ein; leer gilt alsnein.
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.xlsxje Mandant_Uebersicht_Mandanten_JJJJ-MM.xlsxmit 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) undversand.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
- Anfang des Monats
Start-Pruefung.bat→ Prüfberichte in…\JJJJ\MM\00 Prüfungöffnen, Befunde bearbeiten (Optigem korrigieren). - Erneut prüfen, bis keine Fehler mehr offen sind. Die Dateien des Monats werden dabei überschrieben.
Start-Berichte.bat→ ArbeitsordnerAusgabe\JJJJ-MM-DD berichtund Versandliste prüfen; die Dateien liegen bereits in der Ablage.- Versand bestätigen (direkt im Anschluss oder später mit
Berichte-Versenden.bat) → Rückfrage mit j bestätigen → Status inVersandliste.xlsx. - Nach Änderungen an regeln.xlsx oder am Programm zuerst mit Versand =
testlaufen 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.batstarten: 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.mdbwird 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
Ausgabeenthä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 |
No comments to display
No comments to display