OGV Buchhaltungsprüfung – technische Beschreibung
Stand: 16.10.06.11.2026 · Verantwortlich: TCG (M. Boeddinghaus) · Version 1.01
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,Layout (gefiltert aufProjekte,Projekte), dieKassenbücher undKassenbücher, die offenen Posten (Mahnliste)., optional die Buchungsliste und bei eigenen Mandanten der Prüfbericht. - Ablage und Versand: Die Berichte werden
als PDFabgelegt, z. B. inD:\ogv-data\01-OGV\2026\, und per Mail versendet. Die Anlagen sind mit Passwort verschlüsselt.09\10\… - Kita-Planung: Budget Kita Bleiche (Anlage 10 Stadt Gifhorn).
Optigem wird nur gelesen,gelesen, nie verändert oder gesperrt.
2. Systemumgebung
| Punkt | Wert |
|---|---|
| Server | OGV2051 (Windows Server, RDS), Zugriff per RDP/Guacamole |
| Programmordner | D:\ogv- (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) |
soffice.com/.exesmtp.office365.com:587D:\ogv-data · Schreiben: Ausgabe, Ablageordner in EingangD:\ogv-data00 Prüfung)
python\python312._pth enthält python312.zip, ., Lib\site-packages, ..\app und import site.
3. Verzeichnisstruktur
Test-ONE\D:\ogv-prüfen\
├─ Start-Pruefung.batapp\ PrüfungProgramm aller(pruefung.py, Mandantenberichte.py, direktoptigem.py, ausfinanzbericht.py,
Optigem│ offeneposten.py, kita_planung.py, access_parser\)
├─ Start-Pruefung-Exporte.batpython\ PrüfungPython aus3.12 Optigem-Exportenembedded im+ Ordner Eingang (Rückfall)Lib\site-packages
├─ Start-Berichte.batVorlagen\ BerichteKita-Vorlage erzeugen,(Anlage ablegen,10)
ggf.│ versenden└─ Mail\ Mailtexte (Standard.txt, <Bericht>.txt, mXX.txt)
├─ Berichte-Versenden.batAusgabe\ neuestenArbeitsordner
Berichtsordner versenden (mit Rückfrage)│ ├─ Start-Kita-Planung.batJJJJ-MM-DD Kitabericht\ Bleiche,je AnlageBerichtslauf: 10mXX <Bericht>\…, Versandliste.xlsx, versand.json, Mails\
│ └─ JJJJ\ nur noch _Projektliste_fuer_regeln_JJJJ.xlsx
├─ Verbindungstest.batEingang\ Datenbankennur finden,für Mandantden testweiseExport-Modus lesen– kann entfallen
├─ regeln.xlsx Konfiguration (wird bei Updates nie überschrieben)
├─ regeln_Vorlage.xlsx
Vorlage├─ –Start-Pruefung.bat wird· kopiert,Start-Pruefung-Exporte.bat wenn· regeln.xlsx fehltStart-Berichte.bat
├─ Berichte-Versenden.bat · Start-Kita-Planung.bat · Verbindungstest.bat
└─ LIESMICH.txt
├─ app\ Programmcode (siehe 4.)D:\ogv-data\
├─ python\mXX-JJJJ.mdb PythonOptigem-Jahresdatenbanken embedded(nur 32-bitgelesen)
├─ Vorlagen\ Kita-Anlage 10, Mail\Standard.txt (Mailtexte)BuchungsbelegAblage\MXX\JJJJ\
├─ Eingang\01-OGV\JJJJ\MM\
nur│ Export-Modus:├─ Optigem-Exporte00 Prüfung\ Prüfberichte aller Mandanten + Übersicht (.xls/.xlsx)neu)
│ ├─ 00 OGV Zentral\ · 00 Gifhorn – Kita\ · 01 <Ort> 7xx\ · 02 Projekte\
└─ Ausgabe\01-Bramfeld\JJJJ\MM\ ├─· 2026\01-Südharz\… Prüfberichte· je01-Gifhorn\… Mandant,· Übersicht,01-Müden\… Projektliste· └─ 2026-10-16 bericht\ Berichtslauf je Tag (siehe 9.2)01-Helmstedt\…
4. Komponenten
| Modul | Aufgabe |
|---|---|
pruefung.py |
Hauptprogramm Prüfung: Laden der Regeln, Loader (Optigem/Exporte), alle Prüfungen ( |
optigem.py |
Lesen der .%TEMP%\ogvpruef_*, direkt mit mandant_laden() liefert Buchungen, Konten, __main__ = |
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 |
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.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 |
Finanzbericht Finanzbericht 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)
ImNur mit Start-Pruefung-Exporte.bat oder wenn der Optigem-Datenordner nicht erreichbar ist. Dann liegen 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.
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.
- 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.
Kontenklassen OGV:
Projektkreise OGV:
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)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, |
| 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 |
| 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):
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)bat)
Ablage: (Monat des Stichtags, Ordner wird angelegt):Ausgabe\D:\ogv-data\01-OGV\JJJJ\MM\00 Prüfung\
Pruefung_mXX_<Name>_<Datum>._JJJJ-MM.xlsx je _Uebersicht_Mandanten_…_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).
9.2 Berichte (Start-Berichte.bat)bat)
Blatt Berichte,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 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 |
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,Laufs:
Ausgabe\JJJJ-MM-DD bericht\ (je Tag ein Ablage inAusgabe\2026-10-16mXXbericht\<Bericht>\├─mitm01denTiddische\Dateien,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(Empfänger, Anlagen, Status,Blatt VersandAblage)Ablage,+Passwort)BlattundVorlagenversand.json(FinanzberichteVersandstatus).jeDieserMandant)Ordner└─mussversand.jsonbisSteuerdatei für denzum Versand bleiben; ältere Ordner können danach gelöscht werden.
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 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)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 (derzeitnein).
Methode Outlook-Entwurf: Das Programm legt .eml-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):
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.
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} {Jahr}→ {Zeitraum}„Peine: {Anlagen}Auswertung {Absendername}31.10.2026“. Optional geht eine BCC an den Absender als Ablage.
11. Betrieb – typischer Monatsablauf
- Anfang des Monats
Start-Pruefung.bat→BefundePrüfberichte inden…\JJJJ\MM\00öffnen, Befunde bearbeiten (Optigem korrigieren).PrüfberichtenPrüfung - Erneut prüfen, bis keine Fehler mehr offen sind. Die Dateien des Monats werden dabei überschrieben.
Start-Berichte.bat→OrdnerArbeitsordnerAusgabe\JJJJ-MM-DD berichtprüfen,undPDFsVersandliste prüfen; die Dateien liegen bereits in der Ablage.- Versand bestätigen (direkt im Anschluss oder später mit
Berichte-Versenden.bat) → Rückfrage mitjbestätigen → Status inVersandliste.xlsx.
test laufen lassen.
12. Update und Wartung
- Ein Update-ZIP enthält keine
regeln.xlsx.xlsx. Du kopierst es einfach über den Programmordner; die Konfiguration bleibt erhalten. Einzelne Programmdateien kommen nachD:\ogv-prüfen\app\.
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 ja13. 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“ |
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.
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 (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).
Änderungen
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