Skip to content

Vereinsverwaltung Plugin

Claude edited this page Nov 20, 2026 · 3 revisions

Vereinsverwaltung-Plugin (e.V.) (verein.jar)

English: Association plugin (EN) · Übersicht: Plugins

Das Vereinsverwaltung-Plugin (verein.jar) erweitert OpenYaBS für deutsche gemeinnützige Vereine (e.V.) um Mitgliederverwaltung, jährlichen SEPA-Beitragslauf, BMF-konforme Zuwendungsbestätigungen (§ 10b EStG / § 50 EStDV) und eine 4-Sphären-Auswertung – vollständig in Deutsch und Englisch über die Plugin-Übersetzungs-API (ExtensionContext.tr), ohne den OpenYaBS-Kern zu verändern.

Funktionen im Überblick

  • Mitglieder- & SEPA-Daten am Kontakt: Mitgliedsnummer, Status (Aktiv, Jugend, Familie, Passiv (beitragsfrei), Ehrenmitglied (beitragsfrei), Ausgetreten), Beitrags-Artikelnummer (z. B. BEITRAG-AKTIV), Eintritts- und Austrittsdatum, SEPA-Mandatsreferenz & Unterschriftsdatum sowie Notizen.
  • Jährlicher Beitragslauf (Beitragslauf (e.V.) starten): Erzeugt Jahres-Beitragsrechnungen (0 % USt im Ideellen Bereich) für alle beitragspflichtigen Mitglieder. Überspringt automatisch beitragsfreie (Passiv, Ehrenmitglied), vor dem Beitragsjahr ausgetretene sowie bereits für das Jahr abgerechnete Mitglieder und erzeugt die EPC-konforme SEPA-Pre-Notification.
  • 4-Sphären-Modell & EÜR-Auswertung (Stand 2026): Zuordnung jeder Rechnung zu Ideeller Bereich, Vermögensverwaltung, Zweckbetrieb oder Wirtschaftlicher Geschäftsbetrieb inkl. Übersichtstab, CSV-Export und automatischer Prüfung der ab 01.01.2026 geltenden Grenzen (Steueränderungsgesetz 2025):
    • § 64 Abs. 3 AO: Freigrenze Wirtschaftlicher Geschäftsbetrieb 50.000 EUR brutto/Jahr.
    • § 55 Abs. 1 Nr. 5 AO: Befreiung von der zeitnahen Mittelverwendung bis 100.000 EUR Jahreseinnahmen.
  • BMF-Zuwendungsbestätigungen (§ 10b EStG / § 50 EStDV):
    • Taggenaue Gültigkeitsprüfung nach § 63 Abs. 5 AO: 5 Jahre beim Freistellungsbescheid bzw. 3 Jahre beim Feststellungsbescheid nach § 60a AO.
    • Echter deutscher Zahlwort-Konverter (125,00 → einhundertfünfundzwanzig Euro) für das amtliche BMF-Muster.
    • Schutz gegen unzulässige Abzugsbestätigungen für Mitgliedsbeiträge (§ 10b Abs. 1 S. 8 EStG bei Sport-/Freizeitvereinen) sowie Hinweis auf den vereinfachten Zuwendungsnachweis bis 300 EUR (§ 50 Abs. 4 EStDV).
    • Option für Aufwandsverzicht (§ 10b Abs. 3 EStG).
  • Vorlagen-Platzhalter & LibreOffice-Vorlagen: Stellt [ev.*]-Platzhalter bereit und liefert zuwendungsbestaetigung_geld.fodt sowie beitragsrechnung.fodt mit.

Installation

  1. verein.jar aus dem Ordner plugins/ der OpenYaBS-Distribution (bzw. openyabs-plugins-<version>.zip) unter Einstellungen › Plugins › Plugin importieren einbinden.
  2. Beim Start legt das Plugin automatisch die plugin-eigenen Tabellen (verein_schema_version, ev_member_data, ev_invoice_data) datenbankübergreifend (H2, Derby, MySQL/MariaDB, PostgreSQL) an.

Einstellungen

Unter Einstellungen › Plugins › Vereinsverwaltung (e.V.) (je Datenbank gespeichert):

  • SEPA Gläubiger-ID, Zuständiges Finanzamt, Steuernummer des Vereins.
  • Art des Bescheids (§ 63 Abs. 5 AO): Freistellungsbescheid / KSt-Anlage (5 Jahre) oder Feststellungsbescheid nach § 60a AO (3 Jahre), Bescheiddatum (TT.MM.JJJJ), Veranlagungszeitraum, Begünstigter Zweck laut Satzung (§ 52 AO).
  • Mitgliedsbeiträge sind steuerlich abzugsfähig (Standard: aus, da Sport-/Freizeitvereine nach § 10b Abs. 1 S. 8 EStG ausgeschlossen sind).
  • Kleinunternehmerregelung aktiv (§ 19 UStG): dieselbe Einstellung wie in der Firmeninformation (Rechnungshinweis, E-Rechnung, Warnung bei den Grenzen 25.000 EUR Vorjahr / 100.000 EUR laufendes Jahr); siehe Kleinunternehmerregelung.
  • Vereinsrechnungen & Zuwendungsbestätigungen beim Speichern prüfen (nicht-blockierender Hinweisdialog).

Befehle im Menü Plugins

  1. Verein: Standard-Beitragstarife anlegen (0 % USt) – legt BEITRAG-AKTIV, BEITRAG-JUGEND, BEITRAG-FAMILIE und SPENDE mit 0 % USt an (idempotent).
  2. Verein: Beitragslauf (e.V.) starten – erzeugt Jahres-Beitragsrechnungen für das gewählte Beitragsjahr.
  3. Verein: SEPA-Sammellastschrift (pain.008.001.08) exportieren – erzeugt eine gegen das offizielle ISO-20022-Schema (pain.008.001.08.xsd) geprüfte SEPA-Sammeldatei (BtchBookg=true) für alle offenen SEPA-Beitragsrechnungen des gewählten Beitragsjahrs mit individueller Mandatsreferenz, Mandatsdatum und frei wählbarem Fälligkeitsdatum (Standard: +14 Tage für Pre-Notification).
  4. Verein: 4-Sphären-Auswertung (EÜR) & CSV-Export – öffnet den Übersichtstab mit 2026-Grenzwertprüfung und CSV-Export.
  5. Verein: Dokumentvorlagen (.fodt) speichern – exportiert das verbindliche amtliche BMF-Muster Anlage 3 (zuwendungsbestaetigung_geld.fodt) und beitragsrechnung.fodt in einen Ordner.
  6. Verein: Aktuelle Rechnung / Spendenquittung prüfen – prüft den geöffneten Beleg manuell.

Vorlagen-Platzhalter ([ev.*])

Platzhalter Inhalt
[ev.memberId] / [ev.status] / [ev.joinDate] Mitgliedsnummer, Status, Eintrittsdatum
[ev.creditorId] / [ev.sepaMandateRef] / [ev.sepaMandateDate] SEPA-Gläubiger-ID, Mandatsreferenz, Mandatsdatum
[ev.sepaPreNotification] Fertiger SEPA-Pre-Notification- oder Überweisungshinweis
[ev.taxSphere] / [ev.fiscalYear] Steuersphäre & Beitrags-/Spendenjahr
[ev.finanzamt] / [ev.taxNumber] Zuständiges Finanzamt & Steuernummer
[ev.bescheidType] / [ev.freistellungDate] / [ev.freistellungPeriod] Art, Datum und Zeitraum des Bescheids
[ev.purposeClause] Begünstigter Satzungszweck (§ 52 AO)
[ev.amountInWords] Betrag in echten deutschen Worten (BMF-konform)
[ev.donationKind] / [ev.waiverNotice] Geldzuwendung / Mitgliedsbeitrag & Aufwandsverzicht-Angabe

Siehe auch

Clone this wiki locally