Skip to main content

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üfung abgelegt.
  • Berichte: Auswertungen je Empfänger. Das sind der Finanzbericht im Optigem-Layout,Layout (gefiltert auf Projekte,Projekte), die Kassenbücher undKassenbücher, die offenen Posten (Mahnliste)., optional die Buchungsliste und bei eigenen Mandanten der Prüfbericht.
  • Ablage und Versand: Die Berichte werden als PDF abgelegt, z. B. in D:\ogv-data\01-OGV\2026\09\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,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-ONEprü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,exe, headless, eigenes Temp-Profil) Mail SMTP (Exchange Online smtp.office365.com:587,587, STARTTLS) oder Outlook-Entwurf (.eml) Rechte Lesen: D:\ogv-data · Schreiben: Ausgabe, Ablageordner in EingangD:\ogv-data, Ablageordner(Berichte und 00 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 (analyse)analyse), Prüfbericht (write_report)write_report), ÜbersichtÜbersicht, Ablageordner der Prüfung (pruef_ordner)
optigem.py Lesen der .mdb:mdb: Kopie nach %TEMP%\ogvpruef_*, direkt mit access_parser;access_parser; Rückfall ODBC (Jet), unter Linux mdbtools. mandant_laden() liefert Buchungen, Konten, Projekte,Projekte und die Finanzberichtsdefinition. __main__ = VerbindungstestVerbindungstest, 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)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.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,Finanzberichte, Finanzbericht Berichtsteil,Berichtsteil, Finanzbericht Positionen,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)

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.
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)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, PDFFinanzbericht ja/nein,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üfberichtPrü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)bat)

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

        Pruefung_mXX_<Name>_<Datum>._JJJJ-MM.xlsx je Mandant,Mandant dazu _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).
        Buchungen: die ArbeitslisteArbeitsliste. Sie beginnt direkt mit dender 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;markiert. Kontobefunde ohne Buchung stehen oben.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)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 denFinanzbericht 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
        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,Laufs:

          Arbeitsordner Ausgabe\JJJJ-MM-DD bericht\ (je Tag ein Ordner:Ordner):
          Ausgabe\2026-10-16mXX bericht\<Bericht>\ ├─mit m01den Tiddische\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  Blatt Versand (Empfänger, Anlagen, Status, Ablage)Ablage, +Passwort) Blattund Vorlagenversand.json (FinanzberichteVersandstatus). jeDieser Mandant)Ordner └─muss versand.jsonbis Steuerdatei für denzum 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 (Status2026-10_Peine_Auswertung.pdf, je2026-10-31_Peine_540.pdf, Mail)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.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)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-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} {Jahr}→ {Zeitraum}„Peine: {Anlagen}Auswertung {Absendername}31.10.2026“. Optional geht eine BCC an den Absender als Ablage.

                11. Betrieb – typischer Monatsablauf

                1. Anfang des Monats Start-Pruefung.bat → BefundePrüfberichte in den…\JJJJ\MM\00 PrüfberichtenPrü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 → OrdnerArbeitsordner Ausgabe\JJJJ-MM-DD bericht prüfen,und PDFsVersandliste 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.
                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.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.gefunden; Ablage- und Prüfungsordner werden angelegt. Neuer Mandant: Zeile im Blatt Mandanten (Aktiv ja)ja) und bei Bedarf im Blatt Berichte anlegen.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/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)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.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