Repository navigation
Association plugin (EN)
anti43 edited this page Nov 20, 2026
·
2 revisions
Deutsch: Vereinsverwaltung-Plugin (DE) · Overview: Plugins (EN)
The Association (e.V.) plugin (verein.jar) adds German non-profit association management to OpenYaBS — member tiers, annual SEPA dues batch runs, official BMF donation receipts (§ 10b EStG / § 50 EStDV), and 4-sphere tax reporting aligned with 2026 German non-profit tax law (Steueränderungsgesetz 2025). It adapts automatically to English and German via ExtensionContext.tr with zero changes to OpenYaBS core.
-
Member & SEPA metadata on contacts: Member number, status (
Active,Youth,Family,Passive (dues-exempt),Honorary member,Exited), dues tier SKU (e.g.BEITRAG-AKTIV), join/exit dates, SEPA mandate reference & signature date, and notes. - Annual Dues Batch Run: Generates 0 % VAT annual dues invoices (Ideeller Bereich) for all billable active members, skipping exempt, already-exited, and already-billed members, and populating EPC SEPA Core Direct Debit pre-notification text.
-
4-Sphere Tax Model & EÜR Overview (2026 thresholds): Assigns every invoice to Ideeller Bereich, Vermögensverwaltung, Zweckbetrieb, or Wirtschaftlicher Geschäftsbetrieb with a live overview tab, CSV export, and automatic checks against the 01.01.2026 thresholds:
- § 64 Abs. 3 AO: Commercial sphere threshold 50,000 EUR gross/year.
- § 55 Abs. 1 Nr. 5 AO: Timely use of funds exemption up to 100,000 EUR annual receipts.
-
BMF Donation Receipts (§ 10b EStG / § 50 EStDV):
- Exact-day validity check under § 63 Abs. 5 AO: 5 years for Freistellungsbescheid and 3 years for § 60a AO Feststellungsbescheid.
- Real German number-to-words converter (
125.00→ einhundertfünfundzwanzig Euro) for official BMF forms. - Guard against issuing tax-deductible receipts for excluded membership dues (§ 10b Abs. 1 S. 8 EStG) and simplified proof hint up to 300 EUR (§ 50 Abs. 4 EStDV).
- Supports reimbursement waiver flag (Aufwandsverzicht, § 10b Abs. 3 EStG).
-
Template Placeholders & Bundled
.fodtTemplates: Contributes[ev.*]placeholders and bundleszuwendungsbestaetigung_geld.fodtandbeitragsrechnung.fodt.
- Import
verein.jarfromplugins/of the OpenYaBS distribution (oropenyabs-plugins-<version>.zip) via Settings › Plugins › Import plugin. - On startup, the plugin automatically creates its own cross-database tables (
verein_schema_version,ev_member_data,ev_invoice_data).
-
Association: Import starter membership tiers (0 % VAT) – creates
BEITRAG-AKTIV,BEITRAG-JUGEND,BEITRAG-FAMILIE, andSPENDE(idempotent). - Association: Run annual membership dues batch – creates annual dues invoices for a chosen billing year.
-
Association: Export SEPA Direct Debit batch (pain.008.001.08) – generates an ISO 20022 XSD-validated SEPA batch XML (
BtchBookg=true) for all unpaid SEPA membership invoices of a billing year using each member's explicit mandate reference, signature date, and a configurable collection date (default +14 days for Pre-Notification). - Association: 4-Sphere Tax Summary & CSV Export – opens the 4-sphere overview tab with 2026 threshold status and CSV export.
-
Association: Export document templates (.fodt) – exports the verbatim official BMF Anlage 3 donation receipt (
zuwendungsbestaetigung_geld.fodt) andbeitragsrechnung.fodt. - Association: Check current invoice / donation receipt – runs the compliance check on the open invoice.
| Placeholder | Value |
|---|---|
[ev.memberId] / [ev.status] / [ev.joinDate]
|
Member number, status, join date |
[ev.creditorId] / [ev.sepaMandateRef] / [ev.sepaMandateDate]
|
SEPA Creditor ID, mandate reference, signature date |
[ev.sepaPreNotification] |
Ready-to-print SEPA pre-notification or bank transfer text |
[ev.taxSphere] / [ev.fiscalYear]
|
German tax sphere & billing/donation year |
[ev.finanzamt] / [ev.taxNumber]
|
Tax office & association tax number |
[ev.bescheidType] / [ev.freistellungDate] / [ev.freistellungPeriod]
|
Tax exemption notice type, date, and period |
[ev.purposeClause] |
Charitable purpose per statutes (§ 52 AO) |
[ev.amountInWords] |
Amount in real German words (BMF-compliant) |
[ev.donationKind] / [ev.waiverNotice]
|
Donation / membership dues label & reimbursement waiver text |
![]()
Download installation packages here!
Deutsch
- Dokumentation (DE)
- Beschreibung
- Hinweise und Neuerungen
- Datenbank
- E-Rechnung
- Kleinunternehmer
- Datenschutz (DSGVO)
- Journal
- GoBD
- SEPA-Lastschrift
- Kontaktliste
- QR-Code
- Dateinamen
- Shopify
- Kasse und TSE
- Vorlagen
- Spaltendefinition
- Skripte
Plugins (DE)
- Plugins (Übersicht)
- DATEV-Export
- GoBD-Plugin
- Heilpraktiker-Plugin
- Kfz-Werkstatt-Plugin
- Vereinsverwaltung-Plugin
- ScriptOnSavePlugin
- Plugins schreiben
English
- Documentation (EN)
- Notes and changes
- Database
- Journal
- Small business VAT exemption
- Data protection (GDPR)
- SEPA direct debit
- Contact list
- QR code
- File name defaults
- Shopify
- Cash register and TSE
- Templates
- Scripts
Plugins (EN)