README

Diese Python Programm stellt eine grafische Oberfläche zur Verfügung, welche die halbjährliche Mitgliedsabrechnung automatisiert. Dabei werden die aktiven Mitglieder aus der Nami automatisch heruntergalden, mit den Rechnungen des DPSG abgeglichen und eine entsprechende *.csv Datei mit allen Lastschrifteinzügen erstellt, welche dann im VR Networld Programm eingelesen werden kann.

Folgende Features werden zurzeit unterstützt:

Tkinter GUI mit Sun Valley Design (https://github.com/rdbende/Sun-Valley-ttk-theme)
Erstellung einer offiziellen ISO20022 SEPA *.xml Datei
Automatisches Generieren der SEPA-Lastschriftaufträge im korrekten Format für VR-Networld
Abgleich der erzeugten Lastschrifteinzüge mit der Rechnung vom DPSG Mitgliederservice
Überprüfung von korrektem Mapping der SEPA-Mandate und der Nami Mitglieder
Korrekte Behandlung vom Beitragsatz (familienermäßigt, sozialermäßigt)
Korrekte Behandlung von Mitgliedern die unterjährig eingestiegen sind
Korrekte Behandlung von Schnuppermitgliedern und deren korrektes Eintrittsdatum für die Abrechnung
Automatisches Generieren des Verwendungszweckes mit Mitgliedsnamen und Abrechnungsjahr Angabe
Möglichkeit die Beiträge pro Jahr, oder pro Halbjahr zu berechnen
Überprüfung auf korrekte IBAN und BIC

Requirements

Folgende Dinge werden benötigt, damit das Skripot funktioniert:

Python 3.6 oder höher (getestet wurde mit 3.9)
Idealerweise liegt Python in den Pfadvariablen. Alternativ kann auch ein venv erzeugt werden
pynami Package für den API Zugriff (https://pynami.readthedocs.io/en/latest/installation.html und https://github.com/sscholz93/pynami)
Alle packages aus dem requirements.txt. Dazu eine Powershell im Repository root Ordner öffnen und folgenden Befehl ausführen: pip install -r requirements.txt

Usage

Damit der Export problemlos funktioniert, ist es wichtig, dass die Nami Datenbank gepflegt und aktuell ist. Die Nami Datenbank stellt dabei den Master dar und gibt auch die Kontodaten vor. Einzig die Mandate werden im VR-Networld neu angelegt. Das Skript versucht dann für jede Person ein passendes Mandat zu finden.

Nami pflegen und alle Benutzer entsprechend eintragen. Alle Kontodaten aktualisieren. Alle Schnuppermitgliedschaften pflegen
Anlegen aller SEPA-Mandate von neuen Mitgliedern in VR-Networld. Zurzeit ist ein Mandat pro Kontoinhaber vorgesehen.
Exportieren der SEPA-Mandate über VR Symbol -> Export:
Daten in der config.ini Datei entsprechend anpassen. Eine Beschreibung der Parameter findet ihr unten.
Skript ausführen. Dazu eine powershell im Repository Ordner öffnen und folgenden Befehl ausführen: python main.py

Das Skript lädt nun automatisch alle aktiven Nutzer der Nami runter und gleich diese mit den Mandaten ab. Die Statistik zum Schluss gibt Aufschluss darüber, ober etwas schief gegangen ist. Folgende Dinge werden am Ende des Skripts angezeigt:

Schnuppermitglieder, die im Abrechnungsjahr hinzugefügt wurden, jetzt aber schon aktive Mitglieder sind (8 Wochen Schnupperzeit ist abgelaufen).
Mitglieder die im zweiten Halbjahr des Abrechnungsjahres beitragspflichtig eingetragen wurden (Darunter zählen auch Schnuppermitglieder, deren Überführung zu einem beitragspflichtigen Mitglied im zweiten Halbjahr geschah).
Mitglieder die im Folgejahr des Abrechnungsjahres eingetragen wurden. Diese werden für die Abrechnung nicht berücksichtigt.
Mitglieder für die kein passendes SEPA-Mandat gefunden wurde.
Liste von SEPA-Mandaten die nicht verwendet wurden. Dies gibt Aufschluss darüber, ob Karteileichen in VR-Networld existieren.

Es wurde nun im Repository Ordner eine MitgliederAbrechnung_JJJJ.csv Datei erstellt. Diese Datei kann nun verwendet werden, um automatisch alle Lastschrifteinzüge in VR-Networld zu erstellen.

In VR-Networld die generierte Abrechnungsdatei importieren. Dazu VR Symbol -> Import Aufträge -> MitgliederAbrechnung_JJJJ.csv
Im Dialog nun erste importierte Zeile ist die Spaltenüberschrift? anklicken. Das Mapping der Spalten zu den Inhalten sollte nun automatisch funktionieren und richtig sein. Die ersten drei Felder stehen auf <nicht importiern>. Diese Felder sind die Mitgliedsnummer, sowie der Vor- und Nachname. Diese Felder werden für die Importierung nicht benötigt. Alternativ kann auch die Vorlage ImportFromPythoNScript.ini verwendet werden. Dazu muss diese nach C:\Users\Public\Documents\VR-NetWorld\Vorlagen kopiert werden. Die Felder BLZ und KontoNr müssen dann mit dem Vereinskonto noch ausgefüllt werden
OK klicken. Es werden nun alle Lastschrifteinzüge automatisch im Ausgangskorb angelegt.

Zu beachtende Dinge

Bei Mitglieder mit Schnuppermitgliedschaft muss diese an erster Stelle in der Tätigkeitenliste stehen. Ansonsten geht der Check schief, wann das genaue Eintrittsdatum des Mitglieds ist.
Enddatum der Schnuppermitgliedschaft nicht korrekt. Dadurch kann das Abholen der Aktivitäten fehlschlagen Mitglied ...: Enddatum scheint für die Schnuppermitgliedschaft nicht zu stimmen. {1: {'entries_aktivBis': ['Not a valid date.']}} Dies kann zum Beispiel vorkommen, wenn das Datum der Schnuppermitgliedschaft 8 Wochen überschreitet, oder eine zeitliche Lücke zwischen Schnuppermitgliedschaftsende und Berechenbares Mitglied Anfang besteht. Die Abzurechnende Mitgliedschaft muss immer einen Tag nachdem die Schnuppermitgliedschaft beendet wurde beginnen.

Config.ini

Nami Login
Username	Benutzername für den DPSG Nami Login
Password	Passwort für den DPGS Nami Login

General
Accounting Year	Jahr für das die Abbuchung erfolgen soll
Accounting Half-Year	1 = Berechnung erfolgt für das erste Halbjahr, 2= Berechnung erfolgt für das zweite Halbjahr, 3 = Berechnung erfolgt für das ganze Jahr (Beides Halbjahre werden zusammen eingezogen)
Booking Date	Abbuchungstag. Dieses Datum wird als Einzugsdatum im SEPA Lastschrifteinzug verwendet
Mandate Path	Pfad für Mandata Datei *.csv, die aus VR-Networld exportiert wurde

Key Dates
First Half-Year	Stichtag des ersten Halbjahres. Angegebenes Datum zählt noch zum ersten Halbjahr
Second Half-Year	Stichtag des zweiten Halbjahres. Angegebenes Datum zählt noch zum zweiten Halbjahr
Schnupper Weeks	Gibt an wie lange ein Mitglied als Schnuppermitglied angemeldet sein kann. Das Eintrittsdatum wird um die angegebenen Wochen erhöht, woraus sich dann das Eintrittsdatum als Beitragspflichtiges Mitglied ergibt

Membership Fees
Full	Voller Mitgliedsbeitrag (DPSG + individueller Stammesbeitrag)
Family	Familienermäßigter Mitgliedsbeitrag (DPSG + individueller Stammesbeitrag)
Social	Sozialenermäßigter Mitgliedsbeitrag (Nur DPSG Anteil)

Kommende Featureliste

Unterstützung der Abrechnung am Jahresanfang
Einfaches Handling von Mitgliedern die unterjährig ausgestiegen sind und die der Datenweiterverarbeitung nicht zugestimmt haben
Automatisches Mapping der Mandate zu den Mitgliedern über die Mitgliedernummer
Automatisches Anlegen der SEPA-Mandate bei neuen Mitgliedern

Credits

Dieses Projekt benutzt die pynami API von sscholz93, welche hier zu finden ist: https://github.com/sscholz93/pynami

f1shl / nami-beitragsrechner