Skip to content

Association plugin (EN)

anti43 edited this page Nov 20, 2026 · 2 revisions

Association Plugin (e.V.) (verein.jar)

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.

Features

  • 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 .fodt Templates: Contributes [ev.*] placeholders and bundles zuwendungsbestaetigung_geld.fodt and beitragsrechnung.fodt.

Installation

  1. Import verein.jar from plugins/ of the OpenYaBS distribution (or openyabs-plugins-<version>.zip) via Settings › Plugins › Import plugin.
  2. On startup, the plugin automatically creates its own cross-database tables (verein_schema_version, ev_member_data, ev_invoice_data).

Commands (under Plugins)

  1. Association: Import starter membership tiers (0 % VAT) – creates BEITRAG-AKTIV, BEITRAG-JUGEND, BEITRAG-FAMILIE, and SPENDE (idempotent).
  2. Association: Run annual membership dues batch – creates annual dues invoices for a chosen billing year.
  3. 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).
  4. Association: 4-Sphere Tax Summary & CSV Export – opens the 4-sphere overview tab with 2026 threshold status and CSV export.
  5. Association: Export document templates (.fodt) – exports the verbatim official BMF Anlage 3 donation receipt (zuwendungsbestaetigung_geld.fodt) and beitragsrechnung.fodt.
  6. Association: Check current invoice / donation receipt – runs the compliance check on the open invoice.

Template Placeholders ([ev.*])

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

See also

Clone this wiki locally